document current draft for iana submission

[spiffcs]

WIP: Ideally we can discuss this in the afternoon and have a submission by the end of the day

Signed-off-by: Christopher Angelo Phillips christopher.phillips@anchore.com

[github-actions]

Benchmark Test Results

Benchmark results from the latest changes vs base branch

name                                                   old time/op    new time/op    delta
ImagePackageCatalogers/ruby-gemspec-cataloger-2          1.25ms ± 2%    1.31ms ± 1%  +4.68%  (p=0.008 n=5+5)
ImagePackageCatalogers/python-package-cataloger-2        2.86ms ± 2%    2.97ms ± 1%  +3.63%  (p=0.008 n=5+5)
ImagePackageCatalogers/javascript-package-cataloger-2     724µs ± 3%     777µs ± 1%  +7.28%  (p=0.008 n=5+5)
ImagePackageCatalogers/dpkgdb-cataloger-2                 792µs ± 4%     855µs ± 2%  +7.98%  (p=0.008 n=5+5)
ImagePackageCatalogers/rpmdb-cataloger-2                  800µs ± 3%     821µs ± 0%  +2.60%  (p=0.008 n=5+5)
ImagePackageCatalogers/java-cataloger-2                  11.7ms ± 2%    11.5ms ± 1%    ~     (p=0.095 n=5+5)
ImagePackageCatalogers/apkdb-cataloger-2                 1.18ms ± 1%    1.18ms ± 1%    ~     (p=0.151 n=5+5)
ImagePackageCatalogers/go-module-binary-cataloger-2       606ns ± 4%     635ns ± 1%  +4.75%  (p=0.008 n=5+5)

name                                                   old alloc/op   new alloc/op   delta
ImagePackageCatalogers/ruby-gemspec-cataloger-2           247kB ± 0%     247kB ± 0%    ~     (p=1.000 n=5+5)
ImagePackageCatalogers/python-package-cataloger-2        1.11MB ± 0%    1.10MB ± 0%    ~     (p=0.548 n=5+5)
ImagePackageCatalogers/javascript-package-cataloger-2     197kB ± 0%     197kB ± 0%  +0.06%  (p=0.016 n=5+5)
ImagePackageCatalogers/dpkgdb-cataloger-2                 228kB ± 0%     228kB ± 0%    ~     (p=0.151 n=5+5)
ImagePackageCatalogers/rpmdb-cataloger-2                  221kB ± 0%     221kB ± 0%    ~     (p=0.905 n=5+5)
ImagePackageCatalogers/java-cataloger-2                  3.23MB ± 0%    3.24MB ± 0%    ~     (p=0.310 n=5+5)
ImagePackageCatalogers/apkdb-cataloger-2                 1.29MB ± 0%    1.29MB ± 0%    ~     (p=0.690 n=5+5)
ImagePackageCatalogers/go-module-binary-cataloger-2        336B ± 0%      336B ± 0%    ~     (all equal)

name                                                   old allocs/op  new allocs/op  delta
ImagePackageCatalogers/ruby-gemspec-cataloger-2           6.79k ± 0%     6.79k ± 0%    ~     (all equal)
ImagePackageCatalogers/python-package-cataloger-2         26.3k ± 0%     26.3k ± 0%    ~     (p=0.095 n=5+5)
ImagePackageCatalogers/javascript-package-cataloger-2     5.17k ± 0%     5.17k ± 0%    ~     (all equal)
ImagePackageCatalogers/dpkgdb-cataloger-2                 6.65k ± 0%     6.65k ± 0%    ~     (all equal)
ImagePackageCatalogers/rpmdb-cataloger-2                  6.53k ± 0%     6.53k ± 0%    ~     (all equal)
ImagePackageCatalogers/java-cataloger-2                   58.9k ± 0%     58.9k ± 0%    ~     (p=0.151 n=5+5)
ImagePackageCatalogers/apkdb-cataloger-2                  7.71k ± 0%     7.71k ± 0%    ~     (all equal)
ImagePackageCatalogers/go-module-binary-cataloger-2        9.00 ± 0%      9.00 ± 0%    ~     (all equal)

[luhring]

This looks great, @spiffcs! 👏

[wagoodman]

Question: does 1*DIGIT only allow for values like 5 and not 50?

[spiffcs]

Good Question - here is the relevant text.
https://www.rfc-editor.org/rfc/rfc2045.html#section-4

I asked the reviewer if we could use x.x.x and they said it was fine extending to M/m/p here.

MIME-VERSION in their specification does only allow for a single digit

version := "MIME-Version" ":" 1*DIGIT "." 1*DIGIT

I can follow up and see what edits we might need for the submission since this is unclear.

[spiffcs]

I'll make a follow-up PR when I get more clarity from the governing body. As of right now, they accepted the proposal as is. Edits are welcome should this turn out to be more strict than we need for the version constraints.