Skip to content

A client library for the Modrinth API, generated with openapi-generator

License

Notifications You must be signed in to change notification settings

diacritics-owo/modrinth-api

Repository files navigation

modrinth-api

A client library for the Modrinth API, generated with openapi-generator

Getting Started

The major and minor versions of this library correspond directly to the version of the Modrinth API (the patch version may be separate). The earliest supported version of the API is 2.7.0.

Usage Notes

  • When using a token, use Configuration::with_api_key.

Documentation

It is generally not necessary, as most things are self-explanatory, but if you do need to view the documentation, generate the library (see Developing) and view the docs folder.

Developing

  • Prerequisites
    • Java
    • Deno

To generate the client library, run deno task gen. This will use openapi-generator (located at openapi/openapi-generator.jar) to generate the library from the Modrinth API spec (located at openapi/openapi-generator.jar, downloadable from https://docs.modrinth.com/).

Post-processing of the generated files is done within openapi/gen.ts. Edit dependencies.toml, tests.rs, or package.toml to add dev dependencies, edit tests, and add package metadata, respectively. If you need to make deeper modifications to code, edit the file directly and add it to .openapi-generator-ignore.

When updating the API version, remember to also update openapi/config.yaml.

About

A client library for the Modrinth API, generated with openapi-generator

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages