File: faq.rst

package info (click to toggle)
django-environ 0.12.0-1.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 516 kB
  • sloc: python: 2,434; makefile: 171
file content (45 lines) | stat: -rw-r--r-- 1,780 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
===
FAQ
===


#. **Can django-environ determine the location of .env file automatically?**

   django-environ will try to get and read ``.env`` file from the project
   root if you haven't specified the path for it when call :meth:`.environ.Env.read_env`.
   However, this is not the recommended way. When it is possible always specify
   the path tho ``.env`` file. Alternatively, you can use a trick with a
   environment variable pointing to the actual location of ``.env`` file.
   For details see ":ref:`multiple-env-files-label`".

#. **What (where) is the root part of the project, is it part of the project where are settings?**

   Where your ``manage.py`` file is (that is your project root directory).

#. **What kind of file should .env be?**

   ``.env`` is a plain text file.

#. **Should name of the file be simply .env (or something.env)?**

   Just ``.env``. However, this is not a strict rule, but just a common
   practice. Formally, you can use any filename.

#. **Is .env file going to be imported in settings file?**

   No need to import, django-environ automatically picks variables
   from there.

#. **Should I commit my .env file?**

   Credentials should only be accessible on the machines that need access to them.
   Never commit sensitive information to a repository that is not needed by every
   development machine and server.

#. **Why is it not overriding existing environment variables?**

   By default, django-environ won't overwrite existing environment variables as
   it assumes the deployment environment has more knowledge about configuration
   than the application does. To overwrite existing environment variables you can
   pass ``overwrite=True`` to :meth:`.environ.Env.read_env`. For more see
   ":ref:`overwriting-existing-env`"