pygame-ios 0.0.1__tar.gz

pygame_ios-0.0.1/.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+.venv/
+build/
+dist/
+*.egg-info/

pygame_ios-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Luke Lazzaro
+
+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_ios-0.0.1/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: pygame-ios
+Version: 0.0.1
+Summary: Run pygame-ce games on iPhones and iPads easily.
+Author-email: Luke Lazzaro <lazzdev@proton.me>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: requests
+Project-URL: Homepage, https://github.com/seekerluke/pygame-ios
+Project-URL: Issues, https://github.com/seekerluke/pygame-ios/issues
+
+# pygame-ios
+
+Run pygame-ce games on iPhones and iPads easily.
+
+This package contains a simple CLI tool that downloads a template from [pygame-ios-templates](https://github.com/seekerluke/pygame-ios-templates) and adds your game files to it. After that you can run the Xcode project and see your pygame-ce game on your device or simulator of choice.
+
+## Usage
+
+Assuming you have Python 3, run this to install the package:
+
+```bash
+pip install pygame-ios
+```
+
+This gives you a command you can run with one of the following:
+
+```bash
+pygame-ios
+python -m pygame-ios
+```
+
+This command needs arguments. You need to provide a location for your project folder where your files will be copied from, as well as an entry point script which will be renamed to `__main__.py` and used as the entry point in Xcode.
+
+Example usage:
+
+```bash
+pygame-ios . game.py # copies files from current folder, uses game.py as the entry point script
+```
+
+After running this command, an Xcode project will be downloaded. You can open this project in Xcode and run it on a device or simulator.
+
+To update your Xcode project with new files or changes, just run the command again. The download step is skipped and your files are copied, overwriting previous files.
+
+### Other Arguments
+
+You can also specify a pygame-ce version:
+
+```bash
+pygame-ios . game.py 2.5.5 # fetches the v2.5.5 version of the template
+```
+
+Without this argument, the command will download the latest template available. But you can specify a pygame-ce version in case you need something different from the latest stable. Not all pygame-ce versions are supported, see [here](https://github.com/seekerluke/pygame-ios-templates/releases) for supported versions, and see the [repository README](https://github.com/seekerluke/pygame-ios-templates?tab=readme-ov-file#making-new-templates) for details on how to make your own.
+

pygame_ios-0.0.1/README.md

@@ -0,0 +1,42 @@
+# pygame-ios
+
+Run pygame-ce games on iPhones and iPads easily.
+
+This package contains a simple CLI tool that downloads a template from [pygame-ios-templates](https://github.com/seekerluke/pygame-ios-templates) and adds your game files to it. After that you can run the Xcode project and see your pygame-ce game on your device or simulator of choice.
+
+## Usage
+
+Assuming you have Python 3, run this to install the package:
+
+```bash
+pip install pygame-ios
+```
+
+This gives you a command you can run with one of the following:
+
+```bash
+pygame-ios
+python -m pygame-ios
+```
+
+This command needs arguments. You need to provide a location for your project folder where your files will be copied from, as well as an entry point script which will be renamed to `__main__.py` and used as the entry point in Xcode.
+
+Example usage:
+
+```bash
+pygame-ios . game.py # copies files from current folder, uses game.py as the entry point script
+```
+
+After running this command, an Xcode project will be downloaded. You can open this project in Xcode and run it on a device or simulator.
+
+To update your Xcode project with new files or changes, just run the command again. The download step is skipped and your files are copied, overwriting previous files.
+
+### Other Arguments
+
+You can also specify a pygame-ce version:
+
+```bash
+pygame-ios . game.py 2.5.5 # fetches the v2.5.5 version of the template
+```
+
+Without this argument, the command will download the latest template available. But you can specify a pygame-ce version in case you need something different from the latest stable. Not all pygame-ce versions are supported, see [here](https://github.com/seekerluke/pygame-ios-templates/releases) for supported versions, and see the [repository README](https://github.com/seekerluke/pygame-ios-templates?tab=readme-ov-file#making-new-templates) for details on how to make your own.

pygame_ios-0.0.1/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["flit_core >=3.11,<4"]
+build-backend = "flit_core.buildapi"
+
+[project]
+name = "pygame-ios"
+authors = [{name = "Luke Lazzaro", email = "lazzdev@proton.me"}]
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+dynamic = ["version", "description"]
+requires-python = ">=3.13"
+dependencies = ["requests"]
+
+[project.urls]
+Homepage = "https://github.com/seekerluke/pygame-ios"
+Issues = "https://github.com/seekerluke/pygame-ios/issues"
+
+[project.scripts]
+pygame-ios = "pygame_ios.__main__:cli"

pygame_ios-0.0.1/src/pygame_ios/__init__.py

@@ -0,0 +1,3 @@
+"""Run pygame-ce games on iPhones and iPads easily."""
+
+__version__ = "0.0.1"

pygame_ios-0.0.1/src/pygame_ios/__main__.py

@@ -0,0 +1,103 @@
+import io
+import json
+import os
+import shutil
+import sys
+import zipfile
+
+import requests
+
+BASE_API_PATH = "https://api.github.com/repos/seekerluke/pygame-ios-templates/releases/"
+BASE_DOWNLOAD_PATH = (
+    "https://github.com/seekerluke/pygame-ios-templates/releases/download/"
+)
+FOLDER_NAME = "pygame-ios-template"
+
+
+def check_args():
+    result = len(sys.argv) >= 3
+    if not result:
+        print("Usage: pygame-ios project_folder main_python_script [pygame_ce_version]")
+    return result
+
+
+def get_latest_version():
+    response = requests.get(os.path.join(BASE_API_PATH, "latest"))
+    response.raise_for_status()
+    json_data = json.loads(response.content)
+    return json_data["tag_name"]
+
+
+def download_template(main_script_path: str):
+    current_dir = os.path.dirname(main_script_path)
+    template_dir = os.path.join(current_dir, FOLDER_NAME)
+    if os.path.isdir(template_dir):
+        print("pygame-ios template already exists. Skipping.")
+        return
+
+    version_number = f"v{sys.argv[3]}" if len(sys.argv) >= 4 else get_latest_version()
+    version_stripped = version_number.removeprefix("v")
+    download_path = os.path.join(
+        BASE_DOWNLOAD_PATH,
+        version_number,
+        f"pygame-ios-template-{version_stripped}.zip",
+    )
+
+    try:
+        print(f"Downloading Xcode template for pygame-ce {version_number}...")
+        response = requests.get(download_path)
+        response.raise_for_status()
+    except requests.exceptions.HTTPError:
+        print(
+            f"Xcode template for pygame-ce version {version_number} does not exist. It might not be supported yet."
+        )
+        print(
+            "Supported versions are listed here: https://github.com/seekerluke/pygame-ios-templates/releases"
+        )
+        sys.exit(0)
+
+    print("Extracting...")
+    with zipfile.ZipFile(io.BytesIO(response.content)) as zf:
+        zf.extractall(template_dir)
+
+    print("Xcode template downloaded successfully.")
+
+
+def copy_project_files(project_folder_path: str):
+    dest_dir = os.path.join(
+        project_folder_path, FOLDER_NAME, "pygame-ios", "app", "pygame-ios"
+    )
+    shutil.copytree(
+        project_folder_path,
+        dest_dir,
+        dirs_exist_ok=True,
+        # don't copy the Xcode template into the Xcode template
+        ignore=lambda src, names: [FOLDER_NAME],
+    )
+
+    new_main_path = os.path.join(dest_dir, sys.argv[2])
+    new_main_path_name = os.path.join(dest_dir, "__main__.py")
+    os.rename(new_main_path, new_main_path_name)
+
+    print("Copied project files to Xcode template.")
+
+
+def finalise():
+    print(
+        f'Done! Open the Xcode project under "{FOLDER_NAME}" and run the project on your chosen device or simulator.'
+    )
+
+
+def cli():
+    if not check_args():
+        return  # early exit
+
+    project_folder_path = os.path.abspath(sys.argv[1])
+    main_script_path = os.path.abspath(sys.argv[2])
+    download_template(main_script_path)
+    copy_project_files(project_folder_path)
+    finalise()
+
+
+if __name__ == "__main__":
+    cli()