Note: This repository has been used for a demonstration in a python-sevilla event. To use the bedjango starter view the BeDjango repo

BeDjango starter skeleton

An easy to use project template for Django 1.10, for more information visit our blog

Features

• 98% code coverage
• Custom theme and responsive based on bootstrap
• Usefull packages
• Default views
• User control system
• Modularity of the applications
• Application ready for intenationalization
• Python2/3 compatibility
• Different utils (Decorators, breadcrumbs..)

Prerequisites

What things you need to use this starter and how to install them:

• Git (if you are going to clone this project):

 sudo apt install git

• Pip:

 sudo apt install python-pip

• Virtualenv:

 sudo pip install virtualenv

• Python3-dev:

 sudo apt install python3-dev

How to use it

The following steps have been created based on a ubuntu 16 using python3.5. To create a new application using this starter, you must do the following steps

# Create virtualenv
virtualenv -p python3 venv

# Activate virtualenv and install Django
source venv/bin/activate
pip install django==1.10

Use django-admin to create the app using the starter
django-admin.py startproject --template=https://github.com/BeDjango/bedjango-starter/archive/master.zip --extension=py,rst,yml {{nameofproject}}

# Install requirements/dev-requirements
cd nameofproject/nameofproject
pip install -r requirements.txt
pip install -r requirements-dev.txt

# Migrate database 
python3 manage.py migrate

# Compile translations
python3 manage.py compilemessages

# To run our project:
python3 manage.py runserver

Now your app is running at localhost

Other commands

# Create superuser (Password must be at least 8 characters and contain letters, numbers and special characters !-·$%/()=?)
python3 manage.py createsuperuser

# You can create a project from a local template
git clone https://github.com/bedjango/bedjango-starter.git
django-admin.py startproject --template=bedjango-starter/project --extension=py,rst,yml {{nameofproject}}

# If we need create a new app inside our project, if we are cloned this project:
django-admin.py startapp --template=bedjango-starter/project/project_name --extension=py,rst,yml {{nameofapp}}

# If you haven't cloned this project, you must use following django command:
python3 manage.py startapp {{nameofapp}}

Testing

To run tests we must run the following command:

coverage run --source='.' manage.py test --settings base.test_settings

# To get a coverage report
coverage report -m

Packages included

• Django debug toolbar
• Django cachalot
• Material design for admin

License

This project is licensed under the MIT License