Perceval backend for Topicbox
Project description
perceval-topicbox
Perceval backend for Topicbox.
Backends
The backend currently managed by this package support the next repository:
- Topicbox
Requirements
- Python >= 3.9
You will also need some other libraries for running the tool, you can find the whole list of dependencies in pyproject.toml file.
Installation
There are several ways to install perceval-topicbox on your system: packages or source code using Poetry or pip.
PyPI
perceval-topicbox can be installed using pip, a tool for installing Python packages. To do it, run the next command:
$ pip install perceval-topicbox
Source code
To install from the source code you will need to clone the repository first:
$ git clone https://github.com/bitergia-analytics/grimoirelab-perceval-topicbox
$ cd grimoirelab-perceval-topicbox
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-topicbox in editable mode:
$ pip install -e .
Poetry
We use poetry for dependency management and packaging. You can install it following its documentation. Once you have installed it, you can install perceval-topicbox and the dependencies in a project isolated environment using:
$ poetry install
To spaw a new shell within the virtual environment use:
$ poetry shell
Example
Topicbox
You need an account_id
and a group URL to fetch the messages.
- To obtain the
account_id
, open Network tab in the browser Devtool and identify theaccountId
in any/jmap
request made by the browser.
Run perceval with the Topicbox group URL and the account id to fetch the messages. For example:
$ perceval topicbox "https://mytopicbox.topicbox.com/groups/example" --account-id <account_id>
It can be run from a specific date using the --from-date
parameter.
License
Licensed under GNU General Public License (GPL), version 3 or later.
Project details
Release history Release notifications | RSS feed
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_topicbox-0.1.13-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 21321414483ea2695a8319dac3e6122c0c7f6557a63e78a7ad7d962cd65ef627 |
|
MD5 | 76ac204b12fcf635a6d2e277d605a65e |
|
BLAKE2b-256 | be2c72b41661600f0452b6e6d963b4f4c8e5e99ed8a54ea93c2071b62d0ab664 |