Perceval backend for Zulip.
We use Poetry for managing the project. You can install it following these steps.
Perceval Zulip backend can be installed using pip
It is advised to use a virtual environment
(.venv) $ pip install perceval-zulip
Clone the repository
$ git clone https://github.com/vchrombie/grimoirelab-perceval-zulip perceval-zulip
$ cd perceval-zulip
Install the required dependencies (this will also create a virtual environment)
$ poetry install
Activate the virtual environment
$ poetry shell
Note: You need the email
and the api_token
(API key) from the server. You can use the user email and API key
for authentication or create a bot and use the bot email and API key.
Reference: About bots (Zulip Help Center).
(.venv) $ perceval zulip --help
[2021-09-20 15:57:22,523] - Sir Perceval is on his quest.
usage: perceval [-h] [--category CATEGORY] [--tag TAG] [--filter-classified] -t API_TOKEN
[--archive-path ARCHIVE_PATH] [--no-archive] [--fetch-archive]
[--archived-since ARCHIVED_SINCE] [--no-ssl-verify] [-o OUTFILE]
[--json-line] -e EMAIL
url stream
positional arguments:
url Zulip chat URL
stream Zulip chat stream name
optional arguments:
-h, --help show this help message and exit
authentication arguments:
-t API_TOKEN, --api-token API_TOKEN
backend authentication token / API key
zulip arguments:
-e EMAIL, --email EMAIL
Zulip bot/user email
Fetch messages from the importlib
stream of the Python Zulip Server with the
bot email [email protected]
and API key xxxx
(.venv) $ perceval zulip https://python.zulipchat.com importlib -e [email protected] -t xxxx
[2021-09-20 15:59:24,593] - Sir Perceval is on his quest.
{
...
This project follows the contributing guidelines of the GrimoireLab.
The backend was initially developed by @vchrombie.
Adhering to the guidelines, the work is started in this external repository. But, this can be merged (chaoss/grimoirelab-perceval/#/667) into the Perceval repository in the future.
Licensed under GNU General Public License (GPL), version 3 or later.