Metadata-Version: 2.1
Name: randmac
Version: 0.1
Summary: a random 12-digit mac address generator
Home-page: https://github.com/joshschmelzle/randmac
Author: Josh Schmelzle
Author-email: josh@joshschmelzle.com
License: MIT
Keywords: randmac,random mac,random mac address
Platform: UNKNOWN
Classifier: Natural Language :: English
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3.2
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Utilities
Requires-Python: >3.2,
Description-Content-Type: text/markdown

randmac.py
==========

a utility that generates 12-digit mac addresses; either the NIC portion or full 12-digit MAC. 

the optional `-f` argument will return a random 12-digit MAC address that can be identified by the locally administrated address (LAA) format. This means you will always see `x2`, `x6`, `xA`, or `xE` at the beginning of a MAC address generated by randmac.

# installation

to install with pip:

`pip install randmac`

# requirements

Python >3.2 required.

# mac address formats

Supported MAC address formats:
 - MM:MM:MM:SS:SS:SS
 - MM-MM-MM-SS-SS-SS
 - MM.MM.MM.SS.SS.SS
 - MMMM.MMSS.SSSS
 - MMMMMMSSSSSS

where `M` stands for the manufacturer or vendor, and `S` stands for the NIC specific portion. 

# usage

you can `from randmac import RandMac` and use it like `RandMac()`.

if you wish to change the mac address format. provide a sample mac so `randmac` knows what the output format should be.

you can `from randmac import RandMac` and use it like `RandMac("0000.0000.0000")`.

from a terminal (if the the console scripts entry point `randmac` is in your path and executable) you can use `randmac` to get a generate a new 12-digit LAA address, or `randmac 00:00:00:00:00:00 -p` to generate a MAC with the same OUI, but a different NIC portion.

# example usage

```
>>> from randmac import RandMac
>>> RandMac()
'a6:9b:6b:8e:b3:42'
>>> RandMac("00:00:00:00:00:00", True)
'00:00:00:3f:8a:06'
>>> RandMac("0000:0000:0000", True)
'0000007ce662'
>>> RandMac("0000:0000:0000")
'06eb4584d1e3'
```

or

```
> randmac
fa:bf:7c:5d:65:3e
> randmac 00-00-00-00-00-00 -p
00-00-00-dd-5f-16
``` 

# license

license can be found [here](https://github.com/joshschmelzle/randmac/blob/master/LICENSE).


