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

Release history Release notifications

History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
lasso-0.0.5.tar.gz (5.0 kB) Copy SHA256 hash SHA256 Source None Mar 14, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page