framework-lib 0.1.2__py3-none-any.whl

framework_lib/program.py

@@ -0,0 +1,126 @@
+import data
+import time
+import builtins
+from models import RedirectField, ErrorForm, ErrorHelper, PygameEmbedding, pygame
+from inspect import signature as s
+
+class DummyPage:
+        name="dummy"
+        def call(self, ctx={}):
+                pass
+
+class Singleton(type):
+        _instances = {}
+        def __call__(cls, *args, **kwargs):
+                if cls not in cls._instances:
+                        inst = super().__call__(*args, **kwargs)
+                        cls._instances[cls] = inst
+                        try:
+                                si=s(inst.on_begin)
+                                args=list(si.parameters)
+                                if len(args)>0:
+                                        ErrorForm(f"on_begin of Game cannot accept any arguments", "INITIALIZATION", type="304 GAME ERROR").call()
+                                else:
+                                        inst.on_begin()
+                                        for k, v in inst.__dict__.items():
+                                            setattr(builtins, k, v)
+                        except AttributeError:
+                                pass
+                return cls._instances[cls]
+
+class Game(metaclass=Singleton):
+        pass
+        
+class Program:
+        def __init__(self, ps, pctx, pcs, vpgs, game, pps=25, gfile="g.json", globals={}):
+                asr=["page", "page context", "file", "globals", "valid pages","pages per second", "game"]
+                args=[ps, pctx, gfile, globals, vpgs, pps, game]
+                types=[str, dict, str, dict, list, int, Game]
+                self.c=ErrorHelper(asr, args, types)
+                self.db=data.Database(gfile, ps, globals)
+                self.vpgs=vpgs
+                self.g=game
+                if not self.c:
+                        self.vpgs.append("dummy")
+                if self.db.retrieve("", total=True)=="ERR" or self.db.retrieve("", total=True)=={}:
+                        self.db.new()
+                self.page_ctx=pctx
+                self.exit_now=False
+                self.page_class=pcs
+                self.history=[]
+                self.PPS=pps
+                self.gfile=gfile
+                result=1
+                if not self.c:
+                        result=RedirectField(pcs, DummyPage, self, pctx).call()
+                self.globals=globals
+                self.st=globals
+                self.sv=globals
+                self.gload()
+                if result==1:
+                        self.c=True
+        def run(self):
+                if not self.c:
+                        cl=None
+                        try:
+                                while True:
+                                        time.sleep(1/self.PPS)
+                                        if not isinstance(cl,self.page_class):
+                                                self.cl, cl=self.page_class(), self.page_class()
+                                        config=None
+                                        try:
+                                                config=self.page_class.config
+                                        except:
+                                                pass
+                                        if config=="pgwin":
+                                                cl.call()
+                                        elif type(config) == tuple:
+                                                if isinstance(config[1], PygameEmbedding):
+                                                        if config[0]=="scene":
+                                                                self.gload()
+                                                                config[1].ebf=cl.call
+                                                                config[1].call()
+                                                                if config[1].exit:
+                                                                        pygame.quit()
+                                                                        self.exit_now=True
+                                                                self.write_history(cl.name)
+                                                                self.gstore()
+                                                else:
+                                                        ErrorForm(f"Invalid config for a page: {config}", self.page_class.name, "100 INTERNAL ERROR").call()
+                                        else:
+                                                self.gload()
+                                                if self.page_ctx=={}:
+                                                        cl.call()
+                                                else:
+                                                        cl.call(self.page_ctx)
+                                                self.write_history(cl.name)
+                                                self.gstore()
+                                        if self.exit_now:
+                                                break
+                                return 0
+                        except KeyboardInterrupt:
+                                ErrorForm("Warning: KeyboardInterrupt used to exit the framework program. Some data may have not been saved.", self.page_class.name, "400 EXIT WARNING").call()
+                else:
+                        return 1
+        def gstore(self):
+                self.db.change("",self.globals, total=True)
+        def gload(self):
+                globals=self.db.retrieve("", total=True)
+                if globals=="ERR":
+                        self.globals=self.st
+                else:
+                        self.globals=globals
+        def write_history(self, page):
+                c=ErrorHelper(["page"], [page], [str])
+                if not c:
+                        self.history.append({"page": page, "context": self.page_ctx, "class": self.page_class})
+                else:
+                        return "ERR"
+        def read_history(self, block_err=False):
+                if len(self.history)==0 and not block_err:
+                        ErrorForm("Accessing unknown value in history is not possible", self.control, "302 HISTORY ERROR")
+                if len(self.history)==0:
+                        return "ERR"
+                package=self.history.pop()
+                self.page_class=package["class"]
+                self.page_ctx=package["context"]

framework_lib/setup.py

@@ -0,0 +1,12 @@
+from setuptools import setup
+
+setup(
+    name="framework",
+    version="0.2",
+    py_modules=["framework", "models", "data", "program"],
+    entry_points={
+        "console_scripts": [
+            "framework=framework:main",
+        ],
+    },
+)

framework_lib-0.1.2.dist-info/METADATA

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: framework-lib
+Version: 0.1.2
+Summary: Python Framework Library, expandable, provides support for Console, Tkinter and Pygame.
+Author-email: Ad1Ad1 <help91922@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Ad1Ad1/game-framework
+Project-URL: Issues, https://github.com/Ad1Ad1/game-framework/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Quick Start and PyPI guide for Page Framework(v1.0)
+
+## Useful Links
+
+[View official API documentation](https://github.com/Ad1Ad1/game-framework/blob/main/README.md)
+
+[View official examples page](https://github.com/Ad1Ad1/game-framework/blob/main/EXAMPLES.md)
+
+## Installation
+First, install the framework with this command
+
+```shell
+pip install framework-lib
+```
+
+## Project creation
+Now, create a new project(maybe in a separate folder) with this command
+```shell
+framework-lib project create {name}
+```
+Open created folder. List contents with this command:
+```shell
+ls
+```
+You should see something like this
+
+```plaintext
+Mode                 LastWriteTime         Length Name
+----                 -------------         ------ ----
+-a----        10.07.2026     19:53           4294 data.py
+-a----        10.07.2026     19:53          72680 models.py
+-a----        10.07.2026     19:53              2 models_requirements.json
+-a----        10.07.2026     19:53           6578 program.py
+```
+
+Now create your file there. 
+
+## What to use?
+Choose one from our examples or create your own

framework_lib-0.1.2.dist-info/RECORD

@@ -0,0 +1,11 @@
+framework_lib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+framework_lib/data.py,sha256=g56bxejhs8wLOHwKDyE7tN0pKYfqwlQi_7tDxKf1YsI,4293
+framework_lib/framework.py,sha256=mod5xdOnGWVfWnEZw2mpHzN8itBe-S1w1eQXgPBuI1E,7205
+framework_lib/models.py,sha256=Tf90-J41iNSneH4X0bG2jsYVPqIqmYs6_2ytk8LIkOk,72842
+framework_lib/program.py,sha256=_wptDdtdKTDoUzE2YiWxO230egNqFPlGRNpFCWNKmMc,6578
+framework_lib/setup.py,sha256=RZR74vPPI7gJa4WC31QcJ9ox76BOVyZK9oYG5FCTvIY,257
+framework_lib-0.1.2.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+framework_lib-0.1.2.dist-info/METADATA,sha256=TlC-vqqPPgXD_xbztoCgZXEOsAqGKZ890fmo6ji06ac,1703
+framework_lib-0.1.2.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+framework_lib-0.1.2.dist-info/top_level.txt,sha256=rKbRZtVN2huyCl-EYLEFC9eczt3lxUvJxltdN75jFuA,14
+framework_lib-0.1.2.dist-info/RECORD,,

framework_lib-0.1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

framework_lib-0.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+framework_lib