Skip to main content

Preflibtools

PyPI Status Build badge codecov

Overview

The PrefLib-Tools is a set of Python tools developed to work with preference data from the PrefLib.org website.

This package provides input and output operations on PrefLib instances, together with some additional functionalities on the instances: Testing whether a Condorcet winner exists, whether the instance is single-peaked, etc...

We developed this package in the hope of making the use of PrefLib instances easy. This has been done in the same spirit as PrefLib: Providing tools for the community with the help of the community. If you want to contribute, feel free to create pull requests. If you have a question, a remark, or encounter a problem, please open an issue, create a pull request etc...

The full documentation of the package can be found there: https://preflib.github.io/preflibtools/.

If, for some reasons, you are looking for the older version of the PrefLib-Tools, it is still available in the GitHub repository Preflib-Tools-Old.

Installation

The installation is as easy as:

pip3 install preflibtools

Documentation

The complete documentation is available here.

GitHub Workflow

Publishing on PyPI

The pipeline between GitHub and PyPI is automatised. To push a new version do the following:

  • Update the pyproject.toml with the new version number.
  • Update the pabutools/__init__.py with the new version number.
  • On GitHub, create a new release tagged with the new version number (only admins can do that), on this page.
  • You're done, the new version of the package is automatically pushed to PyPI after the creation of a GitHub release.

Building the Docs

If the docs-source has been updated but the docs/ folder has not, you can build the docs via a GitHub action here: https://github.com/PrefLib/preflibtools/actions/workflows/docs.yml. Simply click "Run workflow" and the docs will be built and the built files will be pushed back to the server.

Release files for preflibtools 2.0.33

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for preflibtools 2.0.33
File Size Uploaded
preflibtools-2.0.33.tar.gz 61.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for preflibtools 2.0.33
File Interpreter ABI Platform
preflibtools-2.0.33-py3-none-any.whl Python 3 none any Details

Total release size: 139.0 kB

Release files / preflibtools-2.0.33.tar.gz

Download URL preflibtools-2.0.33.tar.gz
Size 61.7 kB
Tags Source
SHA-256 checksum
How to use checksums
949cfc2857fe4fce8d402615281ac0c9ca68e6546d473527fa610698fb89951f
BLAKE2b-256 checksum
How to use checksums
04cb5d6a8d41416b1d09b99fa05ed0f7f366ef35913d123e19e775e3a1763cf5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release files / preflibtools-2.0.33-py3-none-any.whl

Download URL preflibtools-2.0.33-py3-none-any.whl
Size 77.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
59c8a5c4d7de9a698f4cc349aad74ee121db6df44ed563bbc32d90ef54778d01
BLAKE2b-256 checksum
How to use checksums
06fa1881ba46d29d6da90c22eac60984a644882db6078f4d81bce36a507341df
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page