flit VS tomlplusplus

Queries on https://github.com/pypa/flit/tree/main/flit_core/flit_core (omitted tests/)

(Pdb) print(indexer.query("def normalize_dist_name(name: str, version: str) -> str:"))

If it's pure Python, the only packaging file you need is `pyproject.toml`. You can fill that file with packaging metadata per PEP 518 and PEP 621, including using modern build tooling like flit[1] for the build backend and build[2] for the frontend.

With that, you entire package build (for all distribution types) should be reducible to `python -m build`. Here's an example of a full project doing everything with just `pyproject.toml`[3] (FD: my project).

[1]: https://github.com/pypa/flit

[2]: https://github.com/pypa/build

[3]: https://github.com/pypa/pip-audit

I published a very simple project flit_pytest_circleci_template that uses: * [flit](https://github.com/pypa/flit) to build a package. * pytest to test it * circleci to run the above and publish the package to pypi whenever a source file is committed. This is the hard part IMO as I do not know circleci well (and didn't know it at all when I started this project).

flit

I hadn't heard of flit, it does seem like it's not brand new on the scene, however it is primarily a single contributor:

https://github.com/takluyver/flit/graphs/contributors

With a title like this, I'd be expecting to see an article describing the latest tools and recommendations from the PyPA.

Unless you want to make your own config file parser as an exercise (which is a good idea) I'd recommend using toml++.

It's a public repo - this one: https://github.com/marzer/tomlplusplus but thank you

For a live demo, see the toml++ homepage: https://marzer.github.io/tomlplusplus/

Added bonus, tomlplusplus is a solid C++ implementation, actively updated, and easy to drop into a project (header only, CMake, vcpkg, Conan, etc.). Very easy to use for what I've needed.

Key links: - Homepage: https://marzer.github.io/tomlplusplus/ - Repository: https://github.com/marzer/tomlplusplus - "What is TOML?": https://toml.io/

cmake_minimum_required(VERSION 3.23) project(testProj) set(CMAKE_CXX_STANDARD 23) set(FETCHCONTENT_BASE_DIR ${PROJECT_SOURCE_DIR}/${CMAKE_PROJECT_NAME}/libs CACHE PATH "Missing description." FORCE) include(FetchContent) FetchContent_Declare( tomlplusplus GIT_REPOSITORY https://github.com/marzer/tomlplusplus.git GIT_TAG v3.1.0 ) FetchContent_MakeAvailable(tomlplusplus) add_executable(testProj testProj/src/main.cpp) target_link_libraries(testProj tomlplusplus)

I use them in toml++ to store the path of the source document for all the data nodes parsed from that document. Storing it as a separate std::string allocation for every single object would have been very wasteful, and the alternative would have been to make an overall document class that owned everything, which I didn't want to do, so shared_ptr was a good compromise.

Key links: - Homepage: https://marzer.github.io/tomlplusplus/ - Repository: https://github.com/marzer/tomlplusplus - "What is TOML?": https://toml.io/

toml++ was both my first 'public'/open-source project, and my first ever attempt at a parser. There's a few things I'd do differently now if I were to write it from scratch, but I've learned a lot along the way (particularly about making things build 'clean' on multiple platforms).