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.6.1.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

curseforge-1.6.1-py2.py3-none-any.whl (11.5 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: curseforge-1.6.1.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.13

File hashes

Hashes for curseforge-1.6.1.tar.gz
Algorithm Hash digest
SHA256 a33a17e45faf9abdfcabd255ea1e3cfc4ec972e4396cfccd70d57c3aec25eb2c
MD5 5f4eb040513353fc1e65ca32d7196342
BLAKE2b-256 efed812042c0af9840000a43c9846835cbafc8a6342bb6d9c9e238881d641015

See more details on using hashes here.

File details

Details for the file curseforge-1.6.1-py2.py3-none-any.whl.

File metadata

  • Download URL: curseforge-1.6.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 11.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.13

File hashes

Hashes for curseforge-1.6.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 88fbc212c08a27b3d5952d6b739d9d49a2a610b676f0dbed9be0ca557b75800f
MD5 63bd95624921bb5341f8f6d89e6be6f0
BLAKE2b-256 b113a12123da4b5f03520251b03a093606e1169f9c2bee92441eeb91728ac19a

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