flashboot-core 0.1.2__tar.gz

flashboot_core-0.1.2/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: flashboot-core
+Version: 0.1.2
+Summary: Add your description here
+Requires-Python: >=3.10
+Requires-Dist: commons-lang>=0.2.4
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic-yaml>=1.4.0
+Requires-Dist: pyyaml>=6.0.2

flashboot_core-0.1.2/flashboot_core/env/__init__.py

@@ -0,0 +1,7 @@
+from .environment import Environment
+from .property_source_loader import property_bind
+
+__all__ = [
+    "Environment",
+    "property_bind",
+]

flashboot_core-0.1.2/flashboot_core/env/environment.py

@@ -0,0 +1,40 @@
+import argparse
+import os
+from typing import Literal, Optional, get_args
+
+from commons_lang.text import string_utils
+
+ACTIVE_PROFILES_PROPERTY_NAME = "profiles.active"
+
+Profile = Literal["dev", "test", "prod"]
+
+
+class Environment(object):
+
+    @staticmethod
+    def get_active_profiles(default_profile: Optional[Profile] = "prod") -> list[str]:
+        """
+        Get the active profiles from the environment.
+        The value may be comma-delimited.
+        :return: The active profiles.
+        """
+        profiles = []
+        active_profiles = os.getenv(ACTIVE_PROFILES_PROPERTY_NAME)
+        if string_utils.is_blank(active_profiles):
+            parser = argparse.ArgumentParser()
+            parser.add_argument(
+                f"--{ACTIVE_PROFILES_PROPERTY_NAME}",
+                dest="active_profiles",
+                help="The active profiles",
+                default=default_profile,
+                choices=list(map(lambda x: str(x), get_args(Profile))),
+                required=True
+            )
+            args = parser.parse_args()
+            active_profiles = args.active_profiles
+
+        if string_utils.is_not_blank(active_profiles):
+            profiles.extend(active_profiles.split(","))
+        if len(profiles) == 0:
+            raise RuntimeError("No active profiles found")
+        return profiles

flashboot_core-0.1.2/flashboot_core/env/property_source.py

@@ -0,0 +1,20 @@
+import typing
+
+T = typing.TypeVar("T")
+
+
+class PropertySource(object):
+    def __init__(self, name: str, source: typing.Optional[T] = object):
+        self.name = name
+        self.source = source
+        assert self.name is not None
+        assert self.source is not None
+
+    def get_name(self) -> str:
+        return self.name
+
+    def get_source(self) -> T:
+        return self.source
+
+    def get_contains_property(self, name: str):
+        pass

flashboot_core-0.1.2/flashboot_core/env/property_source_loader.py

@@ -0,0 +1,45 @@
+import typing
+from abc import ABC, abstractmethod
+from typing import Optional
+
+from flashboot_core.env.environment import Environment
+from flashboot_core.env.property_source import PropertySource
+from flashboot_core.io.resource import Resource
+
+
+class PropertySourceLoader(ABC):
+
+    @abstractmethod
+    def get_file_extensions(self) -> typing.List[str]:
+        pass
+
+    @abstractmethod
+    def load(self, name: str, source: Resource) -> PropertySource:
+        pass
+
+
+class SimpleYamlLoader:
+    configs = {}
+
+    def __init__(self):
+        self.env = Environment()
+
+    def load(self, source: Optional[Resource]) -> None:
+        profiles = self.env.get_active_profiles()
+        for profile in profiles:
+            pass
+
+#
+# yaml_loader = SimpleYamlLoader()
+# yaml_loader.load("")
+
+
+def property_bind(property_path: str):
+    def decorator(cls):
+        if property_path is None:
+            return
+
+        setattr(cls, "property_path", property_path)
+        pass
+
+    return decorator

flashboot_core-0.1.2/flashboot_core/env/yaml_property_source_loader.py

@@ -0,0 +1,15 @@
+import typing
+
+from flashboot_core.env.property_source import PropertySource
+from flashboot_core.env.property_source_loader import PropertySourceLoader
+from flashboot_core.io.resource import Resource
+
+
+# TODO 使用YamlPropertySourceLoader而不是SimpleYamlLoader
+class YamlPropertySourceLoader(PropertySourceLoader):
+
+    def get_file_extensions(self) -> typing.List[str]:
+        return ["yml", "yaml"]
+
+    def load(self, name: str, source: Resource) -> PropertySource:
+        pass

flashboot_core-0.1.2/flashboot_core/event_bus/__init__.py

@@ -0,0 +1,9 @@
+from flashboot_core.event_bus.async_event_bus import AsyncEventBus, async_event_bus
+from flashboot_core.event_bus.sync_event_bus import SyncEventBus, sync_event_bus
+
+__all__ = [
+    "SyncEventBus",
+    "AsyncEventBus",
+    "sync_event_bus",
+    "async_event_bus"
+]

flashboot_core-0.1.2/flashboot_core/event_bus/async_event_bus.py

@@ -0,0 +1,21 @@
+from typing import Callable
+
+from flashboot_core.event_bus.base import BaseEventBus
+
+
+class AsyncEventBus(BaseEventBus):
+
+    def on(self, event: str, /, *, priority: int = 1) -> Callable | int:
+        pass
+
+    def subscribe(self, event: str, callback: Callable, /, *, priority: int = 1) -> int:
+        pass
+
+    def unsubscribe(self, event: str, callback: Callable, /) -> int | None:
+        pass
+
+    def emit(self, event: str, /, **kwargs) -> int:
+        pass
+
+
+async_event_bus = AsyncEventBus()

flashboot_core-0.1.2/flashboot_core/event_bus/base.py

@@ -0,0 +1,29 @@
+from abc import abstractmethod
+from typing import Dict, List, Callable, Any
+
+from flashboot_core.exceptions.event_bus import InvalidEventException
+
+
+class BaseEventBus:
+    subscribers: Dict[str, List[Dict]] = {}
+
+    @abstractmethod
+    def on(self, event: str, /, *, priority: int = 1) -> Callable | int:
+        ...
+
+    @abstractmethod
+    def subscribe(self, event: str, callback: Callable, /, *, priority: int = 1) -> int:
+        ...
+
+    @abstractmethod
+    def unsubscribe(self, event: str, callback: Callable, /) -> int | None:
+        ...
+
+    @abstractmethod
+    def emit(self, event: str, /, **kwargs) -> int:
+        ...
+
+    @staticmethod
+    def validate_event(event: Any):
+        if not isinstance(event, str):
+            raise InvalidEventException(event)

flashboot_core-0.1.2/flashboot_core/event_bus/sync_event_bus.py

@@ -0,0 +1,46 @@
+from typing import Callable
+
+from flashboot_core.event_bus.base import BaseEventBus
+
+
+class SyncEventBus(BaseEventBus):
+
+    def on(self, event: str, /, *, priority: int = 1) -> Callable:
+        """
+        Decorator for event subscribe, do not use for instance method.
+        :param event:
+        :param priority:
+        :return:
+        """
+        self.validate_event(event)
+
+        def wrapper(callback: Callable):
+            self.subscribe(event, callback, priority=priority)
+            return callback
+
+        return wrapper
+
+    def subscribe(self, event: str, callback: Callable, /, *, priority: int = 1) -> None:
+        if event not in self.subscribers:
+            self.subscribers[event] = []
+        self.subscribers[event].append({"callback": callback, "priority": priority})
+        self.subscribers[event].sort(key=lambda x: x["priority"], reverse=True)
+
+    def unsubscribe(self, event: str, callback: Callable, /) -> None:
+        if event not in self.subscribers:
+            return
+        self.subscribers[event] = [x for x in self.subscribers[event] if x["callback"] != callback]
+
+    def emit(self, event: str, *args, **kwargs) -> int:
+        self.validate_event(event)
+
+        emit_count: int = 0
+        for subscriber in self.subscribers.get(event, []):
+            callback = subscriber["callback"]
+            callback(*args, **kwargs)
+            emit_count += 1
+
+        return emit_count
+
+
+sync_event_bus = SyncEventBus()

flashboot_core-0.1.2/flashboot_core/exceptions/__init__.py

@@ -0,0 +1,5 @@
+from flashboot_core.exceptions.base import FlashBootException
+
+__all__ = [
+    "FlashBootException",
+]

flashboot_core-0.1.2/flashboot_core/exceptions/base.py

@@ -0,0 +1,3 @@
+class FlashBootException(Exception):
+    ...
+

flashboot_core-0.1.2/flashboot_core/exceptions/event_bus.py

@@ -0,0 +1,9 @@
+from typing import Any
+
+from flashboot_core.exceptions.base import FlashBootException
+
+
+class InvalidEventException(FlashBootException):
+
+    def __init__(self, event: Any) -> None:
+        super().__init__(f"Expected type \"str\" but got type \"{type(event).__name__}\" instead")

flashboot_core-0.1.2/flashboot_core/io/__init__.py

@@ -0,0 +1,5 @@
+from .file import File
+
+__all__ = [
+    "File"
+]

flashboot_core-0.1.2/flashboot_core/io/file.py

@@ -0,0 +1,13 @@
+from pathlib import Path
+
+
+class File:
+
+    def __init__(self, pathname: str | Path):
+        self.pathname = Path(pathname)
+
+    def get_name(self) -> str:
+        return str(self.pathname)
+
+    def get_absolute_path(self) -> str:
+        return str(self.pathname.absolute())

flashboot_core-0.1.2/flashboot_core/io/file_system_resource.py

@@ -0,0 +1,16 @@
+from pathlib import Path
+
+from flashboot_core.io import File
+from flashboot_core.io.resource import Resource
+
+
+class FileSystemResource(Resource):
+
+    def __init__(self, pathname: str | Path):
+        self.pathname = Path(pathname)
+
+    def get_file(self) -> File:
+        return File(self.pathname)
+
+    def get_file_name(self) -> str:
+        return self.pathname.name

flashboot_core-0.1.2/flashboot_core/io/resource.py

@@ -0,0 +1,14 @@
+from abc import ABC, abstractmethod
+
+from flashboot_core.io import File
+
+
+class Resource(ABC):
+
+    @abstractmethod
+    def get_file(self) -> File:
+        pass
+
+    @abstractmethod
+    def get_file_name(self) -> str:
+        pass

flashboot_core-0.1.2/flashboot_core.egg-info/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: flashboot-core
+Version: 0.1.2
+Summary: Add your description here
+Requires-Python: >=3.10
+Requires-Dist: commons-lang>=0.2.4
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic-yaml>=1.4.0
+Requires-Dist: pyyaml>=6.0.2

flashboot_core-0.1.2/flashboot_core.egg-info/SOURCES.txt

@@ -0,0 +1,25 @@
+pyproject.toml
+flashboot_core/__init__.py
+flashboot_core.egg-info/PKG-INFO
+flashboot_core.egg-info/SOURCES.txt
+flashboot_core.egg-info/dependency_links.txt
+flashboot_core.egg-info/requires.txt
+flashboot_core.egg-info/top_level.txt
+flashboot_core/env/__init__.py
+flashboot_core/env/environment.py
+flashboot_core/env/properties_property_source_loader.py
+flashboot_core/env/property_source.py
+flashboot_core/env/property_source_loader.py
+flashboot_core/env/yaml_property_source_loader.py
+flashboot_core/event_bus/__init__.py
+flashboot_core/event_bus/async_event_bus.py
+flashboot_core/event_bus/base.py
+flashboot_core/event_bus/sync_event_bus.py
+flashboot_core/exceptions/__init__.py
+flashboot_core/exceptions/base.py
+flashboot_core/exceptions/event_bus.py
+flashboot_core/io/__init__.py
+flashboot_core/io/file.py
+flashboot_core/io/file_system_resource.py
+flashboot_core/io/resource.py
+flashboot_core/utils/__init__.py

flashboot_core-0.1.2/flashboot_core.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

flashboot_core-0.1.2/flashboot_core.egg-info/requires.txt

@@ -0,0 +1,4 @@
+commons-lang>=0.2.4
+loguru>=0.7.3
+pydantic-yaml>=1.4.0
+pyyaml>=6.0.2

flashboot_core-0.1.2/flashboot_core.egg-info/top_level.txt

@@ -0,0 +1 @@
+flashboot_core

flashboot_core-0.1.2/pyproject.toml

@@ -0,0 +1,11 @@
+[project]
+name = "flashboot-core"
+version = "0.1.2"
+description = "Add your description here"
+requires-python = ">=3.10"
+dependencies = [
+    "commons-lang>=0.2.4",
+    "loguru>=0.7.3",
+    "pydantic-yaml>=1.4.0",
+    "pyyaml>=6.0.2",
+]

flashboot_core-0.1.2/setup.cfg

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