automatic import of python-percevalopeneuler20.03

3 files changed, 1519 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..076c4c0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/perceval-0.21.6.tar.gz
diff --git a/python-perceval.spec b/python-perceval.spec
new file mode 100644
index 0000000..bd510fe
--- /dev/null
+++ b/python-perceval.spec
@@ -0,0 +1,1517 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-perceval
+Version:	0.21.6
+Release:	1
+Summary:	Send Sir Perceval on a quest to fetch and gather data from software repositories.
+License:	GPL-3.0+
+URL:		https://chaoss.github.io/grimoirelab/
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/90/fb/a92f97015b78af694d8af4789595e49ad170e034c46c835db57dcaa676a1/perceval-0.21.6.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-dateutil
+Requires:	python3-requests
+Requires:	python3-beautifulsoup4
+Requires:	python3-feedparser
+Requires:	python3-dulwich
+Requires:	python3-urllib3
+Requires:	python3-PyJWT
+Requires:	python3-cryptography
+Requires:	python3-grimoirelab-toolkit
+Requires:	python3-myst-parser
+Requires:	python3-furo
+
+%description
+# Perceval [![Build Status](https://github.com/chaoss/grimoirelab-perceval/workflows/tests/badge.svg)](https://github.com/chaoss/grimoirelab-perceval/actions?query=workflow:tests+branch:master+event:push) [![Coverage Status](https://img.shields.io/coveralls/chaoss/grimoirelab-perceval.svg)](https://coveralls.io/r/chaoss/grimoirelab-perceval?branch=master) [![PyPI version](https://badge.fury.io/py/perceval.svg)](https://badge.fury.io/py/perceval) [![Documentation in RTD](https://readthedocs.org/projects/perceval/badge/)](http://perceval.readthedocs.io)
+
+Send Sir Perceval on a quest to retrieve and gather data from software
+repositories.
+
+## Usage
+
+```
+usage: perceval [-g] <backend> [<args>] | --help | --version | --list
+
+Send Sir Perceval on a quest to retrieve and gather data from software
+repositories.
+
+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, pull requests and repository information from GitHub
+    gitlab           Fetch issues, merge requests from GitLab
+    gitter           Fetch messages from a Gitter room
+    googlehits       Fetch hits from Google API
+    groupsio         Fetch messages from Groups.io
+    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
+    mattermost       Fetch posts from a Mattermost server
+    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
+    pagure           Fetch issues from Pagure
+    phabricator      Fetch tasks from a Phabricator site
+    pipermail        Fetch messages from a Pipermail archiver
+    redmine          Fetch issues from a Redmine server
+    rocketchat       Fetch messages from a Rocket.Chat channel
+    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
+    twitter          Fetch tweets from the Twitter Search API
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -v, --version         show version
+  -g, --debug           set debug mode on
+  -l, --list            show available backends
+
+Run 'perceval <backend> --help' to get information about a specific backend.
+
+```
+
+## Requirements
+
+ * Python >= 3.7
+ * Poetry >= 1.2
+ * git
+ * build-essential
+
+You will also need some other libraries for running the tool, you can find the
+whole list of dependencies in [pyproject.toml](pyproject.toml) file.
+
+### How to install
+
+- **build-essentials**
+
+Build-essentials is a package that contains a set of tools to compile and build
+software. It is required to work with Debian packages.
+
+```
+$ sudo apt-get install build-essential
+```
+
+- **git**
+
+Git is a version control system that allows you to keep track of changes in your
+code. It is required to work with Git repositories.
+
+```
+$ sudo apt-get install git
+```
+
+## Installation
+
+There are several ways to install Perceval on your system: packages or source
+code using Poetry or pip or using Docker.
+
+### PyPI
+
+Perceval can be installed using pip, a tool for installing Python packages. To
+do it, run the next command:
+```
+$ pip install perceval
+```
+
+### Source code
+
+To install from the source code you will need to clone the repository first:
+```
+$ git clone https://github.com/chaoss/grimoirelab-perceval
+$ cd grimoirelab-perceval
+```
+
+Then use pip or Poetry to install the package along with its dependencies.
+
+#### Pip
+To install the package from local directory run the following command:
+```
+$ pip install .
+```
+In case you are a developer, you should install perceval in editable mode:
+```
+$ pip install -e .
+```
+
+#### Poetry
+We use [poetry](https://python-poetry.org/) for dependency management and
+packaging. You can install it following its
+[documentation](https://python-poetry.org/docs/#installation). Once you have
+installed it, you can install perceval and the dependencies in a project
+isolated environment using:
+```
+$ poetry install
+```
+To spaw a new shell within the virtual environment use:
+```
+$ poetry shell
+```
+
+### Docker
+
+A Perceval Docker image is available at
+[DockerHub](https://hub.docker.com/r/grimoirelab/perceval/).
+
+Detailed information on how to run and/or build this image can be found
+[here](https://github.com/chaoss/grimoirelab-perceval/tree/master/docker/images/).
+
+## Documentation
+
+Documentation is generated automatically in the [ReadTheDocs Perceval
+site](http://perceval.readthedocs.org/).
+
+## References
+
+If you use Perceval in your research papers, please refer to [Perceval: software
+project data at your will](https://dl.acm.org/citation.cfm?id=3183475) --
+[Pre-print](https://www.researchgate.net/profile/Valerio_Cosentino/publication/325334393_Perceval_Software_Project_Data_at_Your_Will/links/5b066c9fa6fdcc8c2522b07c/Perceval-Software-Project-Data-at-Your-Will.pdf):
+
+### APA style
+
+```
+Dueñas, S., Cosentino, V., Robles, G., & Gonzalez-Barahona, J. M. (2018, May). Perceval: software project data at your will. In Proceedings of the 40th International Conference on Software Engineering: Companion Proceeedings (pp. 1-4). ACM.
+```
+
+### BibTeX
+
+```
+@inproceedings{duenas2018perceval,
+  title={Perceval: software project data at your will},
+  author={Due{\~n}as, Santiago and Cosentino, Valerio and Robles, Gregorio and Gonzalez-Barahona, Jesus M},
+  booktitle={Proceedings of the 40th International Conference on Software Engineering: Companion Proceeedings},
+  pages={1--4},
+  year={2018},
+  organization={ACM}
+}
+```
+
+## Examples
+
+### Askbot
+```
+$ perceval askbot 'http://askbot.org/' --from-date '2016-01-01'
+```
+
+### Bugzilla
+To fetch bugs from Bugzilla, you have two options:
+
+a) Use the traditional backend
+
+```
+$ perceval bugzilla 'https://bugzilla.redhat.com/' --backend-user user --backend-password pass --from-date '2016-01-01'
+```
+
+b) Use the REST API backend for Buzilla 5.0 (or higher) servers. We strongly
+recommend this backend when data is fetched from version servers >=5.0 because
+the retrieval process is much faster.
+
+```
+$ perceval bugzillarest 'https://bugzilla.mozilla.org/' --backend-user user --backend-password pass --from-date '2016-01-01'
+```
+
+### Confluence
+```
+$ perceval confluence 'https://wiki.opnfv.org/' --from-date '2016-01-01'
+```
+
+### Discourse
+```
+$ perceval discourse 'https://foro.mozilla-hispano.org/' --from-date '2016-01-01'
+```
+
+### Docker Hub
+```
+$ perceval dockerhub grimoirelab perceval
+```
+
+### Gerrit
+To run gerrit, you will need an authorized SSH private key:
+
+```
+$ eval `ssh-agent -s`
+$ ssh-add ~/.ssh/id_rsa
+Identity added: /home/user/.ssh/id_rsa (/home/user/.ssh/id_rsa)
+```
+
+To run the backend, execute the next command:
+
+```
+$ perceval gerrit --user user 'review.openstack.org' --from-date '2016-01-01'
+```
+
+### Git
+
+To run this backend execute the next command. Take into account that to run this
+backend Git program has to be installed on your system.
+
+```
+$ perceval git 'https://github.com/chaoss/grimoirelab-perceval.git' --from-date '2016-01-01'
+```
+
+To run the backend against a **private git repository**, you must pass the
+credentials directly in the URL:
+
+```
+$ perceval git https://<username>:<password>@repository-url
+```
+
+For example, for private GitHub repositories:
+
+```
+$ perceval git https://<username>:<api-token>@github.com/chaoss/grimoirelab-perceval
+```
+
+Git backend can also work with a Git log file as input. We recommend to use the
+next command to get the most complete log file.
+
+```
+$ git log --raw --numstat --pretty=fuller --decorate=full --parents --reverse --topo-order -M -C -c --remotes=origin --all > /tmp/gitlog.log
+```
+
+Then, to run the backend, just execute any of the next commands:
+
+```
+$ perceval git --git-log '/tmp/gitlog.log' 'file:///myrepo.git'
+```
+
+or
+
+```
+$ perceval git '/tmp/gitlog.log'
+```
+
+### GitHub
+```
+$ perceval github elastic logstash --from-date '2016-01-01'
+```
+
+The GitHub backend accepts the categories `issue`, `pull_request` and
+`repository` which allow to fetch the specific data.
+
+```
+$ perceval github --category issue elastic logstash
+```
+
+### GitLab
+```
+$ perceval gitlab fdroid fdroiddata -t $GITLAB_TOKEN --from-date '2016-01-01'
+```
+
+### Gitter
+```
+$ perceval gitter -t 'abcdefghi' --from-date '2020-03-18' 'jenkinsci' 'jenkins'
+```
+
+### GoogleHits
+```
+$ perceval googlehits "bitergia grimoirelab"
+```
+
+### Groups.io
+```
+$ perceval groupsio 'updates' -e '<me@example.com>' -p 'my-password' --from-date '2016-01-01'
+```
+In order to fetch the data from a group, you should first subscribe to it via
+the Groups.io website. In case you want to know the group names where you are
+subscribed, you can use the following script:
+https://gist.github.com/valeriocos/ad33a0b9b2d13a8336230c8c59df3c55
+
+
+### HyperKitty
+```
+$ perceval hyperkitty 'https://lists.mailman3.org/archives/list/mailman-users@mailman3.org' --from-date 2017-01-01
+```
+
+### Jenkins
+```
+$ perceval jenkins 'https://build.opnfv.org/ci/'
+```
+
+### JIRA
+```
+$ perceval jira 'https://tickets.puppetlabs.com' --project PUP --from-date '2016-01-01'
+```
+
+### Launchpad
+```
+$ perceval launchpad ubuntu --from-date '2016-01-01'
+```
+
+### Mattermost
+```
+$ perceval mattermost 'http://mattermost.example.com' jgw7jdmjkjf19ffkwnw59i5f9e --from-date '2016-01-01' -t 'abcdefghijk'
+```
+
+### MBox
+```
+$ perceval mbox 'http://example.com' /tmp/mboxes/
+```
+
+### MediaWiki
+```
+$ perceval mediawiki 'https://wiki.mozilla.org' --from-date '2016-06-30'
+```
+
+### Meetup
+```
+$ perceval meetup 'Software-Development-Analytics' --from-date '2016-06-01' -t abcdefghijk
+```
+
+### NNTP
+```
+$ perceval nntp 'news.mozilla.org' 'mozilla.dev.project-link' --offset 10
+```
+
+### Pagure
+```
+$ perceval pagure '389-ds-base' --from-date '2020-03-06'
+```
+
+### Phabricator
+```
+$ perceval phabricator 'https://secure.phabricator.com/' -t 123456789abcefe
+```
+
+### Pipermail
+```
+$ perceval pipermail 'https://mail.gnome.org/archives/libart-hackers/'
+```
+
+Pipermail also is able to fetch data from Apache's `mod_box` interface:
+```
+$ perceval pipermail 'http://mail-archives.apache.org/mod_mbox/httpd-dev/'
+```
+
+### Redmine
+```
+$ perceval redmine 'https://www.redmine.org/' --from-date '2016-01-01' -t abcdefghijk
+```
+
+### Rocket.Chat
+
+Rocket.Chat backend needs an API token and a User Id to authenticate to the
+server.
+```
+$ perceval rocketchat -t 'abchdefghij' -u '1234abcd' --from-date '2020-05-02' https://open.rocket.chat general
+```
+
+### RSS
+```
+$ perceval rss 'https://blog.bitergia.com/feed/'
+```
+
+### Slack
+
+Slack backend requires an API token for authentication. Slack apps can be used
+to generate and configure this API token. The scopes required by a Slack app for
+the backend are `channels:history`, `channels:read` and `users:read`. To know
+more about Slack apps and its integration please refer the [Slack apps
+documentation](https://api.slack.com/start/overview). For more information about
+the scopes required by a Slack app please refer the [Scopes and permissions
+documentation](https://api.slack.com/scopes).
+
+The following
+[script](https://gist.github.com/valeriocos/de31324625a3fab32449cf5d43b24075)
+can also be used to generate an OAuth2 token to access the Slack API.
+
+```
+$ perceval slack C0001 --from-date 2016-01-12 -t abcedefghijk
+```
+
+### StackExchange
+```
+$ perceval stackexchange --site stackoverflow --tagged python --from-date '2016-01-01' -t abcdabcdabcdabcd
+```
+
+### Supybot
+```
+$ perceval supybot 'http://channel.example.com' /tmp/supybot/
+```
+
+### Telegram
+
+Telegram backend needs an API token to authenticate the bot. In addition and in
+order to fetch messages from a group or channel, privacy settings must be
+disabled. To know how to create a bot, to obtain its token and to configure it
+please read the [Telegram Bots docs pages](https://core.telegram.org/bots).
+
+Note that the messages are available on the Telegram server until the bot
+fetches them, but they will not be kept longer than 24 hours.
+
+```
+$ perceval telegram mybot -t 12345678abcdefgh --chats 1 2 -10
+```
+
+### Twitter
+
+Twitter backend needs a bearer token to authenticate the requests. It can be
+obtained using the code available on GistGitHub:
+https://gist.github.com/valeriocos/7d4d28f72f53fbce49f1512ba77ef5f6
+
+```
+$ perceval twitter grimoirelab -t 12345678abcdefgh
+```
+
+## Community Backends
+
+Some backends are implemented in a seperate repository but not merged into
+[chaoss/grimoirelab-perceval](https://github.com/chaoss/grimoirelab-perceval)
+due to long-run maintainence reasons. Please feel free to check the backends and
+contact the maintainers for any issues or questions related to them.
+
+- Bundle for Puppet, Inc. ecosystem:
+  [chaoss/grimoirelab-perceval-puppet](https://github.com/chaoss/grimoirelab-perceval-puppet)
+- Bundle for OPNFV ecosystem:
+  [chaoss/grimoirelab-perceval-opnfv](https://github.com/chaoss/grimoirelab-perceval-opnfv)
+- Bundle for Mozilla ecosystem:
+  [chaoss/grimoirelab-perceval-mozilla](https://github.com/chaoss/grimoirelab-perceval-mozilla)
+- Bundle for FINOS ecosystem:
+  [Bitergia/grimoirelab-perceval-finos](https://github.com/Bitergia/grimoirelab-perceval-finos)
+- Weblate backend:
+  [chaoss/grimoirelab-perceval-weblate](https://github.com/chaoss/grimoirelab-perceval-weblate)
+- Zulip backend:
+  [vchrombie/grimoirelab-perceval-zulip](https://github.com/vchrombie/grimoirelab-perceval-zulip)
+- OSF backend:
+  [gitlab.com/open-rit/perceval-osf](https://gitlab.com/open-rit/perceval-osf)
+- Gitee backend:
+  [grimoirelab-gitee/grimoirelab-perceval-gitee](https://github.com/grimoirelab-gitee/grimoirelab-perceval-gitee)
+- Airtable backend:
+  [perceval-backends/grimoirelab-perceval-airtable](https://github.com/perceval-backends/grimoirelab-perceval-airtable)
+- Bitbucket backend:
+  [perceval-backends/grimoirelab-perceval-bitbucket](https://github.com/perceval-backends/grimoirelab-perceval-bitbucket)
+
+## Running tests
+
+Perceval comes with a comprehensive list of unit tests. To run them, in addition
+to the dependencies installed with Perceval, you need `httpretty`.
+
+## License
+
+Licensed under GNU General Public License (GPL), version 3 or later.
+
+
+%package -n python3-perceval
+Summary:	Send Sir Perceval on a quest to fetch and gather data from software repositories.
+Provides:	python-perceval
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-perceval
+# Perceval [![Build Status](https://github.com/chaoss/grimoirelab-perceval/workflows/tests/badge.svg)](https://github.com/chaoss/grimoirelab-perceval/actions?query=workflow:tests+branch:master+event:push) [![Coverage Status](https://img.shields.io/coveralls/chaoss/grimoirelab-perceval.svg)](https://coveralls.io/r/chaoss/grimoirelab-perceval?branch=master) [![PyPI version](https://badge.fury.io/py/perceval.svg)](https://badge.fury.io/py/perceval) [![Documentation in RTD](https://readthedocs.org/projects/perceval/badge/)](http://perceval.readthedocs.io)
+
+Send Sir Perceval on a quest to retrieve and gather data from software
+repositories.
+
+## Usage
+
+```
+usage: perceval [-g] <backend> [<args>] | --help | --version | --list
+
+Send Sir Perceval on a quest to retrieve and gather data from software
+repositories.
+
+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, pull requests and repository information from GitHub
+    gitlab           Fetch issues, merge requests from GitLab
+    gitter           Fetch messages from a Gitter room
+    googlehits       Fetch hits from Google API
+    groupsio         Fetch messages from Groups.io
+    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
+    mattermost       Fetch posts from a Mattermost server
+    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
+    pagure           Fetch issues from Pagure
+    phabricator      Fetch tasks from a Phabricator site
+    pipermail        Fetch messages from a Pipermail archiver
+    redmine          Fetch issues from a Redmine server
+    rocketchat       Fetch messages from a Rocket.Chat channel
+    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
+    twitter          Fetch tweets from the Twitter Search API
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -v, --version         show version
+  -g, --debug           set debug mode on
+  -l, --list            show available backends
+
+Run 'perceval <backend> --help' to get information about a specific backend.
+
+```
+
+## Requirements
+
+ * Python >= 3.7
+ * Poetry >= 1.2
+ * git
+ * build-essential
+
+You will also need some other libraries for running the tool, you can find the
+whole list of dependencies in [pyproject.toml](pyproject.toml) file.
+
+### How to install
+
+- **build-essentials**
+
+Build-essentials is a package that contains a set of tools to compile and build
+software. It is required to work with Debian packages.
+
+```
+$ sudo apt-get install build-essential
+```
+
+- **git**
+
+Git is a version control system that allows you to keep track of changes in your
+code. It is required to work with Git repositories.
+
+```
+$ sudo apt-get install git
+```
+
+## Installation
+
+There are several ways to install Perceval on your system: packages or source
+code using Poetry or pip or using Docker.
+
+### PyPI
+
+Perceval can be installed using pip, a tool for installing Python packages. To
+do it, run the next command:
+```
+$ pip install perceval
+```
+
+### Source code
+
+To install from the source code you will need to clone the repository first:
+```
+$ git clone https://github.com/chaoss/grimoirelab-perceval
+$ cd grimoirelab-perceval
+```
+
+Then use pip or Poetry to install the package along with its dependencies.
+
+#### Pip
+To install the package from local directory run the following command:
+```
+$ pip install .
+```
+In case you are a developer, you should install perceval in editable mode:
+```
+$ pip install -e .
+```
+
+#### Poetry
+We use [poetry](https://python-poetry.org/) for dependency management and
+packaging. You can install it following its
+[documentation](https://python-poetry.org/docs/#installation). Once you have
+installed it, you can install perceval and the dependencies in a project
+isolated environment using:
+```
+$ poetry install
+```
+To spaw a new shell within the virtual environment use:
+```
+$ poetry shell
+```
+
+### Docker
+
+A Perceval Docker image is available at
+[DockerHub](https://hub.docker.com/r/grimoirelab/perceval/).
+
+Detailed information on how to run and/or build this image can be found
+[here](https://github.com/chaoss/grimoirelab-perceval/tree/master/docker/images/).
+
+## Documentation
+
+Documentation is generated automatically in the [ReadTheDocs Perceval
+site](http://perceval.readthedocs.org/).
+
+## References
+
+If you use Perceval in your research papers, please refer to [Perceval: software
+project data at your will](https://dl.acm.org/citation.cfm?id=3183475) --
+[Pre-print](https://www.researchgate.net/profile/Valerio_Cosentino/publication/325334393_Perceval_Software_Project_Data_at_Your_Will/links/5b066c9fa6fdcc8c2522b07c/Perceval-Software-Project-Data-at-Your-Will.pdf):
+
+### APA style
+
+```
+Dueñas, S., Cosentino, V., Robles, G., & Gonzalez-Barahona, J. M. (2018, May). Perceval: software project data at your will. In Proceedings of the 40th International Conference on Software Engineering: Companion Proceeedings (pp. 1-4). ACM.
+```
+
+### BibTeX
+
+```
+@inproceedings{duenas2018perceval,
+  title={Perceval: software project data at your will},
+  author={Due{\~n}as, Santiago and Cosentino, Valerio and Robles, Gregorio and Gonzalez-Barahona, Jesus M},
+  booktitle={Proceedings of the 40th International Conference on Software Engineering: Companion Proceeedings},
+  pages={1--4},
+  year={2018},
+  organization={ACM}
+}
+```
+
+## Examples
+
+### Askbot
+```
+$ perceval askbot 'http://askbot.org/' --from-date '2016-01-01'
+```
+
+### Bugzilla
+To fetch bugs from Bugzilla, you have two options:
+
+a) Use the traditional backend
+
+```
+$ perceval bugzilla 'https://bugzilla.redhat.com/' --backend-user user --backend-password pass --from-date '2016-01-01'
+```
+
+b) Use the REST API backend for Buzilla 5.0 (or higher) servers. We strongly
+recommend this backend when data is fetched from version servers >=5.0 because
+the retrieval process is much faster.
+
+```
+$ perceval bugzillarest 'https://bugzilla.mozilla.org/' --backend-user user --backend-password pass --from-date '2016-01-01'
+```
+
+### Confluence
+```
+$ perceval confluence 'https://wiki.opnfv.org/' --from-date '2016-01-01'
+```
+
+### Discourse
+```
+$ perceval discourse 'https://foro.mozilla-hispano.org/' --from-date '2016-01-01'
+```
+
+### Docker Hub
+```
+$ perceval dockerhub grimoirelab perceval
+```
+
+### Gerrit
+To run gerrit, you will need an authorized SSH private key:
+
+```
+$ eval `ssh-agent -s`
+$ ssh-add ~/.ssh/id_rsa
+Identity added: /home/user/.ssh/id_rsa (/home/user/.ssh/id_rsa)
+```
+
+To run the backend, execute the next command:
+
+```
+$ perceval gerrit --user user 'review.openstack.org' --from-date '2016-01-01'
+```
+
+### Git
+
+To run this backend execute the next command. Take into account that to run this
+backend Git program has to be installed on your system.
+
+```
+$ perceval git 'https://github.com/chaoss/grimoirelab-perceval.git' --from-date '2016-01-01'
+```
+
+To run the backend against a **private git repository**, you must pass the
+credentials directly in the URL:
+
+```
+$ perceval git https://<username>:<password>@repository-url
+```
+
+For example, for private GitHub repositories:
+
+```
+$ perceval git https://<username>:<api-token>@github.com/chaoss/grimoirelab-perceval
+```
+
+Git backend can also work with a Git log file as input. We recommend to use the
+next command to get the most complete log file.
+
+```
+$ git log --raw --numstat --pretty=fuller --decorate=full --parents --reverse --topo-order -M -C -c --remotes=origin --all > /tmp/gitlog.log
+```
+
+Then, to run the backend, just execute any of the next commands:
+
+```
+$ perceval git --git-log '/tmp/gitlog.log' 'file:///myrepo.git'
+```
+
+or
+
+```
+$ perceval git '/tmp/gitlog.log'
+```
+
+### GitHub
+```
+$ perceval github elastic logstash --from-date '2016-01-01'
+```
+
+The GitHub backend accepts the categories `issue`, `pull_request` and
+`repository` which allow to fetch the specific data.
+
+```
+$ perceval github --category issue elastic logstash
+```
+
+### GitLab
+```
+$ perceval gitlab fdroid fdroiddata -t $GITLAB_TOKEN --from-date '2016-01-01'
+```
+
+### Gitter
+```
+$ perceval gitter -t 'abcdefghi' --from-date '2020-03-18' 'jenkinsci' 'jenkins'
+```
+
+### GoogleHits
+```
+$ perceval googlehits "bitergia grimoirelab"
+```
+
+### Groups.io
+```
+$ perceval groupsio 'updates' -e '<me@example.com>' -p 'my-password' --from-date '2016-01-01'
+```
+In order to fetch the data from a group, you should first subscribe to it via
+the Groups.io website. In case you want to know the group names where you are
+subscribed, you can use the following script:
+https://gist.github.com/valeriocos/ad33a0b9b2d13a8336230c8c59df3c55
+
+
+### HyperKitty
+```
+$ perceval hyperkitty 'https://lists.mailman3.org/archives/list/mailman-users@mailman3.org' --from-date 2017-01-01
+```
+
+### Jenkins
+```
+$ perceval jenkins 'https://build.opnfv.org/ci/'
+```
+
+### JIRA
+```
+$ perceval jira 'https://tickets.puppetlabs.com' --project PUP --from-date '2016-01-01'
+```
+
+### Launchpad
+```
+$ perceval launchpad ubuntu --from-date '2016-01-01'
+```
+
+### Mattermost
+```
+$ perceval mattermost 'http://mattermost.example.com' jgw7jdmjkjf19ffkwnw59i5f9e --from-date '2016-01-01' -t 'abcdefghijk'
+```
+
+### MBox
+```
+$ perceval mbox 'http://example.com' /tmp/mboxes/
+```
+
+### MediaWiki
+```
+$ perceval mediawiki 'https://wiki.mozilla.org' --from-date '2016-06-30'
+```
+
+### Meetup
+```
+$ perceval meetup 'Software-Development-Analytics' --from-date '2016-06-01' -t abcdefghijk
+```
+
+### NNTP
+```
+$ perceval nntp 'news.mozilla.org' 'mozilla.dev.project-link' --offset 10
+```
+
+### Pagure
+```
+$ perceval pagure '389-ds-base' --from-date '2020-03-06'
+```
+
+### Phabricator
+```
+$ perceval phabricator 'https://secure.phabricator.com/' -t 123456789abcefe
+```
+
+### Pipermail
+```
+$ perceval pipermail 'https://mail.gnome.org/archives/libart-hackers/'
+```
+
+Pipermail also is able to fetch data from Apache's `mod_box` interface:
+```
+$ perceval pipermail 'http://mail-archives.apache.org/mod_mbox/httpd-dev/'
+```
+
+### Redmine
+```
+$ perceval redmine 'https://www.redmine.org/' --from-date '2016-01-01' -t abcdefghijk
+```
+
+### Rocket.Chat
+
+Rocket.Chat backend needs an API token and a User Id to authenticate to the
+server.
+```
+$ perceval rocketchat -t 'abchdefghij' -u '1234abcd' --from-date '2020-05-02' https://open.rocket.chat general
+```
+
+### RSS
+```
+$ perceval rss 'https://blog.bitergia.com/feed/'
+```
+
+### Slack
+
+Slack backend requires an API token for authentication. Slack apps can be used
+to generate and configure this API token. The scopes required by a Slack app for
+the backend are `channels:history`, `channels:read` and `users:read`. To know
+more about Slack apps and its integration please refer the [Slack apps
+documentation](https://api.slack.com/start/overview). For more information about
+the scopes required by a Slack app please refer the [Scopes and permissions
+documentation](https://api.slack.com/scopes).
+
+The following
+[script](https://gist.github.com/valeriocos/de31324625a3fab32449cf5d43b24075)
+can also be used to generate an OAuth2 token to access the Slack API.
+
+```
+$ perceval slack C0001 --from-date 2016-01-12 -t abcedefghijk
+```
+
+### StackExchange
+```
+$ perceval stackexchange --site stackoverflow --tagged python --from-date '2016-01-01' -t abcdabcdabcdabcd
+```
+
+### Supybot
+```
+$ perceval supybot 'http://channel.example.com' /tmp/supybot/
+```
+
+### Telegram
+
+Telegram backend needs an API token to authenticate the bot. In addition and in
+order to fetch messages from a group or channel, privacy settings must be
+disabled. To know how to create a bot, to obtain its token and to configure it
+please read the [Telegram Bots docs pages](https://core.telegram.org/bots).
+
+Note that the messages are available on the Telegram server until the bot
+fetches them, but they will not be kept longer than 24 hours.
+
+```
+$ perceval telegram mybot -t 12345678abcdefgh --chats 1 2 -10
+```
+
+### Twitter
+
+Twitter backend needs a bearer token to authenticate the requests. It can be
+obtained using the code available on GistGitHub:
+https://gist.github.com/valeriocos/7d4d28f72f53fbce49f1512ba77ef5f6
+
+```
+$ perceval twitter grimoirelab -t 12345678abcdefgh
+```
+
+## Community Backends
+
+Some backends are implemented in a seperate repository but not merged into
+[chaoss/grimoirelab-perceval](https://github.com/chaoss/grimoirelab-perceval)
+due to long-run maintainence reasons. Please feel free to check the backends and
+contact the maintainers for any issues or questions related to them.
+
+- Bundle for Puppet, Inc. ecosystem:
+  [chaoss/grimoirelab-perceval-puppet](https://github.com/chaoss/grimoirelab-perceval-puppet)
+- Bundle for OPNFV ecosystem:
+  [chaoss/grimoirelab-perceval-opnfv](https://github.com/chaoss/grimoirelab-perceval-opnfv)
+- Bundle for Mozilla ecosystem:
+  [chaoss/grimoirelab-perceval-mozilla](https://github.com/chaoss/grimoirelab-perceval-mozilla)
+- Bundle for FINOS ecosystem:
+  [Bitergia/grimoirelab-perceval-finos](https://github.com/Bitergia/grimoirelab-perceval-finos)
+- Weblate backend:
+  [chaoss/grimoirelab-perceval-weblate](https://github.com/chaoss/grimoirelab-perceval-weblate)
+- Zulip backend:
+  [vchrombie/grimoirelab-perceval-zulip](https://github.com/vchrombie/grimoirelab-perceval-zulip)
+- OSF backend:
+  [gitlab.com/open-rit/perceval-osf](https://gitlab.com/open-rit/perceval-osf)
+- Gitee backend:
+  [grimoirelab-gitee/grimoirelab-perceval-gitee](https://github.com/grimoirelab-gitee/grimoirelab-perceval-gitee)
+- Airtable backend:
+  [perceval-backends/grimoirelab-perceval-airtable](https://github.com/perceval-backends/grimoirelab-perceval-airtable)
+- Bitbucket backend:
+  [perceval-backends/grimoirelab-perceval-bitbucket](https://github.com/perceval-backends/grimoirelab-perceval-bitbucket)
+
+## Running tests
+
+Perceval comes with a comprehensive list of unit tests. To run them, in addition
+to the dependencies installed with Perceval, you need `httpretty`.
+
+## License
+
+Licensed under GNU General Public License (GPL), version 3 or later.
+
+
+%package help
+Summary:	Development documents and examples for perceval
+Provides:	python3-perceval-doc
+%description help
+# Perceval [![Build Status](https://github.com/chaoss/grimoirelab-perceval/workflows/tests/badge.svg)](https://github.com/chaoss/grimoirelab-perceval/actions?query=workflow:tests+branch:master+event:push) [![Coverage Status](https://img.shields.io/coveralls/chaoss/grimoirelab-perceval.svg)](https://coveralls.io/r/chaoss/grimoirelab-perceval?branch=master) [![PyPI version](https://badge.fury.io/py/perceval.svg)](https://badge.fury.io/py/perceval) [![Documentation in RTD](https://readthedocs.org/projects/perceval/badge/)](http://perceval.readthedocs.io)
+
+Send Sir Perceval on a quest to retrieve and gather data from software
+repositories.
+
+## Usage
+
+```
+usage: perceval [-g] <backend> [<args>] | --help | --version | --list
+
+Send Sir Perceval on a quest to retrieve and gather data from software
+repositories.
+
+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, pull requests and repository information from GitHub
+    gitlab           Fetch issues, merge requests from GitLab
+    gitter           Fetch messages from a Gitter room
+    googlehits       Fetch hits from Google API
+    groupsio         Fetch messages from Groups.io
+    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
+    mattermost       Fetch posts from a Mattermost server
+    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
+    pagure           Fetch issues from Pagure
+    phabricator      Fetch tasks from a Phabricator site
+    pipermail        Fetch messages from a Pipermail archiver
+    redmine          Fetch issues from a Redmine server
+    rocketchat       Fetch messages from a Rocket.Chat channel
+    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
+    twitter          Fetch tweets from the Twitter Search API
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -v, --version         show version
+  -g, --debug           set debug mode on
+  -l, --list            show available backends
+
+Run 'perceval <backend> --help' to get information about a specific backend.
+
+```
+
+## Requirements
+
+ * Python >= 3.7
+ * Poetry >= 1.2
+ * git
+ * build-essential
+
+You will also need some other libraries for running the tool, you can find the
+whole list of dependencies in [pyproject.toml](pyproject.toml) file.
+
+### How to install
+
+- **build-essentials**
+
+Build-essentials is a package that contains a set of tools to compile and build
+software. It is required to work with Debian packages.
+
+```
+$ sudo apt-get install build-essential
+```
+
+- **git**
+
+Git is a version control system that allows you to keep track of changes in your
+code. It is required to work with Git repositories.
+
+```
+$ sudo apt-get install git
+```
+
+## Installation
+
+There are several ways to install Perceval on your system: packages or source
+code using Poetry or pip or using Docker.
+
+### PyPI
+
+Perceval can be installed using pip, a tool for installing Python packages. To
+do it, run the next command:
+```
+$ pip install perceval
+```
+
+### Source code
+
+To install from the source code you will need to clone the repository first:
+```
+$ git clone https://github.com/chaoss/grimoirelab-perceval
+$ cd grimoirelab-perceval
+```
+
+Then use pip or Poetry to install the package along with its dependencies.
+
+#### Pip
+To install the package from local directory run the following command:
+```
+$ pip install .
+```
+In case you are a developer, you should install perceval in editable mode:
+```
+$ pip install -e .
+```
+
+#### Poetry
+We use [poetry](https://python-poetry.org/) for dependency management and
+packaging. You can install it following its
+[documentation](https://python-poetry.org/docs/#installation). Once you have
+installed it, you can install perceval and the dependencies in a project
+isolated environment using:
+```
+$ poetry install
+```
+To spaw a new shell within the virtual environment use:
+```
+$ poetry shell
+```
+
+### Docker
+
+A Perceval Docker image is available at
+[DockerHub](https://hub.docker.com/r/grimoirelab/perceval/).
+
+Detailed information on how to run and/or build this image can be found
+[here](https://github.com/chaoss/grimoirelab-perceval/tree/master/docker/images/).
+
+## Documentation
+
+Documentation is generated automatically in the [ReadTheDocs Perceval
+site](http://perceval.readthedocs.org/).
+
+## References
+
+If you use Perceval in your research papers, please refer to [Perceval: software
+project data at your will](https://dl.acm.org/citation.cfm?id=3183475) --
+[Pre-print](https://www.researchgate.net/profile/Valerio_Cosentino/publication/325334393_Perceval_Software_Project_Data_at_Your_Will/links/5b066c9fa6fdcc8c2522b07c/Perceval-Software-Project-Data-at-Your-Will.pdf):
+
+### APA style
+
+```
+Dueñas, S., Cosentino, V., Robles, G., & Gonzalez-Barahona, J. M. (2018, May). Perceval: software project data at your will. In Proceedings of the 40th International Conference on Software Engineering: Companion Proceeedings (pp. 1-4). ACM.
+```
+
+### BibTeX
+
+```
+@inproceedings{duenas2018perceval,
+  title={Perceval: software project data at your will},
+  author={Due{\~n}as, Santiago and Cosentino, Valerio and Robles, Gregorio and Gonzalez-Barahona, Jesus M},
+  booktitle={Proceedings of the 40th International Conference on Software Engineering: Companion Proceeedings},
+  pages={1--4},
+  year={2018},
+  organization={ACM}
+}
+```
+
+## Examples
+
+### Askbot
+```
+$ perceval askbot 'http://askbot.org/' --from-date '2016-01-01'
+```
+
+### Bugzilla
+To fetch bugs from Bugzilla, you have two options:
+
+a) Use the traditional backend
+
+```
+$ perceval bugzilla 'https://bugzilla.redhat.com/' --backend-user user --backend-password pass --from-date '2016-01-01'
+```
+
+b) Use the REST API backend for Buzilla 5.0 (or higher) servers. We strongly
+recommend this backend when data is fetched from version servers >=5.0 because
+the retrieval process is much faster.
+
+```
+$ perceval bugzillarest 'https://bugzilla.mozilla.org/' --backend-user user --backend-password pass --from-date '2016-01-01'
+```
+
+### Confluence
+```
+$ perceval confluence 'https://wiki.opnfv.org/' --from-date '2016-01-01'
+```
+
+### Discourse
+```
+$ perceval discourse 'https://foro.mozilla-hispano.org/' --from-date '2016-01-01'
+```
+
+### Docker Hub
+```
+$ perceval dockerhub grimoirelab perceval
+```
+
+### Gerrit
+To run gerrit, you will need an authorized SSH private key:
+
+```
+$ eval `ssh-agent -s`
+$ ssh-add ~/.ssh/id_rsa
+Identity added: /home/user/.ssh/id_rsa (/home/user/.ssh/id_rsa)
+```
+
+To run the backend, execute the next command:
+
+```
+$ perceval gerrit --user user 'review.openstack.org' --from-date '2016-01-01'
+```
+
+### Git
+
+To run this backend execute the next command. Take into account that to run this
+backend Git program has to be installed on your system.
+
+```
+$ perceval git 'https://github.com/chaoss/grimoirelab-perceval.git' --from-date '2016-01-01'
+```
+
+To run the backend against a **private git repository**, you must pass the
+credentials directly in the URL:
+
+```
+$ perceval git https://<username>:<password>@repository-url
+```
+
+For example, for private GitHub repositories:
+
+```
+$ perceval git https://<username>:<api-token>@github.com/chaoss/grimoirelab-perceval
+```
+
+Git backend can also work with a Git log file as input. We recommend to use the
+next command to get the most complete log file.
+
+```
+$ git log --raw --numstat --pretty=fuller --decorate=full --parents --reverse --topo-order -M -C -c --remotes=origin --all > /tmp/gitlog.log
+```
+
+Then, to run the backend, just execute any of the next commands:
+
+```
+$ perceval git --git-log '/tmp/gitlog.log' 'file:///myrepo.git'
+```
+
+or
+
+```
+$ perceval git '/tmp/gitlog.log'
+```
+
+### GitHub
+```
+$ perceval github elastic logstash --from-date '2016-01-01'
+```
+
+The GitHub backend accepts the categories `issue`, `pull_request` and
+`repository` which allow to fetch the specific data.
+
+```
+$ perceval github --category issue elastic logstash
+```
+
+### GitLab
+```
+$ perceval gitlab fdroid fdroiddata -t $GITLAB_TOKEN --from-date '2016-01-01'
+```
+
+### Gitter
+```
+$ perceval gitter -t 'abcdefghi' --from-date '2020-03-18' 'jenkinsci' 'jenkins'
+```
+
+### GoogleHits
+```
+$ perceval googlehits "bitergia grimoirelab"
+```
+
+### Groups.io
+```
+$ perceval groupsio 'updates' -e '<me@example.com>' -p 'my-password' --from-date '2016-01-01'
+```
+In order to fetch the data from a group, you should first subscribe to it via
+the Groups.io website. In case you want to know the group names where you are
+subscribed, you can use the following script:
+https://gist.github.com/valeriocos/ad33a0b9b2d13a8336230c8c59df3c55
+
+
+### HyperKitty
+```
+$ perceval hyperkitty 'https://lists.mailman3.org/archives/list/mailman-users@mailman3.org' --from-date 2017-01-01
+```
+
+### Jenkins
+```
+$ perceval jenkins 'https://build.opnfv.org/ci/'
+```
+
+### JIRA
+```
+$ perceval jira 'https://tickets.puppetlabs.com' --project PUP --from-date '2016-01-01'
+```
+
+### Launchpad
+```
+$ perceval launchpad ubuntu --from-date '2016-01-01'
+```
+
+### Mattermost
+```
+$ perceval mattermost 'http://mattermost.example.com' jgw7jdmjkjf19ffkwnw59i5f9e --from-date '2016-01-01' -t 'abcdefghijk'
+```
+
+### MBox
+```
+$ perceval mbox 'http://example.com' /tmp/mboxes/
+```
+
+### MediaWiki
+```
+$ perceval mediawiki 'https://wiki.mozilla.org' --from-date '2016-06-30'
+```
+
+### Meetup
+```
+$ perceval meetup 'Software-Development-Analytics' --from-date '2016-06-01' -t abcdefghijk
+```
+
+### NNTP
+```
+$ perceval nntp 'news.mozilla.org' 'mozilla.dev.project-link' --offset 10
+```
+
+### Pagure
+```
+$ perceval pagure '389-ds-base' --from-date '2020-03-06'
+```
+
+### Phabricator
+```
+$ perceval phabricator 'https://secure.phabricator.com/' -t 123456789abcefe
+```
+
+### Pipermail
+```
+$ perceval pipermail 'https://mail.gnome.org/archives/libart-hackers/'
+```
+
+Pipermail also is able to fetch data from Apache's `mod_box` interface:
+```
+$ perceval pipermail 'http://mail-archives.apache.org/mod_mbox/httpd-dev/'
+```
+
+### Redmine
+```
+$ perceval redmine 'https://www.redmine.org/' --from-date '2016-01-01' -t abcdefghijk
+```
+
+### Rocket.Chat
+
+Rocket.Chat backend needs an API token and a User Id to authenticate to the
+server.
+```
+$ perceval rocketchat -t 'abchdefghij' -u '1234abcd' --from-date '2020-05-02' https://open.rocket.chat general
+```
+
+### RSS
+```
+$ perceval rss 'https://blog.bitergia.com/feed/'
+```
+
+### Slack
+
+Slack backend requires an API token for authentication. Slack apps can be used
+to generate and configure this API token. The scopes required by a Slack app for
+the backend are `channels:history`, `channels:read` and `users:read`. To know
+more about Slack apps and its integration please refer the [Slack apps
+documentation](https://api.slack.com/start/overview). For more information about
+the scopes required by a Slack app please refer the [Scopes and permissions
+documentation](https://api.slack.com/scopes).
+
+The following
+[script](https://gist.github.com/valeriocos/de31324625a3fab32449cf5d43b24075)
+can also be used to generate an OAuth2 token to access the Slack API.
+
+```
+$ perceval slack C0001 --from-date 2016-01-12 -t abcedefghijk
+```
+
+### StackExchange
+```
+$ perceval stackexchange --site stackoverflow --tagged python --from-date '2016-01-01' -t abcdabcdabcdabcd
+```
+
+### Supybot
+```
+$ perceval supybot 'http://channel.example.com' /tmp/supybot/
+```
+
+### Telegram
+
+Telegram backend needs an API token to authenticate the bot. In addition and in
+order to fetch messages from a group or channel, privacy settings must be
+disabled. To know how to create a bot, to obtain its token and to configure it
+please read the [Telegram Bots docs pages](https://core.telegram.org/bots).
+
+Note that the messages are available on the Telegram server until the bot
+fetches them, but they will not be kept longer than 24 hours.
+
+```
+$ perceval telegram mybot -t 12345678abcdefgh --chats 1 2 -10
+```
+
+### Twitter
+
+Twitter backend needs a bearer token to authenticate the requests. It can be
+obtained using the code available on GistGitHub:
+https://gist.github.com/valeriocos/7d4d28f72f53fbce49f1512ba77ef5f6
+
+```
+$ perceval twitter grimoirelab -t 12345678abcdefgh
+```
+
+## Community Backends
+
+Some backends are implemented in a seperate repository but not merged into
+[chaoss/grimoirelab-perceval](https://github.com/chaoss/grimoirelab-perceval)
+due to long-run maintainence reasons. Please feel free to check the backends and
+contact the maintainers for any issues or questions related to them.
+
+- Bundle for Puppet, Inc. ecosystem:
+  [chaoss/grimoirelab-perceval-puppet](https://github.com/chaoss/grimoirelab-perceval-puppet)
+- Bundle for OPNFV ecosystem:
+  [chaoss/grimoirelab-perceval-opnfv](https://github.com/chaoss/grimoirelab-perceval-opnfv)
+- Bundle for Mozilla ecosystem:
+  [chaoss/grimoirelab-perceval-mozilla](https://github.com/chaoss/grimoirelab-perceval-mozilla)
+- Bundle for FINOS ecosystem:
+  [Bitergia/grimoirelab-perceval-finos](https://github.com/Bitergia/grimoirelab-perceval-finos)
+- Weblate backend:
+  [chaoss/grimoirelab-perceval-weblate](https://github.com/chaoss/grimoirelab-perceval-weblate)
+- Zulip backend:
+  [vchrombie/grimoirelab-perceval-zulip](https://github.com/vchrombie/grimoirelab-perceval-zulip)
+- OSF backend:
+  [gitlab.com/open-rit/perceval-osf](https://gitlab.com/open-rit/perceval-osf)
+- Gitee backend:
+  [grimoirelab-gitee/grimoirelab-perceval-gitee](https://github.com/grimoirelab-gitee/grimoirelab-perceval-gitee)
+- Airtable backend:
+  [perceval-backends/grimoirelab-perceval-airtable](https://github.com/perceval-backends/grimoirelab-perceval-airtable)
+- Bitbucket backend:
+  [perceval-backends/grimoirelab-perceval-bitbucket](https://github.com/perceval-backends/grimoirelab-perceval-bitbucket)
+
+## Running tests
+
+Perceval comes with a comprehensive list of unit tests. To run them, in addition
+to the dependencies installed with Perceval, you need `httpretty`.
+
+## License
+
+Licensed under GNU General Public License (GPL), version 3 or later.
+
+
+%prep
+%autosetup -n perceval-0.21.6
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-perceval -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Wed May 10 2023 Python_Bot <Python_Bot@openeuler.org> - 0.21.6-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..08d3c22
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+fce238969f52af3472294770154def5a  perceval-0.21.6.tar.gz