django.social
Website for https://django.social project.
Running in development mode
Pre-commit (git hooks)
To help ensure code quality and standards, like many projects, there is a pre-commit config to run tools like black and ruff
To install the Pre-Commit framework, you may wish to read the installation docs.
It's available via pip:
python -m pip install pre-commit
Or homebrew:
brew install pre-commit
Once you've installed pre-commit run
pre-commit install
Now, once you come to commit, the project's hooks will be ran automatically.
Python dependencies
Project dependencies are managed and maintained using pip-tools.
The core dependencies of the project can be found in django/requirements.in
and requirements.txt
is generated by running pip-compile
available via the do.sh
script. More on this below.
Using Docker Compose
The easiest way to run the development server is to use Docker Compose. This presumes you have Docker and Docker compose installed. Please refer to the Docker installation instructions or your operating system's documentation for details. I would recommend installing Docker Engine rather than Docker Desktop.
First, clone the repository:
git clone ...
cd djangosocial/
Copy the Docker Override file into the project's root directory:
cp -iv dev-templates/docker-compose.override.yml.tpl ./docker-compose.override.yml
Edit the file if needed, then you need to build the containers and run them.
You can do this manually:
docker compose up --build
# Note: if you have an older version of Docker, you may instead need to use:
docker-compose up --build
The server should now be running at http://localhost:8000, or whichever port you defined.
Alternatively there is a bash script to aid development, do.sh
.
The useful parts of the script to get going are:
do.sh build
- runs docker compose builddo.sh start
- runs docker compose updo.sh migrate
- runs django migrationsdo.sh shell
- starts a bash prompt in the app
Running commands inside the python container
You can now run commands inside the python container by running:
./do.sh shell
This will give you access to the bash
shell inside the container where you may run Django commands like:
python manage.py createsuperuser # to create and admin account
python manage.py makemigrations # to run migrations
python manage.py migrate # to apply migrations
python manage.py shell # to access the Django shell
Utility functions from the bash script
do.sh check
- run django's check command in the containerdo.sh djshell
- run django's shell command in the containerdo.sh migrate
- run makemigrations from within the containerdo.sh makemigrations
- run makemigrations from within the containerdo.sh pip-compile
- compile the requirements from within the containerdo.sh pip-upgrade
- compile the requirements with the upgrade flag
Using a virtual environment
This section is a work in progress (and I haven't had time to test it properly yet), but you should be able to run this project inside a virtual environment like most Django projects. The general idea should be:
- Install and configure PostgreSQL.
- Clone the repository.
- Create a virtual environment.
- Activate the virtual environment.
- Install dependencies.
- Set environment variables.
- Run the development server inside the virtual environment.
TODO: Figure out if this causes conflicts with the media and static files, though urls.py
should include a hack to avoid this.
Running on Windows
TODO.
Contributing
See the CONTRIBUTING.md file for details.