Programatically tries to answer the 12 questions from Adam Johnson's blog post https://adamj.eu/tech/2021/11/04/the-well-maintained-test/
Project description
the-well-maintained-test
Programatically tries to answer the 12 questions from Adam Johnson's blog post
Installation
Install this tool using pip
:
$ pip install the-well-maintained-test
Authentication
The GitHub API will rate limit anonymous calls. You can authenticate yourself with a personal token (documentation on how to generate is here)
Run this command and paste in your new token:
the-well-maintained-test auth
This will create a file called auth.json in your current directory containing the required value. To save the file at a different path or filename, use the --auth=myauth.json
option.
Usage
Usage: the-well-maintained-test [OPTIONS] COMMAND [ARGS]...
Programatically tries to answer the 12 questions from Adam Johnson's
blog post https://adamj.eu/tech/2021/11/04/the-well-maintained-test/ URL is
a url to a github repository you'd like to check, for example: the-well-
maintained-test 'https://github.com/ryancheley/the-well-maintained-test'
Options:
--version Show the version and exit.
--help Show this message and exit.
Commands:
auth Save authentication credentials to a JSON file
questions List of questions tested
requirements Loop over a requirements.txt file
url url to a github repository you'd like to check
URL is a url to a github repository you'd like to check, for example:
the-well-maintained-test url 'https://github.com/ryancheley/the-well-maintained-test'
If you want to see what questions will be answered before running you you can pass
the-well-maintained-test questions
If you want to see a single question
the-well-maintained-test questions -q 3
Development
To contribute to this tool, first checkout the code. Then create a new virtual environment:
cd the-well-maintained-test
python -m venv venv
source venv/bin/activate
Or if you are using pipenv
:
pipenv shell
Now install the dependencies and test dependencies:
pip install -e '.[test]'
To run the tests:
just test
To run mypy
command you'll need to run
mypy --install-types
Then, to run mypy:
just mypy
You can also do a pre-commit check on the files by running
just check
This will run several pre-commit hooks, but before that it will run mypy
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for the-well-maintained-test-0.7.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9953f40408c31a7b46c77ffed77657aae0c4cf001c6b7e275631631da2b5b65a |
|
MD5 | 3abde66d184607e44ee2146141ab75e3 |
|
BLAKE2b-256 | cc124a2874e26afae8ca730e89176707d0232b7121873345c48c5754597ef59d |
Hashes for the_well_maintained_test-0.7.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7118148e2099bb36f600555df292072e1fee9bc4b16c63c5bb0330405740a572 |
|
MD5 | d671138e278cf95b1b84d98fbbec581e |
|
BLAKE2b-256 | c65ed86d6ded65234fc6f377ce0131f4c23afb2887935695b530913a5d77a27a |