Skip to main content

MAC address manipulation library

Project description


Micro library I'm planing to develop by using TDD approach, just to try it.

Example usage

import l2address

mac = l2address.mac_address(0xff00ff)
# 00:00:00:ff:00:ff
mac += 0xff00
# 00:00:00:ff:ff:ff
mac -= l2address.mac_address('00:00:00:ff:ff:f0')
# 00:00:00:00:00:0f
print(mac == l2address.mac_address(0xf))
# True
print(l2address.mac_address('ffffffffffff') + 1)
# 00:00:00:00:00:00
print(l2address.mac_address(0xff, l2address.PeriodFormatter(4)))
# 0000.0000.00ff


At the current moment supports:

  • Create MAC address from int
  • Create MAC address from str
  • Sum and Substitution of MAC addresses (and with ints)
  • Convert MAC to string
  • Different formatting types (00:00:00:00:00:00, 0000.0000.0000, 00-00-00-00-00-00, and so on)
  • Validation of format when parsing from string. There are predefined formats, but can be extended, see: Extending Formats

Extending Formats

import l2address
from l2address.utils import per_join

# Just inherit l2address.Formatter and use new formatter

class MyMacStarFormatter(l2address.Formatter):
    def format(self, value, max_value):
        return per_join(self._to_clean_str(value, max_value), '*', 2)

    def _get_validator_regexp(self, _str, max_value):
        return r'^([\da-fA-F][\da-fA-F]\*?){6}'

except ValueError:
    print('Failed as expected')
    # Failed as expected

mac = l2address.mac_address('AB*ab*bc*de*ff*ff', MyMacStarFormatter())
# ab*ab*bc*de*ff*ff
# ab:ab:bc:de:ff:ff
# 00*00*00*00*00*ff


  • Multiplication by int
  • Different lengths of MAC address (there are 64 bit MAC addesses I believe)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

l2address-1.0.1.tar.gz (3.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page