embuildstats

Langue: en

Version: Sun 11 Jan 2009 19:55:45 GMT (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

embuildstats - report tool to see an overview of your Emdebian builds

SYNOPSIS

embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]] [[-p] | [--pager]]
embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]] {-c|--csv}
embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]] {-x|--xml}
embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]] {-w|--html}
embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]] {-l|--lintian}

DESCRIPTION

embuildstats checks your Emdebian work directory for emdebianised packages, build logs, .changes files and upload data and prepares a simple report. By default, the report is piped through sensible-pager but CSV, XML and HTML formats are also available.

For more detailed information on a particular package, use emsource --status PACKAGE.

For information on which source packages have new versions available, use emtargetcmp.

Although error messages use the same colour output as other scripts in emdebian-tools, the report itself does not. If you would prefer alternative formats for the report, please ask (or submit a patch).

The report columns (or tags) describe (left to right):

1. Package name (source) in alphabetical order.
2. Total number of emdebian patch files (including emdebian.*.patch and debian-patch.*.patch files). (Until Debian has a working implementation for translation packages - tdebs - the majority of these patches are to create the locale packages.)
3. List of versions built with emdebuild. These versions are not necessarily successful builds, embuildstats just checks for the presence of a build log for this column. (See column 5.)
4. List of versions built successfully with empdebuild (within an Emdebian chroot). These versions should be suitable for automated building. embuildstats checks for the presence of a build log and a .changes file for the same Emdebian version.
5. List of versions with a .changes file for an Emdebian version. These are successful builds by emdebuild.
6. List of versions of .changes files uploaded and the timestamp of the upload.

COMMANDS

-p|--pager

Produce a tabular report and pipe to sensible-pager. Press 'q' to quit. This is the default but the output cannot be redirected.

-c|--csv

Produce a report of comma separated values to STDOUT. The number of patch files is not included. Redirect to a file if preferred.
 "xdemineur"," 2.1.1-10em1"," 2.1.1-10em1"," 2.1.1-10em1 Tue Nov 27 20:13:58 2007"
           
 

-x|--xml

Produce an XML report to STDOUT. The number of patch files is not included. Redirect to a file if preferred.
 <?xml version="1.0"?>
 <stats>
   <package>
    <name>package name</name>
    <build>emdebuild version list</build>
    <changes>empdebuild version list</changes>
    <uploads>uploaded version with date</name>
   </package>
   <package>
    <name>package name</name>
    <build>emdebuild version list</build>
    <changes>empdebuild version list</changes>
    <uploads>uploaded version with date</name>
   </package>
 </stats>
           
 

-w|--html

Produce a tabular report in HTML and print to STDOUT. Redirect to a file if preferred. (This is the same format as --pager wrapped in a basic HTML page and using <pre> for the table itself.

-l|--lintian

Identify the latest .changes file for each build and use lintian to check the packages against Emdebian Policy.
This can take a lot of time and work, even on a fast machine, depending on how many packages you have built locally.

OPTIONS

-a|--arch ARCH

Produce a report for a specific architecture, overriding any dpkg-cross default.

-v|--verbose

be verbose - currently only used if there are errors.

-q|--quiet

be quiet (error messages only).

-h|--help

print the usage message and exit.

--version

print the usage message and exit.

FILES

embuildstats uses your Emdebian work directory as the base for all searches. emdebuild stats are expected to be derived from $WORK/trunk/ and empdebuild stats are expected to be derived from the $WORK/pbuilder/result/ hierarchy. $WORK itself is defined by debconf for emdebian-tools or ~/.apt-cross/emsource.

AUTHOR

embuildstats was written by Neil Williams codehelp@debian.org.

This manual page was written by Neil Williams codehelp@debian.org

SEE ALSO

See also emdebuild (1), empdebuild (1), emsource (1), emtargetcmp (1), dpkg-cross (1), emdebian-tools (1).

AUTHOR

Emdebian

Neil Williams

Debian and Emdebian developer.