3 ms·
This is really nicely written; kudos to the author for compiling a great deal of information in a readable format. If I can be forgiven one nitpick: Poetry doe
by woodruffw 4y ago
This is really nicely written; kudos to the author for compiling a great deal of information in a readable format.
If I can be forgiven one nitpick: Poetry does not use a PEP 518-style[1] build configuration by default, which means that its use of `pyproject.toml` is slightly out of pace with the rest of the Python packaging ecosystem. That isn't to say that it isn't excellent, because it is! But you the standards have come a long way, and you can now use `pyproject.toml` with any build backend as long as you use the standard metadata.
By way of example, here's a project that's completely PEP 517 and PEP 518 compatible without needing a setup.py or setup.cfg[2]. Everything goes through pyproject.toml.
[1]: https://peps.python.org/pep-0518/ https://peps.python.org/pep-0518/
[2]: https://github.com/trailofbits/pip-audit/blob/main/pyproject.toml https://github.com/trailofbits/pip-audit/blob/main/pyproject...
- RojerGS 4y agoYour nitpick is forgiven! Thanks a lot for this information, I was not aware of this... However, I took a look at PEP 518 and failed to understand what was wrong with Poetry's default configuration. Can you help me out?
- pid-1 4y ago> By way of example, here's a project that's completely PEP 517 and PEP 518 compatible without needing a setup.py or setup.cfg[2]. Everything goes through pyproject.toml. Using pyproject.toml with pip / flit still has many rough edges such as pip being unable to install deps locally for development or not generating lock files. Poetry is way more mature IMO.
- woodruffw 4y agoMaybe I’m misunderstanding what you mean, but installing dependencies locally for development (meaning development extras) and generating lock files (via pep freeze) both work for me.
- milliams 4y agoI believe that Poetry does conform to PEP 518 (i.e. it specifies `[build-system]requires/build-backend`), but not to the `dependencies` part of PEP 621 [1]. There are plans for this in the future though [2]. Though I would defer to your expertise if I'm mistaken. [1] https://peps.python.org/pep-0621/ https://peps.python.org/pep-0621/ [2] https://github.com/python-poetry/roadmap/issues/3 https://github.com/python-poetry/roadmap/issues/3
- woodruffw 4y agoYes, this was a mistake on my part! I meant PEP 621.
- rmbyrro 4y agoIf I can be forgiven another nitpick regarding readability: The font size is extremely small to the point of being unreadable on a mobile phone.
- zwirbl 4y agoI think the font size is perfect, but I take offense to the font used for headings
- RojerGS 4y agoI've been looking for a replacement for that font for a long time. Do you have any suggestions?
- dflock 4y agoYou could just use the same font as your body copy - "Atkinson Hyperligeible" with `line-height: 0.8` and `font-weight: 700` - and remove the `font-size: .8rem;` from your `body` rule. If you want to keep a similar style: https://fonts.google.com/?category=Handwriting https://fonts.google.com/?category=Handwriting Also: https://www.pagecloud.com/blog/best-google-fonts-pairings https://www.pagecloud.com/blog/best-google-fonts-pairings