Metadata-Version: 2.4
Name: mini-arcade-core
Version: 1.6.2
Summary: Tiny scene-based game loop core for small arcade games.
License: Copyright (c) 2025 Santiago Rincón
           
           Permission is hereby granted, free of charge, to any person obtaining a copy
           of this software and associated documentation files (the "Software"), to deal
           in the Software without restriction, including without limitation the rights
           to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           copies of the Software, and to permit persons to whom the Software is
           furnished to do so, subject to the following conditions:
           
           The above copyright notice and this permission notice shall be included in all
           copies or substantial portions of the Software.
           
           THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           SOFTWARE.
License-File: LICENSE
Author: Santiago Rincon
Author-email: rincores@gmail.com
Requires-Python: >=3.9,<3.12
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Provides-Extra: dev
Requires-Dist: black (>=24.10,<25.0) ; extra == "dev"
Requires-Dist: isort (>=5.13,<6.0) ; extra == "dev"
Requires-Dist: mypy (>=1.5,<2.0) ; extra == "dev"
Requires-Dist: pillow (<12)
Requires-Dist: pylint (>=3.3,<4.0) ; extra == "dev"
Requires-Dist: pytest (>=8.3,<9.0) ; extra == "dev"
Requires-Dist: pytest-cov (>=6.0,<7.0) ; extra == "dev"
Description-Content-Type: text/markdown

# mini-arcade-core

`mini-arcade-core` is the simulation-first core of Mini Arcade.

It is backend-agnostic and focuses on:

- scenes as simulation containers
- entities and lightweight component-style data
- systems for input, simulation, and render preparation
- draw packets that backends can replay

Backends are responsible for:

- window and event polling
- drawing primitives, textures, and text
- audio, capture, and frame presentation

## Design goals

- small, explicit API surface
- deterministic simulation patterns
- testable game logic outside the rendering layer
- backend swapping between `native` and `pygame`

## Frame mental model

A typical frame is:

1. gather input and produce intents
2. tick simulation and systems
3. build draw packets
4. let the selected backend render and present the frame

## Install

```bash
pip install mini-arcade-core
```

## Docs

See the monorepo docs for architecture and concepts:

- `docs/source/concepts/architecture.md`
- `docs/source/concepts/capabilities.md`
- `docs/source/tutorials/index.md`

