perceval-topicbox

Perceval backend for Topicbox.

Backends

The backend currently managed by this package support the next repository:

Topicbox

Requirements

Python >= 3.10

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 the accountId 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

perceval_topicbox-0.2.10.tar.gz (23.2 kB view details)

Uploaded Jun 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

perceval_topicbox-0.2.10-py3-none-any.whl (18.6 kB view details)

Uploaded Jun 22, 2026 Python 3

File details

Details for the file perceval_topicbox-0.2.10.tar.gz.

File metadata

Download URL: perceval_topicbox-0.2.10.tar.gz
Upload date: Jun 22, 2026
Size: 23.2 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1018-azure

File hashes

Hashes for perceval_topicbox-0.2.10.tar.gz
Algorithm	Hash digest
SHA256	`b5be084fd62fe929f0da5fe0aa89da7c717d88b5c039b4f5b1589f9db3f9f610`
MD5	`4589dd49c1c8f740bcca0745f164d035`
BLAKE2b-256	`aa0bf569643ab4323601b8263309abeaac2e53993d49f0a1968a6d8bf984af56`

See more details on using hashes here.

File details

Details for the file perceval_topicbox-0.2.10-py3-none-any.whl.

File metadata

Download URL: perceval_topicbox-0.2.10-py3-none-any.whl
Upload date: Jun 22, 2026
Size: 18.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1018-azure

File hashes

Hashes for perceval_topicbox-0.2.10-py3-none-any.whl
Algorithm	Hash digest
SHA256	`c2c501da09eda15418ce0d6c2b7cc3f634958529dcf66783ff9c92bbf2b758f1`
MD5	`d6a30fbf784fb0c7ef507c1033bebbb0`
BLAKE2b-256	`a1cdaa5e431d4dad72d52eb37e2be2ebf46dc21e558fda7f355ce7efb1f0bc4e`