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.8
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.2rc1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9f41519dcd313e84b4ae921fee7df08d5363bc6b21f295b34cf923065213b627 |
|
MD5 | 1ff34e260ff3c433b767aac8640d624e |
|
BLAKE2b-256 | afaaa5653cf61289c0306a6d48c8bb4a46dbb4316c2152e503484dd741f48bb7 |
Hashes for perceval_topicbox-0.1.2rc1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e7a90667b8c9678da36aa6c97507e9daf760381626ea5e6e9685035b9e343f65 |
|
MD5 | c2551123b5c94c4d00f8898c208ac1f0 |
|
BLAKE2b-256 | 854bc10e8e3a12efe3f73668cc09308fb36c3c4d2b43b2b372722cbeb8d6b072 |