The pythonic REST client and testing tool.

Zapy REST Client - SDK

Zapy REST Client is an extension for VSCode that serves as a tool for testing APIs. The accompanying Zapy SDK, a Python library, is an integral component that enables the utilization of Zapy request files, empowering the client and Python scripts to perform API operations. The primary goal is to streamline the process of API testing.

Documentation: https://docs.zapy.dev

Github repo: https://github.com/ZapyLabs/zapy-sdk

FAQ: https://zapy.dev/faq

Key features

❤️ Python/Jinja2 expressions: Utilize 🐍 Python and Jinja2 expressions for variable declaration and string templating.

🗔 Visual interface: Enjoy the VSCode extension for rapid development, enhancing productivity and ease of use.

⚡️ Async operations: Support async functions, hooks and stores for handling requests and responses.

📝 File based and git sync: Manage your requests with file-based local storage and optional Git for collaboration 👨‍👩‍👧‍👦.

🐍 Python scripting and tests. Leverage Python scripting capabilities and conduct tests within the client. Import packages and use snippets for enhanced functionality and customization.

🚀 CI/CD Ready: Import and execute request files directly within your integration tests.

♻️ Request reusability and invocation: Reuse requests and integrate seamlessly with your favorite tools such as pytest, Playwright, or Robot Framework, enhancing interoperability and extensibility.

🔗 Chaining: Chain requests using Jupyter notebooks and/or stores, facilitating interactive exploration and collaboration.

Requirements

Python 3.11+

For using the VSCode extension:

• Python virtual environment
• Zapy SDK
• VSCode

Usage

1. Install Zapy VSCode Extension.

2. Install the python library under a virtual environment.

   pip install zapy-sdk

3. Create a .zapy file, for example my_first_request.zapy.

4. Start the Zapy server.

5. Send your request 🚀.

Requests

Create requests visually using the Zapy VSCode Extension.

Stores

Stores enable the persistence and inspection of Python data for use in multiple requests, including the creation and management of environment variables.

Hooks

Hooks can be global or request-specific, allowing interception and modification of requests, such as for authentication.

from zapy.requests import hooks, HttpxArguments

@hooks.pre_request
async def on_each_request(httpx_args: HttpxArguments):
    httpx_args['auth'] = ('alice', 'ecila123')
    print(httpx_args)

Chaining

Chaining runs a sequence of requests with one click, using responses from one request in the next. It also offers the ability to use conditionals or to resume from a failed step.

Integration test

Requests and their tests can be invoked directly on your integration tests.

import pytest
from zapy import requests

@pytest.mark.asyncio
async def test_single():
    request = requests.from_path("request1.zapy")
    # if raise_assert is enabled, it will perform all assertions defined in the request file
    _ = await request.send(raise_assert=True)

Privacy

Data for authentication is collected when using Zapy VSCode Extension. No personal or request data is collected.

License

Zapy REST Client - SDK (a.k.a. Zapy SDK) is licensed under the terms of the Business Source License 1.1 (BSL). Zapy REST Client (a.k.a. Zapy VSCode Extension) is under End User Service Agreement.

By installing or running this software you expressly agree with the terms of use.