Add a few more release bits
This commit is contained in:
parent
0c8897a2b5
commit
4c00e11d63
3
CHANGELOG.md
Normal file
3
CHANGELOG.md
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
## 0.3.0 (2022-11-24)
|
||||||
|
|
||||||
|
Initial release!
|
@ -1,65 +0,0 @@
|
|||||||
# Contributing to Takahē
|
|
||||||
|
|
||||||
## Getting Started
|
|
||||||
|
|
||||||
Development can be done "bare metal" or with Docker. We'll describe both here.
|
|
||||||
|
|
||||||
|
|
||||||
### Bare Metal
|
|
||||||
|
|
||||||
Takahē requires Python 3.10 or above, so you'll need that first. Then, create and
|
|
||||||
activate a virtual environment:
|
|
||||||
|
|
||||||
```shell
|
|
||||||
$ python3 -m venv .venv
|
|
||||||
$ . .venv/bin/activate
|
|
||||||
```
|
|
||||||
|
|
||||||
You can install the development requirements:
|
|
||||||
|
|
||||||
```shell
|
|
||||||
$ pip install -r requirements-dev.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
...and enable git commit hooks if you like:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ pre-commit install
|
|
||||||
```
|
|
||||||
|
|
||||||
Finally, you can run the tests with PyTest:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ pytest
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
### Docker
|
|
||||||
|
|
||||||
The docker build process will take care of much of the above, but you just have
|
|
||||||
to be sure that you're executing it from the project root.
|
|
||||||
|
|
||||||
First, you need to build your image:
|
|
||||||
|
|
||||||
```shell
|
|
||||||
$ docker build -f ./docker/Dockerfile -t "takahe:latest" .
|
|
||||||
```
|
|
||||||
|
|
||||||
Then start the `compose` session:
|
|
||||||
|
|
||||||
```shell
|
|
||||||
$ docker compose -f docker/docker-compose.yml up
|
|
||||||
```
|
|
||||||
|
|
||||||
Once your session is up and running, you can run the tests inside your
|
|
||||||
container:
|
|
||||||
|
|
||||||
```shell
|
|
||||||
$ docker compose -f docker/docker-compose.yml exec web pytest
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
# Code of Conduct
|
|
||||||
|
|
||||||
As a contributor, you can help us keep the Takahē community open and inclusive. Takahē
|
|
||||||
follows the [Django Project Code of Conduct](https://www.djangoproject.com/conduct/).
|
|
@ -37,7 +37,7 @@ Stator runner.
|
|||||||
What To Run
|
What To Run
|
||||||
-----------
|
-----------
|
||||||
|
|
||||||
You need to run at least two copies of the Docker image:
|
You need to run at least two copies of the `Docker image <https://hub.docker.com/r/jointakahe/takahe>`_:
|
||||||
|
|
||||||
* One with no command or arguments specified, which will serve web traffic
|
* One with no command or arguments specified, which will serve web traffic
|
||||||
* One with the arguments (command) ``python manage.py runstator``, which will
|
* One with the arguments (command) ``python manage.py runstator``, which will
|
||||||
@ -48,6 +48,12 @@ Both of these can have as many copies run as needed. Note that the image has
|
|||||||
required environment variables before it will boot, and this is the only way
|
required environment variables before it will boot, and this is the only way
|
||||||
to configure it - see below.
|
to configure it - see below.
|
||||||
|
|
||||||
|
While you can run Takahē directly from a checkout if you like, we're not
|
||||||
|
officially supporting that right now, as it increases our support burden by
|
||||||
|
having to deal with lots of OS and library versions. It's a standard Django
|
||||||
|
app, though, so if you know what you're doing, have at it - just expect us to
|
||||||
|
push back if you file tickets about things not working on your OS!
|
||||||
|
|
||||||
|
|
||||||
Environment Variables
|
Environment Variables
|
||||||
---------------------
|
---------------------
|
||||||
|
Reference in New Issue
Block a user