.\" -*- mode: troff; coding: utf-8 -*-
.TH APKG-GENABUILD 8
.SH NAME
apkg-genabuild \- generate an abuild recipe template from a source URL
.SH DESCRIPTION
.LP
\fBapkg-genabuild\fR generates an \fIabuild\fR template file from a source URL.
It attempts to parse the package name and version from the URL and creates
a directory with a skeleton \fIabuild\fR recipe.
.SH USAGE
.LP
\f(CRapkg-genabuild <url> [name]\fR
.PP
If \fIname\fR is not provided, it is derived from the URL.
Special handling is included for GitHub tag archives, PyPI packages, and
CPAN/Perl packages, which get the appropriate prefix (\fIpython-\fR or \fIperl-\fR).
.SH OUTPUT
.LP
Creates a directory named after the package containing an \fIabuild\fR file
with \fIname\fR, \fIversion\fR, \fIrelease\fR, and \fIsource\fR fields populated,
and an \fIinfo\fR file with \fIdescription\fR, \fIhomepage\fR, \fIlicense\fR,
and \fImaintainer\fR fields as a template.
.SH FILES
.TP
\fB<name>/abuild\fR
Generated package recipe with \fIname\fR, \fIversion\fR, \fIrelease\fR, and
\fIsource\fR populated.
.TP
\fB<name>/info\fR
Package metadata template with \fIdescription\fR, \fIhomepage\fR, \fIlicense\fR,
and \fImaintainer\fR fields.
.SH EXAMPLES
.LP
\f(CRapkg-genabuild https://example.com/pkg-1.2.3.tar.gz\fR - Generate template for a tarball.
.PP
\f(CRapkg-genabuild https://github.com/user/repo/archive/v1.0.tar.gz\fR - Generate template from a GitHub tag archive.
.SH AUTHORS
.LP
emmett1 \c
.MT me@emmett1.my
.ME
.SH REPORTING BUGS
.LP
Please report bugs and issues in the project issue tracker: \c
.UR https://codeberg.org/emmett1/autils/issues
.UE