syntax: glob

*.pyc

*~

testproject/testproject.db

testproject/south

docs/_build

tmp/

dist/

django_conntrackt.egg-info/

projtect/.coverage

#

# Copyright (C) 2013 Branko Majic

#

# This file is part of Django Conntrackt.

#

# Django Conntrackt is free software: you can redistribute it and/or modify it

# under the terms of the GNU General Public License as published by the Free

# Software Foundation, either version 3 of the License, or (at your option) any

# later version.

#

# Django Conntrackt is distributed in the hope that it will be useful, but

# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more

# details.

#

# You should have received a copy of the GNU General Public License along with

# Django Conntrackt.  If not, see <http://www.gnu.org/licenses/>.

#

include LICENSE-GPLv3

include LICENSE-CC-BY-SA-3.0-Unported

include MANIFEST.in

include README.rst

recursive-include conntrackt/static *

recursive-include conntrackt/templates *

recursive-include docs *

recursive-include requirements *

recursive-exclude * *.py[co]

Conntrackt development, including instructions on how to get started,

procedures, and common tools.

Instructions are primarily aimed at use of Debian Stretch (as of time

of this writing). If you are running a different distribution or OS,

you will need to modify the instructions to suit your environment.

Preparing development environment

---------------------------------

Perform the following steps in order to prepare development

environment:

1. Ensure that the following system packages are available on the

   system:

   - `Python 2.7.x <https://www.python.org/>`_

   - `Graphviz <https://graphviz.org/>`_

   - `virtualenv <https://pypi.python.org/pypi/virtualenv>`_

   - `virtualenvwrapper

     <https://virtualenvwrapper.readthedocs.io/en/latest/>`_

   Under Debian GNU/Linux it should be easy to install all the

   necessary dependencies with command (provided you have sudo set-up,

   otherwise run command as ``root`` without ``sudo``):

   .. warning::

      Don't forget to start a new shell in order to be able to use the

      virtualenvwrapper.

   ::

     sudo apt-get install python2.7 graphviz mercurial virtualenv virtualenvwrapper

2. Clone the application repository::

     mkdir ~/projects/

     hg clone https://code.majic.rs/conntrackt/ ~/projects/conntrackt

3. Set-up a new virtual environment::

     mkvirtualenv -a ~/projects/conntrackt/ conntrackt

4. Install required packages in the virtual environment::

     workon conntrackt && pip install -r ~/projects/conntrackt/requirements/development.txt

Development/test Django project

-------------------------------

*Django Contrackt* comes with a test Djanbo project which can be used

out-of-the-box once database has been initialised.

Once the development environment has been set-up, you can set-up its

database with::

  workon conntrackt

  cd testproject/

  ./manage.py syncdb

  ./manage.py migrate

Once the database has been set-up, run the development server with::

  workon conntrackt

  cd testproject/

  ./manage.py runserver

To access the application via started development server, simply point

your browser to http://localhost:8000/conntrackt/ .

Running tests

-------------

The application is well covered with various (primarily unit) tests,

and the tests can be easily run via the supplied test/development

projects. Once the development environment has been set-up, tests can

be easily run with::

  workon conntrackt

  cd ~/projects/conntrackt/testproject/

  ./manage.py test conntrackt

Keeping installation and development requirements up-to-date

------------------------------------------------------------

There are two different types of (``pip``) requirements to keep in

mind while developing the application:

- Package installation requirements, specified in ``setup.py``.

- Development requirements, maintained in dedicated requiremnts files.

Distinction exists in order to allow faster start-up with the

#

# Copyright (C) 2017 Branko Majic

#

# This file is part of Django Conntrackt.

#

# Django Conntrackt is free software: you can redistribute it and/or modify it

# under the terms of the GNU General Public License as published by the Free

# Software Foundation, either version 3 of the License, or (at your option) any

# later version.

#

# Django Conntrackt is distributed in the hope that it will be useful, but

# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more

# details.

#

# You should have received a copy of the GNU General Public License along with

# Django Conntrackt.  If not, see <http://www.gnu.org/licenses/>.

#

-r base.in

# Used for generating test code coverage report.

coverage~=4.4.0

# Used for dynamic generation of fixture data in tests.

factory_boy~=2.1.0

# Used for mocking in unit tests.

mock~=1.3.0

# Used for building documentation.

sphinx~=1.6.0

# Used for handling of timezones.

#

# This file is autogenerated by pip-compile

# To update, run:

#

#    pip-compile --output-file requirements/development.txt requirements/development.in

#

alabaster==0.7.10         # via sphinx

babel==2.5.1              # via sphinx

certifi==2017.11.5        # via requests

chardet==3.0.4            # via requests

coverage==4.4.2

django-braces==1.12.0

django-crispy-forms==1.7.0

django==1.11.8

docutils==0.14            # via sphinx

factory-boy==2.1.2

funcsigs==1.0.2           # via mock

idna==2.6                 # via requests

imagesize==0.7.1          # via sphinx

jinja2==2.10              # via sphinx

markupsafe==1.0           # via jinja2

mock==1.3.0

palette==0.2

pbr==3.1.1                # via mock

pygments==2.2.0           # via sphinx

pyparsing==2.2.0          # via pydot

pytz==2017.3

requests==2.18.4          # via sphinx

six==1.11.0               # via mock, sphinx

snowballstemmer==1.2.1    # via sphinx

sphinx==1.6.5

sphinxcontrib-websupport==1.0.1  # via sphinx

typing==3.6.2             # via sphinx

urllib3==1.22             # via requests

#

# This file is autogenerated by pip-compile

# To update, run:

#

#    pip-compile --output-file requirements/test.txt requirements/test.in

#

alabaster==0.7.10         # via sphinx

babel==2.5.1              # via sphinx

certifi==2017.11.5        # via requests

chardet==3.0.4            # via requests

coverage==4.4.2

django-braces==1.12.0

django-crispy-forms==1.7.0

django==1.11.8

docutils==0.14            # via sphinx

factory-boy==2.1.2

funcsigs==1.0.2           # via mock

idna==2.6                 # via requests

imagesize==0.7.1          # via sphinx

jinja2==2.10              # via sphinx

markupsafe==1.0           # via jinja2

mock==1.3.0

palette==0.2

pbr==3.1.1                # via mock

pygments==2.2.0           # via sphinx

pyparsing==2.2.0          # via pydot

pytz==2017.3

requests==2.18.4          # via sphinx

six==1.11.0               # via mock, sphinx

snowballstemmer==1.2.1    # via sphinx

sphinx==1.6.5

sphinxcontrib-websupport==1.0.1  # via sphinx

typing==3.6.2             # via sphinx

urllib3==1.22             # via requests