Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: Clarify compression package #14257

Merged
merged 4 commits into from
Sep 30, 2024
Merged

Conversation

chaudum
Copy link
Contributor

@chaudum chaudum commented Sep 25, 2024

What this PR does / why we need it:

This PR renames "encoding" to "codec" in the compression package to remove the cognitive dissonance.

It also removes the Enc prefix for codec identifiers, so that they adhere Go's best practice of naming conventions, e.g. compression.EncGZIP becomes compression.GZIP when used in a different package.

Special notes for your reviewer:

  • It is important that the order of the items in the codecs iota stays untouched, because the value (byte) is encoded into chunks.
  • This PR does not change user-facing occurrences of the word "encoding".

Checklist

  • Reviewed the CONTRIBUTING.md guide (required)
  • Documentation added
  • Tests updated
  • Title matches the required conventional commits format, see here
    • Note that Promtail is considered to be feature complete, and future development for logs collection will be in Grafana Alloy. As such, feat PRs are unlikely to be accepted unless a case can be made for the feature actually being a bug fix to existing behavior.
  • Changes that require user attention or interaction to upgrade are documented in docs/sources/setup/upgrade/_index.md
  • For Helm chart changes bump the Helm chart version in production/helm/loki/Chart.yaml and update production/helm/loki/CHANGELOG.md and production/helm/loki/README.md. Example PR
  • If the change is deprecating or removing a configuration option, update the deprecated-config.yaml and deleted-config.yaml files respectively in the tools/deprecated-config-checker directory. Example PR

@chaudum chaudum marked this pull request as ready for review September 25, 2024 13:23
@chaudum chaudum requested a review from a team as a code owner September 25, 2024 13:23
Copy link
Contributor

@ashwanthgoli ashwanthgoli left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

A compression algorithm is called Codec, not Encoding.

Signed-off-by: Christian Haudum <[email protected]>
Signed-off-by: Christian Haudum <[email protected]>
@chaudum chaudum force-pushed the chaudum/clarify-compression-package branch from 722cd71 to 0e96e12 Compare September 30, 2024 06:34
@chaudum chaudum merged commit f52f8ad into main Sep 30, 2024
61 checks passed
@chaudum chaudum deleted the chaudum/clarify-compression-package branch September 30, 2024 06:55
jeschkies pushed a commit to jeschkies/loki that referenced this pull request Oct 1, 2024
This PR renames "encoding" to "codec" in the compression package to remove the cognitive dissonance.

It also removes the `Enc` prefix for codec identifiers, so that they adhere Go's best practice of naming conventions, e.g. `compression.EncGZIP` becomes `compression.GZIP` when used in a different package.

Signed-off-by: Christian Haudum <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants