1
0
mirror of https://github.com/krateng/maloja.git synced 2023-08-10 21:12:55 +03:00
maloja/DEVELOPMENT.md

59 lines
1.3 KiB
Markdown
Raw Normal View History

# Development
Clone the repository and enter it.
```console
git clone https://github.com/krateng/maloja
cd maloja
```
## Environment
To avoid cluttering your system, consider using a [virtual environment](https://docs.python.org/3/tutorial/venv.html).
2022-03-10 23:45:56 +03:00
Your system needs several packages installed. For supported distributions, this can be done with e.g.
2021-12-22 00:39:07 +03:00
```console
2022-03-10 23:45:56 +03:00
sh ./install/install_dependencies_alpine.sh
```
2021-12-22 00:39:07 +03:00
For other distros, try to find the equivalents of the packages listed or simply check your error output.
Then install all Python dependencies with
```console
pip install -r requirements.txt
```
## Running the server
2021-12-22 00:13:27 +03:00
For development, you might not want to install maloja files all over your filesystem. Use the environment variable `MALOJA_DATA_DIRECTORY` to force all user files into one central directory - this way, you can also quickly change between multiple configurations.
You can quickly run the server with all your local changes with
```console
python3 -m maloja run
```
You can also build the package with
```console
pip install .
```
2022-03-10 07:06:31 +03:00
## Docker
You can also always build and run the server with
```console
2022-03-24 05:38:06 +03:00
sh ./dev/run_docker.sh
2022-03-10 07:06:31 +03:00
```
This will use the directory `testdata`.
## Further help
Feel free to [ask](https://github.com/krateng/maloja/discussions) if you need some help!