How js1b/simple-physics-engine works
Project type and purpose
• This is a Python‑based, open‑source physics engine library with rendering (OpenGL) and input handling (Pygame).
• Its focus is on simulating rigid‑body dynamics (gravity, friction, collisions) and providing a simple API for embedding in applications or running the example scripts (e.g., Newton’s cradle).
File structure
• Top‑level:
• setup.py, requirements‑dev.txt – packaging, development dependencies
• examples/ – demonstration scripts
• simplephysicsengine/ – core library
• tests/ – unit tests
• In simplephysicsengine/:
• engine.py – main simulation loop, orchestrates subsystems
• physics.py – physics calculations (forces, integrations, collisions)
• objects/ – rigid‑body definitions (ball, string, world container)
• gl_object.py – OpenGL rendering abstraction
• key_mappings.py, config_loader.py, config/key_mappings.json – input mapping and configuration
• mixins.py – shared behavior utilities for objects
README for additional insights
• Confirms core capabilities: rigid‑body dynamics, gravity, friction, collisions
Final advice
• Be very detailed: break down the Object Model into its parts (world, ball, string) if space allows.
• Avoid over‑complicating: represent each Python module or folder as a distinct component.