https://github.com/hypothesis/test-pyapp
A test app for our pyapp cookiecutter.
https://github.com/hypothesis/test-pyapp
Last synced: 11 months ago
JSON representation
A test app for our pyapp cookiecutter.
- Host: GitHub
- URL: https://github.com/hypothesis/test-pyapp
- Owner: hypothesis
- License: bsd-2-clause
- Created: 2022-11-14T13:39:57.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-08-06T08:52:38.000Z (11 months ago)
- Last Synced: 2025-08-06T10:31:37.326Z (11 months ago)
- Language: Python
- Homepage:
- Size: 200 KB
- Stars: 0
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Python App Cookiecutter Test
A test app for our pyapp cookiecutter.
## Setting up Your Python App Cookiecutter Test Development Environment
First you'll need to install:
* [Git](https://git-scm.com/).
On Ubuntu: `sudo apt install git`, on macOS: `brew install git`.
* [GNU Make](https://www.gnu.org/software/make/).
This is probably already installed, run `make --version` to check.
* [pyenv](https://github.com/pyenv/pyenv).
Follow the instructions in pyenv's README to install it.
The **Homebrew** method works best on macOS.
The **Basic GitHub Checkout** method works best on Ubuntu.
You _don't_ need to set up pyenv's shell integration ("shims"), you can
[use pyenv without shims](https://github.com/pyenv/pyenv#using-pyenv-without-shims).
* [Docker Desktop](https://www.docker.com/products/docker-desktop/).
On Ubuntu follow [Install on Ubuntu](https://docs.docker.com/desktop/install/ubuntu/).
On macOS follow [Install on Mac](https://docs.docker.com/desktop/install/mac-install/).
Then to set up your development environment:
```terminal
git clone https://github.com/hypothesis/test-pyapp.git
cd test-pyapp
make services
make help
```
## Changing the Project's Python Version
To change what version of Python the project uses:
1. Change the Python version in the
[cookiecutter.json](.cookiecutter/cookiecutter.json) file. For example:
```json
"python_version": "3.10.4",
```
2. Re-run the cookiecutter template:
```terminal
make template
```
3. Re-compile the `requirements/*.txt` files.
This is necessary because the same `requirements/*.in` file can compile to
different `requirements/*.txt` files in different versions of Python:
```terminal
make requirements
```
4. Commit everything to git and send a pull request
## Changing the Project's Python Dependencies
### To Add a New Dependency
Add the package to the appropriate [`requirements/*.in`](requirements/)
file(s) and then run:
```terminal
make requirements
```
### To Remove a Dependency
Remove the package from the appropriate [`requirements/*.in`](requirements)
file(s) and then run:
```terminal
make requirements
```
### To Upgrade or Downgrade a Dependency
We rely on [Dependabot](https://github.com/dependabot) to keep all our
dependencies up to date by sending automated pull requests to all our repos.
But if you need to upgrade or downgrade a package manually you can do that
locally.
To upgrade a package to the latest version in all `requirements/*.txt` files:
```terminal
make requirements --always-make args='--upgrade-package '
```
To upgrade or downgrade a package to a specific version:
```terminal
make requirements --always-make args='--upgrade-package =='
```
To upgrade **all** packages to their latest versions:
```terminal
make requirements --always-make args=--upgrade
```