Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions builds/packages/base/internetworking/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@ The core package intentionally ships only compact, curated static registries wit
- `computecommons-data-iana` for complete IANA protocol, port, and media-type registries
- `computecommons-data-pci` for PCI vendor and device identifiers
- `computecommons-data-usb` for USB vendor and product identifiers
- `computecommons-data-oui` for IEEE OUI and MAC address assignment data

## Package boundaries

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,9 @@
ARCHITECTURE_ALIASES_METADATA = RegistryMetadata(
name="architecture-aliases",
source="Curated aliases for common CPU architectures",
version="0.1.0",
source_url="package://computecommons/static/architectures.py",
package_curation_version="0.1.0",
compactness_notes="Hand-picked aliases for common runtime and packaging architecture names.",
published_at="2026-07-15",
)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,9 @@ class Filesystem:
FILESYSTEMS_METADATA = RegistryMetadata(
name="filesystems",
source="Curated aliases for common filesystems",
version="0.1.0",
source_url="package://computecommons/static/filesystems.py",
package_curation_version="0.1.0",
compactness_notes="Compact list of common local, server, and image filesystems only.",
published_at="2026-07-15",
)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,10 @@ def value(self) -> str:
name="media-types",
source="Curated subset of the IANA Media Types registry",
source_url="https://www.iana.org/assignments/media-types/media-types.xhtml",
package_curation_version="0.1.0",
compactness_notes=(
"Subset limited to frequently encountered application, text, and image media types."
),
retrieved_at="2026-07-15",
)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,18 @@

@dataclass(frozen=True, slots=True)
class RegistryMetadata:
"""Provenance metadata for a compact static registry."""
"""Provenance and curation metadata for a compact static registry.

Static registries in the core package are intentionally small, curated
snapshots. Complete externally maintained registries should be distributed
through optional data packages instead of being embedded here.
"""

name: str
source: str
package_curation_version: str
compactness_notes: str
source_url: str | None = None
version: str | None = None
source_version: str | None = None
published_at: str | None = None
retrieved_at: str | None = None
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,12 @@ class OperatingSystemRelease:
OPERATING_SYSTEMS_METADATA = RegistryMetadata(
name="operating-systems",
source="Curated aliases for common operating-system releases and families",
version="0.1.0",
source_url="package://computecommons/static/operating_systems.py",
package_curation_version="0.1.0",
compactness_notes=(
"Representative OS families and releases used for normalization, "
"not a distribution catalog."
),
published_at="2026-07-15",
)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,8 @@ def __post_init__(self) -> None:
name="well-known-ports",
source="Curated subset of the IANA Service Name and Transport Protocol Port Number Registry",
source_url="https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml",
package_curation_version="0.1.0",
compactness_notes="Subset limited to foundational well-known ports needed by core helpers.",
retrieved_at="2026-07-15",
)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@
name="ip-protocol-numbers",
source="Curated subset of the IANA Protocol Numbers registry",
source_url="https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml",
package_curation_version="0.1.0",
compactness_notes=(
"Subset limited to common IP protocol numbers used by lightweight networking models."
),
retrieved_at="2026-07-15",
)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,12 @@ class Vendor:
VENDORS_METADATA = RegistryMetadata(
name="vendors",
source="Curated aliases for common compute vendors",
version="0.1.0",
source_url="package://computecommons/static/vendors.py",
package_curation_version="0.1.0",
compactness_notes=(
"Small alias set for common compute vendors; PCI, USB, and OUI identifiers "
"are out of core."
),
published_at="2026-07-15",
)

Expand Down
3 changes: 3 additions & 0 deletions builds/packages/base/internetworking/tests/test_static.py
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,9 @@ def test_static_registry_metadata_is_present() -> None:
"well-known-ports",
}
assert all(item.source for item in metadata)
assert all(item.source_url for item in metadata)
assert all(item.package_curation_version == "0.1.0" for item in metadata)
assert all(item.compactness_notes for item in metadata)

with pytest.raises(FrozenInstanceError):
WELL_KNOWN_PORTS_METADATA.name = "other" # type: ignore[misc]
Expand Down