# netbox-sdk v0.0.8

netbox-sdk v0.0.8

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/netbox-sdk/releases/v0.0.8 |
| GitHub URL | https://github.com/emersonfelipesp/netbox-sdk/releases/tag/v0.0.8 |
| Tag | v0.0.8 |
| State | stable |
| Author | emersonfelipesp |
| Created | 2026-05-04 20:28 UTC |
| Published | 2026-05-04 20:29 UTC |
| Target | main |
| Synced | 2026-08-25 01:07 UTC |
| Assets | 0 |

## Release notes

# 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](https://github.com/emersonfelipesp/netbox-sdk/compare/v0.0.7...v0.0.8)

## Assets

No binary assets attached.

Source archives:

| Format |URL |
| --- | --- |
| zip | https://api.github.com/repos/emersonfelipesp/netbox-sdk/zipball/v0.0.8 |
| tar.gz | https://api.github.com/repos/emersonfelipesp/netbox-sdk/tarball/v0.0.8 |