Skip to main content

A no-compromises wrapper for the CurseForge API

Project description

Curseforge API

This is a no-compromise CurseForge API wrapper for python. It is a re-write of cursepy which is maintained but not actively developed. This project is a complete re-write of the original project, with a focus on simplicity and ease of use.

This project is still in development, and is not yet ready for production use. It also speeds up the process by using disk caching, It will cache the response from the API and will only make a new request if the request is not cached.

This, of course can be disabled by setting the cache to False.

Features

  • Simple and easy to use
  • Caches responses from the API to disk for faster response times
  • Allows direct access to the API via the fetch method
  • Allows exporting of the objects to DICT, JSON, or YAML
  • Can directly parse a manifest file from a curseforge modpack

Installation

pip install curseforge

Usage

from curseforge import CurseClient

client = CurseClient("API-KEY", cache=True)

minecraft = client.game(432) # 432 is the ID of Minecraft

# or we can list all the games
games = client.games()

for game in games:
    print(game.name)

# The search is up to the user to implement, this is just a wrapper

# We can also get the latest files for a project

JourneyMap = client.mod(2238) # 2238 is the ID of JourneyMap

for file in JourneyMap.files:
    print(file.name)

TODO

  • Implement the export methods
  • Implement the cache
  • Implement the fetch method
  • Deal with the download URL being a null value
  • Implement the search method
  • Wrap the ENTIRE API
  • Rename the classes so they have a Curse prefix

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

curseforge-1.5.5.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

curseforge-1.5.5-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

Details for the file curseforge-1.5.5.tar.gz.

File metadata

  • Download URL: curseforge-1.5.5.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.2

File hashes

Hashes for curseforge-1.5.5.tar.gz
Algorithm Hash digest
SHA256 2f739bce0f84785c0eedcd8640c299a09ac9937fd1451d3760a26fbee51bab26
MD5 32aa1150dba8872f72f753eb62001b4d
BLAKE2b-256 38e426d6ff4d7a87ece1bb0a38414b740ef56a126f923dc3d9785e34b7e1d5b9

See more details on using hashes here.

File details

Details for the file curseforge-1.5.5-py3-none-any.whl.

File metadata

  • Download URL: curseforge-1.5.5-py3-none-any.whl
  • Upload date:
  • Size: 10.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.2

File hashes

Hashes for curseforge-1.5.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c9ec94dc3b9a07e059f11194558946067985331596569877116bc5c00e665942
MD5 3ede430277adf6d192313dbfcf49d158
BLAKE2b-256 e9949aafdb6d591b0220bff8c11bbe63d713bc27b189b55b90dcbf6b71699f26

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page