beltway2 0.1.0__tar.gz

beltway2-0.1.0/.github/workflows/publish_package.yml

@@ -0,0 +1,36 @@
+name: Publish Python Package
+
+on:
+  push:
+    tags:
+      - '*'
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # required for setuptools-scm to determine version from tags
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: python -m twine upload --verbose dist/*

beltway2-0.1.0/.github/workflows/unit_tests.yml

@@ -0,0 +1,41 @@
+name: Unit-tests
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v3
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install system dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y --no-install-recommends portaudio19-dev
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install .[test]
+    - name: Run tests
+      run: |
+        pytest -vv --log-level DEBUG \
+        --cov src \
+        --cov-branch \
+        --cov-report html:reports/pytest_coverage \
+        --cov-fail-under 0 \
+        --junitxml=reports/junit/test-results-${{ matrix.python-version }}.xml
+    - name: Upload pytest test results
+      uses: actions/upload-artifact@v4
+      with:
+        name: reports-${{ matrix.python-version }}
+        path: |
+          reports
+      if: ${{ always() }}

beltway2-0.1.0/.gitignore

@@ -0,0 +1,187 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Python template
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# IPython Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# dotenv
+.env
+
+# virtualenv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+
+# Rope project settings
+.ropeproject
+### VirtualEnv template
+# Virtualenv
+# http://iamzed.com/2009/05/07/a-primer-on-virtualenv/
+#[Bb]in
+[Ii]nclude
+[Ll]ib64
+[Ll]ocal
+pyvenv.cfg
+.venv
+pip-selfcheck.json
+
+### JetBrains template
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+**/.idea/*
+.idea/*
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# AWS User-specific
+.idea/**/aws.xml
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# SonarLint plugin
+.idea/sonarlint/
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+#vscode
+.vscode/
+
+**/test_reports
+*~

beltway2-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2017 matthewh
+Copyright (c) 2026 int2code
+
+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.

beltway2-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+recursive-include src/beltway2 *.py

beltway2-0.1.0/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.4
+Name: beltway2
+Version: 0.1.0
+Summary: Beltway2 is a threaded WAMP client (a loose port of Autobahn) and fork of original beltway.
+Maintainer-email: Marcin Tomiczek <marcin.tomiczek@int2code.com>
+License: MIT License
+        
+        Copyright (c) 2017 matthewh
+        Copyright (c) 2026 int2code
+        
+        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.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: six
+Requires-Dist: structlog
+Requires-Dist: txaio
+Requires-Dist: ws4py
+Provides-Extra: test
+Requires-Dist: coverage; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: pytest-html; extra == "test"
+Provides-Extra: dev
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-html; extra == "dev"
+Dynamic: license-file
+
+This is a lightly modified fork of beltway, updated to drop Python 2 support and maintain
+compatibility with modern Python and SSL defaults.
+The original project remains credited and unmodified; this fork focuses on bug fixes and modern Python support.

beltway2-0.1.0/README.md

@@ -0,0 +1,3 @@
+This is a lightly modified fork of beltway, updated to drop Python 2 support and maintain
+compatibility with modern Python and SSL defaults.
+The original project remains credited and unmodified; this fork focuses on bug fixes and modern Python support.

beltway2-0.1.0/_ci/is_dev_version.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+version=$(python -c "from setuptools_scm import get_version; print(get_version())" 2>/dev/null || cat version.txt 2>/dev/null || echo "")
+
+if [[ $version =~ ^[0-9]+\.[0-9]+\.[0-9]+\.dev[0-9]+$ ]]; then
+  echo "Valid dev version."
+  exit 0
+else
+  echo "Invalid dev version! Version must have .dev[xx] suffix."
+  exit 1
+fi

beltway2-0.1.0/examples/client_test.py

@@ -0,0 +1,32 @@
+import logging
+
+from beltway2.client import WampWebSocketClient
+from beltway2.autolog import log
+from beltway2.wamp.exception import ApplicationError
+
+class MyException(Exception):
+    pass
+
+
+if __name__ == '__main__':
+    logging.basicConfig(level=logging.DEBUG, format='%(asctime)s,%(msecs)03d %(levelname)-8s [%(name)s] %(threadName)s %(message)s')
+
+    client = WampWebSocketClient('ws://127.0.0.1:8080/ws', timeout=5)
+    client.connect()
+    try:
+        client.joined_event.wait()
+
+        client.subscribe(lambda event: print("EVENT: {}".format(event)), 'hello')
+        client.define(MyException, 'myexc')
+
+        print(client.call('service.helloWorld'))
+        print()
+        print(client.call('service.sleepy', 2))
+        print()
+        print(client.call('service.twisty'))
+    except MyException as x:
+        print("THANK YOU, YES, I GOT IT.")
+    except Exception as x:
+        log.exception("You suck: {}".format(x.__class__))
+    finally:
+        client.close()

beltway2-0.1.0/examples/server_test.py

@@ -0,0 +1,54 @@
+import logging
+import time
+
+from beltway2.client import WampWebSocketClient
+from beltway2.autolog import log
+from beltway2.wamp.exception import ApplicationError
+
+
+class MyException(Exception):
+    pass
+
+if __name__ == '__main__':
+    logging.basicConfig(level=logging.DEBUG, format='%(asctime)s,%(msecs)03d %(levelname)-8s [%(name)s] %(threadName)s %(message)s')
+
+    client = WampWebSocketClient('ws://127.0.0.1:8080/ws', timeout=5)
+    client.connect()
+
+    def hello_world():
+        log.info("In hello_worlld()")
+        client.publish('hello', "You called?")
+        return "Hello World"
+
+    def sleepy(seconds):
+        log.info("In sleepy()")
+        time.sleep(seconds)
+        raise MyException("Blah")
+        return "Slept for {} seconds".format(seconds)
+
+    def twisty():
+        log.info("In twisty()")
+        return client.call('service.twisty2')
+
+    def twisty2():
+        log.info("In twisty2()")
+        return "Woah. Twisted."
+
+    client.joined_event.wait(timeout=3.0)
+
+    client.define(MyException, 'myexc')
+
+    client.register(hello_world, 'service.helloWorld')
+    client.register(sleepy, 'service.sleepy')
+    client.register(twisty, 'service.twisty')
+    client.register(twisty2, 'service.twisty2')
+
+    try:
+        log.debug("Running forever")
+        client.run_forever()
+    except KeyboardInterrupt:
+        log.debug("CTRL-C")
+        client.close()
+    except:
+        log.exception("Unhandled error.")
+        client.close()

beltway2-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "beltway2"
+description = "Beltway2 is a threaded WAMP client (a loose port of Autobahn) and fork of original beltway."
+readme = "README.md"
+requires-python = ">=3.12"
+license = {file = "LICENSE"}
+maintainers = [
+  {name = "Marcin Tomiczek", email = "marcin.tomiczek@int2code.com"},
+]
+dynamic = ["dependencies", "version", "optional-dependencies"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+dependencies = {file = ["requirements.txt"]}
+
+[tool.setuptools_scm]
+write_to = "src/beltway2/_version.py"
+
+[tool.setuptools.dynamic.optional-dependencies]
+test = {file = ["requirements-test.txt"]}
+dev = {file = ["requirements-test.txt", "requirements-dev.txt"]}
+
+[build-system]
+requires = ["setuptools>=64", "setuptools-scm>=8"]
+build-backend = "setuptools.build_meta"

beltway2-0.1.0/requirements-dev.txt.py

@@ -0,0 +1 @@
+tox

beltway2-0.1.0/requirements-test.txt

@@ -0,0 +1,4 @@
+coverage
+pytest
+pytest-cov
+pytest-html

beltway2-0.1.0/requirements.txt

@@ -0,0 +1,4 @@
+six
+structlog
+txaio
+ws4py

beltway2-0.1.0/setup.cfg

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

beltway2-0.1.0/src/beltway2/__init__.py

@@ -0,0 +1,4 @@
+try:
+    from ._version import version as __version__
+except ImportError:
+    __version__ = "unknown"

beltway2-0.1.0/src/beltway2/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)
+
+__commit_id__ = commit_id = 'g5ae20c00a'

beltway2-0.1.0/src/beltway2/autolog.py

@@ -0,0 +1,76 @@
+import inspect
+
+import structlog
+
+
+class AutoLogger:
+    """
+    A logger proxy object, with all of the methods and attributes of C{Logger}.
+
+    When an attribute (e.g., "debug") is requested, inspects the stack for the
+    calling module's name, and passes that name to C{logging.getLogger}.
+
+    What this means is that you can instantiate an C{AutoLogger} anywhere, and
+    when you call it, the log entry shows the module where you called it, not
+    where it was created.
+
+    C{AutoLogger} also inspects the local variables where it is called, looking
+    for C{self}. If C{self} exists, its classname is added to the module name.
+    """
+
+    def __init__(self):
+        pass
+
+    def __getattr__(self, name):
+
+        stack = inspect.stack()
+        frame = stack[1][0] if len(stack) > 1 else stack[0][0]
+
+        try:
+            # print("-" * 80)
+            # print(inspect.stack()[1])
+            # print("-" * 80)
+
+            if 'self' in frame.f_locals:
+                other = frame.f_locals['self']
+                caller_name = '%s.%s' % (other.__class__.__module__, other.__class__.__name__)
+            else:
+                caller_name = frame.f_globals['__name__']
+
+            logger = structlog.get_logger(caller_name)
+
+            return getattr(logger, name)
+        finally:
+            # See https://docs.python.org/3/library/inspect.html#the-interpreter-stack
+            del frame
+
+
+log = AutoLogger()
+
+
+def log_exceptions(fn):
+    """ A decorator designed to wrap a function and log any exception that method produces.
+
+    The exception will still be raised after being logged.
+
+    Also logs (at the trace level) the arguments to every call.
+
+    Currently this is only designed for module-level functions.  Not sure what happens if a method is decorated
+    with this (since logger is resolved from module name).
+    """
+
+    def wrapper(*args, **kwargs):
+        try:
+            a = args or []
+            a = [str(x)[:255] for x in a]
+            kw = kwargs or {}
+            kw = dict([(str(k)[:255], str(v)[:255]) for k, v in kw.items()])
+            log.debug('Calling %s.%s %r %r' % (fn.__module__, fn.__name__, a, kw))
+            return fn(*args, **kwargs)
+        except Exception as e:
+            log.error("Error calling function %s: %s" % (fn.__name__, e))
+            log.exception(e)
+            raise
+
+    wrapper.__name__ = fn.__name__
+    return wrapper