Python variant

[coatless]

As I'm aiming to close out #27 this week, we probably should discuss how the Python variant should be structured.

Given there are a lot of packaging tools for Python, is there a preference among the tools that should be used? e.g. Build + setuptools, Poetry, Twine, Flit, Hatch, or PDM.

If we're aiming to publish on PyPi's repository, we'll need to rename to py-countdown as countdown is already taken by someone else. Alternatively, we could reach out and ask if they would be okay with letting us re-use the name (not sure how that would work).

For the package layout, I'm thinking about something like:

.
├── LICENSE
├── pyproject.toml
├── README.md
├── src/ 
│   ├── countdown/
│   │   ├── __init__.py
│   │   ├── countdown.py
│   │   └── utils.py
│   └── shiny_app/
│       ├── __init__.py
│       └── app.py
└── tests/

[gadenbuie]

Thanks for writing this out. Personally, I'd prefer using build + setuptools for packaging. Simon Willison has a helpful cookiecutter template and a post about his workflow in Python packages with pyproject.toml and nothing else.

If we're aiming to publish on PyPi's repository, we'll need to rename to py-countdown as countdown is already taken by someone else.

That's a bummer. And countdown-timer is also taken. I'm not a huge fan of py-countdown; I'd rather pick a name that makes sense if you saw it out-of-context in PyPI. I'm thinking countdown-widget for the package name, but users would still import the countdown function. It's not my favorite name but I think it makes sense within the Python package ecosystem.

[coatless]

Simon Willison has a helpful cookiecutter template and a post about his workflow in Python packages with pyproject.toml and nothing else.

Oh, nice! I'll aim to use that when spinning up the new project.

I'm thinking countdown-widget for the package name, but users would still import the countdown function.

Okay. Would you like me to try reaching out and asking if the person would be okay with letting us use the name as well? Both projects seem to have stopped updating and I'm not sure of the use.