netjsonconfig

Netjsonconfig is part of the OpenWISP project.

netjsonconfig is a python library that converts NetJSON DeviceConfiguration objects into real router configurations that can be installed on systems like OpenWRT, LEDE or OpenWisp Firmware.

Its main features are:

• OpenWRT / LEDE support
• OpenWisp Firmware support
• OpenVPN support
• Possibility to support more firmwares via custom backends
• Based on the NetJSON RFC
• Validation based on JSON-Schema
• Templates: store common configurations in templates
• Multiple template inheritance: reduce repetition to the minimum
• File inclusion: easy inclusion of arbitrary files in configuration packages
• Variables: reference variables in the configuration
• Command line utility: easy to use from shell scripts or from other programming languages

Contents:

• Setup
  • Install stable version from pypi
  • Install development version
  • Install git fork for contributing
• Basic concepts
  • NetJSON configuration dictionary
  • Backend
  • Schema
  • Validation
  • Template
  • Multiple template inheritance
  • Context (configuration variables)
  • Project goals
  • Support
  • License
• AirOS Backend
  • Intermediate representation
  • Flattening
  • Tools
  • Process
  • Initialization
  • Render method
  • Generate method
  • Write method
  • JSON method
  • Extending the backend
  • The configuration upgrade process
  • Converters with defaults
  • General settings
  • Network interface
  • GUI
  • Netmode
  • NTP servers
  • Radio
  • Ssh
  • Users
  • WPA2
• OpenWRT Backend
  • Initialization
  • Render method
  • Generate method
  • Write method
  • Parse method
  • JSON method
  • General settings
  • Network interfaces
  • Bridge settings
  • Wireless settings
  • Radio settings
  • Static Routes
  • Policy routing
  • Programmable switch settings
  • NTP settings
  • LED settings
  • Including custom options
  • Including custom lists
  • Including additional files
  • OpenVPN
  • All the other settings
• OpenWISP 1.x Backend
  • Generate method
  • General settings
  • Traffic Control
• OpenVPN 2.3 Backend
  • OpenVPN backend schema
  • Working around schema limitations
  • Automatic generation of clients
• Command line utility
  • Environment variables
• Running tests
  • Using runtests.py
  • Using nose
• Contributing
  • Reach out before you start
  • Create a virtual environment
  • Fork repo and install your fork
  • Ensure test coverage does not decrease
  • Follow style conventions (PEP8, isort)
  • Update the documentation
  • Send pull request
• Motivations and Goals
  • Motivations
  • Goals
• Change log
  • Version 0.6.2 [2017-08-29]
  • Version 0.6.1 [2017-07-05]
  • Version 0.6.0 [2017-06-01]
  • Version 0.5.6 [2017-05-24]
  • Version 0.5.5.post1 [2017-04-18]
  • Version 0.5.5 [2017-03-15]
  • Version 0.5.4.post1 [2017-03-07]
  • Version 0.5.4 [2017-02-14]
  • Version 0.5.3 [2017-01-17]
  • Version 0.5.2 [2016-12-29]
  • Version 0.5.1 [2016-09-22]
  • Version 0.5.0 [2016-09-19]
  • Version 0.4.5 [2016-09-05]
  • Version 0.4.4 [2016-06-27]
  • Version 0.4.3 [2016-04-23]
  • Version 0.4.2 [2016-04-11]
  • Version 0.4.1 [2016-04-04]
  • Version 0.4.0 [2016-03-22]
  • Version 0.3.7 [2016-02-19]
  • Version 0.3.6 [2016-02-17]
  • Version 0.3.5 [2016-02-10]
  • Version 0.3.4 [2016-01-14]
  • Version 0.3.3 [2015-12-18]
  • Version 0.3.2 [2015-12-11]
  • Version 0.3.1 [2015-12-02]
  • Version 0.3 [2015-11-30]
  • Version 0.2 [2015-11-23]
  • Version 0.1 [2015-10-20]

Indices and tables

• Index
• Module Index
• Search Page