mockarty 0.1.0__tar.gz

mockarty-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

mockarty-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Mockarty
+
+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.

mockarty-0.1.0/PKG-INFO

@@ -0,0 +1,232 @@
+Metadata-Version: 2.4
+Name: mockarty
+Version: 0.1.0
+Summary: Official Python SDK for Mockarty — multi-protocol mock server for HTTP, gRPC, MCP, GraphQL, SOAP, SSE, Kafka, RabbitMQ, SMTP
+Project-URL: Homepage, https://mockarty.ru
+Project-URL: Documentation, https://mockarty.ru/docs
+Project-URL: Repository, https://github.com/mockarty/py-sdk
+Project-URL: Issues, https://github.com/mockarty/py-sdk/issues
+Project-URL: Changelog, https://github.com/mockarty/py-sdk/releases
+Author-email: Mockarty <info@mockarty.ru>
+License: MIT
+License-File: LICENSE
+Keywords: api,api-testing,contract-testing,fuzzing,graphql,grpc,kafka,mcp,mock,mock-server,performance-testing,rabbitmq,smtp,soap,sse,test-automation,testing,websocket
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Testing :: Mocking
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24
+Requires-Dist: pydantic>=2.0
+Provides-Extra: async
+Requires-Dist: httpx[http2]; extra == 'async'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.21; extra == 'test'
+Requires-Dist: pytest>=7.0; extra == 'test'
+Requires-Dist: respx>=0.21; extra == 'test'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="logo.svg" alt="Mockarty" width="400">
+</p>
+
+<h1 align="center">Python SDK</h1>
+
+<p align="center">
+  Official Python client library for <a href="https://mockarty.ru">Mockarty</a> — a multi-protocol mock server for HTTP, gRPC, MCP, GraphQL, SOAP, SSE, WebSocket, Kafka, RabbitMQ, and SMTP.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/mockarty/"><img src="https://img.shields.io/pypi/v/mockarty" alt="PyPI"></a>
+  <a href="https://pypi.org/project/mockarty/"><img src="https://img.shields.io/pypi/pyversions/mockarty" alt="Python"></a>
+  <a href="https://github.com/mockarty/py-sdk/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mockarty/py-sdk" alt="License"></a>
+</p>
+
+## Installation
+
+```bash
+pip install mockarty
+```
+
+For async HTTP/2 support:
+
+```bash
+pip install mockarty[async]
+```
+
+## Quick Start
+
+### Synchronous Client
+
+```python
+from mockarty import MockartyClient, MockBuilder, AssertAction
+
+# Create a client
+client = MockartyClient(
+    base_url="http://localhost:5770",
+    api_key="your-api-key",
+    namespace="sandbox",
+)
+
+# Create a mock using the builder
+mock = (
+    MockBuilder.http("/api/users/:id", "GET")
+    .id("user-get")
+    .respond(200, body={"id": "$.pathParam.id", "name": "$.fake.FirstName"})
+    .ttl(3600)
+    .build()
+)
+
+result = client.mocks.create(mock)
+print(f"Created mock: {result.mock.id}")
+
+# List mocks
+page = client.mocks.list(namespace="sandbox", limit=10)
+for m in page.items:
+    print(f"  {m.id}")
+
+# Health check
+health = client.health.check()
+print(f"Status: {health.status}")
+
+client.close()
+```
+
+### Async Client
+
+```python
+import asyncio
+from mockarty import AsyncMockartyClient, MockBuilder
+
+async def main():
+    async with AsyncMockartyClient(base_url="http://localhost:5770") as client:
+        mock = MockBuilder.http("/api/hello", "GET").respond(200, body={"msg": "hello"}).build()
+        result = await client.mocks.create(mock)
+        print(f"Created: {result.mock.id}")
+
+asyncio.run(main())
+```
+
+### Context Manager
+
+```python
+with MockartyClient() as client:
+    client.mocks.create(mock)
+    # client.close() is called automatically
+```
+
+### Mock Builder
+
+```python
+from mockarty import MockBuilder, AssertAction
+
+# HTTP mock with conditions
+mock = (
+    MockBuilder.http("/api/orders", "POST")
+    .id("create-order")
+    .namespace("production")
+    .tags("orders", "v2")
+    .priority(10)
+    .condition("$.body.amount", AssertAction.NOT_EMPTY)
+    .header_condition("Authorization", AssertAction.NOT_EMPTY)
+    .respond(201, body={
+        "orderId": "$.fake.UUID",
+        "amount": "$.req.amount",
+        "status": "created",
+    })
+    .callback("https://webhook.site/test", method="POST", body={"event": "order.created"})
+    .ttl(7200)
+    .build()
+)
+
+# gRPC mock
+grpc_mock = (
+    MockBuilder.grpc("user.UserService", "GetUser")
+    .id("grpc-get-user")
+    .condition("$.id", AssertAction.NOT_EMPTY)
+    .respond(200, body={"id": "$.req.id", "name": "$.fake.FirstName"})
+    .build()
+)
+
+# MCP mock
+mcp_mock = (
+    MockBuilder.mcp("get_weather")
+    .id("mcp-weather")
+    .respond(200, body={"temperature": 22, "city": "$.req.city"})
+    .build()
+)
+```
+
+### Working with Stores
+
+```python
+with MockartyClient() as client:
+    # Global store
+    client.stores.global_set("counter", 0)
+    data = client.stores.global_get()
+    print(data)  # {"counter": 0}
+
+    # Chain store
+    client.stores.chain_set("order-flow", "orderId", "abc-123")
+    chain_data = client.stores.chain_get("order-flow")
+    print(chain_data)  # {"orderId": "abc-123"}
+```
+
+### Error Handling
+
+```python
+from mockarty import MockartyClient
+from mockarty.errors import MockartyNotFoundError, MockartyAPIError
+
+client = MockartyClient()
+try:
+    mock = client.mocks.get("non-existent")
+except MockartyNotFoundError:
+    print("Mock not found")
+except MockartyAPIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+## Configuration
+
+The client reads these environment variables as defaults:
+
+| Variable | Description | Default |
+|---|---|---|
+| `MOCKARTY_BASE_URL` | Mockarty server URL | `http://localhost:5770` |
+| `MOCKARTY_API_KEY` | API authentication key | `None` |
+
+## pytest Integration
+
+Install the test extras:
+
+```bash
+pip install mockarty[test]
+```
+
+Use the provided fixtures in your tests:
+
+```python
+# conftest.py
+pytest_plugins = ["mockarty.testing.fixtures"]
+
+# test_example.py
+def test_create_mock(mock_cleanup):
+    from mockarty import MockBuilder
+    mock = MockBuilder.http("/test", "GET").respond(200, body="ok").build()
+    created = mock_cleanup(mock)
+    assert created.id is not None
+```
+
+## License
+
+MIT

mockarty-0.1.0/README.md

@@ -0,0 +1,195 @@
+<p align="center">
+  <img src="logo.svg" alt="Mockarty" width="400">
+</p>
+
+<h1 align="center">Python SDK</h1>
+
+<p align="center">
+  Official Python client library for <a href="https://mockarty.ru">Mockarty</a> — a multi-protocol mock server for HTTP, gRPC, MCP, GraphQL, SOAP, SSE, WebSocket, Kafka, RabbitMQ, and SMTP.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/mockarty/"><img src="https://img.shields.io/pypi/v/mockarty" alt="PyPI"></a>
+  <a href="https://pypi.org/project/mockarty/"><img src="https://img.shields.io/pypi/pyversions/mockarty" alt="Python"></a>
+  <a href="https://github.com/mockarty/py-sdk/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mockarty/py-sdk" alt="License"></a>
+</p>
+
+## Installation
+
+```bash
+pip install mockarty
+```
+
+For async HTTP/2 support:
+
+```bash
+pip install mockarty[async]
+```
+
+## Quick Start
+
+### Synchronous Client
+
+```python
+from mockarty import MockartyClient, MockBuilder, AssertAction
+
+# Create a client
+client = MockartyClient(
+    base_url="http://localhost:5770",
+    api_key="your-api-key",
+    namespace="sandbox",
+)
+
+# Create a mock using the builder
+mock = (
+    MockBuilder.http("/api/users/:id", "GET")
+    .id("user-get")
+    .respond(200, body={"id": "$.pathParam.id", "name": "$.fake.FirstName"})
+    .ttl(3600)
+    .build()
+)
+
+result = client.mocks.create(mock)
+print(f"Created mock: {result.mock.id}")
+
+# List mocks
+page = client.mocks.list(namespace="sandbox", limit=10)
+for m in page.items:
+    print(f"  {m.id}")
+
+# Health check
+health = client.health.check()
+print(f"Status: {health.status}")
+
+client.close()
+```
+
+### Async Client
+
+```python
+import asyncio
+from mockarty import AsyncMockartyClient, MockBuilder
+
+async def main():
+    async with AsyncMockartyClient(base_url="http://localhost:5770") as client:
+        mock = MockBuilder.http("/api/hello", "GET").respond(200, body={"msg": "hello"}).build()
+        result = await client.mocks.create(mock)
+        print(f"Created: {result.mock.id}")
+
+asyncio.run(main())
+```
+
+### Context Manager
+
+```python
+with MockartyClient() as client:
+    client.mocks.create(mock)
+    # client.close() is called automatically
+```
+
+### Mock Builder
+
+```python
+from mockarty import MockBuilder, AssertAction
+
+# HTTP mock with conditions
+mock = (
+    MockBuilder.http("/api/orders", "POST")
+    .id("create-order")
+    .namespace("production")
+    .tags("orders", "v2")
+    .priority(10)
+    .condition("$.body.amount", AssertAction.NOT_EMPTY)
+    .header_condition("Authorization", AssertAction.NOT_EMPTY)
+    .respond(201, body={
+        "orderId": "$.fake.UUID",
+        "amount": "$.req.amount",
+        "status": "created",
+    })
+    .callback("https://webhook.site/test", method="POST", body={"event": "order.created"})
+    .ttl(7200)
+    .build()
+)
+
+# gRPC mock
+grpc_mock = (
+    MockBuilder.grpc("user.UserService", "GetUser")
+    .id("grpc-get-user")
+    .condition("$.id", AssertAction.NOT_EMPTY)
+    .respond(200, body={"id": "$.req.id", "name": "$.fake.FirstName"})
+    .build()
+)
+
+# MCP mock
+mcp_mock = (
+    MockBuilder.mcp("get_weather")
+    .id("mcp-weather")
+    .respond(200, body={"temperature": 22, "city": "$.req.city"})
+    .build()
+)
+```
+
+### Working with Stores
+
+```python
+with MockartyClient() as client:
+    # Global store
+    client.stores.global_set("counter", 0)
+    data = client.stores.global_get()
+    print(data)  # {"counter": 0}
+
+    # Chain store
+    client.stores.chain_set("order-flow", "orderId", "abc-123")
+    chain_data = client.stores.chain_get("order-flow")
+    print(chain_data)  # {"orderId": "abc-123"}
+```
+
+### Error Handling
+
+```python
+from mockarty import MockartyClient
+from mockarty.errors import MockartyNotFoundError, MockartyAPIError
+
+client = MockartyClient()
+try:
+    mock = client.mocks.get("non-existent")
+except MockartyNotFoundError:
+    print("Mock not found")
+except MockartyAPIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+## Configuration
+
+The client reads these environment variables as defaults:
+
+| Variable | Description | Default |
+|---|---|---|
+| `MOCKARTY_BASE_URL` | Mockarty server URL | `http://localhost:5770` |
+| `MOCKARTY_API_KEY` | API authentication key | `None` |
+
+## pytest Integration
+
+Install the test extras:
+
+```bash
+pip install mockarty[test]
+```
+
+Use the provided fixtures in your tests:
+
+```python
+# conftest.py
+pytest_plugins = ["mockarty.testing.fixtures"]
+
+# test_example.py
+def test_create_mock(mock_cleanup):
+    from mockarty import MockBuilder
+    mock = MockBuilder.http("/test", "GET").respond(200, body="ok").build()
+    created = mock_cleanup(mock)
+    assert created.id is not None
+```
+
+## License
+
+MIT

mockarty-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mockarty"
+version = "0.1.0"
+description = "Official Python SDK for Mockarty — multi-protocol mock server for HTTP, gRPC, MCP, GraphQL, SOAP, SSE, Kafka, RabbitMQ, SMTP"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [{name = "Mockarty", email = "info@mockarty.ru"}]
+keywords = [
+    "mock", "testing", "api", "grpc", "mcp", "graphql", "soap",
+    "kafka", "rabbitmq", "smtp", "sse", "websocket",
+    "contract-testing", "fuzzing", "performance-testing",
+    "api-testing", "mock-server", "test-automation",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Software Development :: Testing :: Mocking",
+    "Framework :: Pytest",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.24",
+    "pydantic>=2.0",
+]
+
+[project.optional-dependencies]
+async = ["httpx[http2]"]
+test = ["pytest>=7.0", "pytest-asyncio>=0.21", "respx>=0.21"]
+
+[project.urls]
+Homepage = "https://mockarty.ru"
+Documentation = "https://mockarty.ru/docs"
+Repository = "https://github.com/mockarty/py-sdk"
+Issues = "https://github.com/mockarty/py-sdk/issues"
+Changelog = "https://github.com/mockarty/py-sdk/releases"
+
+[project.entry-points.pytest11]
+mockarty = "mockarty.testing.fixtures"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mockarty"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/mockarty", "LICENSE", "README.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"