os-normalizer 0.3.2__py3-none-any.whl

os_normalizer-0.3.2.dist-info/METADATA

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: os-normalizer
+Version: 0.3.2
+Summary: Normalize raw OS strings/metadata into structured data (family, product, version, arch).
+Project-URL: Homepage, https://github.com/johnscillieri/os-normalizer
+Project-URL: Repository, https://github.com/johnscillieri/os-normalizer
+Project-URL: Issues, https://github.com/johnscillieri/os-normalizer/issues
+Project-URL: Changelog, https://github.com/johnscillieri/os-normalizer/releases
+License: MIT License
+        
+        Copyright (c) 2025 OS Normalizer contributors
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: cpe,fingerprint,normalize,os,parsing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Operating System
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# OS Normalizer
+
+A Python library for identifying and parsing operating system information from various sources.
+
+## Overview
+
+The OS Normalizer library parses raw operating system strings and JSON data to identify the OS family, version, architecture, and other details. It supports parsing of:
+
+- Windows (NT builds, versions)
+- macOS (Darwin versions, codenames)
+- Linux distributions (Ubuntu, Debian, Red Hat, etc.)
+- iOS and Android mobile OS
+- BSD variants (FreeBSD, OpenBSD, NetBSD)
+- Network operating systems (Cisco IOS, Junos, FortiOS, etc.)
+
+## Installation
+
+```bash
+pip install os-normalizer
+```
+
+## Usage
+
+The main entry point is the `normalize_os` function, which takes a string and an optional data dictionary and returns a structured `OSData` result.
+
+### Basic Usage
+
+```python
+from os_normalizer import normalize_os
+
+# Parse the OS information
+result = normalize_os("Windows NT 10.0 build 22631 Enterprise x64")
+print(result.family)  # windows
+print(result.product)  # Windows 11
+print(result.version_major)  # 11
+```
+
+### Using Raw OS JSON Data
+
+```python
+from os_normalizer import normalize_os
+
+# Fingerprint with both raw string and JSON data
+raw_os_string="Linux host 5.15.0-122-generic x86_64"
+raw_os_json={
+    "os_release": 'NAME="Ubuntu"\nID=ubuntu\nVERSION_ID="22.04.4"\nVERSION_CODENAME=jammy\nPRETTY_NAME="Ubuntu 22.04.4 LTS"'}
+
+result = normalize_os(raw_os_string, raw_os_json)
+print(result.family)  # linux
+print(result.product)  # Ubuntu
+print(result.codename)  # Jammy
+print(result.arch)  # x86_64
+```
+
+### Parsing Network Operating Systems
+
+```python
+from os_normalizer import normalize_os
+
+# Parse Cisco IOS XE
+raw_os_string="Cisco IOS XE Software, Version 17.9.4a (Amsterdam) C9300-24T, universalk9, c9300-universalk9.17.09.04a.SPA.bin"
+
+result = normalize_os(raw_os_string)
+print(result.family)  # network-os
+print(result.vendor)  # Cisco
+print(result.product)  # IOS XE
+```
+
+## Models
+
+### OSData
+
+Represents structured operating system information:
+
+- `family`: OS family (windows, linux, macos, ios, android, bsd, network-os)
+- `vendor`: Vendor name (Microsoft, Apple, Cisco, etc.)
+- `product`: Product name (Windows 11, Ubuntu, macOS, etc.)
+- `edition`: Edition information (Pro, Enterprise, etc.)
+- `codename`: Release codename (Sequoia, Ventura, etc.)
+- `channel`: Release channel (GA, LTS, etc.)
+- `version_major`, `version_minor`, `version_patch`, `version_build`: Version components
+- `kernel_name`, `kernel_version`: Kernel details
+- `arch`: Architecture (x86_64, arm64, etc.)
+- `distro`: Distribution name
+- `like_distros`: List of similar distributions
+- `pretty_name`: Pretty formatted name
+- `hw_model`, `build_id`: Network device details
+- `precision`: Precision level (family, product, major, minor, patch, build)
+- `confidence`: Confidence score (0.0 to 1.0)
+- `evidence`: Evidence used for parsing decisions
+- `os_key`: Canonical key for deduplication
+
+## Architecture
+
+The library follows a modular architecture:
+
+- **os_normalizer.py**: Main orchestration logic that delegates to appropriate parsers
+- **parsers/**: OS-specific parsers (macOS, Linux, Windows, Network, Mobile, BSD)
+- **models.py**: Data models for parsed results
+- **constants.py**: Static lookup tables (aliases, build maps, codenames)
+- **helpers.py**: Utility functions (architecture extraction, confidence calculation)
+
+## Testing
+
+You can run tests with uv in a few ways:
+
+- Ephemeral runner (downloads pytest if needed):
+  - `uvx pytest`
+- Use the project environment and dev dependencies declared in `pyproject.toml`:
+  - `uv run --group dev pytest`
+- Optional editable install for import paths:
+  - `uv pip install -e .`
+  - `uv run pytest`
+
+### Using Nox (with nox-uv)
+
+If you prefer repeatable sessions, this project includes Nox configured with the `nox-uv` plugin so virtualenvs are created via `uv`:
+
+- Run tests: `uv run nox`
+
+## Contributing
+
+Contributions are welcome! Please ensure that any new parsers or improvements follow the existing code patterns and include appropriate tests.
+
+## License
+
+MIT

os_normalizer-0.3.2.dist-info/RECORD

@@ -0,0 +1,22 @@
+os_normalizer/__init__.py,sha256=ZA2JnO3juuAn8xQBqUoUXxca10B-rE1MIuwtzDofpKs,212
+os_normalizer/constants.py,sha256=aIm6TiT95Mr7adABYwW6f57Hef0-_thopnNoHssiHFA,2676
+os_normalizer/cpe.py,sha256=G7hFiuVMlXM2d70ra7NA8v3a7kV7gYBt24bFunCAzk8,8742
+os_normalizer/helpers.py,sha256=IymYS2NAJ6J8ngI_HL5PH2_6zN6zzIpWMx1-05D2O3c,3347
+os_normalizer/models.py,sha256=_FAisDt9Pi5GDHIvzzfilEE8svvjyx6EcG2ZvMSRRJ0,5793
+os_normalizer/os_normalizer.py,sha256=IsWxE_Yes7FQxxNhA8twNrzmeRcl8QXTxjTfn0zCTTI,10143
+os_normalizer/parsers/__init__.py,sha256=-z-iu6os5LWuMUznvmfv_5LIw6Fbb3M1Auq2Wm7Rvfc,325
+os_normalizer/parsers/bsd.py,sha256=Umm7RSXjQfv6pfziJ8BYlmOc80VlLRueTrYw1iR-UjY,2018
+os_normalizer/parsers/linux.py,sha256=dQA0D57agO6g7EqFCRZ2cv6sLoR3jpEJ9onWZFZi35c,3528
+os_normalizer/parsers/macos.py,sha256=fU1YyiijzBdDAxUBSL2EQLhUu3JbOSx-N_KYvOg0XsI,3627
+os_normalizer/parsers/mobile.py,sha256=Ca864JhrO9zW5fs0zbs2VcMypKIkFHqZtxpJDbi12q0,1033
+os_normalizer/parsers/windows.py,sha256=DQtGwOhXqqwvdD_aShAZOiIYZ9hltq-6DwdL5AQjiYw,6589
+os_normalizer/parsers/network/__init__.py,sha256=TvRz08lNDZbr6yG8O3M7cLNu0hWAbtE1y7_9SwhP4g4,1596
+os_normalizer/parsers/network/cisco.py,sha256=ivhw85IHnHVT4sW-65F-ZGCR7yvu0mMMBfXRT4EzUfc,3203
+os_normalizer/parsers/network/fortinet.py,sha256=C-f5DgDS6mvda69vJ5bRM-blEE92E2rAEzYvbHXl2WM,1807
+os_normalizer/parsers/network/huawei.py,sha256=Su3eCRlmOCmpOPA_TGeH8gHY3-ZdXKFW4O3_W0SOPmk,1158
+os_normalizer/parsers/network/juniper.py,sha256=gskbaY4-LYWauM9yrvGMuCxPrNBKmUfIRPd1zsUUY7w,1275
+os_normalizer/parsers/network/netgear.py,sha256=AhgjVlhQiKvzuCHWAGMZCTucdOOSDt7cl9xONpb2aSA,1220
+os_normalizer-0.3.2.dist-info/METADATA,sha256=DugZSc8kZQ9tkKEEHKgIE7OTWJ_8QqlRYB4lk7E5_tg,6421
+os_normalizer-0.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+os_normalizer-0.3.2.dist-info/licenses/LICENSE,sha256=DN0enoiHxVkJ-hxmIchPaCQWrDsZwva5LY8XvG3UK8w,1083
+os_normalizer-0.3.2.dist-info/RECORD,,

os_normalizer-0.3.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

os_normalizer-0.3.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OS Normalizer contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.