Our great sponsors
-
WorkOS
The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.
-
LibCST
A concrete syntax tree parser and serializer library for Python that preserves many aspects of Python's abstract syntax tree
-
InfluxDB
Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.
I ask because black has a history of being a "problem package" and breaking install workflows with unfortunate regularity. This issue was one recent example and versions of it/related issues caused by it (such as issue 1847) stayed open for extended periods. I also remember earlier instances around black's forced early adoption of pyproject.toml, when the tooling support for it wasn't yet good enough to be reliable and triggered unexpected/unwanted behaviors in pip.
After rolling out Black + isort (and later usort) to millions of lines of code, I prefer https://github.com/omnilib/ufmt
I myself am working on upgrading LibCST's parser engine to support the new syntax, and then am hoping we can rewrite Black's formatting rules in terms of LibCST's API. That's not a small amount of work, which is why we can't confidently say that's going to be the way forward.
Thank you! I'm actually maintaining a PyCharm plugin that relies on it, so it is good to know that effort will not go to waste. :)
It seems MkDocs is gaining traction, you can see it in action in FastAPI docs. I personally haven't used it yet so can't compare.
Related posts
- Let's meet Black: Python Code Formatting
- Auto-formater for Android (Kotlin)
- Lute v3 - installed software for learning foreign languages through reading
- Python rewrites values in all nested dictionaries, rather than iterating through them uniquely?
- Forcing double quotes would make this great project unusable for many users who picked the rule of using single quotes.