Skip to main content

Zapy SDK for Zapy REST client

Project description

The pythonic REST client and testing tool.

Test Coverage Version Package version Supported Python versions

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.


Github repo:


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.


Python 3.11+

For using the VSCode extension:

  • Python virtual environment
  • Zapy SDK
  • VSCode


  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 🚀.



Create requests visually using the Zapy VSCode Extension.

first look


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



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

from zapy.requests import hooks, HttpxArguments

async def on_each_request(httpx_args: HttpxArguments):
    httpx_args['auth'] = ('alice', 'ecila123')


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

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)


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


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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zapy_sdk-0.0.1a2.tar.gz (30.1 kB view hashes)

Uploaded Source

Built Distribution

zapy_sdk-0.0.1a2-py3-none-any.whl (32.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page