1UPT(1)                      General Commands Manual                     UPT(1)
2
3
4

NAME

6       upt - Universal Packaging Tool
7

SYNOPSIS

9       upt list-backends
10
11       upt list-frontends
12
13       upt  package [-f FRONTEND] [-b BACKEND] [-o OUTPUT] [--debug] [--quiet]
14       PACKAGE
15

DESCRIPTION

17       Create a package for a distribution (such  as  OpenBSD,  Fedora,  etc.)
18       from  a  language-specific  package archive (such as the Python Package
19       Index, the Comprehensive Perl Archive Network, etc.).
20
21       Upt works with two kinds of modules:
22
23       · frontends, which parse package metadata from a software archive;
24
25       · backends, which create package definitions suitable for inclusion  in
26         your favorite distribution.
27
28       The following subcommands are available:
29
30       list-backends
31              List all installed backends.
32
33       list-frontends
34              List all installed frontends.
35
36       package [options...] <package>
37              Package  the  given package.  This usually requires options, de‐
38              scribed below.
39

OPTIONS

41       -b BACKEND, --backend BACKEND
42              Specify backend to use.  Must be one of the values  returned  by
43              “upt  list-backends”.   At  least one backend must be installed.
44              If only one backend is installed, this is optional; otherwise it
45              is required.  See BACKENDS.
46
47       --debug
48              Print debug messages.  Cannot be used with --quiet.
49
50       -f FRONTEND, --frontend FRONTEND
51              Specify  frontend to use.  Must be one of the values returned by
52              “upt list-frontends”.  At least one frontend must be  installed.
53              If  only  one frontend is installed, this is optional; otherwise
54              it is required.  See FRONTENDS.
55
56       -h, --help
57              Show help and return.
58
59       -o, --output OUTPUT
60              Specify an output file or directory.   If  this  option  is  not
61              specified, stdout will be used (if possible).  The exact meaning
62              of this option may vary depending on the backend: it  should  do
63              the most natural thing.
64
65       -q, --quiet
66              Suppress all logging output.  Cannot be used with --debug.
67
68       -r, --recursive
69              Recursively package requirements.
70

BACKENDS

72       upt-fedora
73              Create packages for Fedora
74
75       upt-freebsd
76              Create packages for FreeBSD
77
78       upt-guix
79              Create packages for GNU Guix
80
81       upt-macports
82              Create packages for MacPorts
83
84       upt-nix
85              Create packages for Nix
86
87       upt-openbsd
88              Create packages for OpenBSD
89

FRONTENDS

91       upt-cpan
92              Gather metadata about packages hosted on cpan.org
93
94       upt-pypi
95              Gather metadata about packages hosted on pypi.org
96
97       upt-rubygems
98              Gather metadata about packages hosted on rubygems.org
99

EXAMPLES

101       List installed frontends
102              upt list-frontends
103
104       List installed backends
105              upt list-backends
106
107       Package “requests” from PyPI, for use in GNU Guix
108              upt package -f pypi -b guix requests
109
110       Same, omitting “-b” when there is only one installed backend
111              upt package -f pypi requests
112
113       Same, omitting “-f” when there is only one installed frontend
114              upt package requests
115

BUGS

117       Bugs  can  be reported to upt@framalistes.org.  A web interface is also
118       available at https://framagit.org/upt (one  may  sign  in  using  their
119       github.com/gitlab.com/bitbucket.org credentials).  Feel free to suggest
120       new backends and frontends.
121
122       Users are also welcome in the #upt-packaging channel on Freenode.
123

AUTHORS

125       Cyril Roelandt <upt@framalistes.org>.
126
127
128
129upt 0.10.3                       31 July 2019                           UPT(1)