pyTooling 1.5.0

pyTooling is a powerful collection of arbitrary useful classes, decorators, meta-classes and exceptions.

pyTooling

pyTooling is a powerful collection of arbitrary useful classes, decorators, meta-classes and exceptions. It's useful for any Python-base project independent if it's a library, framework or CLI tool.

Introduction

TODO

Package Details

Common Classes

• pyTooling.CallByRef.*
  Emulation of call-by-reference parameters.
• pyTooling.Versioning.*
  Class representations of semantic version (SemVer) and calendar version (CalVer) numbers.

Decorators

• export
  Register the given function or class as publicly accessible in a module.

Exceptions

• EnvironmentException
  ... is raised when an expected environment variable is missing.
• PlatformNotSupportedException
  ... is raise if the platform is not supported.
• NotConfiguredException
  ... is raise if the requested setting is not configured.

Meta-Classes

• Singleton
  Allow only a single instance of a class.
• Overloading
  Overloading Allow method overloading in Python classes. Dispatch method calls based on method signatures (type annotations).

Examples

@export Decorator

from pyTooling.Decorators import export 

@export
class MyClass:
  pass

CallByRefIntParam

from pyTooling.CallByRef import CallByRefIntParam

# define a call-by-reference parameter for integer values
myInt = CallByRefIntParam(3)

# a function using a call-by-reference parameter
def func(param : CallByRefIntParam):
  param <<= param * 4

# call the function and pass the wrapper object
func(myInt)

print(myInt.value)

Contributors

• Patrick Lehmann (Maintainer)
• and more...

License

This Python package (source code) licensed under Apache License 2.0.
The accompanying documentation is licensed under Creative Commons - Attribution 4.0 (CC-BY 4.0).

---

SPDX-License-Identifier: Apache-2.0