feat(registry): implement async HTTP client using httpx #24

New issue

Closed

opened 2026-06-05 17:33:56 +00:00 by CoreRasurae · 0 comments

CoreRasurae commented

2026-06-05 17:33:56 +00:00

Member

Copy link

Metadata

Commit Message: feat(registry): implement async RegistryClient using httpx
Branch: feature/m1-registry-http-client

Background and context

The Package Registry Standard v1.0.0 (§8) defines 4 HTTP API endpoints: GET /packages/{id} (retrieve by PackageId), GET /{type}/{ns}/{name}?version= (resolve a reference), GET /browse (discovery), GET /.well-known/cleverthis-packages (registry metadata). The client uses httpx — mirrors requests API, supports sync+async, already installed (0.27.2).

Part of Epic: Package Registry Client — Support Package Registry Standard v1.0.0

Current behavior

No HTTP registry client exists.

Expected behavior

RegistryClient configured per server URL, async via httpx.AsyncClient
All 4 endpoints implemented with proper request/response handling
Version alias resolution (latest, vx, vX.Y.x, vX.x) per §4.2
Anonymous reads (§9.1), optional API key auth (§9.2)
Error mapping: all 8 error types → typed exceptions
Add httpx as explicit dependency in pyproject.toml

Acceptance criteria

Fetching a valid PackageId returns its YAML content as dict
Version alias resolution works for all alias types
404 → PackageNotFoundError, 400 → InvalidPackageIdError, etc.
Connection errors and timeouts → RegistryNetworkError

Subtasks

Create src/cleveractors/registry/client.py with RegistryClient class
Implement GET /packages/{id} endpoint
Implement GET /{type}/{ns}/{name}?version= with version resolution
Implement GET /browse with type/namespace filters
Implement GET /.well-known/cleverthis-packages discovery
Error mapping to typed exceptions from exceptions.py
Add httpx dependency to pyproject.toml
Tests (Behave): features/registry_http_client.feature — mock server covering all endpoints
Tests (Robot): robot/registry_integration.robot — against fake registry server
Tests (Benchmark ASV): benchmarks/registry_http_client.py -- against fake registry server
Verify coverage >=97% via nox -s coverage_report
Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when:

All subtasks above are completed and checked off.
A Git commit is created where the first line matches the Commit Message in Metadata exactly.
The commit is pushed to the branch matching the Branch in Metadata exactly.
The commit is submitted as a PR to master, reviewed, and merged.

## Metadata Commit Message: feat(registry): implement async RegistryClient using httpx Branch: feature/m1-registry-http-client ## Background and context The Package Registry Standard v1.0.0 (§8) defines 4 HTTP API endpoints: `GET /packages/{id}` (retrieve by PackageId), `GET /{type}/{ns}/{name}?version=` (resolve a reference), `GET /browse` (discovery), `GET /.well-known/cleverthis-packages` (registry metadata). The client uses `httpx` — mirrors `requests` API, supports sync+async, already installed (0.27.2). Part of Epic: Package Registry Client — Support Package Registry Standard v1.0.0 ## Current behavior No HTTP registry client exists. ## Expected behavior - `RegistryClient` configured per server URL, async via `httpx.AsyncClient` - All 4 endpoints implemented with proper request/response handling - Version alias resolution (`latest`, `vx`, `vX.Y.x`, `vX.x`) per §4.2 - Anonymous reads (§9.1), optional API key auth (§9.2) - Error mapping: all 8 error types → typed exceptions - Add `httpx` as explicit dependency in `pyproject.toml` ## Acceptance criteria - Fetching a valid `PackageId` returns its YAML content as dict - Version alias resolution works for all alias types - 404 → `PackageNotFoundError`, 400 → `InvalidPackageIdError`, etc. - Connection errors and timeouts → `RegistryNetworkError` ## Subtasks - [ ] Create `src/cleveractors/registry/client.py` with `RegistryClient` class - [ ] Implement `GET /packages/{id}` endpoint - [ ] Implement `GET /{type}/{ns}/{name}?version=` with version resolution - [ ] Implement `GET /browse` with type/namespace filters - [ ] Implement `GET /.well-known/cleverthis-packages` discovery - [ ] Error mapping to typed exceptions from `exceptions.py` - [ ] Add `httpx` dependency to `pyproject.toml` - [ ] Tests (Behave): features/registry_http_client.feature — mock server covering all endpoints - [ ] Tests (Robot): robot/registry_integration.robot — against fake registry server - [ ] Tests (Benchmark ASV): benchmarks/registry_http_client.py -- against fake registry server - [ ] Verify coverage >=97% via nox -s coverage_report - [ ] Run nox (all default sessions), fix any errors ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - A Git commit is created where the first line matches the Commit Message in Metadata exactly. - The commit is pushed to the branch matching the Branch in Metadata exactly. - The commit is submitted as a PR to master, reviewed, and merged.

CoreRasurae added this to the v2.1.0 milestone

2026-06-05 17:33:56 +00:00

~~CoreRasurae referenced this issue 2026-06-05 17:36:35 +00:00~~

Epic: Package Registry Client — Support Package Registry Standard v1.0.0 #22

~~CoreRasurae referenced this issue 2026-06-05 17:36:52 +00:00~~

feat(registry): extend TemplateType and integrate PackageReference into template system #27

~~CoreRasurae referenced this issue 2026-06-05 17:36:53 +00:00~~

feat(registry): implement client-side LRU cache with TTL and ID validation #28

~~CoreRasurae referenced this issue 2026-06-05 17:36:55 +00:00~~

feat(registry): implement BDD test features and compliance test vectors #30

CoreRasurae added a new dependency

2026-06-05 17:41:00 +00:00

#22 Epic: Package Registry Client — Support Package Registry Standard v1.0.0

CoreRasurae changed title from ~~Registry HTTP client — async resolver and fetcher using httpx~~ to feat(registry): implement async HTTP client using httpx

2026-06-05 17:47:07 +00:00

CoreRasurae referenced this issue from a commit

2026-06-05 20:18:00 +00:00

feat(registry): implement async RegistryClient using httpx

CoreRasurae referenced this issue from a pull request that will close it,

2026-06-05 20:18:25 +00:00

feat(registry): implement async RegistryClient using httpx #32

CoreRasurae added a new dependency

2026-06-05 20:21:07 +00:00

#32 feat(registry): implement async RegistryClient using httpx

CoreRasurae referenced this issue from a commit

2026-06-05 21:07:29 +00:00