Management
This document describes the myriad administrative commands available with Patchwork. Many of these commands are referenced in the development and deployment installation guides.
The manage.py
Script
Django provides the django-admin
command-line utility for interacting with
Django applications and projects, as described in the Django documentation.
Patchwork, being a Django application, provides a wrapper for this command -
manage.py
- that exposes not only the management commands of Django and its
default applications, but also a number of custom, Patchwork-only management
commands.
An overview of the Patchwork-specific commands is provided below. For
information on the commands provided by Django itself, refer to the Django
documentation. Information on any command can also be found by passing the
--help
parameter:
./manage.py cron --help
Available Commands
cron
./manage.py cron
Run periodic Patchwork functions: send notifications and expire unused users.
This is required to ensure notifications emails are actually sent to users that request them and is helpful to expire unused users created by spambots. For more information on integration of this script, refer to the deployment installation guide.
dumparchive
Export Patchwork projects as tarball of mbox files.
./manage.py dumparchive [-c | --compress] [PROJECT [PROJECT...]]
This is mostly useful for exporting the patch dataset of a Patchwork project for use with other programs.
- -c, --compress
compress generated archive.
- PROJECT
list ID of project(s) to export. Export all projects if none specified.
parsearchive
Parse an mbox archive file and store any patches/comments found.
./manage.py parsearchive [--list-id <list-id>] <infile>
This is mostly useful for development or for adding message that were missed due to, for example, an outage.
- --list-id <list-id>
mailing list ID. If not supplied, this will be extracted from the mail headers.
- infile
input mbox filename
parsemail
Parse an mbox file and store any patch/comment found.
./manage.py parsemail [--list-id <list-id>] <infile>
This is the main script used to get mails (and therefore patches) into
Patchwork. It is generally used by the parsemail.sh
script in combination
with a mail transfer agent (MTA) like Postfix. For more information, refer to
the deployment installation guide.
- --list-id <list-id>
mailing list ID. If not supplied, this will be extracted from the mail headers.
- infile
input mbox filename. If not supplied, a patch will be read from
stdin
.
replacerelations
Parse a patch groups file and store any relation found
./manage.py replacerelations <infile>
This is a script used to ingest relations into Patchwork.
A patch groups file contains on each line a list of space separated patch IDs of patches that form a relation.
For example, consider the contents of a sample patch groups file:
1 3 5
2
7 10 11 12
In this case the script will identify 2 relations, (1, 3, 5) and (7, 10, 11, 12). The single patch ID “2” on the second line is ignored as a relation always consists of more than 1 patch.
Further, if a patch ID in the patch groups file does not exist in the database of the Patchwork instance, that patch ID will be silently ignored while forming the relations.
Running this script will remove all existing relations and replace them with the relations found in the file.
- infile
input patch groups file.
rehash
Update the hashes on existing patches.
./manage.py rehash [<patch_id>, ...]
Patchwork stores hashes for each patch it receives. These hashes can be used to uniquely identify a patch for things like automatically changing the state of the patch in Patchwork when it merges. If you change your hashing algorithm, you may wish to rehash the patches.
- patch_id
a patch ID number. If not supplied, all patches will be updated.
retag
Update the tag (Ack/Review/Test) counts on existing patches.
./manage.py retag [<patch_id>...]
Patchwork extracts tags from each patch it receives. By default, three tags are extracted, but it’s possible to change this on a per-instance basis. Should you add additional tags, you may wish to scan older patches for these new tags.
- patch_id
a patch ID number. If not supplied, all patches will be updated.