/wantstoparty

An API wrapper for the wants-to.party API.

Primary LanguagePythonMIT LicenseMIT

wantstoparty

An API wrapper for the wants-to.party API.

About

wantstoparty is a feature-rich API wrapper for the wants-to.party API which provides full API coverage, supporting blocking/non-blocking HTTP methods and much more.

Notable features:

  • Blocking (sync) and non-blocking (async) support. blocking example non-blocking example
  • Upload files by providing a local file path. (I.E, file stored on disk) or bytes-like file object. (see examples above)
  • Get all files hosted on your wants-to.party account.
  • Get account information associated with the given API key.
  • Delete files by their given file ID.
  • Set a maximum uploadable file size limit.
    • Prevents files that exceed your specified limit being uploaded. see example
  • Validation for unsupported file types.
  • User-friendly errors for handling status codes of failed HTTP requests.

Created by acatia#5378

Installation & Setup

  1. Install the package:

    pip install wantstoparty
    
  2. Create a wants-to.party account.

  3. On your dashboard, click the "View api key" button:

    image

  4. Import the WantsToParty class:

    from wantstoparty import WantsToParty
    
    # For async use, refer to the examples.
    wtp = WantsToParty("api key from dashboard")

Join the Motion Development server for extra help, here.

Examples

Some examples can be found in the examples/ folder.

Contributing

Contributions are welcome! Check out the contributing guidelines beforehand.

License

This is licensed under MIT. Read the license here.