I've noticed that a lot of my projects follow the same basic architecture and I often like to write some simple tools for myself where it takes much longer to set up the project than it does to write the domain specific code. So I've been looking into scaffolding tools to help with this. I'm aware of Cookiecutter and Copier. Are there others? How do they compare? What are your preferences and why?

you are viewing a single comment's thread
view the rest of the comments

[–] logging_strict@programming.dev 2 points 1 month ago (3 children)

Package DevOPs is a skill. Half assing it will not:

impress a published package author's peers
encourage confidence in the authors perseverance to maintain the package
encourage confidence in the author's willingness to politely respond to Issues and PRs
package will have issues that never get resolved cuz the author packaging skillset is woefully lacking including but not limited to: Makefile, pre-commit, tox, gha, doctest, documentation, test coverage, multiple platform support, manylinux support, setup for collaboration, and static typing.

So suggest redirecting efforts towards studying how to improve packaging rather than how to avoid packaging.

A suggestion on things to improve documentation:

move the doctest out of in-code documentation and into test suite! So the doctest are proof and contribute to coverage

python -m coverage run --parallel --data-file=.coverage-combine-tests -m pytest --doctest-glob="*.rst" --showlocals $(verbose_text) tests/safe tests/a tests/b

This is straight from a Makefile. Where the file extension for doctest was changed to .rst. Can see have A B testing setup to compare two packages.

Example how to include doctest into Sphinx document

.. literalinclude:: ../tests/a/test_presentation.rst
    :language: pycon
    :name: unique-id
    :caption: illustrative-description

[–] cx40@piefed.ca 2 points 1 month ago (1 children)

Was this meant for a different thread?

[–] logging_strict@programming.dev 2 points 1 month ago (1 children)

On this board, and hope everyone else is, to learn and share. Try to contribute, not just state my opinion.

Didn't feel this thread offered anything substantial to learn, so threw out some gem that others might find useful in their projects.

[–] Balldowern@lemmy.zip 2 points 4 weeks ago* (last edited 4 weeks ago)

Thank you, oh wise one 🙏🏻

load more comments (1 replies)