pysnapapi 0.3.0__py3-none-any.whl

pysnapapi-0.3.0.dist-info/METADATA

@@ -0,0 +1,353 @@
+Metadata-Version: 2.4
+Name: pysnapapi
+Version: 0.3.0
+Summary: Lightweight DSL for HTTP API testing
+Author-email: Deekshith Poojary <deekshithpoojary355@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Deekshith Poojary
+        
+        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: Homepage, https://deekshith-poojary98.github.io/snapapi/
+Project-URL: Documentation, https://github.com/deekshith-poojary98/snapapi#readme
+Project-URL: Repository, https://github.com/deekshith-poojary98/snapapi
+Project-URL: Issues, https://github.com/deekshith-poojary98/snapapi/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: jsonschema>=4.18.0
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Provides-Extra: watch
+Requires-Dist: watchdog>=2.1; extra == "watch"
+Dynamic: license-file
+
+# SnapAPI
+
+[![PyPI version](https://badge.fury.io/py/snapapi.svg)](https://badge.fury.io/py/snapapi)
+[![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue.svg)](https://www.python.org/downloads/)
+[![CI Tests](https://github.com/deekshith-poojary98/snapapi/actions/workflows/snapapi.yml/badge.svg)](https://github.com/deekshith-poojary98/snapapi/actions/workflows/snapapi.yml)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/deekshith-poojary98/snapapi)
+
+
+SnapAPI is a lightweight HTTP API testing framework with a small custom DSL.
+Write `.sapi` files, then run them from the CLI. The older `.snaptest` extension still works.
+
+**[User guide](https://deekshith-poojary98.github.io/snapapi/)** — install, DSL reference, CLI, CI, VS Code, and an in-browser **[playground](https://deekshith-poojary98.github.io/snapapi/playground.html)**
+
+## Features
+
+- Human-readable DSL for GET, POST, PUT, PATCH, DELETE, HEAD, and OPTIONS
+- Attach `BODY`/`DATA`, `HEADER`s, `QUERY`/`PARAM`, and `AUTH` to the current request
+- `EXPECT` checks: status, body contains, JSONPath (filters + collection asserts), XPath, response headers
+- `SAVE` values from JSON responses and reuse them as `${var}`
+- Setup / teardown with cycle detection
+- Env files, tag filters, timeouts, retries, JSON and JUnit reports
+- OpenAPI response/request contract checks, VCR cassettes, JSON mock server
+- pytest plugin (`snapapi_run` / `@pytest.mark.snapapi`)
+- VS Code syntax highlighting and diagnostics for `.sapi` files
+
+## Requirements
+
+- Python 3.9 or newer
+
+## Installation
+
+```bash
+git clone https://github.com/Deekshith-07/snapapi.git
+cd snapapi
+python3 -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+Or with the pinned runtime dependencies:
+
+```bash
+pip install -r requirements.txt
+pip install -e .
+```
+
+## CLI
+
+```bash
+snapapi path/to/file.sapi
+python -m snapapi path/to/file.sapi
+```
+
+Pass multiple files or a directory of `.sapi` files:
+
+```bash
+snapapi tests/test_suite.snaptest
+snapapi tests/ suites/auth.sapi
+```
+
+Options:
+
+| Flag | Meaning |
+| --- | --- |
+| `-k "Login or not Health"` | Pytest-style keyword expression on name/description/tags |
+| `-m "smoke and not slow"` | Pytest-style tag expression |
+| `--tag user` | Run tests that have this tag (repeatable; all given tags must match) |
+| `--exclude slow` | Skip tests with this tag (repeatable) |
+| `--name "Create User"` | Run tests with this name (repeatable) |
+| `--env .env` | Load `KEY=VALUE` pairs for `${VAR}`. If omitted, SnapAPI loads `<suite>.env`, then `.env` next to the file, then a single sibling `*.env` |
+| `-D TOKEN=secret` | Set `${VAR}` from the CLI (repeatable) |
+| `--timeout 10` | HTTP timeout in seconds (overrides `TIMEOUT`) |
+| `--report json:report.json` | Write a JSON report |
+| `--report junit:report.xml` | Write a JUnit XML report |
+| `--report html:report.html` | Write a self-contained HTML report |
+| `-x` / `--exitfirst` / `--stop-on-failure` | Stop each suite on the first failed test (off by default) |
+| `--maxfail N` | Stop after N failures |
+| `--collect-only` | List selected tests without HTTP |
+| `-q` / `-v` | Quiet or verbose console |
+| `--durations N` | Show the N slowest tests |
+| `--profile stage` | Load `environments/stage.env`, `.snapapi/stage.env`, or `stage.env` |
+| `--workers N` | Run independent tests in parallel (SAVE is isolated per test; sibling SAVE falls back to sequential) |
+| `--grep regex` | Filter tests by name/description |
+| `--lf` / `--last-failed` | Re-run failures from `.snapapi/last-run.json` (matches file + suite + name, including `Test [row]`) |
+| `--ff` / `--failed-first` | Run last-failed tests first, then the rest |
+| `--mode record\|replay\|record-on-miss` | VCR cassettes under `.snapapi/cassettes/` |
+| `--record-on-miss` | With `--mode replay`, hit the network and save when a cassette is missing |
+| `--vcr-match query,body,accept,authorization` | Cassette identity fields (default: query, content-type, accept, body) |
+| `--contract-strict` | Fail when an OpenAPI path/method/schema is missing (default: skip/warn) |
+| `--reruns N` | Re-run failed *tests* up to N times (distinct from `EXPECT RETRY`) |
+| `--listener PATH[:Class]` | Python listener called after each test / suite (repeatable) |
+| `--on-fail curl` / `--on-fail har:dir` | Emit a redacted curl or HAR on failure |
+| `--safe-url` | Block private/metadata hosts |
+| `--proxy URL` | HTTP/HTTPS proxy |
+| `--insecure` | Skip TLS certificate verification |
+| `--cert PATH` | Client certificate |
+| `--cacert PATH` | CA bundle used to verify TLS |
+| `snapapi lint PATH` | Parse/validate without HTTP |
+| `snapapi fmt PATH` | Format `.sapi` files |
+| `snapapi openapi spec.yaml` | Generate GET/POST/PUT/PATCH/DELETE smoke tests |
+| `snapapi history [--failed] [--since 7d]` | Print `.snapapi/history.jsonl` |
+| `snapapi mock mock.json [--port 0]` | Serve routes from a JSON mock file (prints the URL) |
+| `snapapi watch PATH [--interval 0.5]` | Re-run when `.sapi` files change (poll; optional `watchdog` extra) |
+
+The process exits `0` when every test passed, `1` when a test failed, and `2` on parse or usage errors.
+
+## DSL
+
+Recommended form:
+
+```
+SUITE: Book Store
+DESC: Validates the user API
+TIMEOUT: 10
+URL: https://api.example.com
+HEADER Content-Type: application/json
+
+TEST: Create User
+DESC: Create a user and keep the id
+TAG: users write
+  POST: /users
+  AUTH: bearer ${TOKEN}
+  BODY: {"name": "Jane", "email": "jane@example.com"}
+  EXPECT: status == 201
+  EXPECT: body contains id
+  SAVE: userId FROM $.id
+
+TEST: Get User
+TAG: users
+SETUP: Create User
+  GET: /users/${userId}
+  EXPECT: status == 200
+  EXPECT: json $.email == "jane@example.com"
+  EXPECT: header Content-Type contains json
+
+TEST: List Users
+  GET: /users
+  QUERY: page=2&limit=10
+  PARAM: sort name
+  EXPECT: status == 200
+
+TEST: Wait for ready
+  GET: /jobs/${id}
+  WAIT: json $.status == "ready" TIMEOUT 10s BACKOFF 0.5s
+  EXPECT: status == 200
+```
+
+Comments are `//` lines. Indentation is cosmetic. JSON bodies may be one line or span multiple lines.
+
+The older forms still parse:
+
+```
+OPTIONS: {"TIMEOUT": 10}
+HEADERS: {"Content-Type": "application/json"}
+TAG: users, write
+REQUEST: POST /users
+HEADERS: {"Authorization": "Bearer ${TOKEN}"}
+DATA: {"name": "Jane"}
+EXPECT: STATUS 201
+EXPECT: CONTAINS id
+EXPECT: JSON $.email == "jane@example.com"
+EXPECT: HEADER Content-Type CONTAINS json
+```
+
+### Keywords
+
+- Suite: `SUITE`, `DESC`, `URL`, `TIMEOUT`, `FOLLOW-REDIRECTS`, `OPTIONS`, `IMPORT`, `SUITE-SETUP`, `SET`
+- Test: `TEST`, `TAG`, `SETUP`, `TEARDOWN`, `DEPENDS`, `SKIP`, `ONLY`, `QUARANTINE`, `EXAMPLES`, `SET`
+- Helper: `HELPER` (named procedure for `SUITE-SETUP` / `SETUP` / `TEARDOWN`; not a test case)
+- Request: `REQUEST`, `GET`/`POST`/`PUT`/`PATCH`/`DELETE`/`HEAD`, `BODY`/`DATA`, `FILE`, `GRAPHQL`, `HEADER`/`HEADERS`, `QUERY`, `PARAM`, `AUTH`, `EXPECT`, `SAVE`, `WAIT`, `SET`
+
+HTTP `OPTIONS` is written as `REQUEST: OPTIONS /path` so it does not collide with suite-level `OPTIONS: {...}` JSON. `HEAD: /x` is a request alias like `GET:`.
+
+`SETUP` / `TEARDOWN` name a `HELPER` or `TEST`. Prefer `HELPER:` for procedures that should not appear as cases. A `TEST` named only as setup is still treated as a helper (legacy).
+
+`DEPENDS: Create User` (comma-separated for several names) keeps both tests as primaries. SnapAPI reorders so named tests run first; unrelated tests keep file order. If a named test failed, skipped, or was not selected (for example `-k`), the dependent test is skipped with that reason. Cycles and unknown names are parse errors. `DEPENDS` cannot target a `HELPER`. This is not `SETUP:` — setup helpers always run first and fail the dependent test when they fail.
+
+`IMPORT: other.sapi` pulls tests from another file (paths are relative to the current file).
+
+`SET: orderId ${uuid()}` assigns an interpolated value (including helpers) without an HTTP call. It may appear at suite, test, or step level.
+
+`WAIT: json $.status == "ready" TIMEOUT 10s BACKOFF 0.5s` reissues the current request until the check passes or the timeout expires. `EXPECT: json $.status == "ready" RETRY 20 BACKOFF 0.5s` also retries when the HTTP status is already 200.
+
+`AUTH: bearer ${TOKEN}` sets `Authorization: Bearer ${TOKEN}`. Explicit `HEADER` lines still work.
+
+`AUTH: oauth2 grant=client_credentials token_url=... client_id=...` and `grant=password username=... password=...` fetch a token (cached). If the token response includes `refresh_token`, a 401 retries once after refresh.
+
+`AUTH: oauth2 grant=authorization_code token_url=... auth_url=... client_id=... redirect_uri=... code=${AUTH_CODE} pkce=true` exchanges an authorization code. SnapAPI does not open a browser; supply `${AUTH_CODE}` from the environment. With `pkce=true` the token request includes S256 `code_verifier` / `code_challenge` fields.
+
+`AUTH: digest user:pass` uses `requests` HTTP Digest Auth.
+
+`QUERY: page=2&limit=10` and `PARAM: page 2` attach query parameters to the current request (they merge with any query string already in the path).
+
+`OPTIONS: {"OPENAPI": "spec.yaml"}` validates JSON responses (and request bodies/required params) against the matching path+method schema when present. Missing path/schema is skipped by default. Strict mode fails instead:
+
+```
+OPTIONS: {"OPENAPI": "spec.yaml", "OPENAPI-STRICT": true}
+EXPECT: openapi ./spec.yaml strict
+```
+
+CLI `--contract-strict` is the same switch. Partial path match (`/users/{id}` vs `/users/1`) is allowed.
+
+### Checks
+
+Check types are case-insensitive. Preferred:
+
+```
+EXPECT: status == 200
+EXPECT: status != 500
+EXPECT: status == 200 RETRY 5 ON 5xx BACKOFF 1s
+EXPECT: body contains userId
+EXPECT: body not contains stack
+EXPECT: json $.email matches ^.+@example\\.com$
+EXPECT: json $.items length == 3
+EXPECT: json $.items[*].id contains 3
+EXPECT: json $.items[?(@.status=="open")].id contains 3
+EXPECT: json $.tags contains-all ["a","b"]
+EXPECT: json $.items each $.status == "active"
+EXPECT: status == 400 OR status == 401
+EXPECT: json $.success == false AND body contains error
+EXPECT: (status == 400 OR status == 401) AND json $.success == false
+EXPECT: schema ./schemas/user.json
+EXPECT: duration < 200ms
+EXPECT: header Content-Type contains json
+EXPECT: openapi ./openapi.yaml
+EXPECT: openapi ./openapi.yaml strict
+EXPECT: xpath //Order/@id == "1"
+```
+
+Also accepted:
+
+```
+EXPECT: STATUS 200
+EXPECT: CONTAINS userId
+EXPECT: JSON $.data.email == "jane@example.com"
+EXPECT: HEADER Content-Type CONTAINS json
+```
+
+JSONPath is a small subset: `$.a.b`, `$.items.0.id`, `$.items[0].id`, `$.items[*].id`, and equality filters `$.items[?(@.status=="open")]` / `$.items[?(@.id==1)]`.
+
+`AND` / `OR` combine checks on one line (`AND` binds tighter than `OR`; parentheses group). Quote a value if it contains those words. Multiple `EXPECT` lines on the same request still all have to pass.
+
+XPath uses stdlib `xml.etree` (descendant tags and `/@attr`). Axes, namespaces, and functions are not implemented.
+
+### Variables
+
+`${NAME}` is expanded in URLs, paths, headers, data, and expect values.
+
+Lookup order: process environment, then `--env` / auto-discovered suite env file, then `SET` / `SAVE` values.
+
+## Sample suite
+
+`tests/recommended.snaptest` shows the current DSL against a local mock server (pytest injects `BASE_URL`). `tests/test_suite.snaptest` is a classic-syntax example against [reqres.in](https://reqres.in) and needs network access. Automated tests in `tests/test_*.py` use a local mock HTTP server and do not call reqres. CI replays `tests/fixtures/offline.snaptest` from a checked-in cassette.
+
+HTML reports include redacted request/response bodies. VCR cassette keys include method, path, and (by default) sorted query string, `Content-Type`/`Accept`, and body. `OPTIONS: {"VCR-MATCH": ["query","body","accept","authorization"]}` or `--vcr-match authorization,query` replaces that default. Replay restores `Set-Cookie` onto the session.
+
+`snapapi mock tests/fixtures/mock.json --port 0` serves JSON routes. Routes may use path templates (`/users/{id}`), optional `match.query` / `match.body` subsets, and `delay_ms`. Exact paths win over templates. There is no language server, gRPC, or WebSocket support.
+
+### pytest plugin
+
+Install with `pip install -e ".[dev]"`. Then:
+
+```python
+def test_suite(snapapi_run):
+    result = snapapi_run("tests/foo.sapi")
+    assert result.ok
+
+@pytest.mark.snapapi("tests/foo.sapi")
+def test_marked(snapapi_run, request):
+    snapapi_run(request.node.get_closest_marker("snapapi").args[0])
+```
+
+`snapapi_run(path, **engine_kwargs)` returns `SuiteResult` and fails the pytest case when the suite is not ok.
+
+## Project layout
+
+```
+snapapi/
+├── snapapi/              # Python package
+│   ├── parser.py         # .sapi DSL parser
+│   ├── engine.py         # runner, checks, setup/teardown
+│   ├── api_client.py     # requests wrapper
+│   └── cli.py            # snapapi command
+├── tests/                # pytest + sample .sapi / .snaptest suites
+├── docs/                 # User guide + in-browser playground
+├── snapapi-language/     # VS Code grammar / run command
+├── pyproject.toml
+└── README.md
+```
+
+## Running the tests
+
+```bash
+pytest
+```
+
+## VS Code
+
+The `snapapi-language` extension is a language pack for `.sapi` files: syntax highlighting, snippets, completions, lightweight diagnostics (unknown keywords, unknown SETUP names, `HEAD:` / `REQUEST: OPTIONS`), and **SnapAPI: Run current file** / **Run test at cursor**. See [snapapi-language/README.md](snapapi-language/README.md). There is no separate language-server process.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

pysnapapi-0.3.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+pysnapapi-0.3.0.dist-info/licenses/LICENSE,sha256=ChRR1xMo7b0WSSORcp1Ue9sJ9rDVG9dqNnIMdefSHLs,1074
+snapapi/__init__.py,sha256=fhKzpKQWD0rF8IPKxIE6sQSWEa1sm_mrtMaGcJzJetM,290
+snapapi/__main__.py,sha256=K0UJytWE0UIzqxvB7XzDpri8gJ8PeH-hjoX4GaqcHR0,70
+snapapi/api_client.py,sha256=5-apEcbAdVfBFiETfhfdi668yVpj7of0RajWk99nT5I,4571
+snapapi/cassette.py,sha256=wNYrjT_sX8tTiFnW5YPMwtGIqUc0RyVoBG4uthIQ88I,2827
+snapapi/cli.py,sha256=RdEWB1cALSElgVMY-k78OJU-0JHEyDP22h0T2ZZAbws,22331
+snapapi/engine.py,sha256=3veWRyle1xa_V1TNRIGtsQlKYz88_bW6ZCzaZgEDfRc,74530
+snapapi/exceptions.py,sha256=ZcU4o1XACzwq2GvvD4_I2EU-uYi96clpM0GdHj-5q9Q,681
+snapapi/fmt.py,sha256=FW3O5UJrJWf4CEm9L7Jrc4v2MbbeR45ekDK6CjrRYyk,2665
+snapapi/helpers.py,sha256=sVTBDUbMLSa6zK441BwqDRmoM0AHCi7kb_HhzJ-mFMM,1957
+snapapi/history.py,sha256=0LJJ3HAJMaNrLqlt3VKPG3PZl82XfcNq1A8ZfPaqTPw,4835
+snapapi/jsonpath.py,sha256=2C2ovYOoCN0PoIHmSUioPto0NZcz03XHllUlsHWqE1Y,5262
+snapapi/lint.py,sha256=Y6FqNu46epL4LM0CFYsaCXqYtjKabV70dxCs82_lZlQ,3942
+snapapi/listeners.py,sha256=AAmdovNGbC6HENDUpoW1bo74SQBhTQRIuZkBUltUrTc,2889
+snapapi/mock.py,sha256=xOQ-ULRGALjw99Lg1HQi690-OxcRLS3y_pXqdcVqIXM,6919
+snapapi/openapi.py,sha256=lObMi5y9enhGTMsf_qqVaZauys8uW9vMWcG7_yX5QVw,8051
+snapapi/parser.py,sha256=7sbLVyFmxwy_HJwwHAod-Jqp5oziP0AKBeO9ZDku4Rw,49913
+snapapi/profiles.py,sha256=nBUMhxAV0n-RO5mmF6R9eDb_lds7kg6-kxhOEC69gFc,747
+snapapi/pytest_plugin.py,sha256=LPIOwZgfhfEoO6BBvjbUV2WWyK3JFQtEt7aWPxSwXG8,1671
+snapapi/redact.py,sha256=xLYRMkvoFxq_ZxTXYJKdx-7NxaAUppwd1GIgbdfaZPs,2005
+snapapi/reports.py,sha256=n52CrVYGqqArmQFZj6Vglilo5hOl_LMStE19yxXHCRI,18011
+snapapi/safety.py,sha256=Ls0aR7u0itWPse45hmiJ4KPqizZv3PghW3LZFwJigTw,1098
+snapapi/select.py,sha256=8bxjowgnYi2H_0uZvkcvj0T1XdQ148-jAfejPg6Jj70,3627
+snapapi/suites.py,sha256=IuMuaZSg85YEsFpQQhs5LxT74flz68umSIuuMJbYrs0,831
+snapapi/variables.py,sha256=sUEsZjY76m7UcvBe_yPzG2PcxcfcnZHAM5QACyFj89Y,3493
+snapapi/watch.py,sha256=F_dBiqInLrelvzVKUaPvuH46X4pAd54FrSAo85h4r74,2141
+snapapi/xpath.py,sha256=Xdo_6GfeplHtr5_4707OydLw1kTScfNZYW_IotyrNqw,2134
+pysnapapi-0.3.0.dist-info/METADATA,sha256=2pfZ387vFdw31SQKpIYoiTcADkQqeKMBzmt6UaWpAm4,16114
+pysnapapi-0.3.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+pysnapapi-0.3.0.dist-info/entry_points.txt,sha256=5vCGUbjt-MrEO6YwbYJJQLoNnU6w6EApymINp5XuR0U,90
+pysnapapi-0.3.0.dist-info/top_level.txt,sha256=ixqJtWjxOFIoE_Mirko8xyRTH-3pKC_AYNRLLUuESoA,8
+pysnapapi-0.3.0.dist-info/RECORD,,

pysnapapi-0.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pysnapapi-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+snapapi = snapapi.cli:entry
+
+[pytest11]
+snapapi = snapapi.pytest_plugin

pysnapapi-0.3.0.dist-info/licenses/LICENSE

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

pysnapapi-0.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+snapapi

snapapi/__init__.py

@@ -0,0 +1,8 @@
+"""SnapAPI — a lightweight DSL for HTTP API testing."""
+
+from snapapi.engine import Engine
+from snapapi.exceptions import ParseError, SnapAPIError
+from snapapi.parser import TestParser
+
+__version__ = "0.3.0"
+__all__ = ["Engine", "TestParser", "ParseError", "SnapAPIError", "__version__"]

snapapi/__main__.py

@@ -0,0 +1,4 @@
+from snapapi.cli import entry
+
+if __name__ == "__main__":
+    entry()

snapapi/api_client.py

@@ -0,0 +1,125 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import requests
+
+
+class APIClient:
+    """Session-backed HTTP client with JSON, form, raw, multipart, and GraphQL bodies."""
+
+    def __init__(
+        self,
+        base_url=None,
+        timeout=30,
+        follow_redirects=True,
+        verify=True,
+        cert=None,
+        proxies=None,
+    ):
+        self.base_url = (base_url or "").rstrip("/")
+        self.timeout = timeout
+        self.follow_redirects = follow_redirects
+        self.verify = verify
+        self.cert = cert
+        self.proxies = dict(proxies or {})
+        self.session = requests.Session()
+        self.session.verify = verify
+        if cert:
+            self.session.cert = cert
+        if self.proxies:
+            self.session.proxies.update(self.proxies)
+
+    def request(
+        self,
+        method,
+        endpoint,
+        json=None,
+        data=None,
+        headers=None,
+        timeout=None,
+        files=None,
+        body_type=None,
+        raw=None,
+        content_type=None,
+        follow_redirects=None,
+        auth=None,
+    ):
+        url = self._build_url(endpoint)
+        kwargs = {
+            "headers": dict(headers or {}),
+            "timeout": self.timeout if timeout is None else timeout,
+            "allow_redirects": self.follow_redirects if follow_redirects is None else follow_redirects,
+        }
+        if auth is not None:
+            kwargs["auth"] = auth
+        kind = (body_type or "json").lower()
+        if files:
+            kwargs["files"] = files
+            if data is not None:
+                kwargs["data"] = data
+        elif kind == "form":
+            kwargs["data"] = data if data is not None else json
+        elif kind == "raw":
+            kwargs["data"] = raw if raw is not None else data
+            if content_type:
+                kwargs["headers"]["Content-Type"] = content_type
+        elif kind == "graphql":
+            kwargs["json"] = json if json is not None else data
+        elif json is not None:
+            kwargs["json"] = json
+        elif data is not None:
+            kwargs["json"] = data
+        return self.session.request(method.upper(), url, **kwargs)
+
+    def get(self, endpoint, headers=None, timeout=None, **kwargs):
+        if "json" in kwargs:
+            return self.request("GET", endpoint, json=kwargs["json"], headers=headers, timeout=timeout)
+        return self.request("GET", endpoint, headers=headers, timeout=timeout)
+
+    def post(self, endpoint, data=None, headers=None, timeout=None, **kwargs):
+        body = kwargs["json"] if "json" in kwargs else data
+        return self.request("POST", endpoint, json=body, headers=headers, timeout=timeout)
+
+    def put(self, endpoint, data=None, headers=None, timeout=None, **kwargs):
+        body = kwargs["json"] if "json" in kwargs else data
+        return self.request("PUT", endpoint, json=body, headers=headers, timeout=timeout)
+
+    def patch(self, endpoint, data=None, headers=None, timeout=None, **kwargs):
+        body = kwargs["json"] if "json" in kwargs else data
+        return self.request("PATCH", endpoint, json=body, headers=headers, timeout=timeout)
+
+    def delete(self, endpoint, data=None, headers=None, timeout=None, **kwargs):
+        body = kwargs["json"] if "json" in kwargs else data
+        return self.request("DELETE", endpoint, json=body, headers=headers, timeout=timeout)
+
+    def head(self, endpoint, headers=None, timeout=None, **kwargs):
+        return self.request("HEAD", endpoint, headers=headers, timeout=timeout, **kwargs)
+
+    def options(self, endpoint, headers=None, timeout=None, **kwargs):
+        return self.request("OPTIONS", endpoint, headers=headers, timeout=timeout, **kwargs)
+
+    def _build_url(self, endpoint):
+        endpoint = (endpoint or "").strip()
+        if endpoint.startswith("http://") or endpoint.startswith("https://"):
+            return endpoint
+        if not self.base_url:
+            raise ValueError(f"No base URL configured for endpoint {endpoint!r}")
+        if not endpoint:
+            return self.base_url
+        if not endpoint.startswith("/"):
+            return f"{self.base_url}/{endpoint}"
+        return f"{self.base_url}{endpoint}"
+
+
+def open_files(file_specs, base_dir):
+    opened = {}
+    handles = []
+    for spec in file_specs or []:
+        path = Path(spec["path"])
+        if not path.is_absolute():
+            path = Path(base_dir) / path
+        handle = path.open("rb")
+        handles.append(handle)
+        opened[spec["field"]] = (path.name, handle)
+    return opened, handles

snapapi/cassette.py

@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+import hashlib
+import json
+from pathlib import Path
+from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
+
+DEFAULT_VCR_MATCH = ("query", "body", "content-type", "accept")
+VCR_HEADER_ALIASES = {
+    "content_type": "content-type",
+    "content-type": "content-type",
+    "accept": "accept",
+    "authorization": "authorization",
+}
+
+
+def parse_vcr_match(value):
+    if value is None:
+        return list(DEFAULT_VCR_MATCH)
+    if isinstance(value, str):
+        items = [item.strip().lower() for item in value.replace(";", ",").split(",") if item.strip()]
+    elif isinstance(value, (list, tuple)):
+        items = [str(item).strip().lower() for item in value if str(item).strip()]
+    else:
+        return list(DEFAULT_VCR_MATCH)
+    return [VCR_HEADER_ALIASES.get(item, item) for item in items] or list(DEFAULT_VCR_MATCH)
+
+
+def cassette_key(method, url, body=None, headers=None, match=None):
+    match_keys = parse_vcr_match(match)
+    parts = urlsplit(url or "")
+    if "query" in match_keys:
+        query = sorted(parse_qsl(parts.query, keep_blank_values=True))
+        query_blob = urlencode(query)
+    else:
+        query_blob = ""
+    canonical = urlunsplit((parts.scheme, parts.netloc, parts.path, query_blob, parts.fragment))
+    wanted_headers = {item for item in match_keys if item in ("accept", "content-type", "authorization")}
+    selected = []
+    for key, value in (headers or {}).items():
+        lowered = str(key).lower()
+        if lowered in wanted_headers:
+            selected.append((lowered, "" if value is None else str(value)))
+    selected.sort()
+    header_blob = "\n".join(f"{key}:{value}" for key, value in selected)
+    body_blob = _body_text(body) if "body" in match_keys else ""
+    raw = f"{method.upper()}\n{canonical}\n{header_blob}\n{body_blob}"
+    return hashlib.sha256(raw.encode("utf-8")).hexdigest()
+
+
+def load_cassettes(directory):
+    path = Path(directory)
+    if not path.is_dir():
+        return {}
+    store = {}
+    for item in path.glob("*.json"):
+        try:
+            payload = json.loads(item.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError):
+            continue
+        key = payload.get("key") or item.stem
+        store[key] = payload
+    return store
+
+
+def save_cassette(directory, key, payload):
+    path = Path(directory)
+    path.mkdir(parents=True, exist_ok=True)
+    record = dict(payload)
+    record["key"] = key
+    (path / f"{key}.json").write_text(json.dumps(record, indent=2, default=str) + "\n", encoding="utf-8")
+
+
+def _body_text(body):
+    if body is None:
+        return ""
+    if isinstance(body, (dict, list)):
+        return json.dumps(body, sort_keys=True, default=str)
+    if isinstance(body, bytes):
+        return hashlib.sha256(body).hexdigest()
+    return str(body)