netbox-sdk v0.0.8

The first minor-stable release on the new schema-driven foundation. v0.0.8
finalises everything that landed across the v0.0.7.post1 → post6 series: a
typed SDK that knows about NetBox 4.6, a schema-driven mock server, a
TUI login modal, hardened async lifecycle and connection pooling, a
migration to ty for type checking, and a CI matrix that now lives-tests
against the three currently supported NetBox releases.

Highlights

NetBox 4.6 is a first-class supported release line

• typed_api() now selects between NetBox 4.6, 4.5, 4.4, and 4.3.
• Bundled OpenAPI schema (netbox_sdk/reference/openapi/netbox-openapi-4.6.json),
  Pydantic models (netbox_sdk.models.v4_6), and typed endpoint bindings
  (netbox_sdk.typed_versions.v4_6) ship with the package.
• Pre-releases such as 4.6.0-beta2 normalise to the 4.6 typed client.
• Version-aware OpenAPI schema selection at runtime; graceful 4.5 fallback
  when the requested release line is unknown.

Live-NetBox CI matrix rotated to v4.5.8 / v4.5.9 / v4.6.0-beta2

• .github/workflows/test.yml now spins up real NetBox containers via
  ghcr.io/netbox-community/netbox for v4.5.8, v4.5.9, and
  v4.6.0-beta2, replacing the previous v4.3.4 / v4.4.9 / v4.5.7
  matrix.
• Mock-API mode is still exercised on Python 3.11 / 3.12 / 3.13 in
  parallel.
• Matching docs and CLAUDE.md guidance updated end-to-end (EN + PT)
  so the supported-release set advertised to users matches the runtime
  surface and the CI gate.

Schema-driven in-memory mock server

• New nbx mock / netbox-sdk[mock] extra: schema-driven FastAPI mock
  server with reset endpoints and per-version routes.
• Examples and MkDocs guides under docs/mock-api/.
• Pytest-integration cookbook page updated to parametrise across all
  four supported release lines.
• Fixed list-seeding bug so custom data lands in _collections (and not
  _objects).

Typed SDK ergonomics and lifecycle

• Async connection pooling and lifecycle hardening on
  NetBoxApiClient (graceful close, retry kwargs, simpler session
  fast-path, casts removed).
• Tolerant of mock sessions without a closed attribute.
• Logging-runtime tweaks and structured-output safety improvements.
• Runtime plugin resource discovery: the SDK can now walk a live NetBox
  instance to discover plugin API surfaces.

TUI

• New LoginModal for username/password sign-in (closes #12).
• TUI lifecycle module split out for cleaner Pilot tests.
• TCSS / theme cleanups.

Tooling and security

• Migrated type checks from mypy to ty across dev and CI.
• Pinned pydantic==2.13.3; bumped aiohttp>=3.13.4 and added
  requests to address Dependabot alerts.
• Security: timing-safe token comparison, demo password no longer
  persisted to disk, mock server now binds to loopback by default.
• .dockerignore per-service for tighter build contexts.

Documentation

• New developer guide section: SDK internals, architecture diagrams,
  proxbox-api integration notes, Claude/agent reference index.
• Install docs aligned with the package version snippets and guard
  against drift.
• Full Portuguese mirror coverage for every doc page touched in this
  series.

Compatibility

• Python: 3.11, 3.12, 3.13
• NetBox typed support: 4.6, 4.5, 4.4, 4.3
• Live CI gate: v4.5.8, v4.5.9, v4.6.0-beta2

Full changelog

v0.0.7...v0.0.8