Skip to main content

No project description provided

Project description

Schemars

PyPI version Downloads

Introduction

Schemars is a Python package, written in Rust and leveraging PyO3, designed for efficient and flexible serialization of Python class instances. It provides a simple yet powerful schema-based approach to serialize complex Python objects.

Installation

To install Schemars, run the following command:

pip install schemars

Requirements

  • Python 3.x
  • Rust (optional for development)

Usage

To use Schemars, define your Python class and corresponding schema class, then serialize instances as shown below:

class Product:
    def __init__(self, name, price, created):
        self.name = name
        self.price = price
        self.created = created

product = Product("test", 10, "1577836800")

import schemars
class ProductSchema(schemars.Schema):
    name = schemars.Str(strict=True)
    price = schemars.Decimal()
    created = schemars.Date(format='%Y/%m/%d')

print(ProductSchema().serialize(product))

Documentation Coming Soon!

We are currently working on comprehensive documentation for Schemars, which will cover detailed usage, advanced features, and integration guides. Stay tuned for updates, and feel free to reach out to us with any specific questions or suggestions in the meantime.

Upcoming in Version 1.0

In the upcoming Version 1.0 of Schemars, we will be introducing additional functionalities including both validation and deserialization. This enhancement aims to provide a more comprehensive and robust experience in handling and processing Python class instances.

Inspired by Marshmallow and Django REST Framework

Schemars was developed in response to performance challenges encountered with existing serialization tools like Marshmallow and Django REST Framework. Our goal was to create a solution that not only addresses these performance issues but also remains user-friendly and familiar.

Easy Migration

If you're already using Marshmallow or Django REST Framework, you'll find Schemars's syntax and usage comfortably similar. This design choice is intentional to ensure that migration to Schemars is smooth and can be accomplished in just minutes. We have prioritized maintaining a familiar interface while significantly enhancing performance, so you can switch to Schemars with minimal adjustments to your existing codebase.

Benchmarking Schemars

Quick Benchmark Setup

To compare Schemars with Django REST Framework (DRF), Marshmallow and Pydantic, follow these steps:

Installation

Install benchmarking requirements:

python3 -m pip install -r bench/requirements.txt

Running the Benchmark

Execute the benchmark script:

python3 bench/run.py

This will run serialization tasks using Schemars, Marshmallow, DRF and Pydantic, allowing you to directly compare their performance.

License

Schemars is released under the [MIT License]

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

schemars-0.4.0.tar.gz (35.4 kB view hashes)

Uploaded Source

Built Distributions

schemars-0.4.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (292.8 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ x86-64

schemars-0.4.0-pp310-pypy310_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl (433.5 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ s390x

schemars-0.4.0-pp310-pypy310_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (307.4 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-pp310-pypy310_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (289.0 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (278.8 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARM64

schemars-0.4.0-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.whl (297.7 kB view hashes)

Uploaded PyPy manylinux: glibc 2.5+ i686

schemars-0.4.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (292.8 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ x86-64

schemars-0.4.0-pp39-pypy39_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl (433.5 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ s390x

schemars-0.4.0-pp39-pypy39_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (307.4 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-pp39-pypy39_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (289.0 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (278.9 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARM64

schemars-0.4.0-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.whl (297.7 kB view hashes)

Uploaded PyPy manylinux: glibc 2.5+ i686

schemars-0.4.0-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (293.3 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ x86-64

schemars-0.4.0-pp38-pypy38_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl (433.4 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ s390x

schemars-0.4.0-pp38-pypy38_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (307.5 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-pp38-pypy38_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (289.1 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (279.0 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARM64

schemars-0.4.0-pp38-pypy38_pp73-manylinux_2_5_i686.manylinux1_i686.whl (298.1 kB view hashes)

Uploaded PyPy manylinux: glibc 2.5+ i686

schemars-0.4.0-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (294.4 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ x86-64

schemars-0.4.0-pp37-pypy37_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl (435.2 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ s390x

schemars-0.4.0-pp37-pypy37_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (308.7 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-pp37-pypy37_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (290.4 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-pp37-pypy37_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (280.0 kB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARM64

schemars-0.4.0-pp37-pypy37_pp73-manylinux_2_5_i686.manylinux1_i686.whl (299.1 kB view hashes)

Uploaded PyPy manylinux: glibc 2.5+ i686

schemars-0.4.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl (432.2 kB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ s390x

schemars-0.4.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (307.7 kB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (287.7 kB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (277.8 kB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ ARM64

schemars-0.4.0-cp312-none-win_amd64.whl (231.4 kB view hashes)

Uploaded CPython 3.12 Windows x86-64

schemars-0.4.0-cp312-none-win32.whl (201.0 kB view hashes)

Uploaded CPython 3.12 Windows x86

schemars-0.4.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (292.1 kB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

schemars-0.4.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl (432.2 kB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ s390x

schemars-0.4.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (307.7 kB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (287.7 kB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (277.8 kB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ARM64

schemars-0.4.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl (297.3 kB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.5+ i686

schemars-0.4.0-cp312-cp312-macosx_11_0_arm64.whl (286.1 kB view hashes)

Uploaded CPython 3.12 macOS 11.0+ ARM64

schemars-0.4.0-cp312-cp312-macosx_10_7_x86_64.whl (312.1 kB view hashes)

Uploaded CPython 3.12 macOS 10.7+ x86-64

schemars-0.4.0-cp311-none-win_amd64.whl (227.5 kB view hashes)

Uploaded CPython 3.11 Windows x86-64

schemars-0.4.0-cp311-none-win32.whl (209.2 kB view hashes)

Uploaded CPython 3.11 Windows x86

schemars-0.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (292.4 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

schemars-0.4.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl (435.1 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ s390x

schemars-0.4.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (306.9 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (288.5 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (278.6 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ARM64

schemars-0.4.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl (297.6 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.5+ i686

schemars-0.4.0-cp311-cp311-macosx_11_0_arm64.whl (286.6 kB view hashes)

Uploaded CPython 3.11 macOS 11.0+ ARM64

schemars-0.4.0-cp311-cp311-macosx_10_7_x86_64.whl (312.8 kB view hashes)

Uploaded CPython 3.11 macOS 10.7+ x86-64

schemars-0.4.0-cp310-none-win_amd64.whl (227.6 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

schemars-0.4.0-cp310-none-win32.whl (209.3 kB view hashes)

Uploaded CPython 3.10 Windows x86

schemars-0.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (292.4 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

schemars-0.4.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl (435.1 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ s390x

schemars-0.4.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (307.0 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (288.5 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (278.6 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ARM64

schemars-0.4.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl (297.6 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.5+ i686

schemars-0.4.0-cp310-cp310-macosx_11_0_arm64.whl (286.6 kB view hashes)

Uploaded CPython 3.10 macOS 11.0+ ARM64

schemars-0.4.0-cp310-cp310-macosx_10_7_x86_64.whl (312.8 kB view hashes)

Uploaded CPython 3.10 macOS 10.7+ x86-64

schemars-0.4.0-cp39-none-win_amd64.whl (227.6 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

schemars-0.4.0-cp39-none-win32.whl (209.2 kB view hashes)

Uploaded CPython 3.9 Windows x86

schemars-0.4.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (292.5 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

schemars-0.4.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl (435.5 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ s390x

schemars-0.4.0-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (307.2 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (288.5 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (278.5 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ARM64

schemars-0.4.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl (297.9 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.5+ i686

schemars-0.4.0-cp38-none-win_amd64.whl (228.7 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

schemars-0.4.0-cp38-none-win32.whl (210.5 kB view hashes)

Uploaded CPython 3.8 Windows x86

schemars-0.4.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (293.8 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

schemars-0.4.0-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl (435.3 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ s390x

schemars-0.4.0-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (308.1 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-cp38-cp38-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (289.7 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (279.4 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ARM64

schemars-0.4.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl (298.7 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.5+ i686

schemars-0.4.0-cp37-none-win_amd64.whl (228.8 kB view hashes)

Uploaded CPython 3.7 Windows x86-64

schemars-0.4.0-cp37-none-win32.whl (210.5 kB view hashes)

Uploaded CPython 3.7 Windows x86

schemars-0.4.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (294.1 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ x86-64

schemars-0.4.0-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl (435.2 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ s390x

schemars-0.4.0-cp37-cp37m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (308.2 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ ppc64le

schemars-0.4.0-cp37-cp37m-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (289.8 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ ARMv7l

schemars-0.4.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (279.6 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ ARM64

schemars-0.4.0-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.whl (298.6 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.5+ i686

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