.TH PKGINFO "1" "October 2012" "pkginfo" "User Commands"
.SH NAME
pkginfo \- print metadata for one or more Python package distributions
.SH SYNOPSIS
.TP
\fBpkginfo [options] \fIpath ...\fR
.SH DESCRIPTION
.TP
Print the metadata for one or more Python package distributions.
.PP
Each 'path' entry can be one of the following:
.PP
- a source distribution:  in this case, 'path' should point to an existing
  archive file (.tar.gz, .tar.bz2, or .zip) as generated by 'setup.py sdist'.
.PP
- a binary distribution:  in this case, 'path' should point to an existing
  archive file (.egg)
.PP
- a "develop" checkout:  in ths case,  'path' should point to a directory
  intialized via 'setup.py develop' (under setuptools).
.PP
- an installed package:  in this case, 'path' should be the importable name of
  the package.
.SH OPTIONS
.IP "\-h, \-\-help"
show help message and exit
.IP "\-m METADATA_VERSION, \-\-metadata\-version=METADATA_VERSION"
Override metadata version
.IP "\-f FIELDS, \-\-field=FIELDS"
Specify an output field (repeatable)
.IP "\-d DOWNLOAD_URL_PREFIX, \-\-download\-url\-prefix=DOWNLOAD_URL_PREFIX"
Download URL prefix
.IP "\-\-simple"
Output as simple key\-value pairs
.IP "\-s, \-\-skip"
Skip missing values in simple output
.IP "\-S, \-\-no\-skip"
Don't skip missing values in simple output
.IP "\-\-single"
Output delimited values
.IP "\-\-item\-delim=ITEM_DELIM"
Delimiter for fields in single\-line output
.IP "\-\-sequence\-delim=SEQUENCE_DELIM"
Delimiter for multi\-valued fields
.IP "\-\-csv"
Output as CSV
.IP "\-\-ini"
Output as INI
.SH "SEE ALSO"
The full documentation for
.B pkginfo
is available in /usr/share/doc/python-pkginfo-doc/html if the python-pkginfo-doc package is installed