All the tooling you need for conferences using Pretalx from handling the initial call for papers to creating the final program.
| CI/CD |     |
| Package |    |
| Details |        |
Trivia: The name Pytanis is a reference to Prytanis using the typical py prefix of Python tools. Prytanis was the name given to the leading members of the government of a city (polis) in ancient Greece. Offices that used this title usually had responsibility for presiding over councils of some kind, which met in the Prytaneion. Romani ite domum!
This is an alpha version! It might break sometimes!
- simple configuration management with a config folder in your home directory, just like many other tools do
- easily access Google Sheets, potentially filled by some Google Forms, and download results as DataFrame
- easy to use Pretalx client that returns proper Python objects thanks to the power of pydantic
- simple HelpDesk client for batch mails, e.g. to your reviewers
- awesome documentation with best practices for the program committee of any community-based conference
- tools to assign proposals to reviewers based on constraints like preferences
- tools to support the final selection process of proposals
- tools to support the creation of the final program schedule
To install Pytanis simple run:
pip install pytanis
or to install all recommended additional dependencies:
pip install pytanis[all]
Then create a configuration file and directory in your user's home directory. For Linux/MacOS/Unix use
~/.pytanis/config.toml and for Windows $HOME\.pytanis\config.toml, where $HOME is e.g. C:\Users\yourusername\.
Use your favourite editor to open config.toml within the .pytanis directory and add the following content:
[Pretalx]
api_token = "932ndsf9uk32nf9sdkn3454532nj32jn"
[Google]
client_secret_json = "client_secret.json"
token_json = "token.json"
[HelpDesk]
account = "934jcjkdf-39df-9df-93kf-934jfhuuij39fd"
entity_id = "email@host.com"
token = "dal:Sx4id934C3Y-X934jldjdfjk"where you need to replace the dummy values in the sections [Pretalx] and [HelpDesk] accordingly.
- Google: Follow the Python Quickstart for the Google API to generate and download the file
client_secret.json. Move it to the~/.pytanisfolder asclient_secret.json. The filetoken.jsonwill be automatically generated later. Note thatconfig.tomlreferences those two files relative to its own location. - Pretalx: The API token for the Pretalx API can be found in your user settings.
- HelpDesk: Login to the LiveChat Developer Console then go to Tools » Personal Access Tokens.
Choose Create new token +, enter the name
Pytanis, select all scopes and confirm. In the following screen copy theAccount ID,Entity IDandTokenand paste them intoconfig.toml. In case there is any trouble with livechat, contact a helpdesk admin.
This section is only relevant if you want to contribute to Pytanis itself. Your help is highly appreciated!
After having cloned this repository:
- install hatch globally, e.g.
pipx install hatch, - create the default environment with
hatch env create, - [only once] run
hatch run pre-commit installto install pre-commit,
and then you are already set up to start hacking. Use hatch run to do everything you would normally do in a virtual
environment, e.g. hatch run juptyer lab to start JupyterLab in the default environment, hatch run test:cov for unit tests
and coverage (like tox) or hatch run docs:servce to build & serve the documentation. Check out the [tool.hatch.envs] sections
in pyproject.toml to learn about other commands. If you really must enter a virtual environment, use
hatch shell to enter the default environment.
The documentation is made with Material for MkDocs and is hosted by GitHub Pages. Your help to extend the documentation, especially in the context of using Pytanis for community conferences like PyConDE, EuroPython, etc. is highly appreciated.
Pytanis is distributed under the terms of the MIT license.
To start this project off a lot of inspiration and code was taken from Alexander Hendorf and Matthias Hofmann.