macsanity 1.0.0

A simple tool for formatting MAC addresses

macsanity

A dangerously friendly tool to convert MAC addresses into whatever weird format the world throws at you.

---

🧵 Our Story

macsanity started as an idea for compostable popsicles.
The working title was..
TurdVendor - Where ethics meets excrement.

Goal:
save the planet — one regrettable dessert at a time.

That didn't really work out.
So we pivoted.

Now it’s a tool for formatting MAC addresses.
Because apparently, no two vendors can agree on what a colon is.

Still trying to save the world.
Just with slightly less shit.

---

How to use in terminal (cli)

positional arguments:

mac_address: The MAC address to format

options:

-h, --help: show this help message and exit
-f, --format: {'colon','dot','dash','ddash','space','blank','binary','compact','eui64','bpf','reverse','upsidedown'}, The format to use. If not specified, all formats will be printed.


Available formats:
colon : Colon-separated format, e.g., ab:12:cd:34:ef:56.
dot : Dot notation, e.g., abcd.ef12.3456.
dash : Hyphen-separated format, e.g., ab-12-cd-34-ef-56.
ddash : Double-dash-separated format, e.g., ab12-cd34-ef56.
space : Space-separated format, e.g., ab 12 cd 34 ef 56.
blank : Continuous string with no delimiters, e.g., ab12cd34ef56.
binary : Binary format, e.g., 10101011 00010010 11001101 00110100 11101111 01010110.
compact : Base64 encoded format, e.g., qXLNTq9W.
eui64 : Cisco EUI-64 format, e.g., ab12.cd34.fffe.ef56.
bpf : BPF format with each byte prefixed by '\x', e.g., \xab\x12\xcd\x34\xef\x56.
reverse : Reverse byte order, e.g., 56ef34cd12ab.
upsidedown : Because why not? Flip your MAC and the world with it. 🌀

-u, --uppercase: Prints the MAC address in uppercase.
-l, --lowercase: Prints the MAC address in lowercase.

Example usage:

macsanity abcdef123456 -f dot

output:

abcd.ef12.3456

There is also a shorter alias:

mcs abcd.ef12.3456 -f colon -u

output:

AB:CD:EF:12:34:56

How to use in your code

from macsanity import MacSanity

mac_address = 'ab:cd:ef:12:34:56'
mac = MacSanity(mac_address)

print(mac.dot)
print(mac.dash)
print(mac.ddash)
print(mac.space)
print(mac.colon)
print(mac.blank)
print(mac.binary)
print(mac.compact)
print(mac.eui64)
print(mac.bpf)
print(mac.reverse)
print(mac.upsidedown)

output:

abcd.ef12.3456  
ab-cd-ef-12-34-56  
abcd-ef12-3456  
ab cd ef 12 34 56  
ab:cd:ef:12:34:56  
abcdef123456  
10101011 11001101 11101111 00010010 00110100 01010110  
q83vEjRW  
ab12.cd34.fffe.ef56  
\xab\xcd\xef\x12\x34\x56  
654321fedcba  
ɓɐ ɟǝ pɔ ʞɾ ᴉu  

---

macsanity is proudly built by anython.
Because someone had to.