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.
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/PKG-INFO +7 -4
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/README.md +208 -205
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/pyproject.toml +169 -169
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/__init__.py +6 -6
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/etherlyzer.env +20 -20
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/exporter.py +30 -31
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/formatters.py +152 -152
- etherlyzer-0.9.6/src/etherlyzer/ieee/analytics.py +47 -0
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/catalog.py +136 -130
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/csv_parser.py +76 -80
- etherlyzer-0.9.6/src/etherlyzer/ieee/eui48_classifier.py +67 -0
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/ieee_registry.py +199 -184
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/index.py +199 -199
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/cli.py +78 -78
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/__init__.py +8 -8
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/format.py +96 -96
- etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/controller.py +114 -0
- etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/types/__init__.py +0 -0
- etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/types/display.py +206 -0
- etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/types/ethertype_inspection.py +6 -0
- etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/types/mac_inspection.py +162 -0
- etherlyzer-0.9.6/src/etherlyzer/terminal/commands/inspect/validation.py +18 -0
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/registries.py +55 -55
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/sync.py +35 -35
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/validate.py +119 -121
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/commands/whois.py +88 -90
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/utility.py +20 -20
- etherlyzer-0.9.6/src/etherlyzer/util/__init__.py +0 -0
- etherlyzer-0.9.6/src/etherlyzer/util/conversion.py +0 -0
- etherlyzer-0.9.6/src/etherlyzer/util/dirs.py +8 -0
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/util/knobs.py +105 -120
- etherlyzer-0.9.4/src/etherlyzer/ieee/eui48_classifier.py +0 -63
- etherlyzer-0.9.4/src/etherlyzer/terminal/commands/inspect.py +0 -222
- etherlyzer-0.9.4/src/etherlyzer/util/dirs.py +0 -6
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/LICENSE +0 -0
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/ieee/__init__.py +0 -0
- {etherlyzer-0.9.4 → etherlyzer-0.9.6}/src/etherlyzer/terminal/__init__.py +0 -0
- {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.
|
|
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>
|
|
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
|
-
|
|
73
|
+
A lightweight, offline-first Python toolkit for analyzing Ethernet identifiers and IEEE EUI-48 address allocations.
|
|
74
74
|
|
|
75
|
-
|
|
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>
|
|
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
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
- **
|
|
61
|
-
- **
|
|
62
|
-
- **
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
-
|
|
70
|
-
- prefix
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
-
|
|
85
|
-
-
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
#
|
|
131
|
-
etherlyzer
|
|
132
|
-
|
|
133
|
-
# Inspect
|
|
134
|
-
etherlyzer inspect
|
|
135
|
-
|
|
136
|
-
#
|
|
137
|
-
etherlyzer
|
|
138
|
-
|
|
139
|
-
#
|
|
140
|
-
etherlyzer
|
|
141
|
-
|
|
142
|
-
#
|
|
143
|
-
etherlyzer format 001122334455
|
|
144
|
-
|
|
145
|
-
#
|
|
146
|
-
etherlyzer
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
etherlyzer
|
|
151
|
-
|
|
152
|
-
#
|
|
153
|
-
etherlyzer
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
-
|
|
168
|
-
-
|
|
169
|
-
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
-
|
|
191
|
-
-
|
|
192
|
-
-
|
|
193
|
-
-
|
|
194
|
-
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
```
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
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).
|