Merge branch 'release/0.4.0'

Author: btorresgil

.flake8.ini

@@ -0,0 +1,19 @@
+[flake8]
+#ignore = E501
+max-line-length = 120
+max-complexity = 20
+exclude =
+# No need to traverse our git directory
+.git,
+# There's no value in checking cache directories
+__pycache__,
+# The conf file is mostly autogenerated, ignore it
+docs/conf.py,
+# The old directory contains Flake8 2.0
+old,
+# This contains our built documentation
+build,
+# This contains builds of flake8 that we don't want to check
+dist,
+# The tox directory
+.tox

.gitignore

@@ -1,46 +1,73 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
 *.py[cod]
+*$py.class
 
 # C extensions
 *.so
 
-# Packages
-*.egg
-*.egg-info
-dist
-build
-eggs
-parts
-bin
-var
-sdist
-develop-eggs
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
 .installed.cfg
-lib
-lib64
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
 
 # Installer logs
 pip-log.txt
+pip-delete-this-directory.txt
 
 # Unit test / coverage reports
+htmlcov/
+.tox/
 .coverage
-.tox
+.coverage.*
+.cache
 nosetests.xml
-htmlcov
+coverage.xml
+*,cover
+.hypothesis/
 
 # Translations
 *.mo
+*.pot
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# IPython Notebook
+.ipynb_checkpoints
 
-# Mr Developer
-.mr.developer.cfg
-.project
-.pydevproject
+# pyenv
+.python-version
 
-# Complexity
-output/*.html
-output/*/index.html
+# dotenv
+.env
 
-# Sphinx
-docs/_build
+# virtualenv
+.venv/
+venv/
+ENV/
 
 # PyCharm / IntelliJ
 .idea

.hound.yml

@@ -0,0 +1,3 @@
+python:
+  enabled: true
+  config_file: .flake8.ini

AUTHORS.rst

@@ -30,7 +30,7 @@ is open to whoever wants to implement it.
 Implement Features
 ~~~~~~~~~~~~~~~~~~
 
-Look through the GitHub issues for features. Anything tagged with "feature"
+Look through the GitHub issues for features. Anything tagged with "enhancement"
 is open to whoever wants to implement it.
 
 Write Documentation
@@ -108,4 +108,4 @@ Tips
 
 To run a subset of tests::
 
-    $ python -m unittest tests.test_pandevice
+    $ python -m unittest tests.test_pandevice

CONTRIBUTING.rst

@@ -3,6 +3,55 @@
 History
 =======
 
+0.4.0
+-----
+
+Released: 2017-03-17
+
+Status: Alpha
+
+- Now supports PAN-OS 7.0, 7.1, and 8.0
+- Support added for the following Firewall/Panorama features:
+
+  - NAT
+  - OSPF
+  - Applications
+  - Services
+  - Interface Management Profiles
+
+- Support for some predefined objects (such as applications from content packs)
+- Convenience methods for common licensing functions
+- New introspective method to describe current state of object: about()
+
+
+Breaking-changes in this version, please update your scripts to account for the following:
+
+- `pandevice()` method changed to `nearest_pandevice()`
+- Arguments of `refresh()` method are in a different order for better consistency
+
+
+Full list of new PanObjects:
+
+- NatRule
+- ServiceObject
+- ServiceGroup
+- ApplicationObject
+- ApplicationGroup
+- ApplicationFilter
+- ApplicationContainer
+- RedistributionProfile
+- Ospf
+- OspfArea
+- OspfRange
+- OspfNssaExternalRange
+- OspfAreaInterface
+- OspfNeighbor
+- OspfAuthProfile
+- OspfAuthProfileMd5
+- OspfExportRules
+- ManagementProfile
+
+
 0.3.5
 -----
 

HISTORY.rst

@@ -1,18 +1,15 @@
-The Palo Alto Networks Device Framework (pandevice) is distributed
-under the ICS License:
+Distributed under ISC license:
 
-http://opensource.org/licenses/ISC
-
-Copyright (c) 2014, Palo Alto Networks
+Copyright (c) 2014-2016, Palo Alto Networks Inc.
 
 Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above
 copyright notice and this permission notice appear in all copies.
 
 THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
+OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
+CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

LICENSE

@@ -7,8 +7,9 @@ Networks devices (including Next-generation Firewalls and Panorama) using the
 device API that is object oriented and conceptually similar to interaction
 with the device via the GUI or CLI.
 
+* Documentation: http://pandevice.readthedocs.io
+* Overview: http://paloaltonetworks.github.io/pandevice
 * Free software: ISC License
-* Documentation: http://pandevice.readthedocs.org
 
 -----
 
@@ -96,16 +97,30 @@ Some operational commands have methods to refresh the variables in an object::
     # populates the version, serial, and model variables from the live device
     fw.refresh_system_info()
 
+See more examples in the `Usage Guide`_.
+
+
+Contributors
+------------
+
+- Brian Torres-Gil - `github <https://github.com/btorresgil>`__
+- Garfield Freeman - `github <https://github.com/shinmog>`__
+- John Anderson - `github <https://github.com/lampwins>`__
+
+Thank you to Kevin Steves, creator of the pan-python library:
+    https://github.com/kevinsteves/pan-python
+
 
 .. _pan-python: http://github.com/kevinsteves/pan-python
-.. _Configuration Tree: http://pandevice.readthedocs.org/en/latest/configtree.html
+.. _Configuration Tree: http://pandevice.readthedocs.io/en/latest/configtree.html
+.. _Usage Guide: http://pandevice.readthedocs.io/en/latest/usage.html
 
 .. |pypi| image:: https://img.shields.io/pypi/v/pandevice.svg
     :target: https://pypi.python.org/pypi/pandevice
     :alt: Latest version released on PyPi
 
 .. |rtd| image:: https://img.shields.io/badge/docs-latest-brightgreen.svg
-    :target: http://pandevice.readthedocs.org/en/latest/?badge=latest
+    :target: http://pandevice.readthedocs.io/en/latest/?badge=latest
     :alt: Documentation Status
 
 .. |coverage| image:: https://img.shields.io/coveralls/PaloAltoNetworks/pandevice/master.svg?label=coverage