Skip to main content

Network Source of Truth (IP Address Management).

Project description

# nsot

[![Build Status](](
[![Documentation Status](](

## Warning

This project is still very much in flux and likely to have database changes without
migration support for the time being. Also some documentation may describe steps not yet possible.

### Description

NSoT is a Network Source of Truth API and FE for managing Network Assets.

Currently only IP Address Management is on the road-map but it will evolve
into more over time.

### Installation

New versions will be updated to PyPI pretty regularly so it should be as easy

$ pip install nsot

### Documentation

The latest documentation will always be available at

### Development

I suggest setting up your test environment in a virtual environment. If you use
virtualenvwrapper you can just do

$ mkvirtualenv nsot

After that, clone the repo into whichever directory you use for development
and install the dependencies.

$ git clone
$ cd nsot
$ pip install -r requirements-dev.txt
$ python develop
#### Running Tests
All tests will automatically be run on Travis CI when pull requests are sent.
However, it's beneficial to run the tests often during development.

py.test -v tests/

#### Running a Test instance

NSoT runs behind a reverse proxy that handles Authentication and so expects
a valid, authenticated, user account. I've included a test proxy for running
on development instances.


# Initialize the config
nsot-server init

# Setup the database.
nsot-server upgrade

# Run the development reverse proxy
nsot-server user_proxy

# Run the frontend server
nsot-server start


#### Working with migrations

If you make any changes to the models you'll want to generate a new migration.
We use alembic for migrations underneath but for general schema changes is
should be sufficient to just run


nsot-server makemigrations api


This will generate a new schema version. You can then sync to the latest version


nsot-server migrate


#### Working with docs

Documentation is done with Sphinx. If you just want to build and view the docs you
cd into the `docs` directory and run `make html`. Then point your browser to
`docs/\_build/html/index.html` on your local filesystem.

If you're actively modifying the docs it's useful to run the autobuild server like

sphinx-autobuild docs docs/_build/html/

This will start a server listening on a port that you can browse to and will
be automatically reloaded when you change any rst files. One downside of this
approach is that is doesn't refresh when docstrings are modified.

#### Managing frontend dependencies

Frontend dependencies are managed through `bower`, however to ensure we always have
a consistent build we checkin the dependencies. We make use of `bower-installer` to
limit the depencies down to their core components to avoid checking in various
README, src, or build artifact files.

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

nsot-0.7.4.tar.gz (881.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page