0.9.0a1

[GhostofGoes]

This pre-release is a complete rewrite of getmac from the ground up.

If you want to test the new changes, use the --pre argument to pip install

pip install --pre -U getmac

It's passing tests and seems to be operable. However, with a change this large there are ineviteably issues that the tests or I don't catch, so I'm doing a series of pre-releases until I'm 99% confident in it's stability. Refer to docs/rewrite.md for a in-depth explanation of the rewrite changes.

The new system has a number of benefits

• Reduction of false-positives and false-negatives by improving method selection accuracy (platform, validity, etc.)
• Significantly faster overall
• "Misses" have the same performance as "Hits"
• Easier to test, since each method can be tested directly via it's class
• Eaiser to type annotate and analyze with mypy
• Easier to read, improving reviewability and ease of contributing for newcomers
• Extensible! Custom methods can be defined and added at runtime (which is perfect if you have some particular edge case but aren't able to open-source it).

Added

• Support Python 3.9

Changed

• Complete rewrite of getmac from the ground up. Refer to docs/rewrite.md for a in-depth explanation of the rewrite changes
• Fixed a failure to look up a hostname now returns None, as expected, instead of raising an exception (socket.gaierror).
• Fixed numerous false-negative and false-positive bugs
• Improved performance overall
• Performance for cases where no MAC is found is now the same as cases where a MAC is found (speed of "misses" now equals that of "hits")
• Improved the reliability of many methods
• Improved the performance of many methods

Dev

• Add samples and tests for WSL (Ubuntu 18.04)
• Add flake8 plugins: flake8-pytest-style and flake8-annotations
• Add additional tests
• Improve existing tests

---

This discussion was created from the release 0.9.0a1.