AdvancedTagscript 3.2.3__py3-none-any.whl

TagScriptEngine/__init__.py

@@ -0,0 +1,227 @@
+from __future__ import annotations
+
+from typing import Final, NamedTuple, Tuple
+
+from .adapter import (
+    SafeObjectAdapter as SafeObjectAdapter,
+    StringAdapter as StringAdapter,
+    IntAdapter as IntAdapter,
+    FunctionAdapter as FunctionAdapter,
+    DiscordAttributeAdapter as DiscordAttributeAdapter,
+    UserAdapter as UserAdapter,
+    MemberAdapter as MemberAdapter,
+    DMChannelAdapter as DMChannelAdapter,
+    ChannelAdapter as ChannelAdapter,
+    GuildAdapter as GuildAdapter,
+    RoleAdapter as RoleAdapter,
+    AttributeAdapter as AttributeAdapter,
+    DiscordObjectAdapter as DiscordObjectAdapter,
+    RedCommandAdapter as RedCommandAdapter,
+    RedBotAdapter as RedBotAdapter,
+)
+from .block import (
+    implicit_bool as implicit_bool,
+    helper_parse_if as helper_parse_if,
+    helper_parse_list_if as helper_parse_list_if,
+    helper_split as helper_split,
+    AllowedMentionsBlock as AllowedMentionsBlock,
+    AllBlock as AllBlock,
+    AnyBlock as AnyBlock,
+    AssignmentBlock as AssignmentBlock,
+    BlacklistBlock as BlacklistBlock,
+    BreakBlock as BreakBlock,
+    SequentialGather as SequentialGather,
+    CommandBlock as CommandBlock,
+    EmbedBlock as EmbedBlock,
+    FiftyFiftyBlock as FiftyFiftyBlock,
+    IfBlock as IfBlock,
+    LooseVariableGetterBlock as LooseVariableGetterBlock,
+    MathBlock as MathBlock,
+    OverrideBlock as OverrideBlock,
+    PythonBlock as PythonBlock,
+    RandomBlock as RandomBlock,
+    RangeBlock as RangeBlock,
+    RedirectBlock as RedirectBlock,
+    ReplaceBlock as ReplaceBlock,
+    RequireBlock as RequireBlock,
+    ShortCutRedirectBlock as ShortCutRedirectBlock,
+    StopBlock as StopBlock,
+    StrfBlock as StrfBlock,
+    StrictVariableGetterBlock as StrictVariableGetterBlock,
+    SubstringBlock as SubstringBlock,
+    URLEncodeBlock as URLEncodeBlock,
+    UpperBlock as UpperBlock,
+    LowerBlock as LowerBlock,
+    CountBlock as CountBlock,
+    LengthBlock as LengthBlock,
+    CooldownBlock as CooldownBlock,
+)
+from .interface import (
+    Adapter as Adapter,
+    SimpleAdapter as SimpleAdapter,
+    Block as Block,
+    verb_required_block as verb_required_block,
+)
+from ._warnings import (
+    TagScriptEngineDeprecationWarning as TagScriptEngineDeprecationWarning,
+)
+from .exceptions import (
+    TagScriptError as TagScriptError,
+    WorkloadExceededError as WorkloadExceededError,
+    ProcessError as ProcessError,
+    EmbedParseError as EmbedParseError,
+    BadColourArgument as BadColourArgument,
+    StopError as StopError,
+    CooldownExceeded as CooldownExceeded,
+)
+from .interpreter import (
+    Interpreter as Interpreter,
+    AsyncInterpreter as AsyncInterpreter,
+    Context as Context,
+    Response as Response,
+    Node as Node,
+    build_node_tree as build_node_tree,
+)
+from .utils import (
+    truncate as truncate,
+    escape_content as escape_content,
+    maybe_await as maybe_await,
+)
+from .verb import (
+    Verb as Verb,
+)
+
+
+__all__: Tuple[str, ...] = (
+    "implicit_bool",
+    "helper_parse_if",
+    "helper_parse_list_if",
+    "helper_split",
+    "AllBlock",
+    "AnyBlock",
+    "AssignmentBlock",
+    "BlacklistBlock",
+    "BreakBlock",
+    "SequentialGather",
+    "CommandBlock",
+    "CooldownBlock",
+    "EmbedBlock",
+    "FiftyFiftyBlock",
+    "IfBlock",
+    "LooseVariableGetterBlock",
+    "MathBlock",
+    "OverrideBlock",
+    "PythonBlock",
+    "RandomBlock",
+    "RangeBlock",
+    "RedirectBlock",
+    "ReplaceBlock",
+    "RequireBlock",
+    "ShortCutRedirectBlock",
+    "StopBlock",
+    "StrfBlock",
+    "StrictVariableGetterBlock",
+    "SubstringBlock",
+    "URLEncodeBlock",
+    "UpperBlock",
+    "LowerBlock",
+    "CountBlock",
+    "LengthBlock",
+    "SafeObjectAdapter",
+    "StringAdapter",
+    "IntAdapter",
+    "FunctionAdapter",
+    "RedCommandAdapter",
+    "RedBotAdapter",
+    "AttributeAdapter",
+    "DiscordAttributeAdapter",
+    "UserAdapter",
+    "MemberAdapter",
+    "DMChannelAdapter",
+    "ChannelAdapter",
+    "GuildAdapter",
+    "RoleAdapter",
+    "DiscordObjectAdapter",
+    "Adapter",
+    "SimpleAdapter",
+    "Block",
+    "verb_required_block",
+    "TagScriptEngineDeprecationWarning",
+    "TagScriptError",
+    "WorkloadExceededError",
+    "ProcessError",
+    "EmbedParseError",
+    "BadColourArgument",
+    "StopError",
+    "CooldownExceeded",
+    "Interpreter",
+    "AsyncInterpreter",
+    "Context",
+    "Response",
+    "Node",
+    "build_node_tree",
+    "truncate",
+    "escape_content",
+    "maybe_await",
+    "Verb",
+    "__version__",
+    "VersionInfo",
+    "version_info",
+)
+
+
+__version__: Final[str] = "3.2.3"
+
+
+class VersionNamedTuple(NamedTuple):
+    major: int
+    minor: int
+    micro: int
+
+
+class VersionInfo(VersionNamedTuple):
+    """
+    Version information.
+
+    Attributes
+    ----------
+    major: int
+        Major version number.
+    minor: int
+        Minor version number.
+    micro: int
+        Micro version number.
+    """
+
+    __slots__: Tuple[str, ...] = ()
+
+    def __str__(self) -> str:
+        """
+        Returns a string representation of the version information.
+
+        Returns
+        -------
+        str
+            String representation of the version information.
+        """
+        return "{major}.{minor}.{micro}".format(**self._asdict())
+
+    @classmethod
+    def from_str(cls, version: str) -> "VersionInfo":
+        """
+        Returns a VersionInfo instance from a string.
+
+        Parameters
+        ----------
+        version: str
+            String representation of the version information.
+
+        Returns
+        -------
+        VersionInfo
+            Version information.
+        """
+        return cls(*map(int, version.split(".")))
+
+
+version_info: VersionInfo = VersionInfo.from_str(__version__)

TagScriptEngine/_warnings.py

@@ -0,0 +1,88 @@
+import warnings
+import functools
+from typing import Callable, Optional, Tuple, TypeVar
+from typing_extensions import ParamSpec
+
+
+_P = ParamSpec("_P")
+_T = TypeVar("_T")
+
+
+__all__: Tuple[str, ...] = (
+    "TagScriptEngineDeprecationWarning",
+    "TagScriptEngineAttributeRemovalWarning",
+)
+
+
+class TagScriptEngineAttributeRemovalWarning(Warning):
+    """A class for issuing removal warning for TagScriptEngine class attributes."""
+
+
+class TagScriptEngineDeprecationWarning(DeprecationWarning):
+    """A class for issuing deprecation warnings for TagScriptEngine modules."""
+
+
+def remove(
+    name: str, *, reason: Optional[str] = None, version: Optional[str] = None, level: int = 2
+) -> None:
+    warnings.warn(
+        "Removal: {name}.{reason}{version}".format(
+            name=name,
+            reason=" ({})".format(reason) if reason else "",
+            version=" -- Removal scheduled since version v{}".format(version) if version else "",
+        ),
+        category=TagScriptEngineAttributeRemovalWarning,
+        stacklevel=level,
+    )
+
+
+def removal(
+    *,
+    name: Optional[str] = None,
+    reason: Optional[str] = None,
+    version: Optional[str] = None,
+    level: int = 3,
+) -> Callable[[Callable[_P, _T]], Callable[_P, _T]]:
+    def decorator(func: Callable[_P, _T]) -> Callable[_P, _T]:
+        functools.wraps(func)
+
+        def wrapper(*args: _P.args, **kwargs: _P.kwargs) -> _T:
+            remove(name or func.__name__, reason=reason, version=version, level=level)
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator
+
+
+def depricate(
+    name: str, *, reason: Optional[str] = None, version: Optional[str] = None, level: int = 2
+) -> None:
+    warnings.warn(
+        "Deprecated: {name}.{reason}{version}".format(
+            name=name,
+            reason=" ({})".format(reason) if reason else "",
+            version=" -- Deprecated since version v{}.".format(version) if version else "",
+        ),
+        category=TagScriptEngineDeprecationWarning,
+        stacklevel=level,
+    )
+
+
+def deprecated(
+    *,
+    name: Optional[str] = None,
+    reason: Optional[str] = None,
+    version: Optional[str] = None,
+    level: int = 3,
+) -> Callable[[Callable[_P, _T]], Callable[_P, _T]]:
+    def decorator(func: Callable[_P, _T]) -> Callable[_P, _T]:
+        functools.wraps(func)
+
+        def wrapper(*args: _P.args, **kwargs: _P.kwargs) -> _T:
+            depricate(name or func.__name__, reason=reason, version=version, level=level)
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator

TagScriptEngine/adapter/__init__.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+from typing import Tuple
+
+from .discordadapters import (
+    AttributeAdapter as AttributeAdapter,
+    DiscordAttributeAdapter as DiscordAttributeAdapter,
+    UserAdapter as UserAdapter,
+    MemberAdapter as MemberAdapter,
+    DMChannelAdapter as DMChannelAdapter,
+    ChannelAdapter as ChannelAdapter,
+    GuildAdapter as GuildAdapter,
+    RoleAdapter as RoleAdapter,
+    DiscordObjectAdapter as DiscordObjectAdapter,
+)
+from .functionadapter import (
+    FunctionAdapter as FunctionAdapter,
+)
+from .intadapter import (
+    IntAdapter as IntAdapter,
+)
+from .objectadapter import (
+    SafeObjectAdapter as SafeObjectAdapter,
+)
+from .redbotadapters import (
+    RedCommandAdapter as RedCommandAdapter,
+    RedBotAdapter as RedBotAdapter,
+)
+from .stringadapter import (
+    StringAdapter as StringAdapter,
+)
+
+
+__all__: Tuple[str, ...] = (
+    "SafeObjectAdapter",
+    "StringAdapter",
+    "IntAdapter",
+    "FunctionAdapter",
+    "AttributeAdapter",
+    "DiscordAttributeAdapter",
+    "UserAdapter",
+    "MemberAdapter",
+    "DMChannelAdapter",
+    "ChannelAdapter",
+    "GuildAdapter",
+    "RoleAdapter",
+    "DiscordObjectAdapter",
+    "RedCommandAdapter",
+    "RedBotAdapter",
+)