Nsot

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

* Upgrade Django v1.11.11, djangorestframework to v3.7.7
* Remove django-smart-selects, which is no longer necessary

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

* Introducing the ``Protocol`` resource object which can be used to model
protocol sessions of various types, such as BGP, IS-IS, or more.

+ The type for a Protocol is defined using a ``ProtocolType`` object which
has optional required attributes that can be used to establish Protocol
attributes required when creating a new session of this type.
+ A Protocol may be bound to a ``Circuit`` or an ``Interface`` (but not both).

* Fix 267: The ``/users`` page in the web UI has been disabled and removed
from the menu until an actual view can be created. This was causing
confusion, especially amongst new users.
* Fix 298: Circuits can now be filtered by the A/Z endpoint interface slug
(aka natural key) or ID number.
* Fix 307: Fix Vagrant setup issues related to the upstream security changes
to PyPI causing the Vagrant install to fail.

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

* Enhance Network "get_next" methods to optionally allocate/reserve at the same
time

+ Users can send a POST request to ``next_network`` and ``next_address``
actions. If it is a POST request then the action will get the networks or
addresses and then save them as Network objects in the database as
``allocated``. If the user sends the ``reserve`` flag and sets it as True,
then it will be saved in the ``reserved`` state instead of ``allocated``.

* Fixed a bug in the web UI for interface creation where a Device query would
return a list instead of an object.
* Sped up ``Interface.networks()`` for MySQL users by splitting a subquery up
into two separate queries.

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

* Support for object-level permissions have been implemented using the
``django-guardian`` plugin. For tree objects (currently ``Interface`` and
``Network`` objects) that can have children and ancestors, the permissions
will be inherited by child nodes *unless a more specific permission has been
set on the child object*.
* Object-level permissions may be managed using the built-in admin dashboard.

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

.. important::
Users who previously updated to NSoT v1.2.0 will have a new database
data migration applied to correct the bug in the previous data migration.
Users upgrading from pre-1.2.0 to 1.2.1 will not affected by this fix and
the correct data migration will only be applied once.

* Fixed a bug in the data migration for the newly-added ``Interface.name_slug``
field that would cause interfaces with ``/`` in their name to have their name
slug incorrectly "slugified". A new data migration has been added to correct
this.
* Fixed a bug that was occuring with model permissions enabled causing
404 errors to be returned as 500 errors in specific cases. The 404
handler has been changed to only check authenticated state and not
model permisisons.

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

* Fix 262: Natural keys can now be used any place a primary key could be used for
related fields on Interfaces and Circuits.

+ For Circuits, the default is now to display the A/Z endpoint interfaces by
their natural key (e.g. ``device_hostname:name`` format).
+ For Interfaces, the Device hostname may now be used to create or retrieve
interfaces (no more need to lookup the Device ID first)
+ Interface now has a ``name_slug`` field that can be used for natural key
lookups. This is now also officially the natural key field.
+ Network now has a ``cidr`` field that can be used for displaying the
``network_address/prefix_length`` without additional effort
+ Network now has a ``parent`` field that can be used for displaying the parent
CIDR without an additional lookup

* All underlying serializer code has been streamlined to reduce code
duplication where possible.
* All "update" serializers have been moved to subclasses of "partial update"
serializers with extra required fields specified as "extra kwargs" vs.
re-defining the fields.
* The fields for ``site_id`` and ``attributes`` have been moved to the base
``ResourceSerializer`` since ALL resources inherit these anyways.
* Bugfix in ``NsotSerializer`` when ``view`` isn't part of the context that caused
a crash.
* Util stats functions can now be directly imported from ``nsot.util``