Skip to main content

Lightweight module to define serializable, schema-validated classes

Project description

Documentation Status Build Status Code Coverage

Lasso lasso-icon is a small module for Python which allows defining classes with type-checked attributes, conforming to a predetermined schema.

Classes with Lasso lasso-icon schemas can be used to:

  • Type-check object attributes.
  • Validate input data.
  • Deserialize input data to application objects, with direct support for deserializing JSON.
  • Serialize application objects to JSON.


Define a class, with a schema attached to it used to type-check the attributes:

>>> from lasso import Schemed
>>> class Point(Schemed):
...   __schema__ = { "x": int, "y": int }

Now values can be created, using keyword arguments to set the values of the attributes. Note how the attributes can be accessed normally:

>>> location = Point(x=-3, y=5)
>>> location.x, location.y
(-3, 5)

Attributes are type-checked:

>>> location.x = 6  # Succeds
>>> location.x = "invalid value"  # Fails
Traceback (most recent call last):
schema.SchemaError: 'invalid value' should be instance of <class 'int'>
>>> location.x, location.y  # Values remain unchanged
(6, 5)

Last, but not least, conversion to and from JSON is automatically supported:

>>> json_text = location.to_json(sort_keys=True)
>>> json_text
'{"x": 6, "y": 5}'
>>> value = Point.from_json(json_text)
>>> value.__class__.__name__


The stable releases are uploaded to PyPI, so you can install them and upgrade using pip:

pip install lasso

Alternatively, you can install development versions —at your own risk— directly from the Git repository:

pip install -e git://


The documentation for Lasso lasso-icon is available at:

Note that the documentation is work in progress. In the meanwhile, you may want to read the source code of the module itself for additional insight, or even better, the code of projects using the module.


If you want to contribute, please use the usual GitHub workflow:

  1. Clone the repository.
  2. Hack on your clone.
  3. Send a pull request for review.

If you do not have programming skills, you can still contribute by reporting issues that you may encounter.


The following projects make use of Lasso lasso-icon:

(If you use it, please do not hesitate in editing this file and add a line to this list.)

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

lasso-0.0.5.tar.gz (5.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page