ecosyste-ms/package-manager-openapi-schemas

OpenAPI 3.0 specifications for package manager registry APIs.

8

9 commits

updated Nov 14, 2025

See the code

README

Package Manager OpenAPI Schemas

OpenAPI 3.0 specifications for many package manager registry APIs.

Initially extract from packages.ecosyste.ms and existing openapi specs.

Available Schemas

EcosystemRegistrySchemaOfficial Spec
NPMregistry.npmjs.orgnpm.yaml-
Goproxy.golang.orggo.yaml-
NuGetnuget.orgnuget.yaml-
PyPIpypi.orgpypi.yaml-
Mavenrepo1.maven.orgmaven.yaml-
Packagistpackagist.orgpackagist.yaml-
Rustcrates.iocrates-io.jsonOpenAPI 3.1.0
RubyGemsrubygems.orgrubygems.yaml-
Pubpub.devpub.yaml-
Hexhex.pmhex.yaml-
OpenVSXopen-vsx.orgopenvsx.jsonOpenAPI 3.1.0
Denoapiland.deno.devdeno.yaml-
Homebrewformulae.brew.shhomebrew.yaml-
CPANmetacpan.orgcpan.yaml-
Condaanaconda.orgconda.yaml-
Dockerhub.docker.comdocker.yaml-
Puppetforgeapi.puppet.compuppet.yaml-
Elmpackage.elm-lang.orgelm.yaml-
Cocoapodscocoapods.orgcocoapods.yaml-
Clojarsclojars.orgclojars.yaml-
Terraformregistry.terraform.ioterraform.yaml-
ArtifactHubartifacthub.ioartifacthub.yaml-
WordPressapi.wordpress.orgwordpress.yaml-
Drupalpackages.drupal.orgdrupal.yaml-

Usage

Generate API Clients

openapi-generator-cli generate -i openapi/npm.yaml -g python -o npm-client
openapi-generator-cli generate -i openapi/cargo.json -g typescript-axios -o cargo-client
# 50+ languages supported

Interactive Documentation

docker run -p 8080:8080 -e SWAGGER_JSON=/schemas/openapi/npm.yaml -v $(pwd):/schemas swaggerapi/swagger-ui

Mock Servers

npm install -g @stoplight/prism-cli
prism mock openapi/npm.yaml

Contributing

See CONTRIBUTING.md for detailed guidelines.

Quick start:

  1. Copy an existing schema as template
  2. Document the API endpoints
  3. Validate: swagger-cli validate openapi/your_ecosystem.yaml
  4. Update this README
  5. Submit PR

License

MIT License - see LICENSE for details.

Note: Schemas sourced from official specifications (marked in the table above) retain their original licenses as defined in the respective spec files.

openapi
package-manager
specs

ecosyste-ms/package-manager-openapi-schemas

OpenAPI 3.0 specifications for package manager registry APIs.

8

9 commits

updated Nov 14, 2025

See the code

README

Package Manager OpenAPI Schemas

OpenAPI 3.0 specifications for many package manager registry APIs.

Initially extract from packages.ecosyste.ms and existing openapi specs.

Available Schemas

EcosystemRegistrySchemaOfficial Spec
NPMregistry.npmjs.orgnpm.yaml-
Goproxy.golang.orggo.yaml-
NuGetnuget.orgnuget.yaml-
PyPIpypi.orgpypi.yaml-
Mavenrepo1.maven.orgmaven.yaml-
Packagistpackagist.orgpackagist.yaml-
Rustcrates.iocrates-io.jsonOpenAPI 3.1.0
RubyGemsrubygems.orgrubygems.yaml-
Pubpub.devpub.yaml-
Hexhex.pmhex.yaml-
OpenVSXopen-vsx.orgopenvsx.jsonOpenAPI 3.1.0
Denoapiland.deno.devdeno.yaml-
Homebrewformulae.brew.shhomebrew.yaml-
CPANmetacpan.orgcpan.yaml-
Condaanaconda.orgconda.yaml-
Dockerhub.docker.comdocker.yaml-
Puppetforgeapi.puppet.compuppet.yaml-
Elmpackage.elm-lang.orgelm.yaml-
Cocoapodscocoapods.orgcocoapods.yaml-
Clojarsclojars.orgclojars.yaml-
Terraformregistry.terraform.ioterraform.yaml-
ArtifactHubartifacthub.ioartifacthub.yaml-
WordPressapi.wordpress.orgwordpress.yaml-
Drupalpackages.drupal.orgdrupal.yaml-

Usage

Generate API Clients

openapi-generator-cli generate -i openapi/npm.yaml -g python -o npm-client
openapi-generator-cli generate -i openapi/cargo.json -g typescript-axios -o cargo-client
# 50+ languages supported

Interactive Documentation

docker run -p 8080:8080 -e SWAGGER_JSON=/schemas/openapi/npm.yaml -v $(pwd):/schemas swaggerapi/swagger-ui

Mock Servers

npm install -g @stoplight/prism-cli
prism mock openapi/npm.yaml

Contributing

See CONTRIBUTING.md for detailed guidelines.

Quick start:

  1. Copy an existing schema as template
  2. Document the API endpoints
  3. Validate: swagger-cli validate openapi/your_ecosystem.yaml
  4. Update this README
  5. Submit PR

License

MIT License - see LICENSE for details.

Note: Schemas sourced from official specifications (marked in the table above) retain their original licenses as defined in the respective spec files.

openapi
package-manager
specs

Significant stargazers

Wes Todd

806 followers · starred Nov 2025

Mike Linksvayer

546 followers · starred Nov 2025