Comparison to other approaches¶
Param was first developed in 2003 for Python 2.1 as part of a long-running brain simulation project, and was made into a separate package on Github in 2012. In the interim a variety of other libraries solving some of the same problems have been developed, including:
Plus, Python itself has incorporated mechanisms addressing some of the same issues:
Each of these approaches overlaps with some but by no means all of the functionality provided by Param, as described below. Also see the comparisons provided with attrs and by an attr user, which were written about
attrs but also apply just as well to Param (with Param differing in also providing e.g. GUI support as listed below).
Here we will use the word “parameter” as a generic term for a Python attribute, a Param Parameter, a Traitlets/HasTraits trait, or an attr
Brevity of code¶
Python properties can be used to express nearly anything Param or Traitlets can do, but they require at least an order of magnitude more code to do it. You can think of Param and Traitlets as a pre-written implementation of a Python property that implements a configurable parameter. Avoiding having to write that code each time is a big win, because configurable parameters are all over any Python codebase, and Parameter/attr.ib/Traits-based approaches lead to much simpler and more maintainable codebases.
Specifically, where Param or Traitlets can express an automatically validated type and bounds on an attribute in a simple and localized one-line declaration like
a = param.Integer(5, bounds=(1,10)), implementing the same functionality using properties requires changes to the constructor plus separate explicit
set methods, each with at least a half-dozen lines of validation code. Though this get/set/validate code may seem easy to write, it is difficult to read, difficult to maintain, and difficult to make comprehensive or exhaustive.
In practice, most programmers simply skip validation or implement it only partially, leaving their code behaving in undefined ways for unexpected inputs. With Param or Traitlets, you don’t have to choose between short/readable/maintainable code and heavily validated code; you can have both for far less work!
attrs provides many of these same benefits, though with type and bounds validation treated as an extra step that is more general but also typically much more verbose.
Python 3 type annotations allow users to specify types for attributes and function returns, but these types are not normally checked at runtime, and so they do not have the same role of validating user input or programmer error as the type declarations in Params, Traits, Traitlets, and attr. They also are limited to the type, so they cannot enforce constraints on range (‘state’ must be in the list [‘Alabama’, ‘Alaska’,…]). Thus even if type hinting is used, programmers still need to write code to actually validate the inputs to functions and methods, which is the role of packages like Param and Traitlets.
Generality and ease of integration with your project¶
The various Python features listed above are part of the standard library with the versions indicated above, and so do not add any dependencies at all to your build process, as long as you restrict yourself to the Python versions where that support was added.
Param, Traitlets, and attrs are all pure Python projects, with minimal dependencies, and so adding them to any project is generally straightforward. They also support a wide range of Python versions, making them usable in cases where the more recent Python-language features are not available.
Django models offer some of the same ways to declare parameters and generate web-based GUIs (below), but require the extensive Django web framework and normally rely on a database and web server, which in practice limit their usage to users building dedicated web sites, unlike the no-dependency Param and attrs libraries that can be added to Python projects of any type.
Traits is a very heavyweight solution, requiring installation and C compilation of a large suite of tools, which makes it difficult to include in separate projects.
Several of these packages support automatically mapping parameters/traits/attributes into GUI widgets. Although any of them could in principle be supported for any GUI toolkit, only certain GUI interfaces are currently available:
Panel: Jupyter and Bokeh-server support for Param
ParamTk: (unsupported) TKinter support for Param
IPywidgets: Jupyter support for Traitlets
TraitsUI: wxWidgets and Qt support for Traits
Param, Traits, Traitlets, and attrs all allow any Python expression to be supplied for initializing parameters, allowing parameter default values to be computed at the time a module is first loaded. Traits and Traitlets also allow a class author to add code for a given parameter to compute a default value on first access.
>>> from time import time >>> import traitlets as tr >>> class A(tr.HasTraits): ... instantiation_time = tr.Float() ... @tr.default('instantiation_time') ... def _look_up_time(self): ... return time() ... >>> a=A() >>> a.instantiation_time 1475587151.967874 >>> a.instantiation_time 1475587151.967874 >>> b=A() >>> b.instantiation_time 1475587164.750875
Param does not currently provide any special support for programmatic default values, which would need to be set explicitly in the Parameterized object’s constructor. On the other hand, Param does allow fully dynamic values for any numeric Parameter instance:
>>> from time import time >>> import param >>> class A(param.Parameterized): ... val=param.Number(0) ... >>> a=A() >>> a.val 0 >>> a.val=lambda:time() >>> a.val 1475587455.437027 >>> a.val 1475587456.501314