Re: Preferred virtualenv layout for Django projects

On Thu, Oct 17, 2013 at 4:26 PM, Tim Chase
<django.users@tim.thechases.com> wrote:
> How do folks prefer to layout their Django projects when using
> virtualenv? Do you do either of the following, or something else?
>
> Method 1: (project & apps at same level)
>
> ~/tmp$ virtualenv my_proj
> ~/tmp$ cd my_proj
> ~/tmp/my_proj$ . bin/activate
> (my_proj)~/tmp/my_proj$ pip install django # ...
> (my_proj)~/tmp/my_proj$ django-admin.py startproject my_project
> (my_proj)~/tmp/my_proj$ django-admin.py startapp my_app1
> (my_proj)~/tmp/my_proj$ # run/test from virtenv root
>
> Method 2: (apps within project)
>
> ~/tmp$ virtualenv my_proj
> ~/tmp$ cd my_proj
> ~/tmp/my_proj$ . bin/activate
> (my_proj)~/tmp/my_proj$ pip install django # ...
> (my_proj)~/tmp/my_proj$ django-admin.py startproject my_project
> (my_proj)~/tmp/my_proj$ cd my_project
> (my_proj)~/tmp/my_proj/my_project$ ./manage.py startapp my_app1
> (my_proj)~/tmp/my_proj/my_project$ # run/test from proj root
>
> Do you have to jockey the $PYTHONPATH to find apps in either case?
> If so, how do you make this portable/versioned (modify the
> virtualenv scripts and add them to $VCS? have a custom script and put
> that in $VCS?)
>
> Which bits do you include/exclude when using version-control?
>
> Do you keep your requirements.txt for pip at the top level virtualenv
> directory, or inside the project folder (or elsewhere)?
>
> I've seen a couple blog-posts that advocate "use virtualenv" but most
> seem to elide the best-practice details.
>
> Any tips appreciated.
>
> -tkc

This is the layout I prefer these days:

the_project_name
├── activate -> project_env/bin/activate
├── bootstrap
├── logs
│ ├── project.debug.log
│ └── project.log
├── project_env
│ ├── bin
│ ├── lib
│ └── src
├── requirements.txt
├── run
│ └── app.pid
└── the_project_name
├── app1
│ └── views.py
├── app2
│ └── views.py
├── app3
│ └── views.py
├── manage.py
└── project
├── default_settings.py
├── routers.py
├── settings.py.example
└── urls.py

The top level directory is named after the project, and contains the
project code, and placeholder folders for the environment, for log
files, for temporary 'run' files like pidfiles, the requirements.txt
for pip, a bootstrap script which creates the virtualenv and installs
necessary packages.

The project code directory is also named for the project (in fact,
it's name is entirely irrelevant, it is only used to specify the path
to manage.py). It has manage.py, the apps that are part of the project
(as opposed to standalone apps used in the project), and the project
directory.

The project directory contains the default_settings.py and
settings.py, routers.py (if needed) and the top level project urls.py.
In settings, we refer to 'app1', 'app2' and so on, not
'the_project_name.app1', the routers would be specified as
'project.routers.YourRouterName', and the ROOT_URLCONF as
'project.urls'.

Everything is checked in to version control, but with ignores to
exclude the venv, log and run folders etc. We deploy with cfengine,
which checks out the repo where it should, checks out the settings.py
from a separate configuration repository, runs bootstrap and starts
the service.

Since the only way to modify the running project is via checking
things in to a repository and requesting a re-deploy, this ensures
that running code is reproducible - a developer can easily recreate
the live environment in their dev site - and repeatable.

When we deploy updates, we first make one backend inactive in haproxy,
wait for existing requests on that server to be completed, and then
re-deploy, re-enabling it in haproxy afterwards. This ensures updates
never cause a client request to be terminated.

Hope that is useful.

Cheers

Tom

--
You received this message because you are subscribed to the Google Groups "Django users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to django-users+unsubscribe@googlegroups.com.
To post to this group, send email to django-users@googlegroups.com.
Visit this group at http://groups.google.com/group/django-users.
To view this discussion on the web visit https://groups.google.com/d/msgid/django-users/CAFHbX1Jrk98D-xdrNyYikJo-0qX2kbQmKPxSkmwaGUBsJpvFzw%40mail.gmail.com.
For more options, visit https://groups.google.com/groups/opt_out.