# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-netbox-acls
VERSION=		1.6.1
KEYWORDS=		python
VARIANTS=		v11 v12
SDESC[v11]=		NetBox plugin for Access List management (3.11)
SDESC[v12]=		NetBox plugin for Access List management (3.12)
HOMEPAGE=		https://github.com/netbox-community/netbox-acls
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/9a/6d/873cf1fca66aaaedc69ffbd7e231c0c99bf9807b5d5b29991513d507f971
DISTFILE[1]=		netbox_acls-1.6.1-py3-none-any.whl:main
DF_INDEX=		1
SPKGS[v11]=		single
SPKGS[v12]=		single

OPTIONS_AVAILABLE=	PY311 PY312
OPTIONS_STANDARD=	none
VOPTS[v11]=		PY311=ON PY312=OFF
VOPTS[v12]=		PY311=OFF PY312=ON

DISTNAME=		netbox_acls-1.6.1.dist-info

GENERATED=		yes

[PY311].USES_ON=			python:v11,wheel

[PY312].USES_ON=			python:v12,wheel

[FILE:2295:descriptions/desc.single]
# NetBox Access Lists Plugin

A [Netbox] plugin for Access List management.

## Features

This plugin provides the following models:

- Access Lists
- Access List to Interface Assignment
- Access List Rules (abstract model basis for other rules)
- Access List Standard Rules
- Access List Extended Rules

## Origin

Based on the NetBox plugin tutorial by [jeremystretch]:

- [demo repository]
- [tutorial]

All credit should go to Jeremy. Thanks, Jeremy!

This project just looks to build on top of this framework and model
presented.

## Contributing

This project is currently maintained jointly by:

- [Abhimanyu Saharan]
- [Ryan Merolle]

See the [CONTRIBUTING] for more information.

## Compatibility

Each Plugin Version listed below has been tested with its corresponding
NetBox Version.

| NetBox Version | Plugin Version |
|:--------------:|:--------------:|
|   >= 4.0.2     |     1.6.1      |
|      3.7       |     1.5.0      |
|      3.6       |     1.4.0      |
|      3.5       |     1.3.0      |
|      3.4       |     1.2.2      |
|      3.3       |     1.1.0      |
|      3.2       |     1.0.1      |

## Installing

For adding to a NetBox Docker setup see
[the general instructions for using netbox-docker with plugins].

You can install with pip:

```bash
pip install netbox-acls
```

or by adding to your `local_requirements.txt` or `plugin_requirements.txt`
(netbox-docker):

```bash
netbox-acls
```

## Configuration

Enable the plugin in `/opt/netbox/netbox/netbox/configuration.py`,
 or if you use netbox-docker, your `/configuration/plugins.py` file :

```python
PLUGINS = [
    "netbox_acls"
]

PLUGINS_CONFIG = {
    "netbox_acls": {
        "top_level_menu": True # If set to True the plugin will add a top
level menu item for the plugin. If set to False the plugin will add a menu
item under the Plugins menu item.  Default is set to True.
    },
}
```

To add the required `netbox-acls` tables to your NetBox database, run the
`migrate` manager subcommand in the NetBox virtual environment:
```
cd /opt/netbox
sudo ./venv/bin/python3 netbox/manage.py migrate
```

## Developing

### VSCode + Docker + Dev Containers

To develop this plugin further one can use the included .devcontainer
configuration. This configuration creates a docker container which includes


[FILE:113:distinfo]
2eaf1036cfb4d0ffe7e6de97852efbc62042664f8b7fb1321969fd577445c57e        41869 netbox_acls-1.6.1-py3-none-any.whl