Django reusable app that provides an admin interface to a freeradius database
Project description
TODO:
Current features
TODO
Project goals
TODO
Install stable version from pypi
Install from pypi:
pip install django-freeradius
Install development version
Install tarball:
pip install https://github.com/openwisp/django-freeradius/tarball/master
Alternatively you can install via pip using git:
pip install -e git+git://github.com/openwisp/django-freeradius#egg=django-freeradius
If you want to contribute, install your cloned fork:
git clone git@github.com:<your_fork>/django-freeradius.git
cd django-freeradius
python setup.py develop
Setup (integrate in an existing django project)
Add django_freeradius to INSTALLED_APPS:
INSTALLED_APPS = [
# other apps
'django_freeradius',
]
Add the URLs to your main urls.py:
urlpatterns = [
# ... other urls in your project ...
# django-freeradius urls
# keep the namespace argument unchanged
url(r'^', include('django_freeradius.urls', namespace='freeradius')),
]
Then run:
./manage.py migrate
Installing for development
Install sqlite:
sudo apt-get install sqlite3 libsqlite3-dev
Install your forked repo:
git clone git://github.com/<your_fork>/django-freeradius
cd django-freeradius/
python setup.py develop
Install test requirements:
pip install -r requirements-test.txt
Create database:
cd tests/
./manage.py migrate
./manage.py createsuperuser
Launch development server:
./manage.py runserver
You can access the admin interface at http://127.0.0.1:8000/admin/.
Run tests with:
./runtests.py
Settings
TODO
Extending django-freeradius
django-freeradius provides a set of models and admin classes which can be imported, extended and reused by third party apps.
To extend django-freeradius, you MUST NOT add it to settings.INSTALLED_APPS, but you must create your own app (which goes into settings.INSTALLED_APPS), import the base classes from django-freeradius and add your customizations.
Extending models
This example provides an example of how to extend the base models of django-freeradius by adding a relation to another django model named Organization.
# TODO
Extending the admin
Following the previous Organization example, you can avoid duplicating the admin code by importing the base admin classes and registering your models with.
# TODO
Contributing
Announce your intentions in the OpenWISP Mailing List
Fork this repo and install it
Write code
Write tests for your code
Ensure all tests pass
Ensure test coverage does not decrease
Document your changes
Send pull request
Changelog
See CHANGES.
License
See LICENSE.
Support
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-freeradius-0.1.alpha.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3cc78f3bb5982d385309005eaca9ac5a557e1027231e28f07c02203333f013da |
|
MD5 | 6a0ba28e4c5fbc15529282c39352b76b |
|
BLAKE2b-256 | fc4ec362eb6669613fd1327bcd652095cc88792f63d9292f3e04a35e4f9a52b7 |
Hashes for django_freeradius-0.1a0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ee90cbdb8e08a69049d4a89fbb0ad682da5b1b97d573b3ffb5e3679e71ceee70 |
|
MD5 | 43d5aee83510298114e7b94c1c0839e3 |
|
BLAKE2b-256 | 8055a69dfaac284caeabe19f94c2bfb771853b9fe6bb9388beabab4974640a38 |