Skip to content

[4.x] Add the Packages API package - #76

Open
Hackwar wants to merge 1 commit into
joomla-framework:4.x-devfrom
Hackwar:4.x-github-packages
Open

Hackwar wants to merge 1 commit into
joomla-framework:4.x-devfrom
Hackwar:4.x-github-packages

Conversation

@Hackwar

@Hackwar Hackwar commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

Summary of Changes

Part of bringing joomla/github up to the current GitHub REST API (phases 1–3 of the modernisation plan). Purely additive: no existing method changes signature or behaviour.

Adds $github->packages (Package\Packages, 27 methods): list, get, delete, restore, versions and Docker conflicts, each for organisations, users and the authenticated user.

Notes for review

  • Package names are rawurlencode()d, so container names with / work.
  • The docs page is docs/github-packages.md because [4.x] Update documentation #66 adds a docs/packages.md describing the library's own packages.
  • Following the spec, listing a user's package versions has no pagination or state filter, unlike the other scopes.

How it was built

Generated from GitHub's official OpenAPI description (github/rest-api-description, api.github.com). Every non-deprecated operation of the category is covered; /enterprises/* endpoints are left out, as the library targets github.com.

Conventions shared by all package PRs: path parameters first, then required body fields, then array $options (optional body fields), array $filters (optional query parameters) and $page, $limit for paginated endpoints; free-form path segments are rawurlencode()d; create-or-update operations are called createOrUpdate…; 204 responses return nothing, 302 downloads return the Location URL, "check" endpoints return a boolean.

Testing Instructions

vendor/bin/phpunit: every new method has a success test (HTTP verb, exact URL and query, exact JSON body, return value) and a failure test. phpcs and phpstan report no errors.

54 new tests.

Documentation Changes Required

Adds docs/github-packages.md. The @property-read line in Github.php and the link from docs/index.md are added together for all new packages in #67, to keep these PRs from conflicting with each other.

🤖 Generated with Claude Code

Adds $github->packages covering all non-deprecated operations of the GitHub
Packages REST API: packages and package versions owned by an organization,
a user or the authenticated user (list, get, delete, restore) and the Docker
migration conflict lists, with tests and docs/github-packages.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant