Skip to main content

A light-weight module that aims to provide control for class attributes.

Project description

[![Build Status](https://travis-ci.org/lejar/traitlite.svg?branch=master)](https://travis-ci.org/lejar/traitlite)

# traitlite

Traitlite is a light-weight (MIT-licensed) package which provides certain [descriptors](https://docs.python.org/3/howto/descriptor.html) to help control the attributes in a class, such as making them read-only<sup>*</sup> or providing type-checking whenever the value is set. The documentation has examples for every trait, so check it out!

<sup>*</sup> well, as read-only as you can get in python

## Installation

The easiest way to install traitlite is through pip:

`bash pip install traitlite `

## Running the tests

Traitlite uses the builtin python unit testing framework, along with [hypothesis](https://hypothesis.works/). Additionally, [cosmic-ray](https://github.com/sixty-north/cosmic-ray) is used for mutation testing.

To install the dependencies required to run the tests, run: `bash pip install -r unittest_requirements.txt ` This will install both hypothesis and cosmic-ray.

To run the tests, simply execute the following from the package directory:

`bash python setup.py test `

To run mutation testing, execute: `bash python setup.py crtest `

If you want to get the [coverage](https://github.com/nedbat/coveragepy) of the tests, execute:

`bash python setup.py coverage `

## Documentation

The docs can be found [here](https://traitlite.readthedocs.io/en/latest/). Alternatively, if you want to build them yourself simply run

`bash make <target> ` in the docs folder of the project. To see a list of all the different targets, simply run make without any arguments.

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

traitlite-0.0.2.tar.gz (6.6 kB view details)

Uploaded Source

File details

Details for the file traitlite-0.0.2.tar.gz.

File metadata

  • Download URL: traitlite-0.0.2.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/3.7

File hashes

Hashes for traitlite-0.0.2.tar.gz
Algorithm Hash digest
SHA256 fe0a5690582645b179fe9b295068fec308eae10799bf88fd55e3764d2c102519
MD5 6cbcdaa87a7fbc0e7e0e0edee4162e6d
BLAKE2b-256 77ff8fbab8081532b12dd2df2003e5bd8a31d12fb2d2cabf411861a8cab39331

See more details on using hashes here.

Supported by

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