8000 [CEP 25] Versioning of Existing conda Standards by beckermr · Pull Request #119 · conda/ceps · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

[CEP 25] Versioning of Existing conda Standards #119

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

Merged
merged 25 commits into from
May 7, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
ce969f5
[CEP XXXX] Versioning of Existing conda Standards
beckermr Mar 14, 2025
a2ca585
Apply suggestions from code review
beckermr Mar 14, 2025
f09ca78
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Mar 14, 2025
bd882c6
Update cep-XXXX.md
beckermr Mar 14, 2025
3bde9bd
Update cep-XXXX.md
beckermr Mar 14, 2025
05041c6
Merge branch 'main' into beckermr-patch-3
beckermr Mar 15, 2025
dc05cc2
Apply suggestions from code review
beckermr Mar 19, 2025
d3b336c
Update cep-XXXX.md
beckermr Mar 19, 2025
d2f3ccb
Update cep-XXXX.md
beckermr Mar 19, 2025
43bd338
Merge branch 'main' into beckermr-patch-3
beckermr Mar 19, 2025
a28403b
Update cep-XXXX.md
beckermr Mar 20, 2025
5128d3c
Update cep-XXXX.md
beckermr Mar 20, 2025
11ffde7
Merge branch 'main' into beckermr-patch-3
beckermr Mar 20, 2025
a53ab74
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Mar 20, 2025
fcfe36d
Merge branch 'main' into beckermr-patch-3
beckermr Mar 21, 2025
0baed5a
Update cep-XXXX.md
beckermr Mar 21, 2025
574d3fb
Reformat versioning and compatibility sections
beckermr Mar 21, 2025
0742039
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Mar 21, 2025
da31f80
Merge branch 'main' into beckermr-patch-3
beckermr Mar 31, 2025
5e29beb
Update cep-XXXX.md
beckermr Mar 31, 2025
c21f398
Update cep-XXXX.md
beckermr Mar 31, 2025
f5d9864
Update cep-XXXX.md
beckermr Mar 31, 2025
619a574
Merge branch 'main' into beckermr-patch-3
beckermr Apr 15, 2025
1adfc36
Merge branch 'main' of github.com:conda/ceps into beckermr-patch-3
jaimergp May 7, 2025
835e042
Mint as CEP 25
jaimergp May 7, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,8 @@ for conda's implementation, all major changes should be submitted as
| [0021](cep-0021.md) | Run-exports in sharded Repodata |
| [0022](cep-0022.md) | Frozen environments |
| [0023](cep-0023.md) | Text spec input files |
| [0024](cep-0024.md) | Specification of <code>environment.yml</code> input files |
| [0025](cep-0025.md) | Versioning of Existing conda Standards |

## References

Expand Down
44 changes: 44 additions & 0 deletions cep-0025.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# CEP 25 - Versioning of Existing conda Standards

<table>
<tr><td> Title </td><td> CEP 25 - Versioning of Existing conda Standards and Specs </td></tr>
<tr><td> Status </td><td> Approved </td></tr>
<tr><td> Author(s) </td><td> Matthew R. Becker &lt;becker.mr@gmail.com&gt;</td></tr>
<tr><td> Created </td><td> Mar 14, 2025</td></tr>
<tr><td> Updated </td><td> Mar 31, 2025</td></tr>
<tr><td> Discussion </td><td> https://github.com/conda/ceps/pull/119 </td></tr>
<tr><td> Implementation </td><td> NA </td></tr>
</table>

## Abstract

As the conda ecosystem is being standardized and evolving, the existing standards
(in many cases only documented by the code that implements them) have been called
`v1` in some cases (e.g., `.tar.bz2` versus `.conda`) and `v0` in others (e.g., `v0` versus `v1` recipe formats).
This differing nomenclature is confusing. In this CEP, we resolve this issue by establishing conventions on how to number existing and future `conda` standards.

## Specification

All existing conda standards which satisfy the following conditions

- are documented formally in CEPs or are only effectively documented through code implementations
- have not been superseded by a newer standard labeled `v1`

MUST be versioned at `v1`.

The numbering of build recipe formats is exempt from this CEP due to the fact
that the new recipe format in [CEP 14](https://github.com/conda/ceps/blob/main/cep-0014.md) specified `schema_version: 1`.

Standards MUST use a version specifier that consists only of numbers and a single period `.`, has a major version,
and has at most a minor version (i.e. matches the regex `^[0-9]+($|\.[0-9]+$)`). A `v` MAY be prepended
for clarity, but MUST be removed before comparing versions. Version comparisons and ordering MUST follow
`conda`'s version comparison and ordering conventions.

## Backwards Compatibility

The `v1` versioning is fully backwards compatible with all current standards, except recipe formats
which have been explicitly excluded.

## Copyright

All CEPs are explicitly [CC0 1.0 Universal](https://creativecommons.org/publicdomain/zero/1.0/).
0