pygame-topdownengine 0.0.1__tar.gz

pygame_topdownengine-0.0.1/.github/workflows/release.yml

@@ -0,0 +1,72 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+
+  # ── Job 0: Build distributions ────────────────────
+  release-build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build release distributions
+        run: |
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  # ── Job 1: Publish to TestPyPI ────────────────────
+  test-pypi-publish:
+    runs-on: ubuntu-latest
+    needs: release-build
+    permissions:
+      id-token: write
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/pygame-topdownengine
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          packages-dir: dist/
+
+  # ── Job 2: Publish to PyPI ────────────────────────
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs: test-pypi-publish
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pygame-topdownengine
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

pygame_topdownengine-0.0.1/.gitignore

@@ -0,0 +1,3 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]

pygame_topdownengine-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaurya Sharma
+
+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.

pygame_topdownengine-0.0.1/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: pygame-topdownengine
+Version: 0.0.1
+Author: Shaurya Sharma
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Games/Entertainment
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS
+Classifier: Typing :: Typed
+Requires-Python: >=3.12.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pygame-ce>=2.5.7
+Dynamic: license-file
+
+# pygame-topdownengine
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://opensource.org)
+
+pygame-topdownengine is a 2.5D engine for top-down games. It is designed to be highly modular, with most core systems being located in the easily extendible GameObject class. It is built on top of the pygame-ce package, which you can find here: https://github.com/pygame-community/pygame-ce/tree/main.
+
+## Features
+- GameObject class that contains all of the core systems.
+- Built-in MobileObj class for anything that moves.
+- Option to use either pixel-perfect or subpixel rendering.
+- Dynamic scale-setting for all GameObjects.
+- Robust 3D collision detection.
+
+## Installation
+In order to install pygame-topdownengine, make sure Python and pip are both installed and in PATH. Then, run this command into your terminal:<br>
+`pip install pygame-topdownengine`
+
+## License
+This library is distributed under the MIT license, which can be found in the root of this repository under the `LICENSE` file.
+
+The source files located in the `examples` subfolder are licensed under the Creative Commons Zero 1.0 Universal license, which can be found inside of `examples/LICENSE`.

pygame_topdownengine-0.0.1/README.md

@@ -0,0 +1,20 @@
+# pygame-topdownengine
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://opensource.org)
+
+pygame-topdownengine is a 2.5D engine for top-down games. It is designed to be highly modular, with most core systems being located in the easily extendible GameObject class. It is built on top of the pygame-ce package, which you can find here: https://github.com/pygame-community/pygame-ce/tree/main.
+
+## Features
+- GameObject class that contains all of the core systems.
+- Built-in MobileObj class for anything that moves.
+- Option to use either pixel-perfect or subpixel rendering.
+- Dynamic scale-setting for all GameObjects.
+- Robust 3D collision detection.
+
+## Installation
+In order to install pygame-topdownengine, make sure Python and pip are both installed and in PATH. Then, run this command into your terminal:<br>
+`pip install pygame-topdownengine`
+
+## License
+This library is distributed under the MIT license, which can be found in the root of this repository under the `LICENSE` file.
+
+The source files located in the `examples` subfolder are licensed under the Creative Commons Zero 1.0 Universal license, which can be found inside of `examples/LICENSE`.

pygame_topdownengine-0.0.1/examples/LICENSE

@@ -0,0 +1,121 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+    HEREUNDER.
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without fear
+of later claims of infringement build upon, modify, incorporate in other
+works, reuse and redistribute as freely as possible in any form whatsoever
+and for any purposes, including without limitation commercial purposes.
+These owners may contribute to the Commons to promote the ideal of a free
+culture and the further production of creative, cultural and scientific
+works, or to gain reputation or greater distribution for their Work in
+part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under its
+terms, with knowledge of his or her Copyright and Related Rights in the
+Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not
+limited to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display,
+     communicate, and translate a Work;
+ ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or
+     likeness depicted in a Work;
+ iv. rights protecting against unfair competition in regards to a Work,
+     subject to the limitations in paragraph 4(a), below;
+  v. rights protecting the extraction, dissemination, use and reuse of data
+     in a Work;
+ vi. database rights (such as those arising under Directive 96/9/EC of the
+     European Parliament and of the Council of 11 March 1996 on the legal
+     protection of databases, and under any national implementation
+     thereof, including any amended or successor version of such
+     directive); and
+vii. other similar, equivalent or corresponding rights throughout the
+     world based on applicable law or treaty, and any national
+     implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+of, applicable law, Affirmer hereby overtly, fully, permanently,
+irrevocably and unconditionally waives, abandons, and surrenders all of
+Affirmer's Copyright and Related Rights and associated claims and causes
+of action, whether now known or unknown (including existing as well as
+future claims and causes of action), in the Work (i) in all territories
+worldwide, (ii) for the maximum duration provided by applicable law or
+treaty (including future time extensions), (iii) in any current or future
+medium and for any number of copies, and (iv) for any purpose whatsoever,
+including without limitation commercial, advertising or promotional
+purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
+member of the public at large and to the detriment of Affirmer's heirs and
+successors, fully intending that such Waiver shall not be subject to
+revocation, rescission, cancellation, termination, or any other legal or
+equitable action to disrupt the quiet enjoyment of the Work by the public
+as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+be judged legally invalid or ineffective under applicable law, then the
+Waiver shall be preserved to the maximum extent permitted taking into
+account Affirmer's express Statement of Purpose. In addition, to the
+extent the Waiver is so judged Affirmer hereby grants to each affected
+person a royalty-free, non transferable, non sublicensable, non exclusive,
+irrevocable and unconditional license to exercise Affirmer's Copyright and
+Related Rights in the Work (i) in all territories worldwide, (ii) for the
+maximum duration provided by applicable law or treaty (including future
+time extensions), (iii) in any current or future medium and for any number
+of copies, and (iv) for any purpose whatsoever, including without
+limitation commercial, advertising or promotional purposes (the
+"License"). The License shall be deemed effective as of the date CC0 was
+applied by Affirmer to the Work. Should any part of the License for any
+reason be judged legally invalid or ineffective under applicable law, such
+partial invalidity or ineffectiveness shall not invalidate the remainder
+of the License, and in such case Affirmer hereby affirms that he or she
+will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of
+action with respect to the Work, in either case contrary to Affirmer's
+express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+ a. No trademark or patent rights held by Affirmer are waived, abandoned,
+    surrendered, licensed or otherwise affected by this document.
+ b. Affirmer offers the Work as-is and makes no representations or
+    warranties of any kind concerning the Work, express, implied,
+    statutory or otherwise, including without limitation warranties of
+    title, merchantability, fitness for a particular purpose, non
+    infringement, or the absence of latent or other defects, accuracy, or
+    the present or absence of errors, whether or not discoverable, all to
+    the greatest extent permissible under applicable law.
+ c. Affirmer disclaims responsibility for clearing rights of other persons
+    that may apply to the Work or any use thereof, including without
+    limitation any person's Copyright and Related Rights in the Work.
+    Further, Affirmer disclaims responsibility for obtaining any necessary
+    consents, permissions or other rights required for any use of the
+    Work.
+ d. Affirmer understands and acknowledges that Creative Commons is not a
+    party to this document and has no duty or obligation with respect to
+    this CC0 or use of the Work.

pygame_topdownengine-0.0.1/examples/basic_usage.py

@@ -0,0 +1,78 @@
+import topdownengine as tde
+from topdownengine.mobile_obj.controller import KeyboardInputController, MovementAIController
+from topdownengine.asset_paths import ASSETS_DIR
+from topdownengine.math import scale_rect
+import pygame as pg
+
+# Define an instance of the Game class
+game = tde.Game(
+    screen_width=900, 
+    screen_height=650, 
+    window_title="pygame-topdownengine Basic Usage Example"
+)
+
+# Define a MobileObj to be the Player
+player = tde.MobileObj(
+    controller=KeyboardInputController(), 
+    animation_paths={
+        'idle': ASSETS_DIR / 'example-player' / 'idle.png',
+        'walk': ASSETS_DIR / 'example-player' / 'walk.png'
+    },
+    frame_size=(16, 16),
+    directional_anims=True
+)
+
+# Define a MobileObj to follow the Player
+enemy = tde.MobileObj(
+    controller=MovementAIController(target_mobile_obj=player), 
+    animation_paths={
+        'idle': ASSETS_DIR / 'example-player' / 'idle.png',
+        'walk': ASSETS_DIR / 'example-player' / 'walk.png'
+    },
+    frame_size=(16, 16),
+    directional_anims=True
+)
+
+# Define an env_obj
+env_obj = tde.EnvObject(frame_size=(32, 32), colliders=[pg.Rect(0, 0, 32, 32)])
+env_obj.position = pg.Vector2(100, 100)
+env_obj.obj_shadow = '32x16'
+
+# Add them to the game object group
+game.game_object_group.add(player)
+game.game_object_group.add(env_obj)
+game.game_object_group.add(enemy)
+
+# Rescale GameObjects to have a SCALE of 3 (this makes them more visible)
+tde.GameObject.set_scale(3, game)
+
+# GameObj automatically generates a four frame "flashing animation."
+# In order to disable it, this line of code makes it use only the first frame,
+# which is solid red.
+env_obj.animations = {'idle': [env_obj.animations['idle'][0]]} 
+
+# You can add subpixel rendering by uncommenting the below line of code
+# tde.GameObject.SUBPIXEL = True
+
+# Debug Rendering
+# original_draw = game.render
+# def new_render():
+#     original_draw()
+#     pg.draw.rect(
+#         game.screen, 
+#         (0, 0, 255), 
+#         scale_rect(mobile_obj.hitboxes[0], mobile_obj.SCALE),
+#         1
+#     )
+#     pg.draw.rect(
+#         game.screen, 
+#         (0, 0, 255), 
+#         scale_rect(env_obj.hitboxes[0], env_obj.SCALE),
+#         1
+#     )
+#     pg.display.flip()
+
+# game.render = new_render
+
+# Run the game
+game.run()

pygame_topdownengine-0.0.1/pygame_topdownengine.egg-info/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: pygame-topdownengine
+Version: 0.0.1
+Author: Shaurya Sharma
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Games/Entertainment
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS
+Classifier: Typing :: Typed
+Requires-Python: >=3.12.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pygame-ce>=2.5.7
+Dynamic: license-file
+
+# pygame-topdownengine
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://opensource.org)
+
+pygame-topdownengine is a 2.5D engine for top-down games. It is designed to be highly modular, with most core systems being located in the easily extendible GameObject class. It is built on top of the pygame-ce package, which you can find here: https://github.com/pygame-community/pygame-ce/tree/main.
+
+## Features
+- GameObject class that contains all of the core systems.
+- Built-in MobileObj class for anything that moves.
+- Option to use either pixel-perfect or subpixel rendering.
+- Dynamic scale-setting for all GameObjects.
+- Robust 3D collision detection.
+
+## Installation
+In order to install pygame-topdownengine, make sure Python and pip are both installed and in PATH. Then, run this command into your terminal:<br>
+`pip install pygame-topdownengine`
+
+## License
+This library is distributed under the MIT license, which can be found in the root of this repository under the `LICENSE` file.
+
+The source files located in the `examples` subfolder are licensed under the Creative Commons Zero 1.0 Universal license, which can be found inside of `examples/LICENSE`.

pygame_topdownengine-0.0.1/pygame_topdownengine.egg-info/SOURCES.txt

@@ -0,0 +1,31 @@
+.gitignore
+LICENSE
+README.md
+pyproject.toml
+.github/workflows/release.yml
+examples/LICENSE
+examples/basic_usage.py
+pygame_topdownengine.egg-info/PKG-INFO
+pygame_topdownengine.egg-info/SOURCES.txt
+pygame_topdownengine.egg-info/dependency_links.txt
+pygame_topdownengine.egg-info/requires.txt
+pygame_topdownengine.egg-info/top_level.txt
+tests/conftest.py
+tests/test_math.py
+tests/test_physics.py
+topdownengine/__init__.py
+topdownengine/asset_paths.py
+topdownengine/controls.py
+topdownengine/env_object.py
+topdownengine/game.py
+topdownengine/game_object.py
+topdownengine/math.py
+topdownengine/py.typed
+topdownengine/visual_utils.py
+topdownengine/assets/example-player/idle.png
+topdownengine/assets/example-player/walk.png
+topdownengine/assets/shadows/16x8.png
+topdownengine/assets/shadows/32x16.png
+topdownengine/assets/shadows/8x4.png
+topdownengine/mobile_obj/__init__.py
+topdownengine/mobile_obj/controller.py

pygame_topdownengine-0.0.1/pygame_topdownengine.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pygame_topdownengine-0.0.1/pygame_topdownengine.egg-info/requires.txt

@@ -0,0 +1 @@
+pygame-ce>=2.5.7

pygame_topdownengine-0.0.1/pygame_topdownengine.egg-info/top_level.txt

@@ -0,0 +1,4 @@
+dist
+examples
+tests
+topdownengine

pygame_topdownengine-0.0.1/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "setuptools-scm>=8.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pygame-topdownengine"
+version = "0.0.1"
+authors = [
+    { name = "Shaurya Sharma" }
+]
+requires-python = ">=3.12.10"
+dependencies = [
+    "pygame-ce>=2.5.7",
+]
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Games/Entertainment",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX",
+    "Operating System :: Unix",
+    "Operating System :: MacOS",
+    "Typing :: Typed"
+]
+
+[tool.setuptools]
+packages = { find = {} }
+include-package-data = true
+
+[tool.setuptools.package-data]
+"*" = ["py.typed", "assets/**/*"]
+
+[tool.setuptools_scm] 

pygame_topdownengine-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pygame_topdownengine-0.0.1/tests/conftest.py

@@ -0,0 +1,40 @@
+# Copyright (c) 2026 Shaurya Sharma
+# SPDX-License-Identifier: MIT
+
+import pygame as pg
+import pytest
+import topdownengine as tde
+from topdownengine.mobile_obj.controller import KeyboardInputController
+from topdownengine.asset_paths import ASSETS_DIR
+from topdownengine.controls import MoreKeysPressed
+
+# Fixtures
+@pytest.fixture
+def game():
+    game = tde.Game(1, 1)
+    print('Initializing game instance.')
+    yield game
+    pg.quit()
+
+@pytest.fixture
+def mobile_obj():
+    return tde.MobileObj(
+        controller=KeyboardInputController(), 
+        animation_paths={
+            'idle': ASSETS_DIR / 'example-player' / 'idle.png',
+            'walk': ASSETS_DIR / 'example-player' / 'walk.png'
+        },
+        frame_size=(16, 16),
+        directional_anims=True
+    )
+
+# This code "monkey patches" pygame-ce to replace get_pressed with a custom
+# function that allows us to add/remove fake keys to the stream by 
+# adding/removing them from the FAKED_KEYS set.
+FAKED_KEYS = set()
+original_get_pressed = pg.key.get_pressed
+
+def fake_get_pressed():
+    return MoreKeysPressed(original_get_pressed(), FAKED_KEYS)
+
+pg.key.get_pressed = fake_get_pressed

pygame_topdownengine-0.0.1/tests/test_math.py

@@ -0,0 +1,25 @@
+# Copyright (c) 2026 Shaurya Sharma
+# SPDX-License-Identifier: MIT
+
+from topdownengine import math as tde_math
+import pytest
+
+LERP_TEST_ARGS = [
+    [5, 8], # P->P
+    [1, -7], # P->N
+    [5, 0], # P->0
+    [-8, 5], # N->P
+    [-5, -10], # N->N
+    [-7, 0], # N->0
+    [0, 7], # 0->P
+    [0, -6], # 0->N
+    [0, 0], # 0->0
+]
+
+@pytest.mark.parametrize("start, end", LERP_TEST_ARGS)
+def test_lerp_with_t_0_equals_start(start, end):
+    assert tde_math.lerp(start, end, 0) == start
+
+@pytest.mark.parametrize("start, end", LERP_TEST_ARGS)
+def test_lerp_with_t_1_equals_end(start, end):
+    assert tde_math.lerp(start, end, 1) == end

pygame_topdownengine-0.0.1/tests/test_physics.py

@@ -0,0 +1,57 @@
+# Copyright (c) 2026 Shaurya Sharma
+# SPDX-License-Identifier: MIT
+
+import os
+
+# Set dummy drivers before importing pygame
+os.environ["SDL_VIDEODRIVER"] = "dummy"
+os.environ["SDL_AUDIODRIVER"] = "dummy"
+
+import topdownengine as tde
+import pytest
+import pygame as pg
+from conftest import FAKED_KEYS
+
+# Jump Tests
+def test_can_jump_while_grounded(game: tde.Game, mobile_obj: tde.MobileObj):
+    mobile_obj.elevation = mobile_obj.z = 0
+    mobile_obj.jump()
+    assert mobile_obj.z_vel == mobile_obj.jump_vel
+
+def test_cannot_jump_while_airborne(game: tde.Game, mobile_obj: tde.MobileObj):
+    mobile_obj.elevation = 0
+    mobile_obj.z = 10
+    mobile_obj.jump()
+    assert mobile_obj.z_vel != mobile_obj.jump_vel
+
+# 2D Movement Tests
+MOVEMENT_TEST_ARGS = [
+    pg.Vector2(1, 0), # Right
+    pg.Vector2(0, 1), # Down
+    pg.Vector2(-1, 0), # Left
+    pg.Vector2(0, -1), # Up
+    pg.Vector2(1, 1), # Down-Right
+    pg.Vector2(1, -1), # Up-Right
+    pg.Vector2(-1, 1), # Down-Left
+    pg.Vector2(-1, -1) # Up-Left
+]
+@pytest.mark.parametrize("dir", MOVEMENT_TEST_ARGS)
+def test_movement(game: tde.Game, mobile_obj: tde.MobileObj, dir: pg.Vector2):
+    def step(key, condition):
+        FAKED_KEYS.clear()
+        FAKED_KEYS.add(key)
+        game.handle_events()
+        mobile_obj.update(60, game)
+        assert eval(condition)
+
+    if dir.x == 1:
+        step(pg.K_d, 'mobile_obj.velocity.x > 0')
+
+    elif dir.x == -1: 
+        step(pg.K_a, 'mobile_obj.velocity.x < 0') 
+
+    if dir.y == 1:
+        step(pg.K_s, 'mobile_obj.velocity.y > 0')
+
+    elif dir.y == -1: 
+        step(pg.K_w, 'mobile_obj.velocity.y < 0')

pygame_topdownengine-0.0.1/topdownengine/__init__.py

@@ -0,0 +1,10 @@
+# Copyright (c) 2026 Shaurya Sharma
+# SPDX-License-Identifier: MIT
+
+"""pygame-topdownengine is a game engine built on top of the pygame-ce
+framework. It allows for the quick creation of 2.5D top-down games."""
+
+from .game import Game
+from .game_object import GameObject
+from .mobile_obj import MobileObj
+from .env_object import EnvObject

pygame_topdownengine-0.0.1/topdownengine/asset_paths.py

@@ -0,0 +1,7 @@
+# Copyright (c) 2026 Shaurya Sharma
+# SPDX-License-Identifier: MIT
+
+from pathlib import Path
+
+PACKAGE_ROOT = Path(__file__).resolve().parent
+ASSETS_DIR = PACKAGE_ROOT / "assets"