Skip to content

[4.x] Add the Dependency Graph API package - #85

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

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

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->dependencyGraph (Package\DependencyGraph): compare() (dependency review between two refs), createSnapshot(), generateSbomReport() and fetchSbomReport().

Notes for review

  • compare() encodes both refs separately and keeps the ... separator.
  • fetchSbomReport() returns the download URL, or '' while the report is still being generated (202).
  • The deprecated synchronous SBOM export is not included.

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.

9 new tests.

Documentation Changes Required

Adds docs/dependency-graph.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->dependencyGraph covering the dependency review diff between
commits, dependency snapshot submission and the SBOM report generation and
fetch, with tests and docs.

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