Skip to main content

Spume

A python terminal-based fluid simulator with ASCII visualisations and minimal dependencies (no rendering dependencies).

Features

  • Minimal ascii, completely cli-based visualisation
  • Minimal external dependencies
  • Interactive; click to disperse, WASD to move spawn point
  • Highly extensible; diverse CLI flags to customise physics and visualisation

Installation

pip install spume
spume -h # Look at possible options

Usage

WASD to move the spawner around, left mouse click (with drag) to disperse fluid, q to exit.

You can also use the CLI flags to customise the simulation, e.g. spawner size, sim maxiter / tolerance (depending on how beefy your laptop is), etc.

Enjoy!

Compatability

Unfortunately, termios is not available on windows, and so for the time being this project will be a unix-only project. I have neither the resources nor the motivation for windows compatability, right now, but I will happily merge any PRs.

Contributing

What I really need right now is good names; I wanted plume, but that was taken on pypi; so I went for spume, but it doesn't seem as poetic. Any ideas?

Metadata

Release files for spume 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for spume 0.1.4
File Size Uploaded Provenance Actions
spume-0.1.4.tar.gz 17.5 kB Without provenance Details for spume-0.1.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for spume 0.1.4
File Interpreter ABI Platform Actions
spume-0.1.4-py3-none-any.whl Python 3 none any Details for spume-0.1.4-py3-none-any.whl

Total release size: 36.8 kB

Release files / spume-0.1.4.tar.gz

Download URL spume-0.1.4.tar.gz
Size 17.5 kB
Tags Source
SHA-256 checksum
How to use checksums
6b23859c85f12de5d266b84b71d6926863ec22a8b87dd08630d157295387b8f7
BLAKE2b-256 checksum
How to use checksums
c84a69ab2ca122106c09c86d58de05b1d9e25c5ffff8dd4ad688edef00b07a3d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / spume-0.1.4-py3-none-any.whl

Download URL spume-0.1.4-py3-none-any.whl
Size 19.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4a6f6ff51d65135319d6d040e747ff7cd8549fb4c2701b4988299d1e716d6b03
BLAKE2b-256 checksum
How to use checksums
706b9a1b279b3436c2e2b4b8320cfc5585bf40b60cf66f58ec9a2e7ca779b4e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for spume 0.1.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page