#modrinth #minecraft #api-client #api-bindings #api-version #api

modrinth-api

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

2 stable releases

2.7.1 Sep 5, 2024

#810 in Web programming


Used in axolotl-cli

CC0 license

1MB
5.5K SLoC

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.

Dependencies

~8–20MB
~275K SLoC