Mercurial > p > roundup > code
view share/man/man1/roundup-demo.1 @ 7752:b2dbab2b34bc
fix(refactor): multiple fixups using ruff linter; more testing.
Converting to using the ruff linter and its rulesets. Fixed a number
of issues.
admin.py:
sort imports
use immutable tuples as default value markers for parameters where a
None value is valid.
reduced some loops to list comprehensions for performance
used ternary to simplify some if statements
named some variables to make them less magic
(e.g. _default_savepoint_setting = 1000)
fixed some tests for argument counts < 2 becomes != 2 so 3 is an
error.
moved exception handlers outside of loops for performance where
exception handler will abort loop anyway.
renamed variables called 'id' or 'dir' as they shadow builtin
commands.
fix translations of form _("string %s" % value) -> _("string %s") %
value so translation will be looked up with the key before
substitution.
end dicts, tuples with a trailing comma to reduce missing comma
errors if modified
simplified sorted(list(self.setting.keys())) to
sorted(self.setting.keys()) as sorted consumes whole list.
in if conditions put compared variable on left and threshold condition
on right. (no yoda conditions)
multiple noqa: suppression
removed unneeded noqa as lint rulesets are a bit different
do_get - refactor output printing logic: Use fast return if not
special formatting is requested; use isinstance with a tuple
rather than two isinstance calls; cleaned up flow and removed
comments on algorithm as it can be easily read from the code.
do_filter, do_find - refactor output printing logic. Reduce
duplicate code.
do_find - renamed variable 'value' that was set inside a loop. The
loop index variable was also named 'value'.
do_pragma - added hint to use list subcommand if setting was not
found. Replaced condition 'type(x) is bool' with 'isinstance(x,
bool)' for various types.
test_admin.py
added testing for do_list
better test coverage for do_get includes: -S and -d for multilinks,
error case for -d with non-link.
better testing for do_find including all output modes
better testing for do_filter including all output modes
fixed expected output for do_pragma that now includes hint to use
pragma list if setting not found.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Fri, 01 Mar 2024 14:53:18 -0500 |
| parents | 7b9bddda9d2d |
| children | 0b82d42790ae |
line wrap: on
line source
.TH ROUNDUP-SERVER 1 "27 July 2004" .SH NAME roundup-demo \- create a roundup "demo" tracker and launch its web interface .SH SYNOPSIS \fBroundup_demo\fP [\fB\-h\fP] [\fB-b\fP \fIBIND_ADDRESS\fP] [\fB-b\fP {\fBanydbm\fP,\fBmysql\fP,\fBsqlite\fP,\fBpostgresql\fP}] [\fB-t\fb {\fBminimal\fP,\fBjinja2\fP,\fBclassic\fP,\fBresponsive\fP,\fBdevel\fP}] [\fB-p\fP \fIPORT\fP] [\fB-P\fP \fIURLPORT\fP] [\fB-V\fP] [\fIdirectory\fP] [\fIbackend\fP] [\fBnuke\fP] .SH OPTIONS .TP \fIdirectory\fP The home directory for the new demo tracker. (*) .TP \fIbackend\fP Choose backend database. Depricated, use \fB-b\fP. .TP \fBnuke\fP Create a fresh demo tracker (deleting the existing one if any). E.G. .EX roundup-demo -b sqlite -t classic ./mytracker nuke .EE will remove an existing tracker (if present) from the directory \fB./mytracker\fP. Then it will create and serve a new empty classic tracker using the sqlite backend. .TP \fB-h\fP, \fB--help\fP Show the help message and exit .TP \fB-b\fp \fIBIND_ADDRESS\fI, \fB--bind_address\fP \fIBIND_ADDRESS\fP Choose address for server to listen at. Use 0.0.0.0 to bind to all addreses. Default: 127.0.0.1. .TP \fB-b\fP {\fBanydbm\fP,\fBmysql\fP,\fBsqlite\fP,\fBpostgresql\fP}, \ \fB--backend_db\fP {\fBanydbm\fP,\fBmysql\fP,\fBsqlite\fP,\fBpostgresql\fP} Choose backend database. Default: sqlite. Available backends are subject to availability on your system. .TP \fB-t\fP \ {\fBminimal\fP,\fBjinja2\fP,\fBclassic\fP,\fBresponsive\fP,\fBdevel\fP}, \ \fP--template\fB \ {\fBminimal\fP,\fBjinja2\fP,\fBclassic\fP,\fBresponsive\fP,\fBdevel\fP} Use specified template when building tracker. (*) .TP \fB-p\fP \fIPORT\fP, \fB--port\fP \fIPORT\fP Listen at this port. Default: search for open port starting at 8917. .TP \fB-P\fP \fIURLPORT\fP, \fB--urlport\fP \fIURLPORT\fP When using docker this option passes the docker external port to the demo instance. If using \fBdocker ... -p 9090:8917 ...\fP this should be set to \fB-P 9090\fP. Default: as selected by \fB--port\fP. .TP \fB-V\fP, \fB--version\fP Show program's version number and exit .PP If items marked with (*) are missing, they will be asked for interactively when setting up the tracker. .SH DESCRIPTION This command creates a fresh demo tracker for you to experiment with. The email features of Roundup will be turned off (so the nosy feature won't send email). It does this by removing the \fBnosyreaction.py\fP module from the demo tracker's \fIdetectors\fP directory. If you wish to send email to promote the trcker to production, you will need to copy \fBnosyreaction.py\fP from the default tracker templates directory. The \fBtemplates\fP command from roundup-admin(1) can help you locate a replacement. If you wish, you may modify the demo tracker by editing its configuration files and HTML templates. See the \fIcustomisation\fP manual for information about how to do that. Once you've fiddled with the demo tracker, you may use it as a template for creating your real, live tracker. Simply run the \fIroundup-admin\fP command to install the tracker from inside the demo tracker home directory, and it will be listed as an available template for installation. No data will be copied over. .SH SEE ALSO .SH AUTHOR This manpage was written by Richard Jones and extensively modified by John Rouillard <rouilj@users.sourceforge.net>.