Metadata-Version: 2.1
Name: randmac
Version: 0.0.1
Summary: a random 12-digit mac address generator
Home-page: https://github.com/joshschmelzle/randmac
Author: Josh Schmelzle
Author-email: joshjoshdev@gmail.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 vendor portion or full 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

requires a mac address as input. it is used to determine what the output format should be.

from a terminal you can use `randmac 00:00:00:00:00:00` to get a generate a new NIC portion, or `randmac 00:00:00:00:00:00 -f` to generate a new 12-digit LAA MAC.

you can also `from randmac import RandMac` and use it like `RandMac("00:00:00:00:00:00")`.

# example usage

```
$ randmac 00:00:00:00:00:00
00:00:00:fc:e1:5b
$ randmac 00:00:00:00:00:00 -f
2a:81:b0:e7:1d:08
``` 

or

```
>>> from randmac import RandMac
>>> RandMac("00:00:00:00:00:00")
'00:00:00:00:fd:9e'
>>> RandMac("00:00:00:00:00:00", True)
'ba:ac:5f:09:fc:bb'
>>> RandMac("0000.0000.0000", True)
'fe84.857f.900f'
```

# license

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


