pytest-api-core 1.0.1__tar.gz

pytest_api_core-1.0.1/LICENSE

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

pytest_api_core-1.0.1/MANIFEST.in

@@ -0,0 +1,4 @@
+include src/pytest_api_core/reporters/templates/*.html
+include README.md
+include LICENSE
+recursive-include src *.py *.html *.yaml *.yml

pytest_api_core-1.0.1/PKG-INFO

@@ -0,0 +1,314 @@
+Metadata-Version: 2.4
+Name: pytest-api-core
+Version: 1.0.1
+Summary: Pytest API automation framework with custom HTML reporting, reusable fixtures, and fluent assertions
+Author: QA Platform Team
+License: MIT License
+        
+        Copyright (c) 2026 Subodh Singh
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Repository, https://github.com/your-org/pytest-api-core-framework
+Project-URL: Documentation, https://your-org.artifactory.com/docs/pytest-api-core
+Keywords: pytest,api,testing,automation,html-report
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+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: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pytest>=7.4
+Requires-Dist: requests>=2.31
+Requires-Dist: Jinja2>=3.1
+Requires-Dist: urllib3>=2.0
+Requires-Dist: jsonschema>=4.20
+Provides-Extra: dotenv
+Requires-Dist: python-dotenv>=1.0; extra == "dotenv"
+Provides-Extra: dev
+Requires-Dist: pytest-mock>=3.12; extra == "dev"
+Requires-Dist: responses>=0.25; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: isort>=5.13; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Dynamic: license-file
+
+# pytest-api-core
+
+> A reusable pytest API automation framework with fluent assertions, built-in auth strategies, environment-aware configuration, and a beautiful custom HTML report — packaged for Artifactory distribution.
+
+## Features
+
+- **`APIClient`** — `requests.Session` wrapper with retry, timeout, and structured logging
+- **Fluent response assertions** — `assert_that(response).status_is(200).json_path("$.id").equals(1)`
+- **Auth strategies** — Bearer token, Basic, API Key (header/query), OAuth2 client credentials
+- **Environment config** — Python `settings.py` classes + `.env` file + `ENV_VAR` overrides via `api_config` fixture
+- **Custom HTML report** — self-contained report with charts, filterable table, captured logs, and request/response details
+- **Auto-registered pytest fixtures** — zero boilerplate in consuming projects
+
+---
+
+## Installation
+
+### From private PyPI
+
+```bash
+pip install pytest-api-core \
+  --index-url https://pypi.example.com/simple/
+```
+
+With `.env` support (optional but recommended):
+
+```bash
+pip install "pytest-api-core[dotenv]"
+```
+
+Or add to `requirements.txt` / `pyproject.toml`:
+
+```
+pytest-api-core==1.0.0
+```
+
+---
+
+## Quick Start
+
+### 1. Create environment settings
+
+```python
+# config/settings.py
+import os
+from pytest_api_core.config.base_settings import BaseSettings
+
+class DevSettings(BaseSettings):
+    base_url = "https://api.dev.example.com"
+    timeout  = 30
+    verify_ssl = True
+    headers  = {"Accept": "application/json", "Content-Type": "application/json"}
+
+class StagingSettings(DevSettings):
+    base_url = os.environ.get("API_BASE_URL", "https://api.staging.example.com")
+    timeout  = 60
+
+ENVIRONMENTS = {
+    "dev":     DevSettings,
+    "staging": StagingSettings,
+}
+```
+
+### 2. Store secrets in `.env` (never commit this file)
+
+```ini
+# .env
+BEARER_TOKEN=eyJhbGciOiJIUzI1NiIs...
+API_KEY=super-secret-key
+```
+
+### 3. Configure pytest.ini
+
+```ini
+[pytest]
+
+# ── Framework ────────────────────────────────────────────────────────────────
+api_env             = dev
+api_settings_module = config.settings
+api_dotenv_file     = .env
+
+# ── Report ───────────────────────────────────────────────────────────────────
+addopts = --api-html-report=reports/{env}/report_{timestamp}.html -v
+api_html_theme      = dark            # or "light"
+api_html_title      = API Test Report # browser tab title
+api_html_header     = API Test Report # page header text
+
+# ── Logging ──────────────────────────────────────────────────────────────────
+api_log_level       = INFO
+log_cli             = true
+log_cli_level       = INFO
+log_cli_format      = %(asctime)s [%(levelname)-8s] %(name)s: %(message)s
+log_cli_date_format = %H:%M:%S
+```
+
+### 4. Write tests
+
+```python
+# tests/test_posts.py
+from pytest_api_core.assertions import assert_that
+
+def test_get_post(api_client):
+    response = api_client.get("/posts/1")
+    assert_that(response).status_is(200).json_path("$.id").equals(1)
+
+def test_create_post(api_client):
+    payload = {"title": "foo", "body": "bar", "userId": 1}
+    response = api_client.post("/posts", json=payload)
+    assert_that(response).status_is(201).has_key("id")
+```
+
+### 5. Run with HTML report
+
+```bash
+pytest tests/ --api-env=staging
+```
+
+The report is written to `reports/staging/report_<timestamp>.html`.
+
+---
+
+## Configuration
+
+### Resolution order (highest → lowest priority)
+
+| Priority | Source |
+|---|---|
+| 1 | Shell / CI environment variables (`API_BASE_URL`, `API_TOKEN`, …) |
+| 2 | `--api-base-url` CLI flag |
+| 3 | `ENVIRONMENTS[env]` class in `settings_module` |
+| 4 | Built-in defaults (`http://localhost`, timeout 30 s, …) |
+
+### pytest.ini options
+
+| Option | Description | Default |
+|---|---|---|
+| `api_env` | Active environment name | `dev` |
+| `api_settings_module` | Dotted path to settings module | — |
+| `api_dotenv_file` | Path to `.env` file | `.env` |
+| `api_log_level` | Log level for framework internals | `WARNING` |
+| `api_html_report` | Output path for HTML report (supports `{env}`, `{timestamp}`) | — |
+| `api_html_theme` | Report theme: `light` or `dark` | `dark` |
+| `api_html_title` | Browser tab title text | `API Test Report` |
+| `api_html_header` | Page header text | `API Test Report` |
+
+### CLI flags
+
+| Flag | Description |
+|---|---|
+| `--api-env` | Override active environment |
+| `--api-base-url` | Override `base_url` |
+| `--api-log-level` | Override framework log level |
+| `--api-html-report` | Override HTML report path |
+
+### Environment variables
+
+| Variable | Purpose |
+|---|---|
+| `API_BASE_URL` | Override `base_url` |
+| `API_TOKEN` | Inject Bearer token (auto-applied by `api_client`) |
+| `API_ENV` | Select environment |
+| `API_TIMEOUT` | Override request timeout |
+| `API_VERIFY_SSL` | Override SSL verification |
+
+---
+
+## Fixtures
+
+| Fixture | Scope | Description |
+|---|---|---|
+| `api_config` | session | Resolved config dict for the active env |
+| `api_client` | session | Configured `APIClient` instance |
+| `api_bearer_auth` | function | `BearerAuth` built from `API_TOKEN` env var |
+| `api_basic_auth` | function | `BasicAuth` built from `API_USERNAME` / `API_PASSWORD` |
+| `api_key_auth` | function | `APIKeyAuth` built from `API_KEY_NAME` / `API_KEY_VALUE` |
+
+### Overriding `api_client` per project
+
+```python
+# tests/conftest.py
+import pytest
+from pytest_api_core.auth.auth_handlers import BearerAuth
+from pytest_api_core.client.api_client import APIClient
+from pytest_api_core.config.env_loader import get_env
+
+@pytest.fixture(scope="session")
+def api_client(api_config):
+    token = get_env("BEARER_TOKEN", required=True)
+    client = APIClient(
+        base_url=api_config["base_url"],
+        auth=BearerAuth(token),
+        timeout=api_config.get("timeout", 30),
+        verify_ssl=api_config.get("verify_ssl", True),
+        default_headers=api_config.get("headers"),
+    )
+    yield client
+    client.close()
+```
+
+---
+
+## Publishing
+
+### Via GitHub Actions (Recommended)
+
+Use the **Publish to Public PyPI** workflow for automated releases:
+
+1. Go to **Actions** → **Publish to Public PyPI**
+2. Click **Run workflow**
+3. Enter version (e.g., `1.0.1`) and enable/disable tests
+4. Workflow will build, test, and publish to PyPI
+
+See [docs/PUBLISHING.md](docs/PUBLISHING.md) for detailed setup instructions.
+
+### Manual Publishing
+
+```bash
+# Build
+python -m build
+
+# Upload to PyPI
+twine upload dist/*
+
+# Or upload to private registry
+twine upload \
+  --repository-url https://pypi.example.com \
+  -u <user> -p <token> \
+  dist/*
+```
+
+---
+
+## Project Layout
+
+```
+src/
+└── pytest_api_core/
+    ├── plugin.py           # pytest entry-point
+    ├── client/             # HTTP client + response wrapper
+    ├── auth/               # Auth strategy classes
+    ├── config/             # Config manager, BaseSettings, env_loader
+    ├── fixtures/           # Auto-registered pytest fixtures
+    ├── assertions/         # Fluent response assertion API
+    └── reporters/          # Custom HTML report plugin
+config/
+└── settings.py             # Project environment settings (not shipped in wheel)
+tests/                      # Package self-tests
+```
+
+---
+
+## License
+
+See [LICENSE](LICENSE).

pytest_api_core-1.0.1/README.md

@@ -0,0 +1,254 @@
+# pytest-api-core
+
+> A reusable pytest API automation framework with fluent assertions, built-in auth strategies, environment-aware configuration, and a beautiful custom HTML report — packaged for Artifactory distribution.
+
+## Features
+
+- **`APIClient`** — `requests.Session` wrapper with retry, timeout, and structured logging
+- **Fluent response assertions** — `assert_that(response).status_is(200).json_path("$.id").equals(1)`
+- **Auth strategies** — Bearer token, Basic, API Key (header/query), OAuth2 client credentials
+- **Environment config** — Python `settings.py` classes + `.env` file + `ENV_VAR` overrides via `api_config` fixture
+- **Custom HTML report** — self-contained report with charts, filterable table, captured logs, and request/response details
+- **Auto-registered pytest fixtures** — zero boilerplate in consuming projects
+
+---
+
+## Installation
+
+### From private PyPI
+
+```bash
+pip install pytest-api-core \
+  --index-url https://pypi.example.com/simple/
+```
+
+With `.env` support (optional but recommended):
+
+```bash
+pip install "pytest-api-core[dotenv]"
+```
+
+Or add to `requirements.txt` / `pyproject.toml`:
+
+```
+pytest-api-core==1.0.0
+```
+
+---
+
+## Quick Start
+
+### 1. Create environment settings
+
+```python
+# config/settings.py
+import os
+from pytest_api_core.config.base_settings import BaseSettings
+
+class DevSettings(BaseSettings):
+    base_url = "https://api.dev.example.com"
+    timeout  = 30
+    verify_ssl = True
+    headers  = {"Accept": "application/json", "Content-Type": "application/json"}
+
+class StagingSettings(DevSettings):
+    base_url = os.environ.get("API_BASE_URL", "https://api.staging.example.com")
+    timeout  = 60
+
+ENVIRONMENTS = {
+    "dev":     DevSettings,
+    "staging": StagingSettings,
+}
+```
+
+### 2. Store secrets in `.env` (never commit this file)
+
+```ini
+# .env
+BEARER_TOKEN=eyJhbGciOiJIUzI1NiIs...
+API_KEY=super-secret-key
+```
+
+### 3. Configure pytest.ini
+
+```ini
+[pytest]
+
+# ── Framework ────────────────────────────────────────────────────────────────
+api_env             = dev
+api_settings_module = config.settings
+api_dotenv_file     = .env
+
+# ── Report ───────────────────────────────────────────────────────────────────
+addopts = --api-html-report=reports/{env}/report_{timestamp}.html -v
+api_html_theme      = dark            # or "light"
+api_html_title      = API Test Report # browser tab title
+api_html_header     = API Test Report # page header text
+
+# ── Logging ──────────────────────────────────────────────────────────────────
+api_log_level       = INFO
+log_cli             = true
+log_cli_level       = INFO
+log_cli_format      = %(asctime)s [%(levelname)-8s] %(name)s: %(message)s
+log_cli_date_format = %H:%M:%S
+```
+
+### 4. Write tests
+
+```python
+# tests/test_posts.py
+from pytest_api_core.assertions import assert_that
+
+def test_get_post(api_client):
+    response = api_client.get("/posts/1")
+    assert_that(response).status_is(200).json_path("$.id").equals(1)
+
+def test_create_post(api_client):
+    payload = {"title": "foo", "body": "bar", "userId": 1}
+    response = api_client.post("/posts", json=payload)
+    assert_that(response).status_is(201).has_key("id")
+```
+
+### 5. Run with HTML report
+
+```bash
+pytest tests/ --api-env=staging
+```
+
+The report is written to `reports/staging/report_<timestamp>.html`.
+
+---
+
+## Configuration
+
+### Resolution order (highest → lowest priority)
+
+| Priority | Source |
+|---|---|
+| 1 | Shell / CI environment variables (`API_BASE_URL`, `API_TOKEN`, …) |
+| 2 | `--api-base-url` CLI flag |
+| 3 | `ENVIRONMENTS[env]` class in `settings_module` |
+| 4 | Built-in defaults (`http://localhost`, timeout 30 s, …) |
+
+### pytest.ini options
+
+| Option | Description | Default |
+|---|---|---|
+| `api_env` | Active environment name | `dev` |
+| `api_settings_module` | Dotted path to settings module | — |
+| `api_dotenv_file` | Path to `.env` file | `.env` |
+| `api_log_level` | Log level for framework internals | `WARNING` |
+| `api_html_report` | Output path for HTML report (supports `{env}`, `{timestamp}`) | — |
+| `api_html_theme` | Report theme: `light` or `dark` | `dark` |
+| `api_html_title` | Browser tab title text | `API Test Report` |
+| `api_html_header` | Page header text | `API Test Report` |
+
+### CLI flags
+
+| Flag | Description |
+|---|---|
+| `--api-env` | Override active environment |
+| `--api-base-url` | Override `base_url` |
+| `--api-log-level` | Override framework log level |
+| `--api-html-report` | Override HTML report path |
+
+### Environment variables
+
+| Variable | Purpose |
+|---|---|
+| `API_BASE_URL` | Override `base_url` |
+| `API_TOKEN` | Inject Bearer token (auto-applied by `api_client`) |
+| `API_ENV` | Select environment |
+| `API_TIMEOUT` | Override request timeout |
+| `API_VERIFY_SSL` | Override SSL verification |
+
+---
+
+## Fixtures
+
+| Fixture | Scope | Description |
+|---|---|---|
+| `api_config` | session | Resolved config dict for the active env |
+| `api_client` | session | Configured `APIClient` instance |
+| `api_bearer_auth` | function | `BearerAuth` built from `API_TOKEN` env var |
+| `api_basic_auth` | function | `BasicAuth` built from `API_USERNAME` / `API_PASSWORD` |
+| `api_key_auth` | function | `APIKeyAuth` built from `API_KEY_NAME` / `API_KEY_VALUE` |
+
+### Overriding `api_client` per project
+
+```python
+# tests/conftest.py
+import pytest
+from pytest_api_core.auth.auth_handlers import BearerAuth
+from pytest_api_core.client.api_client import APIClient
+from pytest_api_core.config.env_loader import get_env
+
+@pytest.fixture(scope="session")
+def api_client(api_config):
+    token = get_env("BEARER_TOKEN", required=True)
+    client = APIClient(
+        base_url=api_config["base_url"],
+        auth=BearerAuth(token),
+        timeout=api_config.get("timeout", 30),
+        verify_ssl=api_config.get("verify_ssl", True),
+        default_headers=api_config.get("headers"),
+    )
+    yield client
+    client.close()
+```
+
+---
+
+## Publishing
+
+### Via GitHub Actions (Recommended)
+
+Use the **Publish to Public PyPI** workflow for automated releases:
+
+1. Go to **Actions** → **Publish to Public PyPI**
+2. Click **Run workflow**
+3. Enter version (e.g., `1.0.1`) and enable/disable tests
+4. Workflow will build, test, and publish to PyPI
+
+See [docs/PUBLISHING.md](docs/PUBLISHING.md) for detailed setup instructions.
+
+### Manual Publishing
+
+```bash
+# Build
+python -m build
+
+# Upload to PyPI
+twine upload dist/*
+
+# Or upload to private registry
+twine upload \
+  --repository-url https://pypi.example.com \
+  -u <user> -p <token> \
+  dist/*
+```
+
+---
+
+## Project Layout
+
+```
+src/
+└── pytest_api_core/
+    ├── plugin.py           # pytest entry-point
+    ├── client/             # HTTP client + response wrapper
+    ├── auth/               # Auth strategy classes
+    ├── config/             # Config manager, BaseSettings, env_loader
+    ├── fixtures/           # Auto-registered pytest fixtures
+    ├── assertions/         # Fluent response assertion API
+    └── reporters/          # Custom HTML report plugin
+config/
+└── settings.py             # Project environment settings (not shipped in wheel)
+tests/                      # Package self-tests
+```
+
+---
+
+## License
+
+See [LICENSE](LICENSE).

pytest_api_core-1.0.1/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pytest-api-core"
+version = "1.0.1"
+description = "Pytest API automation framework with custom HTML reporting, reusable fixtures, and fluent assertions"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [{ name = "QA Platform Team" }]
+keywords = ["pytest", "api", "testing", "automation", "html-report"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Framework :: Pytest",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Testing",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "pytest>=7.4",
+    "requests>=2.31",
+    "Jinja2>=3.1",
+    "urllib3>=2.0",
+    "jsonschema>=4.20",
+]
+
+[project.optional-dependencies]
+dotenv = [
+    "python-dotenv>=1.0",
+]
+dev = [
+    "pytest-mock>=3.12",
+    "responses>=0.25",
+    "black>=24.0",
+    "isort>=5.13",
+    "mypy>=1.8",
+    "twine>=5.0",
+    "build>=1.0",
+]
+
+[project.entry-points."pytest11"]
+pytest-api-core = "pytest_api_core.plugin"
+
+[project.urls]
+Repository = "https://github.com/your-org/pytest-api-core-framework"
+Documentation = "https://your-org.artifactory.com/docs/pytest-api-core"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+pytest_api_core = ["reporters/templates/*.html"]
+
+[tool.black]
+line-length = 100
+target-version = ["py39"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.mypy]
+python_version = "3.9"
+strict = true
+ignore_missing_imports = true

pytest_api_core-1.0.1/setup.cfg

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

pytest_api_core-1.0.1/src/pytest_api_core/__init__.py

@@ -0,0 +1,20 @@
+"""
+pytest-api-core: Reusable API automation framework for pytest.
+Auto-registered as a pytest plugin via entry_points["pytest11"].
+"""
+
+from pytest_api_core.client.api_client import APIClient
+from pytest_api_core.client.api_response import APIResponse
+from pytest_api_core.assertions.response_assertions import assert_that
+from pytest_api_core.auth.auth_handlers import BearerAuth, BasicAuth, APIKeyAuth, OAuth2ClientCredentials
+
+__version__ = "1.0.0"
+__all__ = [
+    "APIClient",
+    "APIResponse",
+    "assert_that",
+    "BearerAuth",
+    "BasicAuth",
+    "APIKeyAuth",
+    "OAuth2ClientCredentials",
+]

pytest_api_core-1.0.1/src/pytest_api_core/assertions/__init__.py

@@ -0,0 +1,3 @@
+from pytest_api_core.assertions.response_assertions import ResponseAssertions, assert_that
+
+__all__ = ["ResponseAssertions", "assert_that"]