On 17 Nov 2021, at 15:12, Eric Timmons wrote:
On 11/17/21 2:38 PM, Robert Goldman wrote:
On 17 Nov 2021, at 13:31, Robert Dodier wrote:
On Wed, Nov 17, 2021 at 10:45 AM Robert Goldman
rpgold...@sift.info
<mailto:rpgold...@sift.info <mailto:rpgold...@sift.info>>
wrote:
I favor something like this because it would be nice to have
prerelease versions of ASDF that perform version checks
properly.
What I mean is, if we are going to add a feature in version
3.4,
right now that would be in a prerelease version with a
version
number of something like 3.3.5.22
It would be a lot better for realistic testing if we could
instead use 3.4.0-alpha1 or 3.4.0-1 and have ASDF know that
3.4.0-1 comes before 3.4.0, not after.
Hi Robert, hi everyone. I haven't been following closely, but
while
you are working out details, let me just mention that I
recommend
against version numbers that require special interpretation
to
discover their ordering, e.g. 3.4.0-1 < 3.4.0.
Mostly I'm just thinking that somebody's not going to get the
memo
(it's usually me).
For what it's worth, and all the best.
I guess that would be an argument for using something more
obvious than |-|, like the string |alpha| so |3.4.0-alpha1|
or
|3.4.0alpha1| instead of |3.4.0-1| since there the meaning
should be relatively obvious.
My feeling is that if a user misinterprets |3.4.0-1|, then
shame
on me. But if a user misinterprets |3.4.0alpha1| then shame
on them.
I'm not sure how that would align with semver...
Erik already sent out some examples of ordering with semver. But
it
is worth noting that 3.4.0-1 *is* valid semver and the ordering
would be 3.4.0-1 < 3.4.0-alpha
So to prevent misinterpretation of 3.4.0-1, ASDF could either
promise to always use something like alpha/beta/etc, use
something
else like PEP440 (I believe that grammar always requires an
alphabetic character for pre-releases), or bake its own grammar.
One thing that's nice about the semver grammar is its
flexibility. I
have some scripts that can generate a version string from a git
repo
that lets you easily order versions based on things like when
they
branched off the default branch. But if we want ASDF to disallow
things like 3.4.0-1, I'm happy to build my own system that uses
the
new API to allow the use of semver strings.
Another option is to choose something compatible with Debian's
version strings. I'm having a little trouble grokking it at the
moment, but it seems to be even more freeform than semver and
adds
an optional epoch prefix.
What might be nice would be to support a /subset/ of semver by
default -- not allowing the numerical prerelease flagged with |-| --
but do so in a way that is extensible.
Here's my rationale: I would like to provide a relatively simple
semantic versioning that is also compatible with automatically
detecting and rejecting ill-formed version strings.
So, for example, we could (by default!) split the version strings by
|#\.| and |#\-| and /reject/ any string bounded by |#\.| that is not
numerical.
We could demand, again by default, that the substring following the
|#\-| be of some constrained form: e.g., Greek letter name followed
by optional numeral. For that matter, we could just say "hey, alpha
and beta are enough" and reject anything but those two. That would be
a nice alternative to having a big table of Greek letter names in
ASDF!
Finally, for those who want to really go for it, we could add a
|:version-scheme| keyword to |defsystem|, which would initially
default to |:unconstrained|, but then through the standard process of
warning and then erroring, migrate to |:standard| (or perhaps
|:asdf|) as the default, but let anyone who wants to make up their
own versioning scheme. |semver| would be an obvious extension.
Hm. That's a bit more complex than I had hoped, but it would mean
ASDF systems would initially continue to work, it provides for some
error checking, and a path to extension.