apitestgenie 1.0.0__tar.gz

apitestgenie-1.0.0/LICENSE

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

apitestgenie-1.0.0/PKG-INFO

@@ -0,0 +1,227 @@
+Metadata-Version: 2.4
+Name: apitestgenie
+Version: 1.0.0
+Summary: A lightweight, developer-friendly Python library for API test automation
+License: MIT License
+        
+        Copyright (c) 2026 Akash Gujarathi
+        
+        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.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0; extra == "dev"
+Dynamic: license-file
+
+# APItestGenie
+
+APItestGenie is a lightweight, developer-friendly Python library designed to simplify API testing for automation engineers.
+Version 1.0 focuses on clarity, correctness, and essential functionality without unnecessary complexity.
+
+---
+
+## Overview
+
+APItestGenie provides:
+
+- Two ways to perform API requests: Client mode and Simple mode
+- Built-in JSON assertions
+- JSON path assertions for nested responses
+- Basic retry logic with retries, retry delay, and retry_on_status
+- A ResponseWrapper abstraction for consistent behavior across requests
+- GET, POST, PUT, PATCH, DELETE support
+- Timeout and headers support
+- A complete pytest suite
+- A modern Python packaging layout using the src structure
+
+Version 1.0 intentionally avoids heavy features like logging frameworks, async support, or automation framework integrations.
+
+---
+
+## Installation
+
+Clone the repository:
+
+```
+git clone https://github.com/Akash402/apitestgenie.git
+cd apitestgenie
+```
+
+Create and activate a virtual environment:
+
+```
+python3 -m venv venv
+source venv/bin/activate
+```
+
+Install dependencies:
+
+```
+pip install httpx pytest
+```
+
+(Optional) Install the library locally in editable mode:
+
+```
+pip install -e .
+```
+
+---
+
+## Usage Examples
+
+### Client Mode
+
+```python
+from apitestgenie.client import ApiClient
+
+api = ApiClient("https://jsonplaceholder.typicode.com", timeout=10)
+
+response = api.get("/posts/1", retries=2)
+response.assert_status(200)
+response.assert_json_value("id", 1)
+```
+
+POST example:
+
+```python
+resp = api.post("/posts", json={"title": "foo"})
+resp.assert_status(201)
+```
+
+PUT example:
+
+```python
+resp = api.put("/posts/1", json={"id": 1, "title": "updated"})
+resp.assert_status(200)
+```
+
+DELETE example:
+
+```python
+resp = api.delete("/posts/1")
+resp.assert_status(200)
+```
+
+---
+
+### Simple Mode
+
+```python
+from apitestgenie.simple import get
+
+response = get("https://jsonplaceholder.typicode.com/posts/1")
+response.assert_status(200)
+print(response.json())
+```
+
+POST example:
+
+```python
+from apitestgenie.simple import post
+
+resp = post("https://jsonplaceholder.typicode.com/posts", json={"hello": "world"})
+resp.assert_status(201)
+```
+
+Retry and timeout example:
+
+```python
+resp = get(
+    "https://jsonplaceholder.typicode.com/posts/1",
+    retries=3,
+    retry_delay=1,
+    retry_on_status=[500],
+    timeout=5
+)
+```
+
+---
+
+## JSON Assertions
+
+```python
+resp.assert_status(200)
+resp.assert_json_key("id")
+resp.assert_json_value("id", 1)
+resp.assert_json_path_exists("title")
+resp.assert_json_path_value("id", 1)
+```
+
+---
+
+## Running Tests
+
+```
+pytest
+```
+
+---
+
+## Project Structure
+
+```
+apitestgenie/
+│
+├── src/
+│   └── apitestgenie/
+│       ├── client.py
+│       ├── simple.py
+│       ├── response_wrapper.py
+│       └── __init__.py
+│
+├── tests/
+├── playground.py
+├── pytest.ini
+├── README.md
+└── SCOPE.md
+```
+
+---
+
+## Version 1.0 Scope Summary
+
+Included:
+
+- CRUD operations
+- Basic retry logic
+- JSON and JSON path assertions
+- ResponseWrapper abstraction
+- Simple and client modes
+- Header and timeout support
+- Test suite
+- Clean structure
+
+Excluded:
+
+- Advanced retry logic
+- Logging framework
+- Robot/Behave integrations
+- Async support
+- Schema validation
+- Plugin system
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

apitestgenie-1.0.0/README.md

@@ -0,0 +1,193 @@
+# APItestGenie
+
+APItestGenie is a lightweight, developer-friendly Python library designed to simplify API testing for automation engineers.
+Version 1.0 focuses on clarity, correctness, and essential functionality without unnecessary complexity.
+
+---
+
+## Overview
+
+APItestGenie provides:
+
+- Two ways to perform API requests: Client mode and Simple mode
+- Built-in JSON assertions
+- JSON path assertions for nested responses
+- Basic retry logic with retries, retry delay, and retry_on_status
+- A ResponseWrapper abstraction for consistent behavior across requests
+- GET, POST, PUT, PATCH, DELETE support
+- Timeout and headers support
+- A complete pytest suite
+- A modern Python packaging layout using the src structure
+
+Version 1.0 intentionally avoids heavy features like logging frameworks, async support, or automation framework integrations.
+
+---
+
+## Installation
+
+Clone the repository:
+
+```
+git clone https://github.com/Akash402/apitestgenie.git
+cd apitestgenie
+```
+
+Create and activate a virtual environment:
+
+```
+python3 -m venv venv
+source venv/bin/activate
+```
+
+Install dependencies:
+
+```
+pip install httpx pytest
+```
+
+(Optional) Install the library locally in editable mode:
+
+```
+pip install -e .
+```
+
+---
+
+## Usage Examples
+
+### Client Mode
+
+```python
+from apitestgenie.client import ApiClient
+
+api = ApiClient("https://jsonplaceholder.typicode.com", timeout=10)
+
+response = api.get("/posts/1", retries=2)
+response.assert_status(200)
+response.assert_json_value("id", 1)
+```
+
+POST example:
+
+```python
+resp = api.post("/posts", json={"title": "foo"})
+resp.assert_status(201)
+```
+
+PUT example:
+
+```python
+resp = api.put("/posts/1", json={"id": 1, "title": "updated"})
+resp.assert_status(200)
+```
+
+DELETE example:
+
+```python
+resp = api.delete("/posts/1")
+resp.assert_status(200)
+```
+
+---
+
+### Simple Mode
+
+```python
+from apitestgenie.simple import get
+
+response = get("https://jsonplaceholder.typicode.com/posts/1")
+response.assert_status(200)
+print(response.json())
+```
+
+POST example:
+
+```python
+from apitestgenie.simple import post
+
+resp = post("https://jsonplaceholder.typicode.com/posts", json={"hello": "world"})
+resp.assert_status(201)
+```
+
+Retry and timeout example:
+
+```python
+resp = get(
+    "https://jsonplaceholder.typicode.com/posts/1",
+    retries=3,
+    retry_delay=1,
+    retry_on_status=[500],
+    timeout=5
+)
+```
+
+---
+
+## JSON Assertions
+
+```python
+resp.assert_status(200)
+resp.assert_json_key("id")
+resp.assert_json_value("id", 1)
+resp.assert_json_path_exists("title")
+resp.assert_json_path_value("id", 1)
+```
+
+---
+
+## Running Tests
+
+```
+pytest
+```
+
+---
+
+## Project Structure
+
+```
+apitestgenie/
+│
+├── src/
+│   └── apitestgenie/
+│       ├── client.py
+│       ├── simple.py
+│       ├── response_wrapper.py
+│       └── __init__.py
+│
+├── tests/
+├── playground.py
+├── pytest.ini
+├── README.md
+└── SCOPE.md
+```
+
+---
+
+## Version 1.0 Scope Summary
+
+Included:
+
+- CRUD operations
+- Basic retry logic
+- JSON and JSON path assertions
+- ResponseWrapper abstraction
+- Simple and client modes
+- Header and timeout support
+- Test suite
+- Clean structure
+
+Excluded:
+
+- Advanced retry logic
+- Logging framework
+- Robot/Behave integrations
+- Async support
+- Schema validation
+- Plugin system
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

apitestgenie-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "apitestgenie"
+version = "1.0.0"
+description = "A lightweight, developer-friendly Python library for API test automation"
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.11"
+dependencies = [
+    "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=9.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]

apitestgenie-1.0.0/setup.cfg

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

apitestgenie-1.0.0/src/apitestgenie/__init__.py

@@ -0,0 +1,4 @@
+from .client import ApiClient
+from .simple import get, post, put, patch, delete
+
+__all__ = ["ApiClient", "get", "post", "put", "patch", "delete"]

apitestgenie-1.0.0/src/apitestgenie/client.py

@@ -0,0 +1,73 @@
+import time
+import httpx
+from .response_wrapper import ResponseWrapper
+
+
+class ApiClient:
+    def __init__(self, base_url, headers=None, timeout=30):
+        self.base_url = base_url.rstrip("/")
+        self.session = httpx.Client(headers=headers, timeout=timeout)
+
+    def _build_url(self, path):
+        return f"{self.base_url}/{path.lstrip('/')}"
+
+    def _request_with_retry(self, method, url, retries, retry_delay, retry_on_status, **kwargs):
+        attempt = 0
+
+        while True:
+            try:
+                response = self.session.request(method, url, **kwargs)
+
+                # If no retry rules → return immediately
+                if not retry_on_status:
+                    return ResponseWrapper(response)
+
+                # If status code NOT in retry list → return
+                if response.status_code not in retry_on_status:
+                    return ResponseWrapper(response)
+
+                # If retry limit exceeded → return last response
+                attempt += 1
+                if attempt > retries:
+                    return ResponseWrapper(response)
+
+                time.sleep(retry_delay)
+
+            except httpx.RequestError:
+                attempt += 1
+                if attempt > retries:
+                    raise
+                time.sleep(retry_delay)
+
+    # ------------------------
+    # HTTP METHODS
+    # ------------------------
+
+    def get(self, path, retries=0, retry_delay=0, retry_on_status=None, **kwargs):
+        url = self._build_url(path)
+        return self._request_with_retry("GET", url, retries, retry_delay, retry_on_status, **kwargs)
+
+    def post(self, path, json=None, retries=0, retry_delay=0, retry_on_status=None, **kwargs):
+        url = self._build_url(path)
+        return self._request_with_retry("POST", url, retries, retry_delay, retry_on_status, json=json, **kwargs)
+
+    def put(self, path, json=None, retries=0, retry_delay=0, retry_on_status=None, **kwargs):
+        url = self._build_url(path)
+        return self._request_with_retry("PUT", url, retries, retry_delay, retry_on_status, json=json, **kwargs)
+
+    def patch(self, path, json=None, retries=0, retry_delay=0, retry_on_status=None, **kwargs):
+        url = self._build_url(path)
+        return self._request_with_retry("PATCH", url, retries, retry_delay, retry_on_status, json=json, **kwargs)
+
+    def delete(self, path, retries=0, retry_delay=0, retry_on_status=None, **kwargs):
+        url = self._build_url(path)
+        return self._request_with_retry("DELETE", url, retries, retry_delay, retry_on_status, **kwargs)
+
+    def close(self):
+        self.session.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()

apitestgenie-1.0.0/src/apitestgenie/response_wrapper.py

@@ -0,0 +1,68 @@
+class ResponseWrapper:
+    def __init__(self, response):
+        self.response = response
+
+    @property
+    def status_code(self):
+        return self.response.status_code
+
+    def json(self):
+        return self.response.json()
+
+    def assert_status(self, expected):
+        actual = self.status_code
+        if actual != expected:
+            raise AssertionError(f"Expected {expected}, got {actual}")
+        return self
+
+    def assert_json_key(self, key: str):
+        data = self.json()
+        if not isinstance(data, dict):
+            raise AssertionError(
+                f"Expected a JSON object to check key '{key}', but got {type(data).__name__}"
+            )
+        if key not in data:
+            raise AssertionError(f"Expected key '{key}' not found in JSON response")
+        return self
+
+    def assert_json_value(self, key: str, expected_value):
+        data = self.json()
+        if not isinstance(data, dict):
+            raise AssertionError(
+                f"Expected a JSON object to check key '{key}', but got {type(data).__name__}"
+            )
+        if key not in data:
+            raise AssertionError(f"Key '{key}' not found in JSON response")
+
+        actual_value = data[key]
+        if actual_value != expected_value:
+            raise AssertionError(
+                f"Expected '{key}' to be '{expected_value}', got '{actual_value}'"
+            )
+        return self
+
+    def _resolve_json_path(self, path):
+        """Resolve a dotted path like 'user.address.city'."""
+        parts = path.split(".")
+        current = self.json()
+
+        try:
+            for p in parts:
+                if isinstance(current, list):
+                    p = int(p)  # list index
+                current = current[p]
+            return current
+        except Exception as e:
+            raise AssertionError(f"JSON path '{path}' not found: {e}")
+
+    def assert_json_path_exists(self, path):
+        _ = self._resolve_json_path(path)
+        return self
+
+    def assert_json_path_value(self, path, expected):
+        actual = self._resolve_json_path(path)
+        if actual != expected:
+            raise AssertionError(
+                f"JSON path '{path}' expected '{expected}', got '{actual}'"
+            )
+        return self

apitestgenie-1.0.0/src/apitestgenie/simple.py

@@ -0,0 +1,145 @@
+import time
+import httpx
+from .response_wrapper import ResponseWrapper
+
+def _request_with_retry(
+    method,
+    url,
+    retries=0,
+    retry_delay=0,
+    retry_on_status=None,
+    timeout=None,
+    **kwargs
+):
+    attempt = 0
+
+    while True:
+        try:
+            response = httpx.request(
+                method,
+                url,
+                timeout=timeout,
+                **kwargs
+            )
+
+            # If no retry rules → return immediately
+            if not retry_on_status:
+                return ResponseWrapper(response)
+
+            # If status code NOT in retry list → return
+            if response.status_code not in retry_on_status:
+                return ResponseWrapper(response)
+
+            # If retry limit exceeded → return last response
+            attempt += 1
+            if attempt > retries:
+                return ResponseWrapper(response)
+
+            # Otherwise retry
+            time.sleep(retry_delay)
+
+        except httpx.RequestError:
+            attempt += 1
+            if attempt > retries:
+                raise
+            time.sleep(retry_delay)
+
+
+# --------------------------------------------------------
+# SIMPLE MODE HTTP METHODS
+# --------------------------------------------------------
+
+def get(
+    url,
+    retries=0,
+    retry_delay=0,
+    retry_on_status=None,
+    timeout=None,
+    **kwargs
+):
+    return _request_with_retry(
+        "GET", url,
+        retries=retries,
+        retry_delay=retry_delay,
+        retry_on_status=retry_on_status,
+        timeout=timeout,
+        **kwargs
+    )
+
+
+def post(
+    url,
+    json=None,
+    retries=0,
+    retry_delay=0,
+    retry_on_status=None,
+    timeout=None,
+    **kwargs
+):
+    return _request_with_retry(
+        "POST", url,
+        retries=retries,
+        retry_delay=retry_delay,
+        retry_on_status=retry_on_status,
+        timeout=timeout,
+        json=json,
+        **kwargs
+    )
+
+
+def put(
+    url,
+    json=None,
+    retries=0,
+    retry_delay=0,
+    retry_on_status=None,
+    timeout=None,
+    **kwargs
+):
+    return _request_with_retry(
+        "PUT", url,
+        retries=retries,
+        retry_delay=retry_delay,
+        retry_on_status=retry_on_status,
+        timeout=timeout,
+        json=json,
+        **kwargs
+    )
+
+
+def patch(
+    url,
+    json=None,
+    retries=0,
+    retry_delay=0,
+    retry_on_status=None,
+    timeout=None,
+    **kwargs
+):
+    return _request_with_retry(
+        "PATCH", url,
+        retries=retries,
+        retry_delay=retry_delay,
+        retry_on_status=retry_on_status,
+        timeout=timeout,
+        json=json,
+        **kwargs
+    )
+
+
+def delete(
+    url,
+    retries=0,
+    retry_delay=0,
+    retry_on_status=None,
+    timeout=None,
+    **kwargs
+):
+    return _request_with_retry(
+        "DELETE", url,
+        retries=retries,
+        retry_delay=retry_delay,
+        retry_on_status=retry_on_status,
+        timeout=timeout,
+        **kwargs
+    )

apitestgenie-1.0.0/src/apitestgenie.egg-info/PKG-INFO

@@ -0,0 +1,227 @@
+Metadata-Version: 2.4
+Name: apitestgenie
+Version: 1.0.0
+Summary: A lightweight, developer-friendly Python library for API test automation
+License: MIT License
+        
+        Copyright (c) 2026 Akash Gujarathi
+        
+        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.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0; extra == "dev"
+Dynamic: license-file
+
+# APItestGenie
+
+APItestGenie is a lightweight, developer-friendly Python library designed to simplify API testing for automation engineers.
+Version 1.0 focuses on clarity, correctness, and essential functionality without unnecessary complexity.
+
+---
+
+## Overview
+
+APItestGenie provides:
+
+- Two ways to perform API requests: Client mode and Simple mode
+- Built-in JSON assertions
+- JSON path assertions for nested responses
+- Basic retry logic with retries, retry delay, and retry_on_status
+- A ResponseWrapper abstraction for consistent behavior across requests
+- GET, POST, PUT, PATCH, DELETE support
+- Timeout and headers support
+- A complete pytest suite
+- A modern Python packaging layout using the src structure
+
+Version 1.0 intentionally avoids heavy features like logging frameworks, async support, or automation framework integrations.
+
+---
+
+## Installation
+
+Clone the repository:
+
+```
+git clone https://github.com/Akash402/apitestgenie.git
+cd apitestgenie
+```
+
+Create and activate a virtual environment:
+
+```
+python3 -m venv venv
+source venv/bin/activate
+```
+
+Install dependencies:
+
+```
+pip install httpx pytest
+```
+
+(Optional) Install the library locally in editable mode:
+
+```
+pip install -e .
+```
+
+---
+
+## Usage Examples
+
+### Client Mode
+
+```python
+from apitestgenie.client import ApiClient
+
+api = ApiClient("https://jsonplaceholder.typicode.com", timeout=10)
+
+response = api.get("/posts/1", retries=2)
+response.assert_status(200)
+response.assert_json_value("id", 1)
+```
+
+POST example:
+
+```python
+resp = api.post("/posts", json={"title": "foo"})
+resp.assert_status(201)
+```
+
+PUT example:
+
+```python
+resp = api.put("/posts/1", json={"id": 1, "title": "updated"})
+resp.assert_status(200)
+```
+
+DELETE example:
+
+```python
+resp = api.delete("/posts/1")
+resp.assert_status(200)
+```
+
+---
+
+### Simple Mode
+
+```python
+from apitestgenie.simple import get
+
+response = get("https://jsonplaceholder.typicode.com/posts/1")
+response.assert_status(200)
+print(response.json())
+```
+
+POST example:
+
+```python
+from apitestgenie.simple import post
+
+resp = post("https://jsonplaceholder.typicode.com/posts", json={"hello": "world"})
+resp.assert_status(201)
+```
+
+Retry and timeout example:
+
+```python
+resp = get(
+    "https://jsonplaceholder.typicode.com/posts/1",
+    retries=3,
+    retry_delay=1,
+    retry_on_status=[500],
+    timeout=5
+)
+```
+
+---
+
+## JSON Assertions
+
+```python
+resp.assert_status(200)
+resp.assert_json_key("id")
+resp.assert_json_value("id", 1)
+resp.assert_json_path_exists("title")
+resp.assert_json_path_value("id", 1)
+```
+
+---
+
+## Running Tests
+
+```
+pytest
+```
+
+---
+
+## Project Structure
+
+```
+apitestgenie/
+│
+├── src/
+│   └── apitestgenie/
+│       ├── client.py
+│       ├── simple.py
+│       ├── response_wrapper.py
+│       └── __init__.py
+│
+├── tests/
+├── playground.py
+├── pytest.ini
+├── README.md
+└── SCOPE.md
+```
+
+---
+
+## Version 1.0 Scope Summary
+
+Included:
+
+- CRUD operations
+- Basic retry logic
+- JSON and JSON path assertions
+- ResponseWrapper abstraction
+- Simple and client modes
+- Header and timeout support
+- Test suite
+- Clean structure
+
+Excluded:
+
+- Advanced retry logic
+- Logging framework
+- Robot/Behave integrations
+- Async support
+- Schema validation
+- Plugin system
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

apitestgenie-1.0.0/src/apitestgenie.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/apitestgenie/__init__.py
+src/apitestgenie/client.py
+src/apitestgenie/response_wrapper.py
+src/apitestgenie/simple.py
+src/apitestgenie.egg-info/PKG-INFO
+src/apitestgenie.egg-info/SOURCES.txt
+src/apitestgenie.egg-info/dependency_links.txt
+src/apitestgenie.egg-info/requires.txt
+src/apitestgenie.egg-info/top_level.txt
+tests/test_client.py

apitestgenie-1.0.0/src/apitestgenie.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

apitestgenie-1.0.0/src/apitestgenie.egg-info/requires.txt

@@ -0,0 +1,4 @@
+httpx>=0.27
+
+[dev]
+pytest>=9.0

apitestgenie-1.0.0/src/apitestgenie.egg-info/top_level.txt

@@ -0,0 +1 @@
+apitestgenie

apitestgenie-1.0.0/tests/test_client.py

@@ -0,0 +1,183 @@
+import httpx
+import pytest
+from src.apitestgenie.client import ApiClient
+from src.apitestgenie.simple import get, post, put, patch, delete
+from src.apitestgenie.response_wrapper import ResponseWrapper
+
+BASE_URL = "https://jsonplaceholder.typicode.com"
+
+# ---------------------------------------------------------
+# GET TESTS
+# ---------------------------------------------------------
+
+def test_client_get():
+    api = ApiClient(BASE_URL)
+    resp = api.get("/posts/1")
+    resp.assert_status(200)
+    resp.assert_json_key("id")
+    resp.assert_json_value("id", 1)
+
+def test_simple_get():
+    resp = get(f"{BASE_URL}/posts/1")
+    resp.assert_status(200)
+    resp.assert_json_key("id")
+    resp.assert_json_value("id", 1)
+
+# ---------------------------------------------------------
+# POST TESTS
+# ---------------------------------------------------------
+
+def test_client_post():
+    api = ApiClient(BASE_URL)
+    resp = api.post("/posts", json={"title": "foo", "body": "bar", "userId": 1})
+    resp.assert_status(201)
+    resp.assert_json_key("id")
+
+def test_simple_post():
+    resp = post(f"{BASE_URL}/posts", json={"title": "foo"})
+    resp.assert_status(201)
+    resp.assert_json_key("id")
+
+
+# ---------------------------------------------------------
+# PUT TESTS
+# ---------------------------------------------------------
+
+def test_client_put():
+    api = ApiClient(BASE_URL)
+    resp = api.put("/posts/1", json={"id": 1, "title": "updated"})
+    resp.assert_status(200)
+    resp.assert_json_key("id")
+    resp.assert_json_value("id", 1)
+
+def test_simple_put():
+    resp = put(f"{BASE_URL}/posts/1", json={"id": 1, "title": "updated"})
+    resp.assert_status(200)
+    resp.assert_json_key("id")
+    resp.assert_json_value("id", 1)
+
+# ---------------------------------------------------------
+# PATCH TESTS
+# ---------------------------------------------------------
+
+def test_client_patch():
+    api = ApiClient(BASE_URL)
+    resp = api.patch("/posts/1", json={"title": "patched"})
+    resp.assert_status(200)
+    resp.assert_json_key("id")
+    resp.assert_json_value("id", 1)
+
+def test_simple_patch():
+    resp = patch(f"{BASE_URL}/posts/1", json={"title": "patched"})
+    resp.assert_status(200)
+    resp.assert_json_key("id")
+    resp.assert_json_value("id", 1)
+
+# ---------------------------------------------------------
+# DELETE TESTS
+# ---------------------------------------------------------
+
+def test_client_delete():
+    api = ApiClient(BASE_URL)
+    resp = api.delete("/posts/1")
+    resp.assert_status(200)
+
+def test_simple_delete():
+    resp = delete(f"{BASE_URL}/posts/1")
+    resp.assert_status(200)
+
+# ---------------------------------------------------------
+# SIMPLE MODE TIMEOUT TESTS
+# ---------------------------------------------------------
+
+def test_simple_mode_timeout():
+    resp = get(f"{BASE_URL}/posts/1", timeout=5)
+    resp.assert_status(200)
+
+
+# ---------------------------------------------------------
+# OFFLINE UNIT TESTS (no network required)
+# ---------------------------------------------------------
+
+def _make_mock_response(status_code, json_body):
+    """Build a ResponseWrapper from a mock httpx response."""
+    import json as _json
+    body = _json.dumps(json_body).encode()
+    mock = httpx.Response(status_code, content=body, headers={"content-type": "application/json"})
+    return ResponseWrapper(mock)
+
+
+def test_assert_status_passes():
+    resp = _make_mock_response(200, {"id": 1})
+    resp.assert_status(200)
+
+
+def test_assert_status_fails():
+    resp = _make_mock_response(404, {"error": "not found"})
+    with pytest.raises(AssertionError, match="Expected 200, got 404"):
+        resp.assert_status(200)
+
+
+def test_assert_json_key_passes():
+    resp = _make_mock_response(200, {"id": 1, "title": "foo"})
+    resp.assert_json_key("id")
+    resp.assert_json_key("title")
+
+
+def test_assert_json_key_missing():
+    resp = _make_mock_response(200, {"id": 1})
+    with pytest.raises(AssertionError, match="not found"):
+        resp.assert_json_key("missing")
+
+
+def test_assert_json_key_on_list_response():
+    resp = _make_mock_response(200, [{"id": 1}, {"id": 2}])
+    with pytest.raises(AssertionError, match="Expected a JSON object"):
+        resp.assert_json_key("id")
+
+
+def test_assert_json_value_passes():
+    resp = _make_mock_response(200, {"id": 42})
+    resp.assert_json_value("id", 42)
+
+
+def test_assert_json_value_fails():
+    resp = _make_mock_response(200, {"id": 42})
+    with pytest.raises(AssertionError, match="Expected 'id' to be '1', got '42'"):
+        resp.assert_json_value("id", 1)
+
+
+def test_assert_json_path_exists():
+    resp = _make_mock_response(200, {"user": {"address": {"city": "London"}}})
+    resp.assert_json_path_exists("user.address.city")
+
+
+def test_assert_json_path_value():
+    resp = _make_mock_response(200, {"user": {"address": {"city": "London"}}})
+    resp.assert_json_path_value("user.address.city", "London")
+
+
+def test_assert_json_path_missing():
+    resp = _make_mock_response(200, {"user": {}})
+    with pytest.raises(AssertionError, match="not found"):
+        resp.assert_json_path_exists("user.address.city")
+
+
+def test_chained_assertions():
+    resp = _make_mock_response(200, {"id": 1, "title": "foo"})
+    resp.assert_status(200).assert_json_key("id").assert_json_value("id", 1)
+
+
+def test_api_client_context_manager():
+    with ApiClient("https://example.com") as api:
+        assert api is not None
+
+
+def test_response_wrapper_status_code():
+    resp = _make_mock_response(201, {})
+    assert resp.status_code == 201
+
+
+def test_response_wrapper_json():
+    resp = _make_mock_response(200, {"key": "value"})
+    assert resp.json() == {"key": "value"}