meshtrade 0.0.1__tar.gz

meshtrade-0.0.1/LICENSE

@@ -0,0 +1,10 @@
+PROPRIETARY LICENSE
+
+Copyright (c) [2021] [Mesh B.V.]
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any authorized client of Mesh B.V. ("the Client") to use this software ("the Software") solely for the purpose of integrating with and accessing Mesh B.V.'s private application programming interfaces ("the APIs").
+
+The Software may not be used for any other purpose. The Client is not permitted to sublicense, modify, merge, publish, distribute, or sell copies of the Software, and 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.

meshtrade-0.0.1/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: meshtrade
+Version: 0.0.1
+Summary: Integration SDK for Mesh API Services
+Author-email: Bernard Bussy <bernard@meshtrade.co>
+License-Expression: LicenseRef-My-Custom-License
+Project-URL: Repository, https://github.com/meshtrade/api
+Keywords: meshtrade,mesh,mesh-sdk,grpc,betterproto,grpclib
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: grpcio<2.0,>=1.73.0
+Requires-Dist: protobuf<7.0,>=6.31.1
+Provides-Extra: dev
+Requires-Dist: ruff~=0.11.13; extra == "dev"
+Requires-Dist: pytest~=8.4.0; extra == "dev"
+Requires-Dist: build~=1.2.2; extra == "dev"
+Requires-Dist: twine~=6.1.0; extra == "dev"
+Requires-Dist: tox~=4.26.0; extra == "dev"
+Requires-Dist: types-protobuf~=6.30.2.20250516; extra == "dev"
+Dynamic: license-file
+
+# Python SDKs for Mesh APIs
+
+[![CI Status](https://img.shields.io/badge/ci-passing-brightgreen.svg)](https://github.com/meshtrade/api)
+
+This directory is the Python Monorepo for all official Mesh API client SDKs.
+
+## Quick Start for API Consumers
+
+This guide is for developers who want to **use** these SDKs in their own applications.
+
+### 1. Installation
+
+Install the desired SDK integration library from PyPI using pip:
+
+```bash
+pip install meshtrade
+```
+
+### 2. Example Usage
+Here is a basic example of how to use SDK clients:
+```python
+import asyncio
+from meshtrade.account.v1 import AccountService
+from meshtrade.iam.v1 import as IAMService
+
+# NOTE: ensure that MESH_API_KEY="your-secret-api-key" is set
+
+async def main():
+    # Instantiate the client for the Account v1 service
+    account_client = AccountService()
+
+    # Call an RPC method
+    try:
+        response = await account_client.get(number="1000111")
+        print("Successfully retrieved account:", response.account)
+    except Exception as e:
+        print(f"An error occurred: {e}")
+    
+    # You can similarly use other clients
+    iam_client = IAMService()
+    # ... use iam_client ...
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+For more detailed information on each SDK, please see their individual READMEs:
+* **[Account v1](python/mesh/account/v1/README.md)**
+* **[IAM v1](python/mesh/iam/v1/README.md)**
+
+## Repository Structure
+This directory is a workspace within a larger polyglot monorepo. It manages versioned Python packages for each integration SDK.
+
+```
+└── python
+    ├── README.md               <-- You are HERE
+    ├── pyproject.toml          <-- SDK workspace configuration
+    ├── requirements-dev.txt    <-- SDK Workspace development requirements
+    ├── tox.ini                 <-- Task automation configuration
+    ├── src
+    │   └── meshtrade
+    │       ├── __init__.py
+    │       └── account         <-- Defines the mesh account api service
+    │           └── vX          <-- Defines the mesh account vX api SDK
+    │               ├── __init__.py
+    │               ├── account_pb2.py
+    │               └── README.md
+    └── tests
+        ├── integration
+        └── unit
+```
+
+## Developer Guide
+This guide is for developers contributing to these SDKs. It explains how to set up the local development environment for this Python monorepo.
+
+### 1. Prerequisites:
+- Python 3.8+
+- The `venv` module (usually included with Python)
+
+### 2. Environment Setup
+All commands should be run from within this `python/` directory.
+
+Create and activate a single shared virtual environment for the workspace:
+```
+python3 -m venv .venv
+source .venv/bin/activate
+```
+Your terminal prompt should now be prefixed with (.venv), indicating the environment is active.
+
+<b>Tip:</b> If you are in an IDE that supports python you can point your IDE to the interpreter in this environment relative to the source of the repository: `./python/.venv/bin/python`. e.g. with VS code:
+
+'cmd + shift + p' > 'Python: Select Interpreter' > 'Enter interpreter path...'  > './python/.venv/bin/python'
+
+
+
+### 3. Install Dependencies
+
+This project uses `pip-tools` to manage dependencies for a reproducible development environment.
+The top-level `pyproject.toml` is the source of truth for our direct dependencies, and `requirements-dev.txt` is the "lock file" that guarantees identical setups for everyone.
+
+**A) For a new setup (e.g. after a `git pull`):**
+
+Install the locked dependencies from `requirements-dev.txt`:
+```bash
+pip install -r requirements-dev.txt
+```
+This synchronises the local virtual environment to match the exact versions in the lock file.
+
+Once this is complete you are set up to begin programming in the sdk source code in: `./python/src/mesh`.
+
+Next to make the SDK discoverable locally for tests do:
+```
+pip install -e .
+```
+
+**B) After a manual change to `pyproject.toml` (e.g. to install a new workspace level dependency or bump its version):**
+
+If changes are made in the pyproject.toml then the lockfile must be regenerated:
+```
+# Step 1: Re-compile the dependencies to update the lock file
+pip-compile --extra=dev --output-file=requirements-dev.txt pyproject.toml
+
+# Step 2: Synchronise the local virtual environment again with the newly updated lock file
+pip install -r requirements-dev.txt
+```
+
+### 4. Run Common Development Tasks
+Tox is used as the as the main command runner for all common tasks like linting, testing, and building.
+
+Tasks can be run from the command line (within the active virtual environment) as follows:
+
+
+- The linter:
+```
+tox -e lint
+```
+- The unit tests:
+```
+tox -e unit-tests
+```
+- The integration tests:
+```
+MESH_API_KEY="your-secret-api-key" tox -e integration-tests
+```
+- All checks (linting and unit tests):
+```
+tox
+```
+
+### 5. Building and Publishing Packages
+- *Build all packages:* The build task in tox will create the distributable wheel (.whl) and sdist (.tar.gz) files for all packages and place them in their respective dist/ folders.
+```
+tox -e build
+```
+
+- *Publish to PyPi:* The `twine` tool is used to securely upload the built packages to PyPI. This is done as part of the official release process.
+```
+twine upload lib/*/v*/dist/*
+```

meshtrade-0.0.1/README.md

@@ -0,0 +1,159 @@
+# Python SDKs for Mesh APIs
+
+[![CI Status](https://img.shields.io/badge/ci-passing-brightgreen.svg)](https://github.com/meshtrade/api)
+
+This directory is the Python Monorepo for all official Mesh API client SDKs.
+
+## Quick Start for API Consumers
+
+This guide is for developers who want to **use** these SDKs in their own applications.
+
+### 1. Installation
+
+Install the desired SDK integration library from PyPI using pip:
+
+```bash
+pip install meshtrade
+```
+
+### 2. Example Usage
+Here is a basic example of how to use SDK clients:
+```python
+import asyncio
+from meshtrade.account.v1 import AccountService
+from meshtrade.iam.v1 import as IAMService
+
+# NOTE: ensure that MESH_API_KEY="your-secret-api-key" is set
+
+async def main():
+    # Instantiate the client for the Account v1 service
+    account_client = AccountService()
+
+    # Call an RPC method
+    try:
+        response = await account_client.get(number="1000111")
+        print("Successfully retrieved account:", response.account)
+    except Exception as e:
+        print(f"An error occurred: {e}")
+    
+    # You can similarly use other clients
+    iam_client = IAMService()
+    # ... use iam_client ...
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+For more detailed information on each SDK, please see their individual READMEs:
+* **[Account v1](python/mesh/account/v1/README.md)**
+* **[IAM v1](python/mesh/iam/v1/README.md)**
+
+## Repository Structure
+This directory is a workspace within a larger polyglot monorepo. It manages versioned Python packages for each integration SDK.
+
+```
+└── python
+    ├── README.md               <-- You are HERE
+    ├── pyproject.toml          <-- SDK workspace configuration
+    ├── requirements-dev.txt    <-- SDK Workspace development requirements
+    ├── tox.ini                 <-- Task automation configuration
+    ├── src
+    │   └── meshtrade
+    │       ├── __init__.py
+    │       └── account         <-- Defines the mesh account api service
+    │           └── vX          <-- Defines the mesh account vX api SDK
+    │               ├── __init__.py
+    │               ├── account_pb2.py
+    │               └── README.md
+    └── tests
+        ├── integration
+        └── unit
+```
+
+## Developer Guide
+This guide is for developers contributing to these SDKs. It explains how to set up the local development environment for this Python monorepo.
+
+### 1. Prerequisites:
+- Python 3.8+
+- The `venv` module (usually included with Python)
+
+### 2. Environment Setup
+All commands should be run from within this `python/` directory.
+
+Create and activate a single shared virtual environment for the workspace:
+```
+python3 -m venv .venv
+source .venv/bin/activate
+```
+Your terminal prompt should now be prefixed with (.venv), indicating the environment is active.
+
+<b>Tip:</b> If you are in an IDE that supports python you can point your IDE to the interpreter in this environment relative to the source of the repository: `./python/.venv/bin/python`. e.g. with VS code:
+
+'cmd + shift + p' > 'Python: Select Interpreter' > 'Enter interpreter path...'  > './python/.venv/bin/python'
+
+
+
+### 3. Install Dependencies
+
+This project uses `pip-tools` to manage dependencies for a reproducible development environment.
+The top-level `pyproject.toml` is the source of truth for our direct dependencies, and `requirements-dev.txt` is the "lock file" that guarantees identical setups for everyone.
+
+**A) For a new setup (e.g. after a `git pull`):**
+
+Install the locked dependencies from `requirements-dev.txt`:
+```bash
+pip install -r requirements-dev.txt
+```
+This synchronises the local virtual environment to match the exact versions in the lock file.
+
+Once this is complete you are set up to begin programming in the sdk source code in: `./python/src/mesh`.
+
+Next to make the SDK discoverable locally for tests do:
+```
+pip install -e .
+```
+
+**B) After a manual change to `pyproject.toml` (e.g. to install a new workspace level dependency or bump its version):**
+
+If changes are made in the pyproject.toml then the lockfile must be regenerated:
+```
+# Step 1: Re-compile the dependencies to update the lock file
+pip-compile --extra=dev --output-file=requirements-dev.txt pyproject.toml
+
+# Step 2: Synchronise the local virtual environment again with the newly updated lock file
+pip install -r requirements-dev.txt
+```
+
+### 4. Run Common Development Tasks
+Tox is used as the as the main command runner for all common tasks like linting, testing, and building.
+
+Tasks can be run from the command line (within the active virtual environment) as follows:
+
+
+- The linter:
+```
+tox -e lint
+```
+- The unit tests:
+```
+tox -e unit-tests
+```
+- The integration tests:
+```
+MESH_API_KEY="your-secret-api-key" tox -e integration-tests
+```
+- All checks (linting and unit tests):
+```
+tox
+```
+
+### 5. Building and Publishing Packages
+- *Build all packages:* The build task in tox will create the distributable wheel (.whl) and sdist (.tar.gz) files for all packages and place them in their respective dist/ folders.
+```
+tox -e build
+```
+
+- *Publish to PyPi:* The `twine` tool is used to securely upload the built packages to PyPI. This is done as part of the official release process.
+```
+twine upload lib/*/v*/dist/*
+```

meshtrade-0.0.1/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "meshtrade"
+version = "v0.0.1"
+authors = [
+    { name = "Bernard Bussy", email = "bernard@meshtrade.co" },
+]
+description = "Integration SDK for Mesh API Services"
+requires-python = ">=3.8"
+keywords = ["meshtrade", "mesh", "mesh-sdk", "grpc", "betterproto", "grpclib"]
+license = "LicenseRef-My-Custom-License"
+license-files = ["LICENSE"]
+readme = "README.md"
+dependencies = [
+    "grpcio >= 1.73.0, < 2.0",
+    "protobuf >= 6.31.1, < 7.0",
+]
+classifiers = [
+    # --- Development Status ---
+    "Development Status :: 1 - Planning",
+
+    # --- Audience & Topic ---
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+
+    # --- Python Versions Supported ---
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+urls = {"Repository"= "https://github.com/meshtrade/api"}
+
+[project.optional-dependencies]
+dev = [
+    "ruff ~= 0.11.13",
+    "pytest ~= 8.4.0",
+    "build ~= 1.2.2",
+    "twine ~= 6.1.0",
+    "tox ~= 4.26.0",
+    "types-protobuf ~= 6.30.2.20250516",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+# --- Ruff Configuration (Linter and Formatter) ---
+[tool.ruff]
+target-version = "py38"
+line-length = 88
+exclude = ["*_pb2.py", "*_pb2.pyi"]
+
+[tool.ruff.lint]
+# E/W: flake8 errors/warnings | F: Pyflakes
+# I: isort | B: flake8-bugbear | C4: flake8-comprehensions
+# SIM: flake8-simplify | UP: pyupgrade | TID: flake8-tidy-imports
+select = ["E", "W", "F", "I", "B", "C4", "SIM", "UP", "TID"]

meshtrade-0.0.1/setup.cfg

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

meshtrade-0.0.1/src/meshtrade/account/v1/__init__.py

@@ -0,0 +1,7 @@
+from .account_pb2 import (
+    Account,
+)
+
+__all__ = [
+    "Account",
+]

meshtrade-0.0.1/src/meshtrade/account/v1/account_pb2.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/account/v1/account.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/account/v1/account.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\"meshtrade/account/v1/account.proto\x12\x14meshtrade.account.v1\"\x1d\n\x07\x41\x63\x63ount\x12\x12\n\x04name\x18\x01 \x01(\tR\x04nameB(Z&github.com/meshtrade/api/go/account/v1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.account.v1.account_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z&github.com/meshtrade/api/go/account/v1'
+  _globals['_ACCOUNT']._serialized_start=60
+  _globals['_ACCOUNT']._serialized_end=89
+# @@protoc_insertion_point(module_scope)

meshtrade-0.0.1/src/meshtrade/account/v1/account_pb2.pyi

@@ -0,0 +1,11 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Account(_message.Message):
+    __slots__ = ("name",)
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    name: str
+    def __init__(self, name: _Optional[str] = ...) -> None: ...

meshtrade-0.0.1/src/meshtrade/account/v1/service_pb2.py

@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/account/v1/service.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/account/v1/service.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from meshtrade.account.v1 import account_pb2 as meshtrade_dot_account_dot_v1_dot_account__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\"meshtrade/account/v1/service.proto\x12\x14meshtrade.account.v1\x1a\"meshtrade/account/v1/account.proto\"$\n\nGetRequest\x12\x16\n\x06number\x18\x01 \x01(\tR\x06number\"F\n\x0bGetResponse\x12\x37\n\x07\x61\x63\x63ount\x18\x01 \x01(\x0b\x32\x1d.meshtrade.account.v1.AccountR\x07\x61\x63\x63ount2U\n\x07Service\x12J\n\x03Get\x12 .meshtrade.account.v1.GetRequest\x1a!.meshtrade.account.v1.GetResponseB(Z&github.com/meshtrade/api/go/account/v1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.account.v1.service_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z&github.com/meshtrade/api/go/account/v1'
+  _globals['_GETREQUEST']._serialized_start=96
+  _globals['_GETREQUEST']._serialized_end=132
+  _globals['_GETRESPONSE']._serialized_start=134
+  _globals['_GETRESPONSE']._serialized_end=204
+  _globals['_SERVICE']._serialized_start=206
+  _globals['_SERVICE']._serialized_end=291
+# @@protoc_insertion_point(module_scope)

meshtrade-0.0.1/src/meshtrade/account/v1/service_pb2.pyi

@@ -0,0 +1,19 @@
+from meshtrade.account.v1 import account_pb2 as _account_pb2
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class GetRequest(_message.Message):
+    __slots__ = ("number",)
+    NUMBER_FIELD_NUMBER: _ClassVar[int]
+    number: str
+    def __init__(self, number: _Optional[str] = ...) -> None: ...
+
+class GetResponse(_message.Message):
+    __slots__ = ("account",)
+    ACCOUNT_FIELD_NUMBER: _ClassVar[int]
+    account: _account_pb2.Account
+    def __init__(self, account: _Optional[_Union[_account_pb2.Account, _Mapping]] = ...) -> None: ...

meshtrade-0.0.1/src/meshtrade/iam/v1/__init__.py

@@ -0,0 +1,11 @@
+from .permission_pb2 import (
+    Permission,
+)
+from .role_pb2 import (
+    Role,
+)
+
+__all__ = [
+    "Permission",
+    "Role",
+]

meshtrade-0.0.1/src/meshtrade/iam/v1/permission_pb2.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/iam/v1/permission.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/iam/v1/permission.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!meshtrade/iam/v1/permission.proto\x12\x10meshtrade.iam.v1\"s\n\nPermission\x12)\n\x10service_provider\x18\x01 \x01(\tR\x0fserviceProvider\x12\x18\n\x07service\x18\x02 \x01(\tR\x07service\x12 \n\x0b\x64\x65scription\x18\x03 \x01(\tR\x0b\x64\x65scriptionB$Z\"github.com/meshtrade/api/go/iam/v1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.iam.v1.permission_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z\"github.com/meshtrade/api/go/iam/v1'
+  _globals['_PERMISSION']._serialized_start=55
+  _globals['_PERMISSION']._serialized_end=170
+# @@protoc_insertion_point(module_scope)

meshtrade-0.0.1/src/meshtrade/iam/v1/permission_pb2.pyi

@@ -0,0 +1,15 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Permission(_message.Message):
+    __slots__ = ("service_provider", "service", "description")
+    SERVICE_PROVIDER_FIELD_NUMBER: _ClassVar[int]
+    SERVICE_FIELD_NUMBER: _ClassVar[int]
+    DESCRIPTION_FIELD_NUMBER: _ClassVar[int]
+    service_provider: str
+    service: str
+    description: str
+    def __init__(self, service_provider: _Optional[str] = ..., service: _Optional[str] = ..., description: _Optional[str] = ...) -> None: ...

meshtrade-0.0.1/src/meshtrade/iam/v1/role_pb2.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/iam/v1/role.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/iam/v1/role.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from meshtrade.iam.v1 import permission_pb2 as meshtrade_dot_iam_dot_v1_dot_permission__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1bmeshtrade/iam/v1/role.proto\x12\x10meshtrade.iam.v1\x1a!meshtrade/iam/v1/permission.proto\"Z\n\x04Role\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12>\n\x0bpermissions\x18\x02 \x03(\x0b\x32\x1c.meshtrade.iam.v1.PermissionR\x0bpermissionsB$Z\"github.com/meshtrade/api/go/iam/v1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.iam.v1.role_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z\"github.com/meshtrade/api/go/iam/v1'
+  _globals['_ROLE']._serialized_start=84
+  _globals['_ROLE']._serialized_end=174
+# @@protoc_insertion_point(module_scope)

meshtrade-0.0.1/src/meshtrade/iam/v1/role_pb2.pyi

@@ -0,0 +1,16 @@
+from meshtrade.iam.v1 import permission_pb2 as _permission_pb2
+from google.protobuf.internal import containers as _containers
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Iterable as _Iterable, Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Role(_message.Message):
+    __slots__ = ("name", "permissions")
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    PERMISSIONS_FIELD_NUMBER: _ClassVar[int]
+    name: str
+    permissions: _containers.RepeatedCompositeFieldContainer[_permission_pb2.Permission]
+    def __init__(self, name: _Optional[str] = ..., permissions: _Optional[_Iterable[_Union[_permission_pb2.Permission, _Mapping]]] = ...) -> None: ...

meshtrade-0.0.1/src/meshtrade.egg-info/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: meshtrade
+Version: 0.0.1
+Summary: Integration SDK for Mesh API Services
+Author-email: Bernard Bussy <bernard@meshtrade.co>
+License-Expression: LicenseRef-My-Custom-License
+Project-URL: Repository, https://github.com/meshtrade/api
+Keywords: meshtrade,mesh,mesh-sdk,grpc,betterproto,grpclib
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: grpcio<2.0,>=1.73.0
+Requires-Dist: protobuf<7.0,>=6.31.1
+Provides-Extra: dev
+Requires-Dist: ruff~=0.11.13; extra == "dev"
+Requires-Dist: pytest~=8.4.0; extra == "dev"
+Requires-Dist: build~=1.2.2; extra == "dev"
+Requires-Dist: twine~=6.1.0; extra == "dev"
+Requires-Dist: tox~=4.26.0; extra == "dev"
+Requires-Dist: types-protobuf~=6.30.2.20250516; extra == "dev"
+Dynamic: license-file
+
+# Python SDKs for Mesh APIs
+
+[![CI Status](https://img.shields.io/badge/ci-passing-brightgreen.svg)](https://github.com/meshtrade/api)
+
+This directory is the Python Monorepo for all official Mesh API client SDKs.
+
+## Quick Start for API Consumers
+
+This guide is for developers who want to **use** these SDKs in their own applications.
+
+### 1. Installation
+
+Install the desired SDK integration library from PyPI using pip:
+
+```bash
+pip install meshtrade
+```
+
+### 2. Example Usage
+Here is a basic example of how to use SDK clients:
+```python
+import asyncio
+from meshtrade.account.v1 import AccountService
+from meshtrade.iam.v1 import as IAMService
+
+# NOTE: ensure that MESH_API_KEY="your-secret-api-key" is set
+
+async def main():
+    # Instantiate the client for the Account v1 service
+    account_client = AccountService()
+
+    # Call an RPC method
+    try:
+        response = await account_client.get(number="1000111")
+        print("Successfully retrieved account:", response.account)
+    except Exception as e:
+        print(f"An error occurred: {e}")
+    
+    # You can similarly use other clients
+    iam_client = IAMService()
+    # ... use iam_client ...
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+For more detailed information on each SDK, please see their individual READMEs:
+* **[Account v1](python/mesh/account/v1/README.md)**
+* **[IAM v1](python/mesh/iam/v1/README.md)**
+
+## Repository Structure
+This directory is a workspace within a larger polyglot monorepo. It manages versioned Python packages for each integration SDK.
+
+```
+└── python
+    ├── README.md               <-- You are HERE
+    ├── pyproject.toml          <-- SDK workspace configuration
+    ├── requirements-dev.txt    <-- SDK Workspace development requirements
+    ├── tox.ini                 <-- Task automation configuration
+    ├── src
+    │   └── meshtrade
+    │       ├── __init__.py
+    │       └── account         <-- Defines the mesh account api service
+    │           └── vX          <-- Defines the mesh account vX api SDK
+    │               ├── __init__.py
+    │               ├── account_pb2.py
+    │               └── README.md
+    └── tests
+        ├── integration
+        └── unit
+```
+
+## Developer Guide
+This guide is for developers contributing to these SDKs. It explains how to set up the local development environment for this Python monorepo.
+
+### 1. Prerequisites:
+- Python 3.8+
+- The `venv` module (usually included with Python)
+
+### 2. Environment Setup
+All commands should be run from within this `python/` directory.
+
+Create and activate a single shared virtual environment for the workspace:
+```
+python3 -m venv .venv
+source .venv/bin/activate
+```
+Your terminal prompt should now be prefixed with (.venv), indicating the environment is active.
+
+<b>Tip:</b> If you are in an IDE that supports python you can point your IDE to the interpreter in this environment relative to the source of the repository: `./python/.venv/bin/python`. e.g. with VS code:
+
+'cmd + shift + p' > 'Python: Select Interpreter' > 'Enter interpreter path...'  > './python/.venv/bin/python'
+
+
+
+### 3. Install Dependencies
+
+This project uses `pip-tools` to manage dependencies for a reproducible development environment.
+The top-level `pyproject.toml` is the source of truth for our direct dependencies, and `requirements-dev.txt` is the "lock file" that guarantees identical setups for everyone.
+
+**A) For a new setup (e.g. after a `git pull`):**
+
+Install the locked dependencies from `requirements-dev.txt`:
+```bash
+pip install -r requirements-dev.txt
+```
+This synchronises the local virtual environment to match the exact versions in the lock file.
+
+Once this is complete you are set up to begin programming in the sdk source code in: `./python/src/mesh`.
+
+Next to make the SDK discoverable locally for tests do:
+```
+pip install -e .
+```
+
+**B) After a manual change to `pyproject.toml` (e.g. to install a new workspace level dependency or bump its version):**
+
+If changes are made in the pyproject.toml then the lockfile must be regenerated:
+```
+# Step 1: Re-compile the dependencies to update the lock file
+pip-compile --extra=dev --output-file=requirements-dev.txt pyproject.toml
+
+# Step 2: Synchronise the local virtual environment again with the newly updated lock file
+pip install -r requirements-dev.txt
+```
+
+### 4. Run Common Development Tasks
+Tox is used as the as the main command runner for all common tasks like linting, testing, and building.
+
+Tasks can be run from the command line (within the active virtual environment) as follows:
+
+
+- The linter:
+```
+tox -e lint
+```
+- The unit tests:
+```
+tox -e unit-tests
+```
+- The integration tests:
+```
+MESH_API_KEY="your-secret-api-key" tox -e integration-tests
+```
+- All checks (linting and unit tests):
+```
+tox
+```
+
+### 5. Building and Publishing Packages
+- *Build all packages:* The build task in tox will create the distributable wheel (.whl) and sdist (.tar.gz) files for all packages and place them in their respective dist/ folders.
+```
+tox -e build
+```
+
+- *Publish to PyPi:* The `twine` tool is used to securely upload the built packages to PyPI. This is done as part of the official release process.
+```
+twine upload lib/*/v*/dist/*
+```

meshtrade-0.0.1/src/meshtrade.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+LICENSE
+README.md
+pyproject.toml
+src/meshtrade/__init__.py
+src/meshtrade.egg-info/PKG-INFO
+src/meshtrade.egg-info/SOURCES.txt
+src/meshtrade.egg-info/dependency_links.txt
+src/meshtrade.egg-info/requires.txt
+src/meshtrade.egg-info/top_level.txt
+src/meshtrade/account/v1/__init__.py
+src/meshtrade/account/v1/account_pb2.py
+src/meshtrade/account/v1/account_pb2.pyi
+src/meshtrade/account/v1/service_pb2.py
+src/meshtrade/account/v1/service_pb2.pyi
+src/meshtrade/iam/v1/__init__.py
+src/meshtrade/iam/v1/permission_pb2.py
+src/meshtrade/iam/v1/permission_pb2.pyi
+src/meshtrade/iam/v1/role_pb2.py
+src/meshtrade/iam/v1/role_pb2.pyi

meshtrade-0.0.1/src/meshtrade.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

meshtrade-0.0.1/src/meshtrade.egg-info/requires.txt

@@ -0,0 +1,10 @@
+grpcio<2.0,>=1.73.0
+protobuf<7.0,>=6.31.1
+
+[dev]
+ruff~=0.11.13
+pytest~=8.4.0
+build~=1.2.2
+twine~=6.1.0
+tox~=4.26.0
+types-protobuf~=6.30.2.20250516

meshtrade-0.0.1/src/meshtrade.egg-info/top_level.txt

@@ -0,0 +1 @@
+meshtrade