• [gentoo-dev] Proposal for a Universal Remote-ID File

    From Siddhanth Rathod@21:1/5 to All on Fri Sep 22 20:50:01 2023
    This is a multi-part message in MIME format.
    I'm writing to propose the creation of a universal remote-ID file within
    the api.git or gentoo.git in the metadata/ directory. Currently, we have
    eight different locations that require manual updates for any future
    changes, including my recent commit (https://gitweb.gentoo.org/proj/gentoolkit.git/commit/?id=5146d35eb97e2c1a8f7691e59c755ed14e858dd4)
    to gentoolkit and the rest seven as mentioned here https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Upstream_remote-id_types.

    By establishing a universal remote-ID file, we can streamline this
    process. Your thoughts and feedback on this proposal would be greatly appreciated.Also, Any preferences on format?

    <html>
    <head>

    <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    </head>
    <body>
    <p><font face="JetBrainsMono Nerd Font">I'm writing to propose the
    creation of a universal remote-ID file within the api.git or
    gentoo.git in the metadata/ directory. Currently, we have eight
    different locations that require manual updates for any future
    changes, including my recent commit
    (<a class="moz-txt-link-freetext" href="https://gitweb.gentoo.org/proj/gentoolkit.git/commit/?id=5146d35eb97e2c1a8f7691e59c755ed14e858dd4">https://gitweb.gentoo.org/proj/gentoolkit.git/commit/?id=5146d35eb97e2c1a8f7691e59c755ed14e858dd4</a>)
    to gentoolkit and the rest seven as mentioned here
    <a class="moz-txt-link-freetext" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Upstream_remote-id_types">https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Upstream_remote-id_types</a>.</font></p>
    <p><font face="JetBrainsMono Nerd Font">By establishing a universal
    remote-ID file, we can streamline this process. Your thoughts
    and feedback on this proposal would be greatly appreciated.Also,
    Any preferences on format?</font><br>
    </p>
    </body>
    </html>

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Ulrich Mueller@21:1/5 to All on Sat Sep 23 09:20:01 2023
    On Fri, 22 Sep 2023, Siddhanth Rathod wrote:

    I'm writing to propose the creation of a universal remote-ID file
    within the api.git or gentoo.git in the metadata/ directory.
    Currently, we have eight different locations that require manual
    updates for any future changes, including my recent commit (https://gitweb.gentoo.org/proj/gentoolkit.git/commit/?id=5146d35eb97e2c1a8f7691e59c755ed14e858dd4)
    to gentoolkit and the rest seven as mentioned here https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Upstream_remote-id_types.

    By establishing a universal remote-ID file, we can streamline this
    process. Your thoughts and feedback on this proposal would be greatly appreciated.Also, Any preferences on format?

    My preference would be a simple text file with a table, similar to files/uid-gid.txt in api.git. Then we could just modify the existing
    tooling to generate the wiki page form it, and wouldn't need any special
    tools to create the other files.

    Alternatively, it could be in XML. While I'm not a large fan of XML, it
    seems a natural choice here, because metadata.xml, the DTD, and the XML
    and Relax-NG schemas are all from the XML world.

    Ulrich

    -----BEGIN PGP SIGNATURE-----

    iQFDBAEBCAAtFiEEtDnZ1O9xIP68rzDbUYgzUIhBXi4FAmUOkPEPHHVsbUBnZW50 b28ub3JnAAoJEFGIM1CIQV4uU50H/1JaZHcxqcbhKUmM6Qbd28QyVRmXMaQnm6JL 7Ud2UbIB7zL/Itx21FF/Jv2sBI3X/SLwZ6kVgPzbWrONd0/gVtnjp9Ydlz5tfh+m rkkUWwQ3V0F8A4EMezL63D1wpcgOLE1+7BqYEOyECXdw6qzq2YQ4glXaMCw3zxXu 0dmHL/NEgcoc2EHGG62iGjegKMjlzCA4CdvEQQVfyG2G5gHR1iwv+rwUhBw4sfsO 4dH0aHeh2+yigdq7YnuuSvRB8wrx4w9aCS/i/KJ+1yMIYoILEH2cuBu9QN37S+Js uww6dey+ZhRNeMuPBrDEEMJv65OuQPfjEW8TrYDjarhDRasxrPA=
    =By+/
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Michael Orlitzky@21:1/5 to Siddhanth Rathod on Sat Sep 23 16:40:01 2023
    On Sat, 2023-09-23 at 00:10 +0530, Siddhanth Rathod wrote:

    By establishing a universal remote-ID file, we can streamline this
    process. Your thoughts and feedback on this proposal would be greatly appreciated.Also, Any preferences on format?

    Building the wiki page isn't too hard, but what's the plan to propagate
    changes into those seven other repositories? If we're still
    copy/pasting the output of some tool, then we haven't really saved a
    step, we've only changed what we're copy/pasting.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Sam James@21:1/5 to Ulrich Mueller on Sat Sep 23 16:20:01 2023
    Ulrich Mueller <[email protected]> writes:

    [[PGP Signed Part:Undecided]]
    On Fri, 22 Sep 2023, Siddhanth Rathod wrote:

    I'm writing to propose the creation of a universal remote-ID file
    within the api.git or gentoo.git in the metadata/ directory.
    Currently, we have eight different locations that require manual
    updates for any future changes, including my recent commit
    (https://gitweb.gentoo.org/proj/gentoolkit.git/commit/?id=5146d35eb97e2c1a8f7691e59c755ed14e858dd4)
    to gentoolkit and the rest seven as mentioned here
    https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Upstream_remote-id_types.

    By establishing a universal remote-ID file, we can streamline this
    process. Your thoughts and feedback on this proposal would be greatly
    appreciated.Also, Any preferences on format?

    My preference would be a simple text file with a table, similar to files/uid-gid.txt in api.git. Then we could just modify the existing
    tooling to generate the wiki page form it, and wouldn't need any special tools to create the other files.

    Sounds ok.


    Alternatively, it could be in XML. While I'm not a large fan of XML, it
    seems a natural choice here, because metadata.xml, the DTD, and the XML
    and Relax-NG schemas are all from the XML world.

    Ulrich



    -----BEGIN PGP SIGNATURE-----

    iOUEARYKAI0WIQQlpruI3Zt2TGtVQcJzhAn1IN+RkAUCZQ7zWF8UgAAAAAAuAChp c3N1ZXItZnByQG5vdGF0aW9ucy5vcGVucGdwLmZpZnRoaG9yc2VtYW4ubmV0MjVB NkJCODhERDlCNzY0QzZCNTU0MUMyNzM4NDA5RjUyMERGOTE5MA8cc2FtQGdlbnRv by5vcmcACgkQc4QJ9SDfkZDXdwD+IaOkRbfJ9qJaMLs9MEzKcfqH3HkJt4cxWrbZ 3w+YN9AA/2GNFkDvDx9zEBDDtf8a4Mc2A+t2jOWPBAXSF75oF5MP
    =VXBJ
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Michael Orlitzky@21:1/5 to Sam James on Sat Sep 23 16:50:01 2023
    On Sat, 2023-09-23 at 15:39 +0100, Sam James wrote:

    At the moment, we bundle the DTD in pkgcore. If we just shoved it in metadata/ instead in the main repo, we don't have that kind of problem.


    I might be missing something obvious, but what I mean is, suppose we
    have this plain-text mapping of remote-id names to URLs. How do we get
    the list of keys (valid remote-id names) into the DTD? Even if both
    files are inside metadata/, there's another step that needs to happen.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Ionen Wolkens@21:1/5 to Sam James on Sat Sep 23 17:20:01 2023
    On Sat, Sep 23, 2023 at 03:39:32PM +0100, Sam James wrote:

    Michael Orlitzky <[email protected]> writes:

    On Sat, 2023-09-23 at 00:10 +0530, Siddhanth Rathod wrote:

    By establishing a universal remote-ID file, we can streamline this
    process. Your thoughts and feedback on this proposal would be greatly
    appreciated.Also, Any preferences on format?

    Building the wiki page isn't too hard, but what's the plan to propagate changes into those seven other repositories? If we're still
    copy/pasting the output of some tool, then we haven't really saved a
    step, we've only changed what we're copy/pasting.

    At the moment, we bundle the DTD in pkgcore. If we just shoved it in metadata/ instead in the main repo, we don't have that kind of problem.

    Likewise for iwdevtools which I'd update for this myself, loading from
    ::gentoo would be pretty trivial beside a little bit overhead to find
    the repo.

    At worst does mean that remote-ids won't resolve if it didn't manage
    the repo (it's optional) but that's entirely fine for that tool and
    beats updating these manually + making a release almost just for that constantly (or fetching files at runtime).

    If this was stored elsewhere (e.g. api.git), then wouldn't gain much.
    --
    ionen

    -----BEGIN PGP SIGNATURE-----

    iQEzBAABCAAdFiEEx3SLh1HBoPy/yLVYskQGsLCsQzQFAmUPARkACgkQskQGsLCs QzRXvgf/b4+ajuPrAVKMQX7hlH7viVgPs76DIiw+PG1/Sp5Wavzdk1VNuMEexU/t HWOzwFxZ5+gXh7DvAXWRmPPDWcTU5Xmoaq9W+g/yyERU95K8MVNiP0WYbogmtbbk QA3sUVW9Q1ZPhuy9DFJY0iprrQNaKvzIAthb6OsuU6H26laVYHgerWckhvoCk9Fm 4HP0HsCrB8eO1U5aqgbz4N6hKeqg88qMPGkoMlIn3LRUw8GQc7G/41M1/bk6PY4R d923Ux73S8jBKutXGK4P1OrMXGPHFndDzAq04u9Ih+2NTsOUhGMyvNWs3FximsrS t7on7hs4pNI4P6KusXg3i37ILC/NvA==
    =4UnD
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Siddhanth Rathod@21:1/5 to Michael Orlitzky on Sun Sep 24 19:50:01 2023
    This is a multi-part message in MIME format.
    How does modifying the DTD with a git hook sound ?

    On 9/23/23 20:17, Michael Orlitzky wrote:
    On Sat, 2023-09-23 at 15:39 +0100, Sam James wrote:
    At the moment, we bundle the DTD in pkgcore. If we just shoved it in
    metadata/ instead in the main repo, we don't have that kind of problem.

    I might be missing something obvious, but what I mean is, suppose we
    have this plain-text mapping of remote-id names to URLs. How do we get
    the list of keys (valid remote-id names) into the DTD? Even if both
    files are inside metadata/, there's another step that needs to happen.


    <html>
    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    </head>
    <body>
    <p><font face="JetBrainsMono Nerd Font">How does modifying the DTD
    with a git hook sound ?</font><br>
    </p>
    <div class="moz-cite-prefix">On 9/23/23 20:17, Michael Orlitzky
    wrote:<br>
    </div>
    <blockquote type="cite"
    cite="mid:[email protected]">
    <pre class="moz-quote-pre" wrap="">On Sat, 2023-09-23 at 15:39 +0100, Sam James wrote:
    </pre>
    <blockquote type="cite">
    <pre class="moz-quote-pre" wrap="">
    At the moment, we bundle the DTD in pkgcore. If we just shoved it in
    metadata/ instead in the main repo, we don't have that kind of problem.

    </pre>
    </blockquote>
    <pre class="moz-quote-pre" wrap="">
    I might be missing something obvious, but what I mean is, suppose we
    have this plain-text mapping of remote-id names to URLs. How do we get
    the list of keys (valid remote-id names) into the DTD? Even if both
    files are inside metadata/, there's another step that needs to happen.


    </pre>
    </blockquote>
    </body>
    </html>

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Michael Orlitzky@21:1/5 to Siddhanth Rathod on Sun Sep 24 22:20:01 2023
    On Sun, 2023-09-24 at 23:14 +0530, Siddhanth Rathod wrote:
    How does modifying the DTD with a git hook sound ?

    That could work if we put the DTD, XML schema, and RELAX NG schema all
    in the repo metadata. The remaining projects are programs and (given
    access to ::gentoo) can probably parse the list themselves.

    We're all sufficiently clever here to imagine some solution; it just
    occurred to me that without a concrete proposal, it's hard to say
    whether the end result would actually be simpler than copy/paste.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)