etherlyzer 0.9.4__tar.gz → 0.9.6__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/PKG-INFO +7 -4
  2. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/README.md +208 -205
  3. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/pyproject.toml +169 -169
  4. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/__init__.py +6 -6
  5. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/etherlyzer.env +20 -20
  6. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/exporter.py +30 -31
  7. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/formatters.py +152 -152
  8. etherlyzer-0.9.6/src/etherlyzer/ieee/analytics.py +47 -0
  9. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/catalog.py +136 -130
  10. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/csv_parser.py +76 -80
  11. etherlyzer-0.9.6/src/etherlyzer/ieee/eui48_classifier.py +67 -0
  12. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/ieee_registry.py +199 -184
  13. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/index.py +199 -199
  14. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/cli.py +78 -78
  15. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/__init__.py +8 -8
  16. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/format.py +96 -96
  17. etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/controller.py +114 -0
  18. etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/types/__init__.py +0 -0
  19. etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/types/display.py +206 -0
  20. etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/types/ethertype_inspection.py +6 -0
  21. etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/types/mac_inspection.py +162 -0
  22. etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/validation.py +18 -0
  23. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/registries.py +55 -55
  24. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/sync.py +35 -35
  25. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/validate.py +119 -121
  26. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/whois.py +88 -90
  27. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/utility.py +20 -20
  28. etherlyzer-0.9.6/src/etherlyzer/util/__init__.py +0 -0
  29. etherlyzer-0.9.6/src/etherlyzer/util/conversion.py +0 -0
  30. etherlyzer-0.9.6/src/etherlyzer/util/dirs.py +8 -0
  31. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/util/knobs.py +105 -120
  32. etherlyzer-0.9.4/src/etherlyzer/ieee/eui48_classifier.py +0 -63
  33. etherlyzer-0.9.4/src/etherlyzer/terminal/commands/inspect.py +0 -222
  34. etherlyzer-0.9.4/src/etherlyzer/util/dirs.py +0 -6
  35. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/LICENSE +0 -0
  36. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/__init__.py +0 -0
  37. {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/__init__.py +0 -0
  38. {etherlyzer-0.9.4/src/etherlyzer/util → etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect}/__init__.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: etherlyzer
3
- Version: 0.9.4
3
+ Version: 0.9.6
4
4
  Summary: Fast offline lookup and classification of Ethernet-related identifiers.
5
5
  License-Expression: MIT
6
6
  License-File: LICENSE
@@ -37,7 +37,7 @@ Description-Content-Type: text/markdown
37
37
  </picture>
38
38
 
39
39
  <p>
40
- <strong>Local Ethernet intelligence for engineers, security tooling, and automation.</strong>
40
+ <strong>Lightweight Ethernet Address Intelligence Engine</strong>
41
41
  </p>
42
42
 
43
43
  <p>
@@ -70,10 +70,13 @@ Description-Content-Type: text/markdown
70
70
 
71
71
  ---
72
72
 
73
- Etherlyzer turns IEEE registry data into a fast, local CLI and Python API for identifying, inspecting, validating, and normalizing Ethernet identifiers.
73
+ A lightweight, offline-first Python toolkit for analyzing Ethernet identifiers and IEEE EUI-48 address allocations.
74
74
 
75
- Identify the organization behind a MAC address, determine the exact IEEE allocation it belongs to, inspect its address range and assignment size, correlate related vendor allocations, resolve EtherTypes, and clean up MAC input — without relying on a third-party lookup API.
75
+ Etherlyzer goes beyond conventional MAC vendor lookups by combining IEEE registry data, address classification, allocation analysis, and organizational correlation into a unified command-line interface and Python API.
76
76
 
77
+ Identify the organization behind a MAC address, determine its IEEE-registered allocation, inspect address ranges and allocation capacities, correlate related vendor blocks, resolve EtherTypes, and validate or normalize MAC addresses — all locally, without relying on third-party lookup APIs.
78
+
79
+ Built for network engineers, security researchers, and developers who need fast, reliable, standards-aware insight into Ethernet addressing.
77
80
  ## Why Etherlyzer?
78
81
 
79
82
  Most MAC lookup tools stop at:
@@ -1,205 +1,208 @@
1
- <div align="center">
2
-
3
- <picture>
4
- <source media="(prefers-color-scheme: dark)" srcset="docs/source/_static/logo_dark.png">
5
- <source media="(prefers-color-scheme: light)" srcset="docs/source/_static/logo_light.png">
6
- <img alt="Etherlyzer" src="docs/source/_static/logo_light.png" width="460">
7
- </picture>
8
-
9
- <p>
10
- <strong>Local Ethernet intelligence for engineers, security tooling, and automation.</strong>
11
- </p>
12
-
13
- <p>
14
- <a href="https://pypi.org/project/etherlyzer/">
15
- <img src="https://img.shields.io/pypi/v/etherlyzer?label=PyPI" alt="PyPI">
16
- </a>
17
- <a href="https://pypi.org/project/etherlyzer/">
18
- <img src="https://img.shields.io/pypi/pyversions/etherlyzer" alt="Python">
19
- </a>
20
- <a href="https://github.com/blue-hexagon/etherlyzer/actions">
21
- <img src="https://img.shields.io/github/actions/workflow/status/blue-hexagon/etherlyzer/tests.yml?branch=main&label=build" alt="Build">
22
- </a>
23
- <a href="https://etherlyzer.docs.manjana.dev/">
24
- <img src="https://img.shields.io/badge/docs-online-6f42c1" alt="Documentation">
25
- </a>
26
- <a href="LICENSE">
27
- <img src="https://img.shields.io/github/license/blue-hexagon/etherlyzer" alt="License">
28
- </a>
29
- </p>
30
-
31
- <p>
32
- <a href="https://etherlyzer.docs.manjana.dev/"><strong>Documentation</strong></a>
33
- ·
34
- <a href="https://pypi.org/project/etherlyzer/"><strong>PyPI</strong></a>
35
- ·
36
- <a href="https://github.com/blue-hexagon/etherlyzer"><strong>Source</strong></a>
37
- </p>
38
-
39
- </div>
40
-
41
- ---
42
-
43
- Etherlyzer turns IEEE registry data into a fast, local CLI and Python API for identifying, inspecting, validating, and normalizing Ethernet identifiers.
44
-
45
- Identify the organization behind a MAC address, determine the exact IEEE allocation it belongs to, inspect its address range and assignment size, correlate related vendor allocations, resolve EtherTypes, and clean up MAC input — without relying on a third-party lookup API.
46
-
47
- ## Why Etherlyzer?
48
-
49
- Most MAC lookup tools stop at:
50
-
51
- > `00:00:0c → Cisco`
52
-
53
- Etherlyzer goes further.
54
-
55
- It understands the IEEE allocation behind the address:
56
-
57
- - **MA-L / OUI-24**
58
- - **MA-M / OUI-28**
59
- - **MA-S / OUI-36**
60
- - **Legacy IAB allocations**
61
- - **Company Identifiers (CID)**
62
- - **EtherType protocol identifiers**
63
-
64
- And exposes details such as:
65
-
66
- - organization and vendor identity,
67
- - assignment prefix,
68
- - registry type,
69
- - address range,
70
- - prefix and host bit lengths,
71
- - allocation capacity,
72
- - legacy status,
73
- - related IEEE allocations belonging to the same organization.
74
-
75
- All registry data is synchronized locally, so normal lookups stay local too.
76
-
77
- ### Built for real workflows
78
-
79
- Etherlyzer is useful anywhere Ethernet identifiers become data rather than something you inspect manually:
80
-
81
- - network automation,
82
- - asset discovery,
83
- - NAC and inventory systems,
84
- - NOC/SOC workflows,
85
- - packet-analysis tooling,
86
- - security investigations,
87
- - bulk dataset enrichment,
88
- - Python applications and scripts.
89
-
90
- ## Install
91
-
92
- Requires Python 3.14+.
93
-
94
- ```console
95
- pip install etherlyzer
96
- etherlyzer --version
97
- ```
98
-
99
- ## See what a MAC address really belongs to
100
-
101
- ```console
102
- etherlyzer inspect 00:00:0c:12:34:56
103
- ```
104
-
105
- ```text
106
- Organization
107
- Name : Cisco Systems
108
- Full Name : Cisco Systems, Inc
109
- Address
110
- 170 WEST TASMAN DRIVE SAN JOSE CA US 95134-1706
111
-
112
- Registry
113
- IEEE Type : MA-L [MAC Address Block Large]
114
- Assignment : 00-00-0c
115
- Range : 00-00-0c-00-00-00 - 00-00-0c-ff-ff-ff
116
- Legacy : False
117
- Prefix Bits : 24 bits
118
- Address Bits : 24 bits
119
- Addresses : 16,777,216
120
- ```
121
-
122
- Etherlyzer can also correlate the organization against its other known IEEE MAC allocations.
123
-
124
- ## One toolkit, multiple jobs
125
-
126
- ```console
127
- # Identify a vendor
128
- etherlyzer whois 00:11:22:33:44:55
129
-
130
- # Inspect the exact IEEE allocation
131
- etherlyzer inspect 00:00:0c:12:34:56
132
-
133
- # Inspect an Ethernet protocol identifier
134
- etherlyzer inspect -t protocol 0800
135
-
136
- # Validate and diagnose malformed input
137
- etherlyzer validate 00-11-22-33-44-55
138
-
139
- # Normalize MAC representation
140
- etherlyzer format 001122334455
141
-
142
- # Cisco-style formatting
143
- etherlyzer format 001122334455 -p . -s 4
144
-
145
- # Process multiple values
146
- etherlyzer whois -f macs.txt
147
- etherlyzer validate -b
148
-
149
- # Inspect local registry state
150
- etherlyzer registries
151
-
152
- # Refresh IEEE registry data
153
- etherlyzer sync
154
- ```
155
-
156
- ## Local by design
157
-
158
- Etherlyzer maintains synchronized copies of the supported IEEE datasets on the local system.
159
-
160
- That means routine lookups do **not** require sending MAC addresses or internal asset data to an external lookup service.
161
-
162
- This makes Etherlyzer particularly useful for:
163
-
164
- - internal infrastructure inventories,
165
- - restricted environments,
166
- - sensitive network datasets,
167
- - high-volume lookups,
168
- - offline analysis,
169
- - automated enrichment pipelines.
170
-
171
- Internet access is only required when the IEEE registry datasets need to be refreshed.
172
-
173
- ## CLI and Python API
174
-
175
- The command-line interface is built on the same underlying Python library.
176
-
177
- Use Etherlyzer interactively from a terminal, compose it into shell workflows, or integrate its registry, lookup, validation, and formatting capabilities directly into Python applications.
178
-
179
- ## Documentation
180
-
181
- Full documentation is available at:
182
-
183
- ### **https://etherlyzer.docs.manjana.dev/**
184
-
185
- It includes:
186
-
187
- - CLI reference
188
- - Python API
189
- - IEEE registry concepts
190
- - MAC address concepts
191
- - validation masks
192
- - configuration
193
- - registry synchronization
194
- - examples and guides
195
-
196
- For quick CLI help:
197
-
198
- ```console
199
- etherlyzer --help
200
- etherlyzer <command> --help
201
- ```
202
-
203
- ## License
204
-
205
- Etherlyzer is released under the [MIT License](LICENSE).
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/source/_static/logo_dark.png">
5
+ <source media="(prefers-color-scheme: light)" srcset="docs/source/_static/logo_light.png">
6
+ <img alt="Etherlyzer" src="docs/source/_static/logo_light.png" width="460">
7
+ </picture>
8
+
9
+ <p>
10
+ <strong>Lightweight Ethernet Address Intelligence Engine</strong>
11
+ </p>
12
+
13
+ <p>
14
+ <a href="https://pypi.org/project/etherlyzer/">
15
+ <img src="https://img.shields.io/pypi/v/etherlyzer?label=PyPI" alt="PyPI">
16
+ </a>
17
+ <a href="https://pypi.org/project/etherlyzer/">
18
+ <img src="https://img.shields.io/pypi/pyversions/etherlyzer" alt="Python">
19
+ </a>
20
+ <a href="https://github.com/blue-hexagon/etherlyzer/actions">
21
+ <img src="https://img.shields.io/github/actions/workflow/status/blue-hexagon/etherlyzer/tests.yml?branch=main&label=build" alt="Build">
22
+ </a>
23
+ <a href="https://etherlyzer.docs.manjana.dev/">
24
+ <img src="https://img.shields.io/badge/docs-online-6f42c1" alt="Documentation">
25
+ </a>
26
+ <a href="LICENSE">
27
+ <img src="https://img.shields.io/github/license/blue-hexagon/etherlyzer" alt="License">
28
+ </a>
29
+ </p>
30
+
31
+ <p>
32
+ <a href="https://etherlyzer.docs.manjana.dev/"><strong>Documentation</strong></a>
33
+ ·
34
+ <a href="https://pypi.org/project/etherlyzer/"><strong>PyPI</strong></a>
35
+ ·
36
+ <a href="https://github.com/blue-hexagon/etherlyzer"><strong>Source</strong></a>
37
+ </p>
38
+
39
+ </div>
40
+
41
+ ---
42
+
43
+ A lightweight, offline-first Python toolkit for analyzing Ethernet identifiers and IEEE EUI-48 address allocations.
44
+
45
+ Etherlyzer goes beyond conventional MAC vendor lookups by combining IEEE registry data, address classification, allocation analysis, and organizational correlation into a unified command-line interface and Python API.
46
+
47
+ Identify the organization behind a MAC address, determine its IEEE-registered allocation, inspect address ranges and allocation capacities, correlate related vendor blocks, resolve EtherTypes, and validate or normalize MAC addresses — all locally, without relying on third-party lookup APIs.
48
+
49
+ Built for network engineers, security researchers, and developers who need fast, reliable, standards-aware insight into Ethernet addressing.
50
+ ## Why Etherlyzer?
51
+
52
+ Most MAC lookup tools stop at:
53
+
54
+ > `00:00:0c → Cisco`
55
+
56
+ Etherlyzer goes further.
57
+
58
+ It understands the IEEE allocation behind the address:
59
+
60
+ - **MA-L / OUI-24**
61
+ - **MA-M / OUI-28**
62
+ - **MA-S / OUI-36**
63
+ - **Legacy IAB allocations**
64
+ - **Company Identifiers (CID)**
65
+ - **EtherType protocol identifiers**
66
+
67
+ And exposes details such as:
68
+
69
+ - organization and vendor identity,
70
+ - assignment prefix,
71
+ - registry type,
72
+ - address range,
73
+ - prefix and host bit lengths,
74
+ - allocation capacity,
75
+ - legacy status,
76
+ - related IEEE allocations belonging to the same organization.
77
+
78
+ All registry data is synchronized locally, so normal lookups stay local too.
79
+
80
+ ### Built for real workflows
81
+
82
+ Etherlyzer is useful anywhere Ethernet identifiers become data rather than something you inspect manually:
83
+
84
+ - network automation,
85
+ - asset discovery,
86
+ - NAC and inventory systems,
87
+ - NOC/SOC workflows,
88
+ - packet-analysis tooling,
89
+ - security investigations,
90
+ - bulk dataset enrichment,
91
+ - Python applications and scripts.
92
+
93
+ ## Install
94
+
95
+ Requires Python 3.14+.
96
+
97
+ ```console
98
+ pip install etherlyzer
99
+ etherlyzer --version
100
+ ```
101
+
102
+ ## See what a MAC address really belongs to
103
+
104
+ ```console
105
+ etherlyzer inspect 00:00:0c:12:34:56
106
+ ```
107
+
108
+ ```text
109
+ Organization
110
+ Name : Cisco Systems
111
+ Full Name : Cisco Systems, Inc
112
+ Address
113
+ 170 WEST TASMAN DRIVE SAN JOSE CA US 95134-1706
114
+
115
+ Registry
116
+ IEEE Type : MA-L [MAC Address Block Large]
117
+ Assignment : 00-00-0c
118
+ Range : 00-00-0c-00-00-00 - 00-00-0c-ff-ff-ff
119
+ Legacy : False
120
+ Prefix Bits : 24 bits
121
+ Address Bits : 24 bits
122
+ Addresses : 16,777,216
123
+ ```
124
+
125
+ Etherlyzer can also correlate the organization against its other known IEEE MAC allocations.
126
+
127
+ ## One toolkit, multiple jobs
128
+
129
+ ```console
130
+ # Identify a vendor
131
+ etherlyzer whois 00:11:22:33:44:55
132
+
133
+ # Inspect the exact IEEE allocation
134
+ etherlyzer inspect 00:00:0c:12:34:56
135
+
136
+ # Inspect an Ethernet protocol identifier
137
+ etherlyzer inspect -t protocol 0800
138
+
139
+ # Validate and diagnose malformed input
140
+ etherlyzer validate 00-11-22-33-44-55
141
+
142
+ # Normalize MAC representation
143
+ etherlyzer format 001122334455
144
+
145
+ # Cisco-style formatting
146
+ etherlyzer format 001122334455 -p . -s 4
147
+
148
+ # Process multiple values
149
+ etherlyzer whois -f macs.txt
150
+ etherlyzer validate -b
151
+
152
+ # Inspect local registry state
153
+ etherlyzer registries
154
+
155
+ # Refresh IEEE registry data
156
+ etherlyzer sync
157
+ ```
158
+
159
+ ## Local by design
160
+
161
+ Etherlyzer maintains synchronized copies of the supported IEEE datasets on the local system.
162
+
163
+ That means routine lookups do **not** require sending MAC addresses or internal asset data to an external lookup service.
164
+
165
+ This makes Etherlyzer particularly useful for:
166
+
167
+ - internal infrastructure inventories,
168
+ - restricted environments,
169
+ - sensitive network datasets,
170
+ - high-volume lookups,
171
+ - offline analysis,
172
+ - automated enrichment pipelines.
173
+
174
+ Internet access is only required when the IEEE registry datasets need to be refreshed.
175
+
176
+ ## CLI and Python API
177
+
178
+ The command-line interface is built on the same underlying Python library.
179
+
180
+ Use Etherlyzer interactively from a terminal, compose it into shell workflows, or integrate its registry, lookup, validation, and formatting capabilities directly into Python applications.
181
+
182
+ ## Documentation
183
+
184
+ Full documentation is available at:
185
+
186
+ ### **https://etherlyzer.docs.manjana.dev/**
187
+
188
+ It includes:
189
+
190
+ - CLI reference
191
+ - Python API
192
+ - IEEE registry concepts
193
+ - MAC address concepts
194
+ - validation masks
195
+ - configuration
196
+ - registry synchronization
197
+ - examples and guides
198
+
199
+ For quick CLI help:
200
+
201
+ ```console
202
+ etherlyzer --help
203
+ etherlyzer <command> --help
204
+ ```
205
+
206
+ ## License
207
+
208
+ Etherlyzer is released under the [MIT License](LICENSE).