toml VS semver

Black uses by default the pyproject.toml file. This file contains a section for each different tool we want to use. The use of a configuration file like pyproject.toml is quite a good choice and helps the contributors to use the same tools and configurations you're using.

> I don't think even though TOML has some official spec

Read it on https://toml.io/ (Full spec on upper-right… with its evolutions up to final 1.00 version).

ini2toml which automatically translates .ini/.cfg files into TOML

toml 1.1 will allow non-ascii in keys (and multi-line inline tables)

See https://github.com/toml-lang/toml/blob/main/CHANGELOG.md

JSON is basically perfect if it allowed trailing commas and comments. TOML is not a replacement for JSON because of how badly it chokes on nested lists of objects (both hard to read and hard to write), due to a misguided attempt to avoid becoming JSON-like[1].

[1] https://github.com/toml-lang/toml/issues/516

See https://github.com/toml-lang/toml/blob/main/CHANGELOG.md

> I still think it's the best format out there.

What do you think of https://toml.io ?

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

Semantic Versioning: An established convention for version numbers following the pattern MAJOR.MINOR.PATCH

Increases the major of the latest tag and prints it As per the Semver spec, it'll also clear the pre-release…

I believe neovim follows semantic versioning. https://semver.org/

Semver has been 2.0.0 for 10 years, look at the date of the assets. Multiple releases created today where none existed before. Not sure why someone is creating releases now, perhaps just some housekeeping/cleanup.

https://github.com/semver/semver/releases

If you're using semver, read the spec it's not overly long or hard to understand.

Semantic versioning actually has a clear rule about this:

The biggest issue with semver is that it encourages compatibility breakages unoer a false promise that increased major version number saves the users from the dependency hell.

https://github.com/semver/semver/issues/771

Python versions include a major, minor, and micro component. It's slightly similar in concept to semver, though the minor version may do something incompatible at times. An example of this is the removal of distutils in 3.12. While technically not a language change persay, it did mean some build systems had to be revamped to accommodate this change. In general you'll see python referred to in a major.minor format such as: