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
Description: 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).
        
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
