Skip to main content

A libretro frontend for Python intended for testing cores.

Project description

libretro.py

A Python binding for libretro intended for testing cores, but suitable for any purpose. Ease of use, flexibility, and complete API support are top priorities.

Build Status PyPi License

Supported Environments

libretro.py has the following requirements:

  • Python 3.10 or newer. May not work on alternative Python implementations like PyPy.
  • Supported on Windows, macOS, and Linux. May work on other platforms, but no promises.

Nothing else is required for most functionality, but some extra features have additional dependencies or constraints.

If contributing then just is optional but recommended, as it will simplify most development tasks. For details, run just (no arguments) in the project root.

Installing

libretro.py supports Python 3.10 or newer. Nothing else is required for most functionality, but some extra features have additional dependencies.

You can install libretro.py with pip like so:

# Install the base libretro.py
pip install libretro.py

Using a virtual environment is recommended:

# Create a virtual environment
python -m venv ./venv

# Activate the virtual environment (in Bash)
source ./venv/bin/activate

# Activate the virtual environment (in PowerShell)
./venv/Scripts/activate.ps1 

Or if you have just installed, let it figure out the details for you:

just venv

Extras

To install additional features, add one or more of the following extras to the install command:

  • dev: Assorted tools used to help develop libretro.py. Required if contributing to libretro.py.
  • opengl: Support for the built-in OpenGL video driver. Required if testing a core's OpenGL support.
  • pillow: Support for the built-in software-only video driver powered by the Pillow image processing library. Not required for any particular feature, but it simplifies tests that inspect the core's video output.

For example, if you want to submit an improvement to the Pillow video driver, you would install libretro.py like so:

pip install libretro.py[pillow,dev]

And if you just want to test your libretro core's OpenGL support:

pip install libretro.py[opengl]

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

libretro_py-0.0.0.tar.gz (91.8 kB view hashes)

Uploaded Source

Built Distribution

libretro.py-0.0.0-py3-none-any.whl (129.1 kB view hashes)

Uploaded Python 3

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