python-phonebox-plugin
Port variant v11
Summary Phone numbers management plugin for NetBox (3.11)
Package version 0.0.7b2
Homepage https://github.com/iDebugAll/phonebox_plugin
Keywords python
Maintainer Python Automaton
License Not yet specified
Other variants v12
Ravenports Buildsheet | History
Ravensource Port Directory | History
Last modified 03 FEB 2024, 15:41:37 UTC
Port created 07 JAN 2023, 04:18:24 UTC
Subpackage Descriptions
single # PhoneBox Plugin A Telephone Number Management Plugin for [NetBox] and more. >The plugin versions 0.0.1b1-0.0.1b4 support NetBox 2.10.x versions. > >Latest plugin version 0.0.1b5 supports NetBox 2.11.0+ versions I described some general considerations behind the plugin development and future plans in my [blog post]. ### Preview ![](docs/media/preview_01.png) # Supported Features and Models ### Numbers The plugin currently implements a Number abstraction representing a single telephone number of an arbitrary format.
A Number can consist of valid DTMF characters and leading plus sign for E.164 support: - leading plus ("+") sign (optional) - digits 0-9 - characters A, B, C, D - pound sign ("#") - asterisk sign ("*") Sample valid numbers: +12341234567, 1000, 123#2341234567, *100#.
Numbers are stored without delimiters. They will be implemented as an additional formatting function.
Number values can be not unique. Tenant is a mandatory option representing a number partition. Number and Tenant are globally unique.
A Number can optionally be assigned with Provider and Region relations.
A Number can contain an optional Description.
A Number can optionally be tagged with Tags.

The plugin supports Bulk Edit and Delete operations for Numbers. ### Voice Circuits Voice Circuit is an entity on a voice-enabled device representing a physical or virtual connection to another voice-enabled device. The plugin supports the following voice circuit types: - SIP Trunk. - Digital Voice Circuit (PRI/BRI/etc). - Analog Voice Circuit (CO lines/etc). A Voice Circuit must be assigned to an interface of a Device or Virtual Machine. ### Plugin API The plugin introduces a NetBox REST API extension `/api/plugins/phonebox/`.
It currently supports all create, read, update, and delete operations for Numbers via `/api/plugins/phonebox/numbers/`.
The API is compatible with [pynetbox]: ``` >>> nb.plugins.phonebox.numbers.get(7) 2000 >>> ``` # Installation General installation steps and considerations follow the [official guidelines]. ### Package Installation from PyPi Assuming you use a Virtual Environment for Netbox: ``` $ source /opt/netbox/venv/bin/activate (venv) $ pip3 install phonebox-plugin ``` ### Package Installation from Source Code The source code is available on [GitHub].
Download and install the package. Assuming you use a Virtual Environment for Netbox: ``` $ git clone https://github.com/iDebugAll/phonebox_plugin $ cd phonebox_plugin $ source /opt/netbox/venv/bin/activate (venv) $ pip3 install . ``` To ensure NextBox UI plugin is automatically re-installed during future upgrades, create a file named `local_requirements.txt` (if not already existing) in the NetBox root directory (alongside `requirements.txt`) and list the `phonebox_plugin` package: ```no-highlight # echo phonebox_plugin >> local_requirements.txt ```
Configuration Switches (platform-specific settings discarded)
PY311 ON Build using Python 3.11 PY312 OFF Build using Python 3.12
Package Dependencies by Type
Build (only) python-setuptools:single:v11
autoselect-python:single:standard
Build and Runtime python311:single:standard
Download groups
main mirror://PYPI/p/phonebox-plugin
Distribution File Information
4ea9428e495af071151440ee53fbd793b92c9317a10a70d1a8957d8bd4013e50 19578 phonebox_plugin-0.0.7b2.tar.gz
Ports that require python-phonebox-plugin:v11
No other ports depend on this one.