Skip to main content

Processing for CPython

Project description

py5

py5 monthly downloads

py5 weekly downloads

mybinder

py5 is a new version of Processing for Python 3.9+. The goal of py5 is to create a version of Processing that is integrated into the Python ecosystem. Built into the library are thoughtful choices about how to best get py5 to work with other popular Python libraries and tools such as Jupyter, numpy, shapely, trimesh, matplotlib, and Pillow.

py5 is an excellent choice for educators looking to teach Python in the context of creative coding and is currently used in classrooms all around the world. The documentation website includes introductory tutorials as well as extensive reference documentation, complete with example code.

Basic Example

Here is a basic example of a working py5 Sketch:

import py5


def setup():
    py5.size(400, 400)
    py5.rect_mode(py5.CENTER)


def draw():
    py5.square(py5.mouse_x, py5.mouse_y, 10)


def mouse_clicked():
    py5.fill(py5.random_int(255), py5.random_int(255), py5.random_int(255))


py5.run_sketch()

Installation

If you have Java 17 installed on your computer, you can install py5 using pip:

pip install py5

Detailed installation instructions are available on the documentation website. There are some Special Notes for Mac Users that you should read if you use macOS.

Getting Started

If you are new to Python, start with the intro to py5 and python tutorials. If you are familiar with Java programming and Processing, you'll find the Tips for Processing Java Users page to be helpful.

There are currently five basic ways to use py5. They are:

  • module mode: create a sketch with setup() and draw() functions that call methods provided by the py5 library. The above example is created in module mode.
  • class mode: create a Python class inherited from py5.Sketch. This mode supports multiple Sketches running at the same time.
  • imported mode: simplified code that omits the py5. prefix. This mode is supported by the py5 Jupyter notebook kernel and the py5-run-sketch command line utility.
  • static mode: functionless code to create static images. This mode is supported by the py5bot Jupyter notebook kernel, the %%py5bot IPython magic, and the py5-run-sketch command line utility.
  • processing mode: make calls to Python from a Processing (Java) Sketch. This mode enables py5 to function as bridge, connecting the Python and Java ecosystems through a new callPython() method.

Source Code

py5 was created by the artist and software developer Jim Schmitz (@hx2A) starting in March of 2020. The library is the foundation of his art practice.

The py5 library makes the Java Processing jars available to the CPython interpreter using JPype. It can do just about everything Processing can do, except with Python instead of Java code. New py5 features and bug fixes are being added to py5 every day. The library is always in active development and is well maintained.

To view the actual installed py5 library code, look at the py5 repository. The py5 library code is the output of the meta-programming project py5generator. All py5 development is done through py5generator.

Funding

Please sponsor py5!

This project is not an official part of the Processing Foundation and is not receiving any funding from them. Any funds you contribute will be used first for website expenses and next to support @hx2A's time to further develop py5 as a solid creative coding framework used by educators, artists, and hobbyists all around the world.

Get In Touch

Have a comment or question? We'd love to hear from you! The best ways to reach out are:

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

py5-0.10.6a0.tar.gz (12.1 MB view details)

Uploaded Source

Built Distribution

py5-0.10.6a0-py3-none-any.whl (12.2 MB view details)

Uploaded Python 3

File details

Details for the file py5-0.10.6a0.tar.gz.

File metadata

  • Download URL: py5-0.10.6a0.tar.gz
  • Upload date:
  • Size: 12.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for py5-0.10.6a0.tar.gz
Algorithm Hash digest
SHA256 0373ea15074c806ea3ccba15821b27aad8ee8300f5b6d6160be7aad4463fd09c
MD5 33f21e0435a1280d5ebef15f65670f2f
BLAKE2b-256 924c162b657a3677a924e3e245341d5b1622d649b8b8a56d6a81723501755e0b

See more details on using hashes here.

File details

Details for the file py5-0.10.6a0-py3-none-any.whl.

File metadata

  • Download URL: py5-0.10.6a0-py3-none-any.whl
  • Upload date:
  • Size: 12.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for py5-0.10.6a0-py3-none-any.whl
Algorithm Hash digest
SHA256 02428e63feefb3e85f4462c9fdd974981f714d63d34ee53aa23ea639338ae4a8
MD5 025614a9c32d65dd41b773f701d5cab3
BLAKE2b-256 4a7b7d71f44f8bbf68585254c2452bf2b20576124d50eb39f15d8299940dcae6

See more details on using hashes here.

Supported by

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