Skip to main content

General purpose utility library

Project description


This is a library of general purpose utility functions and classes written in Python. Much of this code is intended to support the imprint project The modules of this library are more-or-less standalone utilities, organized by category.

This library contains plenty of code that relies on external programs and less common Pyhon libraries. The code is considered to be "extras", in the setuptools sense. Extras can be omitted without any modification to the python code. The following extras are supported:

  • [docx]: Support for docx file utilities requires python-docx to be installed.
  • [latex]: Supporting LaTeX requires a host of external programs to work properly, so this feature is optional. See the dependency page in the main documentation for more information.
  • [pdf]: Requires the poppler library to be installed.
  • [ps]: Requires GhostScript to be installed.
  • [plot]: Plotting tools require matplotlib, which is a heavy dependency, and unnecessary for many purposes.
  • [term]: Terminal colors work out of the box on Linux, but require the colorama library to work on Windows.
  • [scio]: Science I/O depends on the scipy and astropy libraries to deliver IDL and FITS file support, respectively.
  • [xlsx]: Support for xlsx file utilities requires openpyxl to be installed.

To install extras such as latex and pdf, do::

pip install haggis[latex,pdf]

See the documentation at for more information, including the API documentation.

This library in licensed under the AGPLv3, and compatible with later versions. You should have received a copy of the GNU Affero General Public License along with this program. If not, see


0.3.0 (2022-03-29)

  • New functions and classes:
    • load.load_module no longer nested in load.module_as_dict
    • npy_util.iterate_dtype
  • Bugfixes:
    • files.PreOpenedFile object is now properly iterable
  • New unit tests:
    • tests.test_load.TestLoadModule
    • tests.test_load.TestModuleAsDict

0.2.0 (2022-01-27)

  • New modules:
    • npy_util
    • tests.test_numbers
    • tests.test_objects
  • New functions and classes:
    • getsizeof, size_type_mapping in objects
    • ndarray_handler added to size_type_mapping in objects
    • isolate_dtype in npy_util
    • as_base, digit_count in numbers
  • New unit tests:
    • tests.test_objects.TestGetsizeof
    • tests.test_numbers.TestAsBase
    • tests.test_numbers.TestDigitCount
  • Added docs to sdist
  • Moved map_array, mask2runs, runs2mask from math to npy_util

0.1.1 (2022-01-16)

Minor updates to first release.

  • New functions and classes:
    • segment_distance in math
  • Bugfixes:
    • math.read_divide correctly handles scalar inputs
  • Created pytest configuration, added first set of unit tests
    • files.tests.test_csv
    • tests.test_math.TestSegmentDistance
  • Improved documentation with autosummary
  • Added this CHANGELOG to installed data

0.1 (2022-01-10)

First release.

  • New modules
    • time
    • files.ui
  • New functions and classes:
    • json_registry made public in configuration
    • semilogx_base, semilogy_base, loglog_base in mpl_util
    • map_array, rms in math
    • split_extension in files
  • API changes:
    • string_util.timestamp moved to time
    • Added mask2runs and runs2mask to math
    • Improvements to NumpyObject in configuration
    • Improvements to copy_func in objects
    • Added n argument to insert_suffix in files
  • Bufixes:
    • mpl_util.show_extents axis confusion
    • Broken imports in submodules
  • Officially supporting Python versions up to 3.10
  • README -> so GitHub can pick it up

0.1a2 (2021-01-09)

Second alpha release.

  • Major additions to API
  • New modules:
    • threads
    • configuration
    • structures
    • mapping
    • ctypes_util
  • New functions and classes:
    • CloseableMixin in recipes
    • to_hex, camel2snake, snake2camel, timestamp in string_util
    • set_labels in mpl_utils
    • real_divide, threshold, ang_diff_* in math
  • API changes:
    • Moved half of recipes to mapping
    • Updated Namespace, (in mapping), added setdefaults

0.1a1 (2021-04-03)

First alpha release.

  • API changes:
    • SentinelType made public in root package
    • ensure_extension.modes renamed to ensure_exntension.policies in files

0.1a1.dev2 (2019-03-31)

Second development pre-release.

  • Major overhaul of documentation

0.1a1.dev1 (2019-03-20)

First development pre-release.

  • First release on PyPI.
  • Created Read the Docs pages.
  • Only code required for imprint present initially.
  • Documentation 90% complete.
  • No tests worth speaking of.

Download files

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

Source Distribution

haggis-0.3.0.tar.gz (149.1 kB view hashes)

Uploaded source

Built Distribution

haggis-0.3.0-py3-none-any.whl (186.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page