usage: perceval [-c <file>] [-g] <backend> [<args>] | --help | --version

Repositories are reached using specific backends. The most common backends
are:
    askbot           Fetch questions and answers from Askbot site
    bugzilla         Fetch bugs from a Bugzilla server
    bugzillarest     Fetch bugs from a Bugzilla server (>=5.0) using its REST API
    confluence       Fetch contents from a Confluence server
    discourse        Fetch posts from Discourse site
    dockerhub        Fetch repository data from Docker Hub site
    gerrit           Fetch reviews from a Gerrit server
    git              Fetch commits from Git
    github           Fetch issues from GitHub
    gitlab           Fetch issues from GitLab
    hyperkitty       Fetch messages from a HyperKitty archiver
    jenkins          Fetch builds from a Jenkins server
    jira             Fetch issues from JIRA issue tracker
    launchpad        Fetch issues from Launchpad issue tracker
    mbox             Fetch messages from MBox files
    mediawiki        Fetch pages and revisions from a MediaWiki site
    meetup           Fetch events from a Meetup group
    nntp             Fetch articles from a NNTP news group
    phabricator      Fetch tasks from a Phabricator site
    pipermail        Fetch messages from a Pipermail archiver
    redmine          Fetch issues from a Redmine server
    rss              Fetch entries from a RSS feed server
    slack            Fetch messages from a Slack channel
    stackexchange    Fetch questions from StackExchange sites
    supybot          Fetch messages from Supybot log files
    telegram         Fetch messages from the Telegram server

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show version
  -c FILE, --config FILE
                        set configuration file
  -g, --debug           set debug mode on

Run 'perceval <backend> --help' to get information about a specific backend.

$ pip3 install perceval

$ git clone https://github.com/chaoss/grimoirelab-perceval.git

$ pip3 install -r requirements.txt
$ python3 setup.py install

$ perceval askbot 'http://askbot.org/' --from-date '2016-01-01'

$ perceval bugzilla 'https://bugzilla.redhat.com/' --backend-user user --backend-password pass --from-date '2016-01-01'

$ perceval bugzillarest 'https://bugzilla.mozilla.org/' --backend-user user --backend-password pass --from-date '2016-01-01'

$ perceval confluence 'https://wiki.opnfv.org/' --from-date '2016-01-01'

$ perceval discourse 'https://foro.mozilla-hispano.org/' --from-date '2016-01-01'

$ perceval dockerhub grimoirelab perceval

$ eval `ssh-agent -s`
$ ssh-add ~/.ssh/id_rsa
Identity added: /home/user/.ssh/id_rsa (/home/user/.ssh/id_rsa)

$ perceval gerrit --user user 'review.openstack.org' --from-date '2016-01-01'

$ perceval git 'https://github.com/chaoss/grimoirelab-perceval.git' --from-date '2016-01-01'

git log --raw --numstat --pretty=fuller --decorate=full --parents --reverse --topo-order -M -C -c --remotes=origin --all > /tmp/gitlog.log

$ perceval git --git-log '/tmp/gitlog.log' 'file:///myrepo.git'

$ perceval git '/tmp/gitlog.log'

$ perceval github elastic logstash --from-date '2016-01-01'

$ perceval gitlab elastic logstash --from-date '2016-01-01'

$ perceval hyperkitty 'https://lists.mailman3.org/archives/list/[email protected]' --from-date 2017-01-01

$ perceval jenkins 'https://build.opnfv.org/ci/'

$ perceval jira 'https://tickets.puppetlabs.com' --project PUP --from-date '2016-01-01'

$ perceval launchpad ubuntu --from-date '2016-01-01'

$ perceval mbox 'http://example.com' /tmp/mboxes/

$ perceval mediawiki 'https://wiki.mozilla.org' --from-date '2016-06-30'

$ perceval meetup 'Software-Development-Analytics' --from-date '2016-06-01' -t abcdefghijk

$ perceval nntp 'news.mozilla.org' 'mozilla.dev.project-link' --offset 10

$ perceval phabricator 'https://secure.phabricator.com/' -t 123456789abcefe

$ perceval pipermail 'https://mail.gnome.org/archives/libart-hackers/'

$ perceval pipermail 'http://mail-archives.apache.org/mod_mbox/httpd-dev/'

$ perceval redmine 'https://www.redmine.org/' --from-date '2016-01-01' -t abcdefghijk

$ perceval rss 'https://blog.bitergia.com/feed/'

$ perceval slack C0001 --from-date 2016-01-12 -t abcedefghijk

$ perceval stackexchange --site stackoverflow --tagged python --from-date '2016-01-01' --token abcdabcdabcdabcd

$ perceval supybot 'http://channel.example.com' /tmp/supybot/

$ perceval telegram mybot -t 12345678abcdefgh --chats 1 2 -10

$ pip install httpretty==0.8.6
$ cd tests
$ python3 run_tests.py