Setting Up Django For Collaboration
Jimmy McBride
Posted on September 17, 2023
Here's a quick and simple tutorial on how to start a new Django project and get it ready to collaborate with others!
In this quick and easy tutorial we will:
- 1) Set up a new Django project
- 2) Use pipenv for dependency management
- 3) Upload our project to GitHub
Prerequisites
You're computer most like already has python installed. You can check by running python --version
or python3 --version
. If it's not installed, download the latest version of python 3.x.
Once you have ensured python is installed, we just need to install 2 global dependencies. Run pip install django pipenv
. Now we are ready to go! If you want to know more, feel free to check out the docs for django and pipenv as well!
Create Django Project
This step is easy enough! All we need to do is run this command in the folder where we want to create our Django project inside of: django-admin startproject my_project_name
Note that -
's will not work here. Our project name must be in snake_case (like most things in python). This will create a new folder, in our cases, named my_project_name
.
We can cd inside or open our project up in our favorite IDE (Pycharm for the win!). And there we have it! Our Django project is set up and ready to go. There are a few more commands we can run to setup our project before we get started.
-
python manage.py migrate
to migrate our database schema for us. -
python manage.py createsuperuser
to create a user we can use to log into the admin panel.
Setup Pipenv
Pipenv is an amazing tool we can use to setup version control. This allows us to easily save our python dependency versions so that others can others can clone our project and create an environment that downloads the same versions on dependencies we use so that nobody's project breaks because decency versions are out of sync.
-
pipenv --python 3.X
replace x with the specific version, like 3.11 for example. -
pipenv shell
to activate the environment. -
pipenv install django
because while Django is installed globally, it is not installed in our fresh pipenv environment.
Push Project to GitHub
Create a totally blank repository on GitHub with the same name as the project you created and copy the ssh url for it (unless your on windows, then do https). If you need help setting up ssh, GitHub has great documentation on how to set it up!
The blank repository will have all the docs you need to push your project up to GitHub, and now you're all set! You project is not only visible to the world, but anybody can download your project and use pipenv to install the right dependencies from your Pipfile.lock with pipenv sync
Conclusion
If you enjoyed this content and want to see more Django tutorials like, comment and subscribe to let me know you want more!
Posted on September 17, 2023
Join Our Newsletter. No Spam, Only the good stuff.
Sign up to receive the latest update from our blog.