Skip to main content

Simplify the testing of SQL data models and queries by allowing users to mock input data and create tests for various scenarios. It provides a consistent and convenient way to test the execution of your query without the need to process a massive amount of data.

Project description

SQLMock Logo

SQL Mock: Python Library for Mocking SQL Queries with Dictionary Inputs

PyPI version Supported Python versions License: MIT

The primary purpose of this library is to simplify the testing of SQL data models and queries by allowing users to mock input data and create tests for various scenarios. It provides a consistent and convenient way to test the execution of your query without the need to process a massive amount of data.

Documentation

A full documentation can be found on the documentation page

The library currently supports the following databases.

  • BigQuery
  • Clickhouse
  • Redshift
  • Snowflake

Installation

The library can be installed from PyPI using pip:

# BigQuery
pip install --upgrade "sql-mock[bigquery]"

# Clickhouse
pip install --upgrade "sql-mock[clickhouse]"

# Redshift
pip install --upgrade "sql-mock[redshift]"

# Snowflake
pip install --upgrade "sql-mock[snowflake]"

If you need to modify this source code, install the dependencies using poetry:

poetry install --all-extras

Pydantic V1 vs. V2

SQL Mock's published version supports Pydantic V2. You might run into issues when your code depends on Pydantic V1. We have an alternative branch you can install from that supports Pydantic V1 in the meanwhile: https://github.com/DeepLcom/sql-mock/tree/pydantic-v1

Contributing

We welcome contributions to improve and enhance this open-source project. Whether you want to report issues, suggest new features, or directly contribute to the codebase, your input is valuable. To ensure a smooth and collaborative experience for both contributors and maintainers, please follow these guidelines:

Reporting Issues

If you encounter a bug, have a feature request, or face any issues with the project, we encourage you to report them using the project's issue tracker. When creating an issue, please include the following information:

  • A clear and descriptive title.
  • A detailed description of the problem or suggestion.
  • Steps to reproduce the issue (if applicable).
  • Any error messages or screenshots that help clarify the problem.

Feature Requests

If you have ideas for new features or improvements, please use the project's issue tracker to submit a feature request. We appreciate well-documented feature requests that explain the motivation and potential use cases.

Contributing Code

Find more about contributing code in the Contribution Guidelines

Experimental

SQL Mock Buddy - A custom (Chat) GPT to support you

We ran a small experiment to create a custom GPT for SQL Mock. The SQL Mock Buddy can be accessed here: https://chat.openai.com/g/g-FIXNcqu1l-sql-mock-buddy

SQL Mock Buddy should help you to get started quickly with SQL Mock.

It is still in beta mode and you should definitely double-check its output!

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

sql_mock-0.5.3.tar.gz (14.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sql_mock-0.5.3-py3-none-any.whl (17.7 kB view details)

Uploaded Python 3

File details

Details for the file sql_mock-0.5.3.tar.gz.

File metadata

  • Download URL: sql_mock-0.5.3.tar.gz
  • Upload date:
  • Size: 14.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.11.7 Linux/6.2.0-1018-azure

File hashes

Hashes for sql_mock-0.5.3.tar.gz
Algorithm Hash digest
SHA256 0e23f83a586d51e74c14dc4823b82bfb4d56608938cda309ea7baa4b374ac5e6
MD5 b5311d7642e400452feffcd9a5f4a869
BLAKE2b-256 036a799eda875ccf1e17f4e9d60a4fe4dc7338eecac4a17b2821b9a5187c7c3c

See more details on using hashes here.

File details

Details for the file sql_mock-0.5.3-py3-none-any.whl.

File metadata

  • Download URL: sql_mock-0.5.3-py3-none-any.whl
  • Upload date:
  • Size: 17.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.11.7 Linux/6.2.0-1018-azure

File hashes

Hashes for sql_mock-0.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 4cd29c897c86b91050c873a43c4ecf26ba635ed1b5619eeb2b3908f991222722
MD5 404bc4e2e5110557903e315231a23c2d
BLAKE2b-256 0261ff20756bd1003d6251af0f60074012ae2ee931c987182abf63fc7d003ebe

See more details on using hashes here.

Supported by

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