Skip to main content

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

Project description

Sourcecode on GitHub Sourcecode License Documentation Documentation License
PyPI PyPI - Status PyPI - Python Version
GitHub Workflow - Build and Test Status Libraries.io status for latest release Codacy - Quality Codacy - Coverage Codecov - Branch Coverage

GitHub Workflow Status (with branch)

pyTooling

pyTooling is a powerful collection of arbitrary useful abstract data models, classes, decorators, meta-classes and exceptions. It also provides lots of helper functions e.g. to ease the handling of package descriptions.

It's useful for any Python-base project independent if it's a library, framework or CLI tool.

Introduction

pyTooling is a basic collection of powerful helpers needed by almost any Python project. More specialized helpers can be found in sub-namespaces like:

In addition, pyTooling provides a collection of CI job templates for GitHub Actions. This drastically simplifies GHA-based CI pipelines for Python projects.

Package Details

Common Helper Functions

This is a set of useful helper functions:

  • getsizeof calculates the "real" size of a data structure.
  • isnestedclass checks if a class is nested inside another class.
  • mergedicts merges multiple dictionaries into a new dictionary.
  • zipdicts iterate multiple dictionaries simultaneously.

Common Classes

  • Python doesn't provide call-by-reference parameters for simple types. This behavior can be emulated with classes provided by the pyTooling.CallByRef module.
  • Setuptools, PyPI, and others have a varying understanding of license names. The pyTooling.Licensing module provides unified license names as well as license name mappings or translations.
  • Python has many ways in figuring out the current platform using APIs from sys, platform, os, …. Unfortunately, none of the provided standard APIs offers a comprehensive answer. pyTooling provides a unified platform and environment description by summarizing multiple platform APIs into a single class instance.
  • While Python itself has a good versioning schema, there are no classes provided to abstract version numbers. pyTooling provides such a representations of version numbers following semantic versioning (SemVer) and calendar versioning (CalVer) schemes. It's provided by the pyTooling.Versioning module.

Configuration

Various file formats suitable for configuration information share the same features supporting: key-value pairs (dictionaries), sequences (lists), and simple types like string, integer and float. pyTooling provides an abstract configuration file data model supporting these features. Moreover, concrete configuration file format reader implementations are provided as well.

Data Structures

pyTooling also provides fast and powerful data structures offering object-oriented APIs:

Decorators

  • Abstract Methods
    • Methods marked with abstractmethod are abstract and need to be overwritten in a derived class.
      An abstract method might be called from the overwriting method.
    • Methods marked with mustoverride are abstract and need to be overridden in a derived class.
      It's not allowed to call a mustoverride method.
  • Documentation
    • Copy the doc-string from given base-class via InheritDocString.
  • Visibility
    • Register the given function or class as publicly accessible in a module via export.
  • Documentation
  • Visibility
    • @export
      → Register the given function or class as publicly accessible in a module.

Exceptions

Meta-Classes

pyTooling provides an enhanced meta-class called ExtendedType. This meta-classes allows to implement abstract methods, singletons, slotted types and combinations thereof.

class MyClass(metaclass=ExtendedType): A class definition using that meta-class can implement abstract methods using decorators @abstractmethod or @mustoverride.

class MyClass(metaclass=ExtendedType, singleton=True): A class defined with enabled singleton behavior allows only a single instance of that class to exist. If another instance is going to be created, a previously cached instance of that class will be returned.

class MyClass(metaclass=ExtendedType, useSlots=True): A class defined with enabled useSlots behavior stores instance fields in slots. The meta-class, translates all type-annotated fields in a class definition into slots. Slots allow a more efficient field storage and access compared to dynamically stored and accessed fields hosted by __dict__. This improves the memory footprint as well as the field access performance of all class instances. This behavior is automatically inherited to all derived classes.

class MyClass(ObjectWithSlots): A class definition deriving from ObjectWithSlots will bring the slotted type behavior to that class and all derived classes.

Packaging

A set of helper functions to describe a Python package for setuptools.

  • Helper Functions:
    • loadReadmeFile
      Load a README.md file from disk and provide the content as long description for setuptools.
    • loadRequirementsFile
      Load a requirements.txt file from disk and provide the content for setuptools.
    • extractVersionInformation
      Extract version information from Python source files and provide the data to setuptools.
  • Package Descriptions
    • DescribePythonPackage
      tbd
    • DescribePythonPackageHostedOnGitHub
      tbd

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

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

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

pyTooling-2.13.0.tar.gz (61.4 kB view hashes)

Uploaded Source

Built Distribution

pyTooling-2.13.0-py3-none-any.whl (70.3 kB view hashes)

Uploaded Python 3

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