# Pynetbox
Python API client library for [NetBox](https://github.com/netbox-community/netbox).
> **Note:** Version 6.7 and later of the library only supports NetBox 3.3 and above.
## Installation
To install run `pip install pynetbox`.
Alternatively, you can clone the repo and run `python setup.py install`.
## Quick Start
The full pynetbox API is documented on [Read the Docs](http://pynetbox.readthedocs.io/en/latest/), but the following should be enough to get started using it.
To begin, import pynetbox and instantiate the API.
```
import pynetbox
nb = pynetbox.api(
'http://localhost:8000',
token='d6f4e314a5b5fefd164995169f28ae32d987704f'
)
```
The first argument the .api() method takes is the NetBox URL. There are a handful of named arguments you can provide, but in most cases none are required to simply pull data. In order to write, the `token` argument should to be provided.
## Queries
The pynetbox API is setup so that NetBox's apps are attributes of the `.api()` object, and in turn those apps have attribute representing each endpoint. Each endpoint has a handful of methods available to carry out actions on the endpoint. For example, in order to query all the objects in the `devices` endpoint you would do the following:
```
>>> devices = nb.dcim.devices.all()
>>> for device in devices:
... print(device.name)
...
test1-leaf1
test1-leaf2
test1-leaf3
>>>
```
Note that the all() and filter() methods are generators and return an object that can be iterated over only once. If you are going to be iterating over it repeatedly you need to either call the all() method again, or encapsulate the results in a `list` object like this:
```
>>> devices = list(nb.dcim.devices.all())
```
### Threading
pynetbox supports multithreaded calls for `.filter()` and `.all()` queries. It is **highly recommended** you have `MAX_PAGE_SIZE` in your Netbox install set to anything *except* `0` or `None`. The default value of `1000` is usually a good value to use. To enable threading, add `threading=True` parameter to the `.api`:
```python
nb = pynetbox.api(
'http://localhost:8000',
threading=True,
)
```
## Alternative Library
> **Note:** For those interested in a different approach, there is an alternative Python API client library available for NetBox called [netbox-python](https://github.com/netbox-community/netbox-python). This library provides a thin Python wrapper over the NetBox API.
[netbox-python](https://github.com/netbox-community/netbox-python) offers a minimalistic interface to interact with NetBox's API. While it may not provide all the features available in pynetbox, it offers a lightweight and straightforward option for interfacing with NetBox.
To explore further details and access the documentation, please visit the [netbox-python](https://github.com/netbox-community/netbox-python).
Raw data
{
"_id": null,
"home_page": "https://github.com/netbox-community/pynetbox",
"name": "pynetbox",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "netbox",
"author": "Zach Moody",
"author_email": "zmoody@do.co",
"download_url": "https://files.pythonhosted.org/packages/0f/e2/4d2815362f800bc89d942bc430dccd8ee81a046216573eedbd8f619486f4/pynetbox-7.3.3.tar.gz",
"platform": null,
"description": "# Pynetbox\nPython API client library for [NetBox](https://github.com/netbox-community/netbox).\n\n> **Note:** Version 6.7 and later of the library only supports NetBox 3.3 and above.\n\n## Installation\n\nTo install run `pip install pynetbox`.\n\nAlternatively, you can clone the repo and run `python setup.py install`.\n\n\n## Quick Start\n\nThe full pynetbox API is documented on [Read the Docs](http://pynetbox.readthedocs.io/en/latest/), but the following should be enough to get started using it.\n\nTo begin, import pynetbox and instantiate the API.\n\n```\nimport pynetbox\nnb = pynetbox.api(\n 'http://localhost:8000',\n token='d6f4e314a5b5fefd164995169f28ae32d987704f'\n)\n```\n\nThe first argument the .api() method takes is the NetBox URL. There are a handful of named arguments you can provide, but in most cases none are required to simply pull data. In order to write, the `token` argument should to be provided.\n\n\n## Queries\n\nThe pynetbox API is setup so that NetBox's apps are attributes of the `.api()` object, and in turn those apps have attribute representing each endpoint. Each endpoint has a handful of methods available to carry out actions on the endpoint. For example, in order to query all the objects in the `devices` endpoint you would do the following:\n\n```\n>>> devices = nb.dcim.devices.all()\n>>> for device in devices:\n... print(device.name)\n...\ntest1-leaf1\ntest1-leaf2\ntest1-leaf3\n>>>\n```\n\nNote that the all() and filter() methods are generators and return an object that can be iterated over only once. If you are going to be iterating over it repeatedly you need to either call the all() method again, or encapsulate the results in a `list` object like this:\n```\n>>> devices = list(nb.dcim.devices.all())\n```\n\n### Threading\n\npynetbox supports multithreaded calls for `.filter()` and `.all()` queries. It is **highly recommended** you have `MAX_PAGE_SIZE` in your Netbox install set to anything *except* `0` or `None`. The default value of `1000` is usually a good value to use. To enable threading, add `threading=True` parameter to the `.api`:\n\n```python\nnb = pynetbox.api(\n 'http://localhost:8000',\n threading=True,\n)\n```\n\n## Alternative Library\n\n> **Note:** For those interested in a different approach, there is an alternative Python API client library available for NetBox called [netbox-python](https://github.com/netbox-community/netbox-python). This library provides a thin Python wrapper over the NetBox API.\n\n[netbox-python](https://github.com/netbox-community/netbox-python) offers a minimalistic interface to interact with NetBox's API. While it may not provide all the features available in pynetbox, it offers a lightweight and straightforward option for interfacing with NetBox.\n\nTo explore further details and access the documentation, please visit the [netbox-python](https://github.com/netbox-community/netbox-python).\n",
"bugtrack_url": null,
"license": "Apache2",
"summary": "NetBox API client library",
"version": "7.3.3",
"project_urls": {
"Homepage": "https://github.com/netbox-community/pynetbox"
},
"split_keywords": [
"netbox"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5a5c879c62e013c10cd9b596c8342e96caf8c2008917b325aaac1f01e6a3da1d",
"md5": "54f87e52386277968bc8bb9ae1105bc0",
"sha256": "9bc25f83ff126f12d26976e544a2f0f6c7c898c261e6d47f8a4144ab47686d81"
},
"downloads": -1,
"filename": "pynetbox-7.3.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "54f87e52386277968bc8bb9ae1105bc0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 34913,
"upload_time": "2024-01-05T23:18:52",
"upload_time_iso_8601": "2024-01-05T23:18:52.205058Z",
"url": "https://files.pythonhosted.org/packages/5a/5c/879c62e013c10cd9b596c8342e96caf8c2008917b325aaac1f01e6a3da1d/pynetbox-7.3.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0fe24d2815362f800bc89d942bc430dccd8ee81a046216573eedbd8f619486f4",
"md5": "420065e8a8ed63505f79178e033fe40a",
"sha256": "b0bcef4c3a019516d2425ae0ce5509eae7f4f11ad4510c9fe9527d468f22529b"
},
"downloads": -1,
"filename": "pynetbox-7.3.3.tar.gz",
"has_sig": false,
"md5_digest": "420065e8a8ed63505f79178e033fe40a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 67768,
"upload_time": "2024-01-05T23:18:53",
"upload_time_iso_8601": "2024-01-05T23:18:53.606321Z",
"url": "https://files.pythonhosted.org/packages/0f/e2/4d2815362f800bc89d942bc430dccd8ee81a046216573eedbd8f619486f4/pynetbox-7.3.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-05 23:18:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "netbox-community",
"github_project": "pynetbox",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "pynetbox"
}
JSON
