('MAC Address-focused library similar to `ipaddress`',)
Project description
MacTools
MacTools is a MAC-centric library for aiding in network handling and automation.
Full test coverage and fully type annoted.
Installation
This is a publicly available library on PyPI and can be installed with:
pip install mactools
Features
MacAddress
MAC object similar to Python's ipaddress
library. Performs validation on
creation and allows quick and easy format changing for the user. Accepts
EUI-48 and EUI-64 formats.
Usage
Built-in MacAddress
attributes allow for conversion between the common formats
of either delimiters, decimal, or binary. Such as:
from mactools import MacAddress
mac = MacAddress('00:11:22:AA:BB:CC')
# returns the MAC without an delimiters or spaces
mac.clean
# returns the MAC with period delimiters
mac.period
# returns the decimal/numeric form
mac.decimal
# returns the OUI
mac.oui
The full format list includes: clean, colon, period, hyphen, space, oui, decimal, binary
OUICache
Local cache of the IEEE OUI MA-L, MA-M, and MA-S registries for quick look-ups without needing to consistently hit API endpoints for individual queries.
MacAddress
currently automatically performs the look-up on creation.
The full information is available, including OUI, Vendor, Address, etc.
The cache also contains specific references to commonly defined non-vendor OUIs such as Multicast, IEEE protocols (STP, LLDP, etc), Locally administered and others.
Usage
Intakes a string MAC/OUI or MacAddress
object for either vendor or full record
from the IEEE OUI MA-L registry. The cache will be built if one is not present
(or if manually prompted) or the version of the code has changed.
from mactools import get_oui_cache
# the `mac` defined above already has the look-up performed and recorded on creation, if the record was found
vendor = mac.vendor
cache = get_oui_cache()
oui = '01000C'
# These methods would also work with the `mac` defined above as well
vendor = cache.get_vendor(oui)
vendor
will be the string of vendor registered to IEEE.
It will also identify common protocol MACs (such as Spanning Tree, Cisco/Extreme, etc.) and randomized MACs (locally administered).
License
This project is under the MIT license (see the LICENSE file for full text).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.