cascade-core 0.1.12__tar.gz

cascade_core-0.1.12/LICENSE

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

cascade_core-0.1.12/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: cascade-core
+Version: 0.1.12
+Summary: Cascade Core
+License: MIT License
+        
+        Copyright (c) 2024 vadzimshpak
+        
+        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.
+        
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mss
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Dynamic: license-file
+
+# Cascade Core
+
+<p align="center">
+  <img src="./media/logo.png" width="250">
+</p>
+
+Arch:
+- Command - smallest part
+- Pipeline - mix of commands
+- Program - mix of commands and pipelines
+- [Next level...]
+- [Next level...]
+
+Philosophy:
+
+    - Each well-tested and documented command is part of the sucessfull pipeline.
+        - Each well-tested and documented pipeline is part of the sucessfull program.
+            - Each well-tested and documented program is part of the sucessfull cascade.
+                - Each well-tested and documented cascade is part of the sucessfull business.
+
+Add submodule to project:
+`git submodule add https://github.com/vadzimshpak/cascade-core cascade`

cascade_core-0.1.12/README.md

@@ -0,0 +1,22 @@
+# Cascade Core
+
+<p align="center">
+  <img src="./media/logo.png" width="250">
+</p>
+
+Arch:
+- Command - smallest part
+- Pipeline - mix of commands
+- Program - mix of commands and pipelines
+- [Next level...]
+- [Next level...]
+
+Philosophy:
+
+    - Each well-tested and documented command is part of the sucessfull pipeline.
+        - Each well-tested and documented pipeline is part of the sucessfull program.
+            - Each well-tested and documented program is part of the sucessfull cascade.
+                - Each well-tested and documented cascade is part of the sucessfull business.
+
+Add submodule to project:
+`git submodule add https://github.com/vadzimshpak/cascade-core cascade`

cascade_core-0.1.12/cascade/__init__.py

@@ -0,0 +1,6 @@
+from .command import Command
+from .pipeline import Pipeline
+from .program import Program
+from .logger import get_logger
+from .resource import Resource
+from .stack import Stack

cascade_core-0.1.12/cascade/command.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+import time
+import random
+from typing import TYPE_CHECKING, Self
+
+from .logger import get_logger
+from .stack import Stack
+
+
+if TYPE_CHECKING:
+    from .operator import Operator
+
+
+logger = get_logger(__name__)
+random.seed(time.time())
+
+class Command:
+    def __init__(self):
+        self._store_var = None
+        self._stack: Stack = None
+        self._skip_on_raise = False
+        self._jump_on_raise = None
+        self._jump_on_success = None
+        self._vars = []
+
+    def execute(self, stack: Stack):
+        logger.debug(f"Execute subject: {type(self).__name__}")
+
+        self._stack = stack
+        result = self.body()
+
+        if type(result) is str:
+            logger.debug(f"Got {result if len(result) < 100 else result[:100] + '...'} from {type(self).__name__}")
+        else:
+            logger.debug(f"Got {result} from {type(self).__name__}")
+
+        if self._store_var:
+            stack.update(self._store_var, result)
+
+        return result
+
+    def body(self):
+        raise Exception("This subject doesn't have body!")
+
+    def get_param_value(self, number: int):
+        return self._stack.top_value(self._vars[number])
+
+    def __rshift__(self, command: Operator) -> Self | object | Exception:
+        from .operator import Execute, Store, RaiseSkip, JumpOnRaise, JumpOnSuccess
+
+        if type(command) == Execute:
+            try:
+                return self.execute(command.stack)
+            except Exception as e:
+                return e
+
+        elif type(command) == Store:
+            self._store_var = command.var_name
+
+        elif type(command) == RaiseSkip:
+            self._skip_on_raise = True
+
+        elif type(command) == JumpOnRaise:
+            self._jump_on_raise = command.command_index
+
+        elif type(command) == JumpOnSuccess:
+            self._jump_on_success = command.command_index
+
+        return self

cascade_core-0.1.12/cascade/commands/__init__.py

@@ -0,0 +1 @@
+from .service import *

cascade_core-0.1.12/cascade/commands/service.py

@@ -0,0 +1,108 @@
+import time
+import random
+import logging
+
+from cascade.command import Command
+from cascade.logger import get_logger
+
+
+logger = get_logger(__name__)
+random.seed(time.time())
+
+
+class SleepCommand(Command):
+    """
+    Sleep n seconds
+    """
+    
+    def __init__(self, secs: int):
+        super().__init__()
+        self.secs = secs
+
+    def body(self):
+        time.sleep(self.secs)
+
+class SleepRandomRangeCommand(Command):
+    """
+    Sleep a random number of seconds within a range
+    """
+
+    def __init__(self, secs_from: int, secs_to: int):
+        super().__init__()
+        self.secs_from = secs_from
+        self.secs_to = secs_to
+
+    def body(self):
+        time.sleep(random.randrange(self.secs_from, self.secs_to))
+
+class LogCommand(Command):
+    """
+    Log a message at a specified level
+    """
+
+    def __init__(self, level: int, message: str):
+        super().__init__()
+        self.level = level
+        self.message = message
+
+    def body(self):
+        logger.log(self.level, self.message)
+
+class LogExceptionCommand(Command):
+    """
+    Log an exception at the ERROR level
+    """
+
+    def __init__(self, exception: object):
+        super().__init__()
+        self.exception = exception
+
+    def body(self):
+        logger.log(logging.ERROR, self.exception)
+
+class DynamicLogCommand(Command):
+    """
+    Log a dynamic message at a specified level
+    """
+
+    def __init__(self, level: int):
+        super().__init__()
+        self.level = level
+
+    def body(self):
+        message = self.get_param_value(0)
+        logger.log(self.level, message)
+
+class SetStackCommand(Command):
+    """
+    Set the stack to a specified value, need to use with Store(<var>) operator!
+    """
+
+    def __init__(self, value):
+        super().__init__()
+        self.value = value
+
+    def body(self):
+        return self.value
+
+class DebugStackCommand(Command):
+    """
+    Debug the current stack
+    """
+
+    def __init__(self):
+        super().__init__()
+
+    def body(self):
+        logger.debug("Stack: " + repr(self._stack))
+        
+class RaiseCommand(Command):
+    """
+    Raise an exception
+    """
+
+    def __init__(self):
+        super().__init__()
+
+    def body(self):
+        raise Exception("Test raise")

cascade_core-0.1.12/cascade/logger.py

@@ -0,0 +1,83 @@
+import logging
+import sys
+import os
+import requests
+import mss
+import mss.tools
+import io
+
+
+class ConsoleHandler(logging.StreamHandler):
+    def __init__(self, log_level: str, stream):
+        super().__init__(stream)
+
+        formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
+        self.setFormatter(formatter)
+        self.setLevel(log_level)
+
+class TGHandler(logging.Handler):
+    def __init__(self, token: str, chats: str, level: str, image_on_error: bool):
+        super().__init__()
+        self.chats = chats.split(',')
+        self.image_on_error = image_on_error
+        self.url = f"https://api.telegram.org/bot{token}/sendMessage"
+        self.image_url = f"https://api.telegram.org/bot{token}/sendPhoto"
+
+        formatter = logging.Formatter("%(levelname)s - %(message)s")
+        self.setFormatter(formatter)
+        self.setLevel(level)
+
+    def emit(self, record):
+        log_entry = self.format(record)
+
+        for chat in self.chats:
+            payload = {
+                "chat_id": chat,
+                "text": log_entry
+            }
+
+            requests.post(self.url, json=payload)
+    
+        if not self.image_on_error:
+            return
+
+        with mss.mss() as sct:
+            monitor = sct.monitors[1]
+            sct_img = sct.grab(monitor)
+            png_bytes = mss.tools.to_png(sct_img.rgb, sct_img.size)
+
+        image_file = io.BytesIO(png_bytes)
+        image_file.name = 'screenshot.png'
+
+        for chat in self.chats:
+            payload = {'chat_id': chat}
+            files = {'photo': image_file}
+
+            requests.post(self.image_url, data=payload, files=files)
+
+class CustomFileHandler(logging.FileHandler):
+    def __init__(self, filename, mode = "a", encoding = None, delay = False, errors = None):
+        super().__init__(filename, mode, encoding, delay, errors)
+
+        formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
+        self.setFormatter(formatter)
+        self.setLevel(logging.DEBUG)
+
+
+def get_logger(name: str):
+    log_level = os.getenv("LOG_LEVEL", "DEBUG")
+    tg_token = os.getenv("TG_BOT_TOKEN", None)
+    tg_chats = os.getenv("TG_BOT_CHATS", None)
+    tg_log_level = os.getenv("TG_LOG_LEVEL", "INFO")
+    tg_image_on_error = os.getenv("TG_IMAGE_ON_ERROR", 0) == "1"
+
+    logger = logging.getLogger(f"genshin_game.[{name}]")
+    logger.setLevel(logging.DEBUG)
+
+    logger.addHandler(ConsoleHandler(log_level, sys.stdout))
+    logger.addHandler(CustomFileHandler("log.txt"))
+
+    if tg_token and tg_chats:
+        logger.addHandler(TGHandler(tg_token, tg_chats, tg_log_level, tg_image_on_error))
+
+    return logger

cascade_core-0.1.12/cascade/operator.py

@@ -0,0 +1,38 @@
+from .stack import Stack
+
+class Operator:
+    pass
+
+class Execute(Operator):
+    def __init__(self, stack: Stack):
+        self.stack = stack
+
+class Store(Operator):
+    def __init__(self, var_name):
+        self.var_name = var_name
+
+class Param(Operator):
+    def __init__(self, value, accumulated=None):
+        self.values = accumulated if accumulated is not None else []
+        self.values.append(value)
+
+    def __rshift__(self, subject):
+        if isinstance(subject, Param):
+            return Param(subject.values[0], accumulated=self.values)
+        
+        subject._vars = self.values
+        return subject
+
+class RaiseSkip(Operator):
+    def __init__(self):
+        pass
+
+class JumpOnRaise(Operator):
+    def __init__(self, command_index: int):
+        super().__init__()
+        self.command_index = command_index
+
+class JumpOnSuccess(Operator):
+    def __init__(self, command_index: int):
+        super().__init__()
+        self.command_index = command_index

cascade_core-0.1.12/cascade/pipeline.py

@@ -0,0 +1,49 @@
+from .command import Command
+from .logger import get_logger
+
+logger = get_logger(__name__)
+
+class Pipeline(Command):
+    def __init__(self):
+        super().__init__()
+        self.pipeline = []
+
+    def _process_chain(self, chain: list):
+        from .operator import Execute
+        self._stack.push({} if not self._stack.top() else self._stack.top().copy())
+        self._stack.update("__debug_name", type(self).__name__)
+
+        i = 0
+        while i < len(chain):
+            subject = chain[i]
+            i += 1
+
+            if type(subject) == list:
+                self._process_chain(subject)
+                continue
+
+            result = subject >> Execute(self._stack)
+
+            if isinstance(result, Exception):
+                if subject._jump_on_raise is not None:
+                    i = subject._jump_on_raise
+                    logger.debug(f"{type(self).__name__} jump to {i} subject")
+                    continue
+
+                if subject._skip_on_raise:
+                    logger.debug(f"{type(self).__name__} skip pipeline")
+                    break
+                else:
+                    logger.debug(f"{type(self).__name__} raise")
+                    raise result
+
+            if subject._jump_on_success is not None:
+                i = subject._jump_on_success
+                logger.debug(f"{type(self).__name__} jump to {i} subject")
+                continue
+
+        result = self._stack.pop()
+        return result.get("result")
+
+    def body(self):
+        return self._process_chain(self.pipeline)

cascade_core-0.1.12/cascade/program.py

@@ -0,0 +1,6 @@
+from .pipeline import Pipeline
+
+
+class Program(Pipeline):
+    def __init__(self):
+        super().__init__()

cascade_core-0.1.12/cascade/resource.py

@@ -0,0 +1,9 @@
+import base64
+
+class Resource:
+    def __init__(self, path: str):
+        self.path = path
+
+    def openAsBase64(self):
+        with open(self.path, "rb") as image_file:
+            return base64.b64encode(image_file.read()).decode('utf-8')

cascade_core-0.1.12/cascade/stack.py

@@ -0,0 +1,26 @@
+class Stack:
+    def __init__(self):
+        self.stack = [{}]
+
+    def push(self, data):
+        self.stack.append(data)
+
+    def pop(self):
+        return self.stack.pop()
+
+    def top(self):
+        if len(self.stack) == 0:
+            return None
+        return self.stack[-1]
+
+    def update(self, key, value):
+        self.stack[-1].update({key: value})
+
+    def raw(self):
+        return self.stack
+
+    def top_value(self, var_name):
+        return self.top().get(var_name)
+
+    def __repr__(self):
+        return repr(self.stack)

cascade_core-0.1.12/cascade_core.egg-info/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: cascade-core
+Version: 0.1.12
+Summary: Cascade Core
+License: MIT License
+        
+        Copyright (c) 2024 vadzimshpak
+        
+        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.
+        
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mss
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Dynamic: license-file
+
+# Cascade Core
+
+<p align="center">
+  <img src="./media/logo.png" width="250">
+</p>
+
+Arch:
+- Command - smallest part
+- Pipeline - mix of commands
+- Program - mix of commands and pipelines
+- [Next level...]
+- [Next level...]
+
+Philosophy:
+
+    - Each well-tested and documented command is part of the sucessfull pipeline.
+        - Each well-tested and documented pipeline is part of the sucessfull program.
+            - Each well-tested and documented program is part of the sucessfull cascade.
+                - Each well-tested and documented cascade is part of the sucessfull business.
+
+Add submodule to project:
+`git submodule add https://github.com/vadzimshpak/cascade-core cascade`

cascade_core-0.1.12/cascade_core.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+README.md
+pyproject.toml
+cascade/__init__.py
+cascade/command.py
+cascade/logger.py
+cascade/operator.py
+cascade/pipeline.py
+cascade/program.py
+cascade/resource.py
+cascade/stack.py
+cascade/commands/__init__.py
+cascade/commands/service.py
+cascade_core.egg-info/PKG-INFO
+cascade_core.egg-info/SOURCES.txt
+cascade_core.egg-info/dependency_links.txt
+cascade_core.egg-info/requires.txt
+cascade_core.egg-info/top_level.txt

cascade_core-0.1.12/cascade_core.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cascade_core-0.1.12/cascade_core.egg-info/requires.txt

@@ -0,0 +1,6 @@
+mss
+python-dotenv
+requests
+
+[test]
+pytest

cascade_core-0.1.12/cascade_core.egg-info/top_level.txt

@@ -0,0 +1 @@
+cascade

cascade_core-0.1.12/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cascade-core"
+version = "0.1.12"
+description = "Cascade Core"
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.11"
+dependencies = [
+    "mss",
+    "python-dotenv",
+    "requests",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest",
+]
+
+[tool.setuptools.packages.find]
+include = ["cascade*"]

cascade_core-0.1.12/setup.cfg

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