os-normalizer 0.5.1__tar.gz

os_normalizer-0.5.1/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

os_normalizer-0.5.1/.python-version

@@ -0,0 +1 @@
+3.13

os_normalizer-0.5.1/.uv-cache/.gitignore

@@ -0,0 +1 @@
+*

os_normalizer-0.5.1/.uv-cache/CACHEDIR.TAG

@@ -0,0 +1 @@
+Signature: 8a477f597d28d172789f06886806bc55

os_normalizer-0.5.1/CHANGELOG.md

@@ -0,0 +1,104 @@
+# Changelog
+
+All notable changes to this project are documented here.
+This file adheres to Keep a Changelog and Semantic Versioning.
+
+## `v0.5.1` — [Unreleased]
+
+- Added BSD parser support for `/etc/os-release` blobs (FreeBSD, OpenBSD, NetBSD) plus fixtures that lock codename/channel/distro handling.
+- Normalized the hyphenated `x86-64` architecture alias to `x86_64` and added regression coverage in the Linux suite.
+- Fixed Windows fallback parsing so bare “Windows” banners no longer crash, now emit family-level `OSData`, and keep kernel metadata unset when unknown.
+
+## `v0.5.0` — [2025-10-30]
+
+- Update release docs, add 3.14 classifier, sort imports [b7e07de]
+- Add a ton more architectures and extract into constants [bd481f8]
+- Add esxi and solaris support [8c14505]
+- Set the unreleased tag for uv-ship [791361c]
+
+## `v0.4.4` — [2025-10-25]
+
+- Add uv-ship config [afd3bed]
+- Merge pull request #2 from johnscillieri/codex/refactor-family-strings-into-constants [cf84c0f]
+- Polish enum usage and update changelog [c3fb7f4]
+- Merge pull request #1 from johnscillieri/codex/add-support-for-huawei-harmonyos [45fe0f9]
+- Document HarmonyOS support addition [584ed2f]
+- Added: HarmonyOS detection for Huawei devices, including dedicated parsing and metadata.
+- Added: HarmonyOS normalization captures build identifiers (e.g., `5.0.0.107`) and propagates them into generated CPE data.
+- Changed: Replaced string literals for OS families and precision tiers with shared enums and ordering constants across the normalization pipeline.
+
+## [0.4.3] - 2025-10-20
+
+- Fixed: Windows build parsing and inconsistent strings
+
+## [0.4.2] - 2025-10-20
+
+- Fixed: Windows product fingerprinting by build number
+
+## [0.4.1] - 2025-09-25
+
+- Added: Broadened Windows product aliases (e.g., Win11, Win2k) and recognized the macOS 26 codename `Tahoe`.
+- Changed: Windows normalization now always fills NT version major/minor fields and treats marketing releases (21H2/24H2/etc.) as the kernel version for richer telemetry.
+- Changed: Windows CPE generation derives release-channel tokens from build numbers so clients emit `windows_10_21h2`, `windows_11_24h2`, and similar slugs automatically.
+- Fixed: Windows 11 and Server 2025 inputs no longer fall back to Windows 10 defaults, and legacy server builds keep their correct product names.
+- Fixed: Windows `OSData` string formatting avoids duplicate fragments and skips redundant kernel numbers when printing friendly names.
+
+## [0.4.0] - 2025-09-22
+
+- Changed: Windows parser now normalizes typoed `windws` tokens, infers server editions from `Windows 2008/2012/2003` strings, and derives build numbers from generic `6.x.yyyy` patterns.
+- Fixed: Windows Server 2012 R2 and older NT-based servers are correctly identified when only kernel/build identifiers are present.
+- Fixed: OSData now always captures `kernel_version`/`version_build` for telemetry-only inputs.
+
+## [0.3.4] - 2025-09-21
+
+- Added: Extensive Windows kernel/build fixtures (e.g., `Windows 7601 6.1.7601 ...`) to lock in parsing of raw telemetry strings.
+- Added: Coverage for Windows Server kernel identifiers to ensure server products are emitted with matching CPE metadata.
+- Added: Regression tests for Redstone/Windows 10 marketing channels and mixed-case architecture tokens.
+
+## [0.3.3] - 2025-09-21
+
+- Added: `tests/case_utils.py` to share parametrization helpers across suites.
+- Added: Platform-specific suites for clearer test changes.
+- Removed: Legacy `tests/test_os_normalizer.py` harness now that coverage lives beside each platform.
+
+## [0.3.2] - 2025-09-11
+
+- Added: More `pyproject.toml` metadata (description, keywords, classifiers, project URLs).
+- Added: `LICENSE` (MIT) and referenced it from project metadata.
+- Added: `RELEASING.md` with step-by-step TestPyPI/PyPI instructions.
+- Changed: Switched to Hatchling build backend via `[build-system]` in `pyproject.toml`.
+- Changed: Exclude dev artifacts from sdist (`tests/`, caches, lockfiles, egg-info).
+
+## [0.3.1] - 2025-09-09
+
+- Added: Table printing of all OS values.
+
+## [0.3.0] - 2025-09-09
+
+- Added: Support merging in new data to combine observations.
+- Added: Tests covering merge behavior.
+
+## [0.2.0] - 2025-09-09
+
+- Added: Additional `os_key` data for broader OS coverage.
+- Changed: Improve Linux and macOS parsing; update BSD product extraction; better Windows version identification; fix Darwin kernel parsing.
+- Changed: Break up network parsing into vendor-specific modules; general code cleanup; repo structure tidy-up.
+- Changed: Rename `OSParse` to `OSData`; project renamed to `os_normalizer`.
+- Changed: Adopt Ruff and reformat codebase; fix linter errors; improve test harness.
+- Fixed: Failing tests (including `tests/test_full.py`).
+- Removed: Old `Observation` class; now parse text and data directly.
+
+## [0.1.0] - 2025-09-06
+
+- Initial release.
+
+[Unreleased]: https://github.com/johnscillieri/os-normalizer/compare/v0.4.1...HEAD
+[0.4.1]: https://github.com/johnscillieri/os-normalizer/compare/v0.4.0...v0.4.1
+[0.4.0]: https://github.com/johnscillieri/os-normalizer/compare/v0.3.4...v0.4.0
+[0.3.4]: https://github.com/johnscillieri/os-normalizer/compare/v0.3.3...v0.3.4
+[0.3.3]: https://github.com/johnscillieri/os-normalizer/compare/v0.3.2...v0.3.3
+[0.3.2]: https://github.com/johnscillieri/os-normalizer/compare/v0.3.1...v0.3.2
+[0.3.1]: https://github.com/johnscillieri/os-normalizer/compare/v0.3.0...v0.3.1
+[0.3.0]: https://github.com/johnscillieri/os-normalizer/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/johnscillieri/os-normalizer/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/johnscillieri/os-normalizer/releases/tag/v0.1.0

os_normalizer-0.5.1/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.

os_normalizer-0.5.1/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: os-normalizer
+Version: 0.5.1
+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: Programming Language :: Python :: 3.14
+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 supplimental 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 OS Release Data
+
+```python
+from os_normalizer import normalize_os
+
+# Fingerprint with both raw string and contents of os-release file
+raw_os_string="Linux host 5.15.0-122-generic x86_64"
+os_release_data={
+    "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, os_release_data)
+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.5.1/README.md

@@ -0,0 +1,128 @@
+# 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 supplimental 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 OS Release Data
+
+```python
+from os_normalizer import normalize_os
+
+# Fingerprint with both raw string and contents of os-release file
+raw_os_string="Linux host 5.15.0-122-generic x86_64"
+os_release_data={
+    "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, os_release_data)
+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.5.1/RELEASING.md

@@ -0,0 +1,23 @@
+# Releasing to PyPI
+
+This project uses a modern PEP 621 `pyproject.toml` with the Hatchling build backend. Below are the steps to build and publish to PyPI using uv-ship.
+
+## Prereqs
+
+- Python 3.11+
+- `uv` installed (https://github.com/astral-sh/uv)
+- `uv-ship` installed (via `uv tool install uv-ship`)
+- PyPI accounts and API tokens for TestPyPI and/or PyPI
+
+## Run tests and lint
+
+- `uv run pytest`
+- Optionally: `uv run nox`
+
+## Releasing
+
+- `uv-ship next <type>` where type is major|minor|patch
+- Follow the prompts and release the new version to Github
+- `rm -rf dist`
+- `uv build`
+- `uvx twine upload dist/*`

os_normalizer-0.5.1/os_normalizer/__init__.py

@@ -0,0 +1,10 @@
+from .models import OSData
+from .os_normalizer import choose_best_fact, normalize_os, merge_os, update_os
+
+__all__ = [
+    "OSData",
+    "choose_best_fact",
+    "normalize_os",
+    "merge_os",
+    "update_os",
+]