Perceval backend for Zulip.
Project description
perceval-zulip
Perceval backend for Zulip.
Requirements
- Python >= 3.6.1
- python3-requests >= 2.7
- grimoirelab-toolkit >= 0.2
- perceval >= 0.17.4
Installation
1. PyPI
Perceval Zulip backend can be installed using pip
$ pip install perceval-zulip
2. Getting the source code
Clone the repository
$ git clone https://github.com/vchrombie/grimoirelab-perceval-zulip
Prerequisites
Poetry
We use Poetry for managing the project. You can install it following these steps.
Setup
Install the required dependencies (this will also create a virtual environment)
$ poetry install
Activate the virtual environment
$ poetry shell
Usage
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 bot@zulipchat.com
and API key xxxx
(.venv) $ perceval zulip https://python.zulipchat.com importlib -e bot@zulipchat.com -t xxxx
[2021-09-20 15:59:24,593] - Sir Perceval is on his quest.
{
...
Contributing
This project follows the contributing guidelines of the GrimoireLab.
Acknowledgment
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.
License
Licensed under GNU General Public License (GPL), version 3 or later.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for perceval_zulip-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fbd77b1787e4feb1f692cfa40c054567acfcbe162b792b5615d04de7e6be11a1 |
|
MD5 | 32a49490232e1ab3a025ed13eab18267 |
|
BLAKE2b-256 | ced9b2c9a957a685fd68f290773bef4744100fa3c7ee8ef2bf2c54e5d3a942a4 |