I'm Sam, just another nerd.
I really enjoy tinkering with software. You can see some discussion at my neglected blog: sambriggs.dev.
I get a real kick out of someone opening a PR on one of my projects, so don't be shy!
This project forked from audreyfeldroy/cookiecutter-pypackage
Cookiecutter template for a poetry-managed Python package.
License: BSD 3-Clause "New" or "Revised" License
I'm Sam, just another nerd.
I really enjoy tinkering with software. You can see some discussion at my neglected blog: sambriggs.dev.
I get a real kick out of someone opening a PR on one of my projects, so don't be shy!
It might be worth renaming this project to differentiate it from the original?
It isn't necessary but could be good for visibility.
When a new project is generated, the extensions
variable in conf.py
has bad indentation if Google style comments are used:
extensions = [
'sphinx.ext.autodoc',
'sphinx.ext.viewcode',
'sphinxcontrib.napoleon',
]
Simply generated a project, with google docstrings on.
Once #2 is resolved the project should be publicised on the original cookiecutter-pypackage page,
It would be useful to be able to add type checking (with mypy) as an optional extra when starting a new project
If I run a search for setup.py
on the repo I get quite a few hits:
Searching 61 files for "setup.py" (case sensitive)
...
13 matches across 8 files
All of these are cosmetic (tests, comments, or documentation) but it is pretty confusing.
Running tox
fails on the generated package:
https://travis-ci.org/github/briggySmalls/spotify-playlist/jobs/689163757
2020-01-04
1.7.0
3.7
Ubuntu 18.04
Ran cookiecutter and it asks for github_username
. I do have a github, but I use bitbucket a lot more. Does this have support for bitbucket? How hard would it be to add support?
cookiecutter gh:briggySmalls/cookiecutter-pypackage
I created a new project with this cookiecutter template, and ran tox
immediately afterward on the generated project. This failed with
$ tox
ERROR: No setup.py file found. The expected location is:
<redacted>/setup.py
You can
1. Create one:
https://packaging.python.org/tutorials/distributing-packages/#setup-py
2. Configure tox to avoid running sdist:
https://tox.readthedocs.io/en/latest/example/general.html#avoiding-expensive-sdist
I prefer black. Let's use that instead...
When the CI runs the tests it supplied pty=True which is unsupported on Windows.
Supplying this parameter should be platform-dependent.
Building the docs for a generated project fails because conf.py
tries to use the sphinxcontrib.napoleon
package.
However since Sphinx 1.3 this has been shipped with sphinx, and named sphinx.ext.napoleon
.
This should be updated
invoke docs
#16 introduces that tests run the formatter and linter which is great. However this is only done for the project defaults.
These tests should be updated to configure using click/argparse, pytest/unittest, etc, to ensure that different project outputs conform to e.g. the formater immediately
The CI server fails (as does my local machine) because the invocations package (used to document invoke) uses a deprecated sphinx API.
The issue has been reported pyinvoke/invocations#19
Ran documentation build
invoke docs
poetry add
can fail because python version not restricted tightly enough.
python = "*"
is not useful. Better to do something like python = "^3.5"
?
I really like using invoke for linting/formatting/testing etc. but people may not realise how to use it.
This should be added to the project documentation
2020-01-04
1.7.0
3.7
Ubuntu 18.04
This is minor, and maybe intentional, but in your README.rst
it credits the original author instead of your fork. Perhaps both should be mentioned? I may also comment on this issue as time goes on if I find any other inconsistencies that you might have overlooked.
Let me know if this is not helpful. My intent is to be helpful and give credit where credit is due. Like what I see so far.
Ran cookiecutter
As little as I like running after the new hotness, I suspect that Poetry is replacing pipenv as the defacto package manager for python.
It recently released a stable 1.0 version, and seems to be well liked by the hackernews hivemind.
Something to consider maybe
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.