NAME¶

debrequest - generate Debian RFS and ITP requests mails

SYNOPSIS¶

DESCRIPTION¶

debrequest command line program collects machine-readable information from files in debian/ directory of source package located in ROOT, which defaults to current directory and use is to generate RFS or ITP request.

There are at least following assumptions about command line arguments and source package:

• ROOT/debian/control exists and is actually Debian source package control file
• ROOT/debian/copyright follows DEP-5 format and have following optional present: Upstream-Contact, Upstream-Name.
• Environment variables DEBEMAIL and DEBFULLNAME are set to reasonable values.

Probably, there are more. If any of these assumptions are violated, you will receive Python error message, like this:

Traceback (most recent call last):


  File "/usr/bin/debrequest", line 91, in <module>


    info = collect_information(args.root)


  File "/usr/bin/debrequest", line 51, in collect_information


    (upstream_p, *license_ps) = read_paragraphs('debian/copyright', root)
ValueError: need more than 0 values to unpack

While ValueError is not too informative, it is possible to understand that there is something wrong with debian/copyright. Patches to improve error reporting are welcome.

Mandatory positional argument, which either rfs either itp specifies what kind of request to generate.

EXAMPLES¶

Here is example of RFS for debrequest itself:

From: Dmitry Bogatov <KAction@gnu.org>
To: submit@bugs.debian.org
Subject: RFS: debrequest/0.2 ITP
X-Debug-Cc: debian-mentors@lists.debian.org
Package: sponsorship-requests
Severity: wishlist
Dear mentors,
I am looking for a sponsor for my package "debrequest"
* Package name    : debrequest


  Version         : 0.2


  Upstream Author : Dmitry Bogatov <KAction@gnu.org>
* Url             : https://anonscm.debian.org/cgit/users/kaction-guest/debrequest.git
* Licenses        : GPL-3+


  Section         : devel
It builds those binary packages:


  * debrequest
To access further information about this package, visit the following URL:


    https://mentors.debian.net/package/debrequest
Alternatively, one can download the package with dget using this command:


    dget -x https://mentors.debian.net/debian/pool/main/d/debrequest/debrequest_0.2.dsc
Alternatively, you can access package debian/ directory via git from URL:


    https://anonscm.debian.org/cgit/users/kaction-guest/debrequest.git
More information about debrequest can be obtained from


    https://anonscm.debian.org/cgit/users/kaction-guest/debrequest.git
Regards,


  Dmitry Bogatov
    

Note, that this is RFS for first release, so changelog is not mentioned. On other hand, here is RFS for cdist package. Note paragraph about changes.

From: Dmitry Bogatov <KAction@gnu.org>
To: submit@bugs.debian.org
Subject: RFS: cdist/4.3.2-1
X-Debug-Cc: debian-mentors@lists.debian.org
Package: sponsorship-requests
Severity: wishlist
Dear mentors,
I am looking for a sponsor for my package "cdist"
* Package name    : cdist


  Version         : 4.3.2-1


  Upstream Author : Nico Schottelius <nico-debian-cdist@schottelius.org>
* Url             : http://www.nico.schottelius.org/software/cdist/
* Licenses        : GPL-3,GPL-3+


  Section         : admin
It builds those binary packages:


  * cdist


  * cdist-doc
To access further information about this package, visit the following URL:


    https://mentors.debian.net/package/cdist
Alternatively, one can download the package with dget using this command:


    dget -x https://mentors.debian.net/debian/pool/main/c/cdist/cdist_4.3.2-1.dsc
Alternatively, you can access package debian/ directory via git from URL:


    https://anonscm.debian.org/cgit/users/kaction-guest/cdist.git
More information about cdist can be obtained from


    http://www.nico.schottelius.org/software/cdist/
Changes since last upload:


  * New upstream release
Regards,


  Dmitry Bogatov
    

SEE ALSO¶

sendmail(8)

DEP-5 https//www.debian.org/doc/packaging-manuals/copyright-format/1.0/