{"id":17277828,"url":"https://github.com/PioneersHub/pytanis","last_synced_at":"2025-02-25T02:32:47.762Z","repository":{"id":65208791,"uuid":"587412891","full_name":"FlorianWilhelm/pytanis","owner":"FlorianWilhelm","description":"🔱 Python client for Pretalx","archived":false,"fork":false,"pushed_at":"2024-09-16T22:55:24.000Z","size":5370,"stargazers_count":25,"open_issues_count":1,"forks_count":6,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-09-17T03:38:54.861Z","etag":null,"topics":["cfp","conferences","gsheet","helpdesk","pretalx","python"],"latest_commit_sha":null,"homepage":"https://florianwilhelm.info/pytanis/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FlorianWilhelm.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"FlorianWilhelm","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":"https://www.paypal.me/FlorianWilhelm"}},"created_at":"2023-01-10T17:37:10.000Z","updated_at":"2024-08-01T12:41:43.000Z","dependencies_parsed_at":"2023-11-13T22:27:09.413Z","dependency_job_id":"ee18744e-67b4-420a-8a4d-fc265117a757","html_url":"https://github.com/FlorianWilhelm/pytanis","commit_stats":{"total_commits":134,"total_committers":4,"mean_commits":33.5,"dds":0.07462686567164178,"last_synced_commit":"2cf4040808f5fc667d10002da72af997ce9c26e6"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianWilhelm%2Fpytanis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianWilhelm%2Fpytanis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianWilhelm%2Fpytanis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianWilhelm%2Fpytanis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FlorianWilhelm","download_url":"https://codeload.github.com/FlorianWilhelm/pytanis/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219844642,"owners_count":16556483,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cfp","conferences","gsheet","helpdesk","pretalx","python"],"created_at":"2024-10-15T09:10:06.848Z","updated_at":"2025-02-25T02:32:47.746Z","avatar_url":"https://github.com/FlorianWilhelm.png","language":"Jupyter Notebook","funding_links":["https://github.com/sponsors/FlorianWilhelm","https://www.paypal.me/FlorianWilhelm","https://github.com/sponsors/pioneershub"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/pioneershub/pytanis/main/docs/assets/images/logo.svg\" alt=\"Pytanis logo\" width=\"500\" role=\"img\"\u003e\n\u003c/div\u003e\n\nPytanis includes a [Pretalx] client and all the tooling you need for conferences using [Pretalx], from handling the initial call for papers to creating the final program.\n\u003cbr/\u003e\n\n|         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |\n|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| CI/CD   | [![CI - Test](https://github.com/pioneershub/pytanis/actions/workflows/run-tests.yml/badge.svg)](https://github.com/pioneershub/pytanis/actions/workflows/run-tests.yml) [![Coverage](https://img.shields.io/coveralls/github/PioneersHub/pytanis/main.svg?logo=coveralls\u0026label=Coverage)](https://coveralls.io/github/PioneersHub/pytanis) [![CD - Build](https://github.com/pioneershub/pytanis/actions/workflows/publish-pkg.yml/badge.svg)](https://github.com/pioneershub/pytanis/actions/workflows/publish-pkg.yml) [![Docs - Build](https://github.com/pioneershub/pytanis/actions/workflows/build-rel-docs.yml/badge.svg)](https://github.com/pioneershub/pytanis/actions/workflows/build-rel-docs.yml)                                                                                                            |\n| Package | [![PyPI - Version](https://img.shields.io/pypi/v/pytanis.svg?logo=pypi\u0026label=PyPI\u0026logoColor=gold)](https://pypi.org/project/pytanis/) [![PyPI - Downloads](https://img.shields.io/pypi/dm/pytanis.svg?color=blue\u0026label=Downloads\u0026logo=pypi\u0026logoColor=gold)](https://pypistats.org/packages/pytanis) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pytanis.svg?logo=python\u0026label=Python\u0026logoColor=gold)](https://pypi.org/project/pytanis/)                                                                                                                                                                                                                                                                                                                                                                                        |\n| Details | [![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch) [![linting - Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/charliermarsh/ruff) [![types - Mypy](https://img.shields.io/badge/Types-Mypy-blue.svg)](https://github.com/python/mypy) [![License - MIT](https://img.shields.io/badge/License-MIT-9400d3.svg)](https://spdx.org/licenses/) [![GitHub Sponsors](https://img.shields.io/static/v1?label=Sponsor\u0026message=%E2%9D%A4\u0026logo=GitHub\u0026color=ff69b4)](https://github.com/sponsors/pioneershub) |\n\n**Trivia**: The name *Pytanis* is a reference to [Prytanis] using the typical *py* prefix of [Python] tools. [Prytanis]\nwas the name given  to the leading members of the government of a city (polis) in ancient Greece. Offices that used this\ntitle usually had responsibility for presiding over councils of some kind, which met in the [Prytaneion]. Romani ite domum!\n\n## Features\n\n- [x] simple configuration management with a config folder in your home directory, just like many other tools do\n- [x] easily access [Google Sheets], potentially filled by some [Google Forms], and download sheets as data frames\n- [x] easy to use [Pretalx] client that returns proper Python objects thanks to the power of [pydantic]\n- [x] simple e-mail clients for batch mails, e.g. to your reviewers, via [Mailgun] and [HelpDesk]\n- [x] awesome [documentation] with best practices for the program committee of any community-based conference\n- [x] tools to assign proposals to reviewers based on constraints like preferences\n- [x] tools to support the final selection process of proposals\n- [x] tools to support the creation of the final program schedule\n\n## Getting started\n\nTo install Pytanis simple run:\n\n```commandline\npip install pytanis\n```\n\nor to install all recommended additional dependencies:\n\n```commandline\npip install 'pytanis[all]'\n```\n\nThen create a configuration file and directory in your user's home directory. For Linux/MacOS/Unix use\n`~/.pytanis/config.toml` and for Windows `$HOME\\.pytanis\\config.toml`, where `$HOME` is e.g. `C:\\Users\\yourusername\\`.\nUse your favourite editor to open `config.toml` within the `.pytanis` directory and add the following content:\n\n```toml\n[Pretalx]\napi_token = \"932ndsf9uk32nf9sdkn3454532nj32jn\"\n\n[Google]\nclient_secret_json = \"client_secret.json\"\ntoken_json = \"token.json\"\nservice_user_authentication = false\n\n[HelpDesk]\naccount = \"934jcjkdf-39df-9df-93kf-934jfhuuij39fd\"\nentity_id = \"email@host.com\"\ntoken = \"dal:Sx4id934C3Y-X934jldjdfjk\"\n\n[Mailgun]\ntoken = \"gguzdgshbdhjsb87239njsa\"\nfrom_address = \"PyCon DE \u0026 PyData Program Committee \u003cprogram25@mg.pycon.de\u003e\"\nreply_to = \"program25@pycon.de\"\n```\n\nwhere you need to replace the dummy values in the sections `[Pretalx]` and `[HelpDesk]` accordingly. Note that `service_user_authentication` is not required to be set if authentication via a service user is not necessary (see [GSpread using Service Account] for more details).\n\n### Retrieving the Credentials and Tokens\n\n- **Google**:\n  - For end users: Follow the [Python Quickstart for the Google API] to generate and download the file `client_secret.json`.\nMove it to the `~/.pytanis` folder as `client_secret.json`. The file `token.json` will be automatically generated\nlater. Note that `config.toml` references those two files relative to its own location.\n  - For any automation project: Follow [GSpread using Service Account] to generate and download the file `client_secret.json`.\nMove it to the `~/.pytanis` folder as `client_secret.json`. Also make sure to set `service_user_authentication = true` in your `~/.pytanis/config.toml`.\n- **Pretalx**: The API token can be found in the [Pretalx user settings].\n- **HelpDesk**: Login to the [LiveChat Developer Console] then go to \u003ckbd\u003eTools\u003c/kbd\u003e » \u003ckbd\u003ePersonal Access Tokens\u003c/kbd\u003e.\n  Choose \u003ckbd\u003eCreate new token +\u003c/kbd\u003e, enter a the name `Pytanis`, select all scopes and confirm. In the following screen\n  copy the `Account ID`, `Entity ID` and `Token` and paste them into `config.toml`.\n  In case there is any trouble with livechat, contact a helpdesk admin. Also note that the `Account ID` from your token is\n  the `Agent ID` needed when you create a ticket. The `Team ID` you get from [HelpDesk] then \u003ckbd\u003eAgents\u003c/kbd\u003e »\n  \u003ckbd\u003eName of your agent\u003c/kbd\u003e and the final part of the URL shown now.\n\n  **When setting up your agent the first time**,\n  you also need to go to [LiveChat] then log in with your Helpdesk team credentials and click \u003ckbd\u003eRequest\u003c/kbd\u003e to get an invitation.\n  An admin of [LiveChat] needs to confirm this and add you as role `admin`. Then, check [HelpDesk] to receive the invitation\n  and accept.\n\n## Development\n\nThis section is only relevant if you want to contribute to Pytanis itself. Your help is highly appreciated! There are two options for local development.\n\nWhilst both option are valid, the Devcontainer setup is the most convenient, as all dependencies are preconfigured.\n\n### Devcontainer Setup\n\nAfter having cloned this repository:\n\n1. Make sure to have a local installation of [Docker] and [VS Code] running.\n2. Open [VS Code] and make sure to have the [Dev Containers Extension] from Microsoft installed.\n3. Open the cloned project in [VS Code] and from the bottom right corner confirm to open the project to be opened within the Devcontainer.\n\nIf you miss any dependencies check out the `devcontainer.json` within the `.devcontainer` folder. Otherwise, the right python environment with [pipx], [hatch], [pre-commit] and the initialization steps for the Hatch environments, are already included.\n\nFor the use of the `pytanis` libary some credentials and tokens are necessary (see the \"Getting Started\" section). With the Devcontainer setup the `config.yaml` is already created. Just navigate to `~/.pytanis/config.toml` and update the file with the corresponding tokens.\n\n### Conventional Setup\n\nAfter having cloned this repository:\n\n1. install [hatch] globally, e.g. `pipx install hatch`,\n2. install [pre-commit] globally, e.g. `pipx install pre-commit`,\n3. \\[only once\\] run `hatch config set dirs.env.virtual .direnv`  to let [VS Code] find your virtual environments.\n\n\nAnd then you are already set up to start hacking. Use `hatch run` to do everything you would normally do in a virtual\nenvironment, e.g. `hatch run jupyter lab` to start [JupyterLab] in the default environment, `hatch run cov` for unit tests\nand coverage (like [tox]) or `hatch run docs:serve` to build \u0026 serve the documentation. For code hygiene, execute `hatch run lint:all`\nin order to run [ruff] and [mypy] or `hatch run lint:fix` to automatically fix formatting issues.\nCheck out the `[tool.hatch.envs]` sections  in [pyproject.toml](pyproject.toml) to learn about other commands.\nIf you really must enter a virtual environment, use `hatch shell` to enter the default environment.\n\n## Documentation\n\nThe [documentation] is made with [Material for MkDocs] and is hosted by [GitHub Pages]. Your help to extend the\ndocumentation, especially in the context of using Pytanis for community conferences like [PyConDE], [EuroPython], etc.\nis highly appreciated.\n\n## License \u0026 Credits\n\n[Pytanis] is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.\nTo start this project off a lot of inspiration and code was taken from [Alexander Hendorf] and [Matthias Hofmann].\n\n[Pytanis]: https://pioneershub.github.io/pytanis/\n[Python]: https://www.python.org/\n[Pretalx]: https://pretalx.com/\n[hatch]: https://hatch.pypa.io/\n[pre-commit]: https://pre-commit.com/\n[Prytanis]: https://en.wikipedia.org/wiki/Prytaneis\n[Prytaneion]: https://en.wikipedia.org/wiki/Prytaneion\n[Python Quickstart for the Google API]: https://developers.google.com/sheets/api/quickstart/python\n[GSpread using Service Account]: https://docs.gspread.org/en/v5.12.4/oauth2.html#for-bots-using-service-account\n[Pretalx user settings]: https://pretalx.com/orga/me\n[documentation]: https://pioneershub.github.io/pytanis/\n[Alexander Hendorf]: https://github.com/alanderex\n[Matthias Hofmann]: https://github.com/mj-hofmann\n[Google Forms]: https://www.google.com/forms/about/\n[Google Sheets]: https://www.google.com/sheets/about/\n[pydantic]: https://docs.pydantic.dev/\n[HelpDesk]: https://www.helpdesk.com/\n[Material for MkDocs]: https://github.com/squidfunk/mkdocs-material\n[GitHub Pages]: https://docs.github.com/en/pages\n[PyConDE]: https://pycon.de/\n[EuroPython]: https://europython.eu/\n[LiveChat Developer Console]: https://platform.text.com/console/\n[JupyterLab]: https://jupyter.org/\n[tox]: https://tox.wiki/\n[mypy]: https://mypy-lang.org/\n[ruff]: https://github.com/astral-sh/ruff\n[VS Code]: https://code.visualstudio.com/\n[LiveChat]: https://www.livechat.com/\n[Docker]: https://www.docker.com/\n[Dev Containers Extension]: https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers\n[Mailgun]: https://www.mailgun.com/\n[pipx]: https://pipx.pypa.io/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPioneersHub%2Fpytanis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPioneersHub%2Fpytanis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPioneersHub%2Fpytanis/lists"}