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.6.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d9f9ba33617afff75ef99013cea95fc62b696fdcd60eb3ab8b4c28ead5243e68 |
|
MD5 | ade80d65f849abbbc3f99197023c38b0 |
|
BLAKE2b-256 | d823080176d5dd682fa29128dd513b5d0b9dc3a216e056dee9a9c0de3cfaa245 |
Hashes for the_well_maintained_test-0.6.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6d8db258d273f66e54bc321eee668f68ee64d7126f24906f1d6f21fe6efd4d5b |
|
MD5 | 8b2d38e22e595bcba414fc6f118e41f1 |
|
BLAKE2b-256 | e8ed4aa529a863e1ab9e5da15d346f3f944154ebcd611c4446f2da759eb737b7 |