djangonix/README.md

# Djangonix ❄️

Nix expression to declaratively deploy django applications.

## How it works

The main issue for deploying declarative django applications is the pass secrets to the settings.

This opinionated module tackles this issue by building an ad-hox settings
module that re-exports the settings.py from the app and overrides some settings
using the [loadcredential python module](https://github.com/Tom-Hubrecht/loadcredential).
The settings to be overriden are provided by the user through the module.

With this you should be able to deploy almost any django application without any
modification of the `settings.py` file.

## Exemple

```
TODO
```

## Testing
```
nix-build test.nix
```

## TODO

- Hardening
- Add a logic to change `INSTALLED_APPS` and `MIDDLEWARE` easily (the idea is to be able to remove developpement apps at no cost)
- Add test case for runtimeSettings (it is probably broken for now)
- Add test case for static assets
- Remove all TODOs