NAME¶

boobtracker - Console application to send and display messages on various websites

SYNOPSIS¶

boobtracker [-dqv] [-b backends] [-cnfs] [command [arguments..]] boobtracker [--help] [--version]

DESCRIPTION¶

Console application allowing to send messages on various websites and to display message threads and contents.

Supported websites:¶

* redmine (The Redmine project management web application)

BOOBTRACKER COMMANDS¶

attach ISSUE FILENAME

 

Attach a file to an issue (Not implemented yet).

comment ISSUE [TEXT]

 

Comment an issue. If no text is given, enter it in standard input.

edit ISSUE [KEY [VALUE]]

 

Edit an issue.

 

If you are not in interactive mode, you can use these parameters:

 

--title TITLE

 

--assignee ASSIGNEE

 

--target-version VERSION

 

--category CATEGORY

 

--status STATUS

get ISSUE

 

Get an issue and display it.

logtime ISSUE HOURS [TEXT]

 

Log spent time on an issue.

post PROJECT

 

Post a new issue.

 

 

 

If you are not in interactive mode, you can use these parameters:

 

--title TITLE

 

--assignee ASSIGNEE

 

--target-version VERSION

 

--category CATEGORY

 

--status STATUS

remove ISSUE

 

Remove an issue.

search PROJECT

 

List issues for a project.

 

 

 

You can use these filters from command line:

 

--author AUTHOR

 

--title TITLE_PATTERN

 

--assignee ASSIGNEE

 

--target-version VERSION

 

--category CATEGORY

 

--status STATUS

WEBOOB COMMANDS¶

backends [ACTION] [BACKEND_NAME]...

 

Select used backends.

 

 

 

ACTION is one of the following (default: list):

 

* enable enable given backends

 

* disable disable given backends

 

* only enable given backends and disable the others

 

* list list backends

 

* add add a backend

 

* register register a new account on a website

 

* edit edit a backend

 

* remove remove a backend

 

* list-modules list modules

cd [PATH]

 

Follow a path.

 

".." is a special case and goes up one directory.

 

"" is a special case and goes home.

condition [EXPRESSION | off]

 

If an argument is given, set the condition expression used to filter the results.

 

If the "off" value is given, conditional filtering is disabled.

 

 

 

If no argument is given, print the current condition expression.

count [NUMBER | off]

 

If an argument is given, set the maximum number of results fetched.

 

NUMBER must be at least 1.

 

"off" value disables counting, and allows infinite searches.

 

 

 

If no argument is given, print the current count value.

formatter [list | FORMATTER [COMMAND] | option OPTION_NAME [on | off]]

 

If a FORMATTER is given, set the formatter to use.

 

You can add a COMMAND to apply the formatter change only to

 

a given command.

 

 

 

If the argument is "list", print the available formatters.

 

 

 

If the argument is "option", set the formatter options.

 

Valid options are: header, keys.

 

If on/off value is given, set the value of the option.

 

If not, print the current value for the option.

 

 

 

If no argument is given, print the current formatter.

inspect BACKEND_NAME

 

Display the HTML string of the current page of the specified backend's browser.

 

 

 

If webkit_mechanize_browser Python module is installed, HTML is displayed in a WebKit GUI.

logging [LEVEL]

 

Set logging level.

 

 

 

Availables: debug, info, warning, error.

 

* quiet is an alias for error

 

* default is an alias for warning

ls [PATH]

 

List objects in current path.

 

If an argument is given, list the specified path.

quit

 

Quit the application.

select [FIELD_NAME]... | "$direct" | "$full"

 

If an argument is given, set the selected fields.

 

$direct selects all fields loaded in one http request.

 

$full selects all fields using as much http requests as necessary.

 

 

 

If no argument is given, print the currently selected fields.

 

OPTIONS¶

--version

show program's version number and exit

-h, --help

show this help message and exit

-b BACKENDS, --backends=BACKENDS

what backend(s) to enable (comma separated)

 

BOOBTRACKER OPTIONS¶

--author=AUTHOR

--title=TITLE

--assignee=ASSIGNEE

--target-version=VERSION

--category=CATEGORY

--status=STATUS

 

LOGGING OPTIONS¶

-d, --debug

display debug messages

-q, --quiet

display only error messages

-v, --verbose

display info messages

--logging-file=LOGGING_FILE

file to save logs

-a, --save-responses

save every response

 

RESULTS OPTIONS¶

-c CONDITION, --condition=CONDITION

filter result items to display given a boolean expression

-n COUNT, --count=COUNT

get a maximum number of results (all backends merged)

-s SELECT, --select=SELECT

select result item keys to display (comma separated)

 

FORMATTING OPTIONS¶

-f FORMATTER, --formatter=FORMATTER

select output formatter (csv, htmltable, issue_info, issues_list, multiline, simple, table, webkit)

--no-header

do not display header

--no-keys

do not display item keys

-O OUTFILE, --outfile=OUTFILE

file to export result

 

COPYRIGHT¶

Copyright(C) 2011 Romain Bignon For full COPYRIGHT see COPYING file with weboob package.

FILES¶

"~/.config/weboob/backends"

SEE ALSO¶

Home page: http://weboob.org/applications/boobtracker