pymunk is a easy-to-use pythonic 2d physics library that can be used whenever you need 2d rigid body physics from Python. It is built on top of the very nice 2d physics library Chipmunk, http://code.google.com/p/chipmunk-physics/
pymunk visionMake 2d physics easy to include in your game :)
It is (or striving to be):
Easy to use It should be easy to use, no complicated stuff should be needed to add physics to your game/program. "Pythonic" It should not be visible that a c-library (chipmunk) is in the bottom, it should feel like a python library (no strange naming, OO, no memory handling and more) Simple to build & install You shouldnt need to have a zillion of libraries installed to make it install, or do a lot of command line trixs. Multiplatform Should work on both windows, nix and OSX. Non-intrusive It should not put restrictions on how you structure your program and not force you to use a special game loop, it should be possible to use with other libraries like pygame and pyglet.
I hope and believe that with the latest release (1.0.0) these points are mostly fulfilled and visible if you use pymunk.
pymunk 1.0.0!Today after much waiting pymunk 1.0.0 was released!
With this release pymunk has most features I wanted, follows the latest chipmunk version, has quite good api documentation and is fairly well tested and hopefully quite stable. As such I think it's about time the version is bumped to 1.0.0.
As this version is updated to include the new features in chipmunk, and also contain at least one breaking change it is not unlikely that it will break your code. On the other hand, now it has the newest callback system (see Space.add_collision_handler), new joints and other cool stuff that will make it easier and more fun to include 2d physics into your program/game :)
Changes from the last release:
Vec2d now uses radians instead of degrees for all default angle functions. This might break existing code! Upgraded to latest chipmunk. This means new system of callbacks and many other fixes Many unittests added. Better py3k compatibility (everything except for the setup script should work) Better 32/64 bit handling and more
DocumentationSee http://pymunk.googlecode.com/svn/tags/pymunk-1.0.0/docs/api/index.html for the API documentation of pymunk 1.0.0.
A snapshot of the latest svn version of the docs is located here: http://pymunk.googlecode.com/svn/trunk/docs/api/index.html
SupportForumCurrently pymunk has no separate forum, but you can use the general Chipmunk forum at http://www.slembcke.net/forums/index.php Many issues are the same, like how to create a rag doll. If you have a pymunk specific question you can mark your post with [pymunk]
MailYou can mail me: vbxviblo.se (replace x with @)
Tutorial(Not very updated, instead its better to see the scripts in /examples They are always compatible with the latest release) There is a new tutorial in the wiki area. It will walk you through the slide and pinjoint demo included in the release. Go here to read it: SlideAndPinJointsExample
Screenshots from the included demosFrom the contact demo, which paints red balls with big radius for big collisions, and small radius for small ones.
From the balls and lines demo. Static lines drawn by the mouse, balls added by mouseclick and growing balls when hoovering above them.
Displays a L shape with two joints, one pin joint in red and one slide joint in green. After a while the L will tip over and release the balls.