Skip to main content

explicitly typed attributes for Python

Project description

http://docs.enthought.com/traits

Build status Coverage status

The Traits project is at the center of all Enthought Tool Suite development and has changed the mental model used at Enthought for programming in the already extremely efficient Python programming language. We encourage everyone to join us in enjoying the productivity gains from using such a powerful approach.

The Traits project allows Python programmers to use a special kind of type definition called a trait, which gives object attributes some additional characteristics:

  • Initialization: A trait has a default value, which is automatically set as the initial value of an attribute before its first use in a program.

  • Validation: The type of a trait attribute is explicitly declared. The type is evident in the code, and only values that meet a programmer-specified set of criteria (i.e., the trait definition) can be assigned to that attribute.

  • Delegation: The value of a trait attribute can be contained either in the defining object or in another object delegated to by the trait.

  • Notification: Setting the value of a trait attribute can notify other parts of the program that the value has changed.

  • Visualization: User interfaces that allow a user to interactively modify the value of a trait attribute can be automatically constructed using the trait’s definition. (This feature requires that a supported GUI toolkit be installed. If this feature is not used, the Traits project does not otherwise require GUI support.)

A class can freely mix trait-based attributes with normal Python attributes, or can opt to allow the use of only a fixed or open set of trait attributes within the class. Trait attributes defined by a class are automatically inherited by any subclass derived from the class.

Dependencies

Traits runs on both Python 2 and Python 3. It requires Python 2.7 or Python >= 3.4.

Traits has the following optional dependencies:

  • NumPy to support the trait types for arrays.

  • Traitsui to support Gui Views.

To build the full documentation one needs:

  • sphinx > 1.2.3

  • mock (for Python 2 only; optional if traitsui is not available)

  • enthought-sphinx-theme (a version of the documentation can be built without this, but some formatting may be incorrect)

Download files

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

Source Distribution

traits-5.1.0.tar.gz (436.7 kB view details)

Uploaded Source

File details

Details for the file traits-5.1.0.tar.gz.

File metadata

  • Download URL: traits-5.1.0.tar.gz
  • Upload date:
  • Size: 436.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.2 pkginfo/1.4.2 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.8.0 tqdm/4.31.1 CPython/3.7.3

File hashes

Hashes for traits-5.1.0.tar.gz
Algorithm Hash digest
SHA256 af91b481d24cc6f47791f48c3b50c5190f460b7727d30656a780dff894ee63f6
MD5 410dd27a74074f7e82c2c5157a9096b6
BLAKE2b-256 65fd3aad5c3452f73b178619b8a1aad2e86bc9a0d6861d9e5659f8799203a1d7

See more details on using hashes here.

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