shvcli 0.8.0__tar.gz → 0.9.0__tar.gz

shvcli-0.9.0/PKG-INFO

@@ -0,0 +1,267 @@
+Metadata-Version: 2.4
+Name: shvcli
+Version: 0.9.0
+Summary: Silicon Heaven CLI access application
+Author: Elektroline a.s.
+License: MIT License
+        
+        Copyright (c) 2023 Elektroline a.s.
+        
+        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.
+        
+Project-URL: repository, https://gitlab.com/silicon-heaven/shvcli
+Classifier: Development Status :: 4 - Beta
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Topic :: Home Automation
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: Terminals
+Requires-Python: >=3.12
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: pyshv>=0.14.0
+Requires-Dist: prompt-toolkit
+Requires-Dist: pygments
+Requires-Dist: pyxdg
+Requires-Dist: more-itertools
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Dynamic: license-file
+
+#######################################
+ Silicon Heaven CLI access application
+#######################################
+
+.. image:: https://gitlab.com/silicon-heaven/shvcli/-/raw/master/logo.svg
+    :align: right
+    :height: 128px
+
+This provides an easy to use CLI interfase to access the SHV network.
+
+- `📃 Sources <https://gitlab.com/silicon-heaven/shvcli>`__
+- `⁉️ Issue tracker <https://gitlab.com/silicon-heaven/shvcli/-/issues>`__
+- `📕 Silicon Heaven protocol documentation
+  <https://silicon-heaven.github.io/shv-doc/>`__
+
+**************
+ Installation
+**************
+
+The installation can be done with package manager ``pip``.
+
+.. code-block:: console
+
+    $ pip install shvcli
+
+Documentation
+=============
+
+*******
+ Usage
+*******
+
+You need to start application ``shvcli``. The first argument is URL specifying where
+client should connect to.
+
+After successful connection you will see prompt (``>``) and you can start typing.
+Methods can be called with ``PATH:METHOD`` syntax or with just ``METHOD``. You can use
+``PATH:`` for change current path prefix. This prefix is displayed before prompt and is
+prefixed to any paths you specify on command line. To return to the root you need to use
+absolute path (``/``).
+
+An example of usage:
+
+.. code-block:: console
+
+    > ls
+    .app
+    > dir
+    dir ls lschng
+    > .app:
+    .app> dir
+    dir ls lschng shvVersionMajor shvVersionMinor name version ping
+    .app> name
+    "pyshvbroker"
+    .app> broker:ls
+    currentClient client clientInfo
+    .app> ls broker
+    currentClient client clientInfo
+    .app> broker/currentClient:info
+    {"clientId":0,"mountPoint":null,"subscriptions":[],"userName":"admin"}
+    .app> /:
+    >
+
+.. tip::
+
+    The validation that is performed by SHVCLI is best effort and sometimes you might
+    need to submit call that is considered invalid by SHVCLI. For that reason you can
+    use `Ctrl+o` shortcut instead of pressing enter key.
+
+********************
+ Configuration file
+********************
+
+Tool reads configuration from files ``/etc/shvcli.toml`` and ``~/.shvcli.toml``. They
+are in TOML file format and the following sections are supported:
+
+**hosts**: That provides mapping from some name to RPC URL.
+
+**hosts-shell**: That is same as **hosts** with exception that URL is passed through
+your local Shell to expand any variables or command substitutions.
+
+**option**: That allows you to set initial setting for runtime options. The following
+options are available without any plugins:
+
+- **vimode**: If Vi input mode should be used for command line input. The default is
+  ``false``.
+- **autoget**: Automatically call getter methods and print received values when listing
+  nodes and methods (``ls`` and ``dir`` methods special handling).
+- **autoprobe**: Completion process benefits from probing of the SHV nodes with ``ls``
+  and ``dir``, and to provide easier usage this can happen automatically in background.
+  This is what this option controls. It is ``true`` by default but it might not be
+  desirable in some cases, because this can generate a lot of hidden traffic.
+- **raw**: Controls if ``ls`` and ``dir`` methods are handled in a special way as
+  described later in this document. This special handling can be possibly decremental if
+  you are trying to debug something specific with these functions and this provides a
+  way to call them with any CPON to see what they provide. Note that caching and
+  discovery of the nodes will stop working once you are in the raw mode and thus you
+  will no longer get the advantage of that. The default is ``false``.
+- **debug**: Controls if internal debug messages are displayed. These messages can give
+  you idea of what shvcli is actually doing behind the wail but it can be also
+  overwhelming. The default is ``false``. It is beneficial to disable the **autobrobe**
+  once you enable debug because otherwise output on CLI will be mangled on completion.
+- **call_query_timeout**: Timeout in seconds for status request query. The shorter time
+  will result in faster request lost detection while very short time will load SHV
+  network too much.
+- **call_retry_timeout**: Timeout in seconds when call request is sent again if no
+  response is received. This is not applied if query is and thus this mostly is used
+  only in case when method doesn't support delayed responses.
+- **autoget_timeout**: Timeout in seconds for call that is part of autoget
+  functionality.
+- **history_count**: Integer number used for number of records requested at time for
+  ``!history`` builtin.
+
+Example configuration file:
+
+.. code-block:: ini
+
+    [hosts]
+    localhost = tcp://test@localhost?password=test
+
+    [hosts-shell]
+    company = tcp://smith@company.example.org?password=$(pass company/shv)
+
+    [config]
+    vimode = true
+
+******************
+ Internal methods
+******************
+
+CLI provides few additional methods that can be called on top of the ones provided by
+SHV network. They are all prefixed with ``!`` to clearly distinguish them. They provide
+a way to control CLI as well as to get insight into the environment you are running in.
+
+**subscribe|sub**: Add new subscribe. Shortcut to the call of
+``.app/broker/currentClient:subscribe`` that accepts arguments in more convenient way.
+The argument can be multiple RPC RIs (``PATH:METHOD:SIGNAL`` patterns).
+
+**unsubscribe|usub**: Unsubscribe existing subscription. It is reverse operation to the
+**subscribe** and same remarks apply here as well. It is a shortcut to the call of
+``.app/broker/currentClient:unsubscribe``
+
+**subscriptions|subs**: List current subscriptions. This is shortcut to call
+``.app/broker/currentClient:subscriptions``.
+
+**cd**: Change current path prefix to given one even when there is no such node.
+
+**tree|t**: This prints tree of known nodes from current path prefix. This is not all
+nodes present in the SHV network. This is only what was discovered so far (and cached
+thus it can be also old). You can use it to visualize the tree of nodes you are working
+with as well as to get insight into the state of the cache.
+
+**scan[X]**: Perform recursive probing of the tree up to the depth given as `X` (the
+default is 3). On big servers this can be pretty resource demanding and thus use it
+sparely.
+
+**set|s**: allows modification of configuration option in runtime. The names are the
+same as in ``config`` section. The boolean options are set if no argument is provided,
+or cleared if name is prefixed with ``no`` (and thus to disable ``raw`` you use
+``noraw``). You can also add ``=true`` or ``=false``. The equal sign is also used with
+integer and floating point options. Without any configuration option it simply prints
+the current configuration.
+
+**upload**: provides a way to copy local file to the RPC File node. The parameter must
+be path to the local file to be uploaded.
+
+**download**: provides a way to copy RPC File node data to local file. The parameter
+must be path to the local file where data will be stored.
+
+**verify**: provides a way to verify RPC File node against local file. The parameter
+must be path to the local file used for the verification.
+
+**history**: is helper to list recorded history of signals by ``.history`` API. The
+listing is incremental in ``history_count`` configured number of records and in the
+order from the newest ones.
+
+************************************
+ Special methods ``ls`` and ``dir``
+************************************
+
+These methods are handled in a special way to allow easy discovery of the SHV nodes.
+Their output is processed and displayed in easy to read format but not in the fullest
+content.
+
+Their parameter is also handled in a special way. It is considered to be additional path
+suffix unless it is a valid CPON. This is allowed to match the common shells.
+
+You can see ``raw`` option to disable this behavior.
+
+**************
+ OAuth2 login
+**************
+
+SHVCLI supports non-standard login method OAuth2. This is not defined by SHV standard.
+The non-standard URL query ``oauth2=y`` is accepted to perform the OAuth2 login. The
+login is facilitated by web browser. SHVCLI will start server on
+``tcp://localhost:37719/`` to be able to receive token.
+
+*********
+ Plugins
+*********
+
+The support for external plugins is provided. These plugins are discovered using Python
+package metadata using the entry point ``shvcli.plugins``.
+
+Running tests
+=============
+
+This project contains basic tests in directory tests; see the dependencies in the
+``pyproject.toml`` file.
+
+To run tests you have to use **pytest**. To run all tests just run it in the top level
+directory of the project:
+
+.. code-block:: console
+
+    $ pytest
+
+See the `pytest documentation <https://docs.pytest.org/>`__ for more info.

shvcli-0.9.0/README.rst

@@ -0,0 +1,219 @@
+#######################################
+ Silicon Heaven CLI access application
+#######################################
+
+.. image:: https://gitlab.com/silicon-heaven/shvcli/-/raw/master/logo.svg
+    :align: right
+    :height: 128px
+
+This provides an easy to use CLI interfase to access the SHV network.
+
+- `📃 Sources <https://gitlab.com/silicon-heaven/shvcli>`__
+- `⁉️ Issue tracker <https://gitlab.com/silicon-heaven/shvcli/-/issues>`__
+- `📕 Silicon Heaven protocol documentation
+  <https://silicon-heaven.github.io/shv-doc/>`__
+
+**************
+ Installation
+**************
+
+The installation can be done with package manager ``pip``.
+
+.. code-block:: console
+
+    $ pip install shvcli
+
+Documentation
+=============
+
+*******
+ Usage
+*******
+
+You need to start application ``shvcli``. The first argument is URL specifying where
+client should connect to.
+
+After successful connection you will see prompt (``>``) and you can start typing.
+Methods can be called with ``PATH:METHOD`` syntax or with just ``METHOD``. You can use
+``PATH:`` for change current path prefix. This prefix is displayed before prompt and is
+prefixed to any paths you specify on command line. To return to the root you need to use
+absolute path (``/``).
+
+An example of usage:
+
+.. code-block:: console
+
+    > ls
+    .app
+    > dir
+    dir ls lschng
+    > .app:
+    .app> dir
+    dir ls lschng shvVersionMajor shvVersionMinor name version ping
+    .app> name
+    "pyshvbroker"
+    .app> broker:ls
+    currentClient client clientInfo
+    .app> ls broker
+    currentClient client clientInfo
+    .app> broker/currentClient:info
+    {"clientId":0,"mountPoint":null,"subscriptions":[],"userName":"admin"}
+    .app> /:
+    >
+
+.. tip::
+
+    The validation that is performed by SHVCLI is best effort and sometimes you might
+    need to submit call that is considered invalid by SHVCLI. For that reason you can
+    use `Ctrl+o` shortcut instead of pressing enter key.
+
+********************
+ Configuration file
+********************
+
+Tool reads configuration from files ``/etc/shvcli.toml`` and ``~/.shvcli.toml``. They
+are in TOML file format and the following sections are supported:
+
+**hosts**: That provides mapping from some name to RPC URL.
+
+**hosts-shell**: That is same as **hosts** with exception that URL is passed through
+your local Shell to expand any variables or command substitutions.
+
+**option**: That allows you to set initial setting for runtime options. The following
+options are available without any plugins:
+
+- **vimode**: If Vi input mode should be used for command line input. The default is
+  ``false``.
+- **autoget**: Automatically call getter methods and print received values when listing
+  nodes and methods (``ls`` and ``dir`` methods special handling).
+- **autoprobe**: Completion process benefits from probing of the SHV nodes with ``ls``
+  and ``dir``, and to provide easier usage this can happen automatically in background.
+  This is what this option controls. It is ``true`` by default but it might not be
+  desirable in some cases, because this can generate a lot of hidden traffic.
+- **raw**: Controls if ``ls`` and ``dir`` methods are handled in a special way as
+  described later in this document. This special handling can be possibly decremental if
+  you are trying to debug something specific with these functions and this provides a
+  way to call them with any CPON to see what they provide. Note that caching and
+  discovery of the nodes will stop working once you are in the raw mode and thus you
+  will no longer get the advantage of that. The default is ``false``.
+- **debug**: Controls if internal debug messages are displayed. These messages can give
+  you idea of what shvcli is actually doing behind the wail but it can be also
+  overwhelming. The default is ``false``. It is beneficial to disable the **autobrobe**
+  once you enable debug because otherwise output on CLI will be mangled on completion.
+- **call_query_timeout**: Timeout in seconds for status request query. The shorter time
+  will result in faster request lost detection while very short time will load SHV
+  network too much.
+- **call_retry_timeout**: Timeout in seconds when call request is sent again if no
+  response is received. This is not applied if query is and thus this mostly is used
+  only in case when method doesn't support delayed responses.
+- **autoget_timeout**: Timeout in seconds for call that is part of autoget
+  functionality.
+- **history_count**: Integer number used for number of records requested at time for
+  ``!history`` builtin.
+
+Example configuration file:
+
+.. code-block:: ini
+
+    [hosts]
+    localhost = tcp://test@localhost?password=test
+
+    [hosts-shell]
+    company = tcp://smith@company.example.org?password=$(pass company/shv)
+
+    [config]
+    vimode = true
+
+******************
+ Internal methods
+******************
+
+CLI provides few additional methods that can be called on top of the ones provided by
+SHV network. They are all prefixed with ``!`` to clearly distinguish them. They provide
+a way to control CLI as well as to get insight into the environment you are running in.
+
+**subscribe|sub**: Add new subscribe. Shortcut to the call of
+``.app/broker/currentClient:subscribe`` that accepts arguments in more convenient way.
+The argument can be multiple RPC RIs (``PATH:METHOD:SIGNAL`` patterns).
+
+**unsubscribe|usub**: Unsubscribe existing subscription. It is reverse operation to the
+**subscribe** and same remarks apply here as well. It is a shortcut to the call of
+``.app/broker/currentClient:unsubscribe``
+
+**subscriptions|subs**: List current subscriptions. This is shortcut to call
+``.app/broker/currentClient:subscriptions``.
+
+**cd**: Change current path prefix to given one even when there is no such node.
+
+**tree|t**: This prints tree of known nodes from current path prefix. This is not all
+nodes present in the SHV network. This is only what was discovered so far (and cached
+thus it can be also old). You can use it to visualize the tree of nodes you are working
+with as well as to get insight into the state of the cache.
+
+**scan[X]**: Perform recursive probing of the tree up to the depth given as `X` (the
+default is 3). On big servers this can be pretty resource demanding and thus use it
+sparely.
+
+**set|s**: allows modification of configuration option in runtime. The names are the
+same as in ``config`` section. The boolean options are set if no argument is provided,
+or cleared if name is prefixed with ``no`` (and thus to disable ``raw`` you use
+``noraw``). You can also add ``=true`` or ``=false``. The equal sign is also used with
+integer and floating point options. Without any configuration option it simply prints
+the current configuration.
+
+**upload**: provides a way to copy local file to the RPC File node. The parameter must
+be path to the local file to be uploaded.
+
+**download**: provides a way to copy RPC File node data to local file. The parameter
+must be path to the local file where data will be stored.
+
+**verify**: provides a way to verify RPC File node against local file. The parameter
+must be path to the local file used for the verification.
+
+**history**: is helper to list recorded history of signals by ``.history`` API. The
+listing is incremental in ``history_count`` configured number of records and in the
+order from the newest ones.
+
+************************************
+ Special methods ``ls`` and ``dir``
+************************************
+
+These methods are handled in a special way to allow easy discovery of the SHV nodes.
+Their output is processed and displayed in easy to read format but not in the fullest
+content.
+
+Their parameter is also handled in a special way. It is considered to be additional path
+suffix unless it is a valid CPON. This is allowed to match the common shells.
+
+You can see ``raw`` option to disable this behavior.
+
+**************
+ OAuth2 login
+**************
+
+SHVCLI supports non-standard login method OAuth2. This is not defined by SHV standard.
+The non-standard URL query ``oauth2=y`` is accepted to perform the OAuth2 login. The
+login is facilitated by web browser. SHVCLI will start server on
+``tcp://localhost:37719/`` to be able to receive token.
+
+*********
+ Plugins
+*********
+
+The support for external plugins is provided. These plugins are discovered using Python
+package metadata using the entry point ``shvcli.plugins``.
+
+Running tests
+=============
+
+This project contains basic tests in directory tests; see the dependencies in the
+``pyproject.toml`` file.
+
+To run tests you have to use **pytest**. To run all tests just run it in the top level
+directory of the project:
+
+.. code-block:: console
+
+    $ pytest
+
+See the `pytest documentation <https://docs.pytest.org/>`__ for more info.

{shvcli-0.8.0 → shvcli-0.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "shvcli"
-version = "0.8.0"
+version = "0.9.0"
 description = "Silicon Heaven CLI access application"
 readme = "README.rst"
 license = {file = "LICENSE"}
@@ -16,10 +16,10 @@ classifiers = [
   "Topic :: System :: Shells",
   "Topic :: Terminals",
 ]
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 dependencies = [
-  "pyshv >= 0.10.0",
-  "prompt_toolkit",
+  "pyshv >= 0.14.0",
+  "prompt-toolkit",
   "pygments",
   "pyxdg",
   "more-itertools",
@@ -28,6 +28,12 @@ dependencies = [
 [project.urls]
 repository = "https://gitlab.com/silicon-heaven/shvcli"
 
+[project.optional-dependencies]
+test = [
+  "pytest",
+  "pytest-cov",
+]
+
 [project.scripts]
 shvcli = "shvcli.__main__:main"
 
@@ -43,14 +49,13 @@ build_py = "shvcli.__setuptools__.BuildPy"
 
 [tool.coverage.run]
 branch = true
+omit = ["shvcli/__setuptools__.py", "tests/*"]
 [tool.coverage.report]
 exclude_lines = [
     "pragma: no cover",
     "if typing.TYPE_CHECKING:"
 ]
 
-[tool.ruff]
-target-version = "py311"
 [tool.ruff.lint]
 select = [
   "F", "E", "W", "I", "N", "D", "UP", "YTT", "ANN", "ASYNC", "ASYNC1", "S", "BLE",
@@ -59,42 +64,51 @@ select = [
 ignore = [
   # Magic methods have defined behavior so what is there to document. __init__
   # should be documented in class docstring.
-  "D105", "D107",
+  "undocumented-magic-method", "undocumented-public-init",
   # These have conflicting rules.
-  "D203", "D213",
+  "incorrect-blank-line-before-class", "multi-line-summary-second-line",
   # Ignore too long lines (format tackles that)
-  "E501",
+  "line-too-long",
   # It is nice that assert should not be used for input checking but it can be
   # also used for internal consistency checking.
-  "S101", "B011",
+  "assert", "assert-false",
   # subprocess can be insecurely used but not is insecure by design
-  "S404", "S603", "S607",
+  "suspicious-subprocess-import", "subprocess-without-shell-equals-true",
+  "start-process-with-partial-path",
   # Catching Exception is valid and safe in some cases and thus should be allowed
-  "BLE001",
+  "blind-except",
   # Conflict with formatter
-  "COM812",
+  "missing-trailing-comma",
   # Remove too-many limit for more complex code.
-  "PLR0904", "PLR0911", "PLR0912", "PLR0913", "PLR0917", "PLR2004", "PLR1702",
-  "PLR0916",
+  "too-many-public-methods", "too-many-return-statements", "too-many-branches",
+  "too-many-arguments", "too-many-positional-arguments",
+  "magic-value-comparison", "too-many-nested-blocks",
   # This seems like a wrong rule
-  "PLW1641",
+  "eq-without-hash",
 ]
 preview = true
 [tool.ruff.lint.per-file-ignores]
 "tests/**" = [
-  "D100", "D101", "D102", "D103", "D104", "S101", "S106", "ANN001", "ANN002",
-  "ANN003", "ANN201", "ANN202", "ANN204", "ANN205", "PLR6301",
+  "undocumented-public-module", "undocumented-public-class",
+  "undocumented-public-method", "undocumented-public-function",
+  "undocumented-public-package", "assert", "hardcoded-password-func-arg",
+  "missing-type-function-argument", "missing-type-args",
+  "missing-type-kwargs", "missing-return-type-undocumented-public-function",
+  "missing-return-type-private-function", "missing-return-type-special-method",
+  "missing-return-type-static-method", "no-self-use",
 ]
-"docs/conf.py" = ["D100", "D103", "A001", "ANN201", "ANN001"]
 [tool.ruff.format]
 docstring-code-format = true
 preview = true
 
 [tool.mypy]
-python_version = "3.11"
+python_version = "3.12"
 ignore_missing_imports = true
 disallow_untyped_defs = true
 warn_redundant_casts = true
 warn_unused_ignores = true
 warn_return_any = true
 warn_unreachable = true
+[[tool.mypy.overrides]]
+module = "tests.*"
+allow_untyped_defs = true

{shvcli-0.8.0 → shvcli-0.9.0}/shvcli/__init__.py

@@ -52,4 +52,4 @@ __all__ = [
     "register_config",
 ]
 
-importlib.import_module(".builtins", package=__package__)
+importlib.import_module(".builtins", package=__package__)  # ruff: ignore[non-empty-init-module]

{shvcli-0.8.0 → shvcli-0.9.0}/shvcli/__setuptools__.py

@@ -8,7 +8,7 @@ from setuptools.command.build_py import build_py as _build_py
 class BuildPy(_build_py):
     """Custom package build step."""
 
-    def run(self) -> None:  # noqa: D102
+    def run(self) -> None:  # ruff: ignore[undocumented-public-method]
         package = pathlib.Path(__file__).parent.name
         buildlib = pathlib.Path(self.build_lib) / package
         buildlib.mkdir(parents=True, exist_ok=True)

{shvcli-0.8.0 → shvcli-0.9.0}/shvcli/__version__.py

@@ -1,10 +1,9 @@
 """The loader of the version for source file only installation.
 
-It looks for pyproject.toml file in upper directory and loads version from
-there.
+It looks for pyproject.toml file in upper directory and loads version from there.
 
-This file is overwritten during distribution build to contain only constant
-VERSION. Please see __setuptools__.py for details.
+This file is overwritten during distribution build to contain only constant VERSION.
+Please see __setuptools__.py for details.
 """
 
 import pathlib
@@ -12,7 +11,7 @@ import tomllib
 
 
 def _get_version() -> str:
-    pyproject = pathlib.Path(__file__).parent.parent / "pyproject.toml"
+    pyproject = pathlib.Path(__file__).parents[1] / "pyproject.toml"
     if pyproject.exists():
         with pyproject.open("rb") as f:
             res = tomllib.load(f)["project"]["version"]

{shvcli-0.8.0 → shvcli-0.9.0}/shvcli/afterconn.py

@@ -2,7 +2,6 @@
 
 import argparse
 import collections.abc
-import typing
 
 from .args import ArgsParseFuncGenT, register_argparser
 from .client import Client, SHVPath
@@ -10,7 +9,7 @@ from .cliitems import CliItems
 from .scan import scan_nodes
 from .state import StateVar
 
-AfterConnT: typing.TypeAlias = collections.abc.Callable[
+type AfterConnT = collections.abc.Callable[
     [Client], collections.abc.Coroutine[None, None, None]
 ]