Tum-esm-utils

🦚  New Features

* **`column.astronomy` module:** Convenience function for astronomical calculations
* **`column.ncep_profiles` module:** Loading GGG2020 atmospheric profiles into polars dataframes
* **`column.averaging_kernel` module:** Functions to store, load and apply a column averaging kernel.

Use the new `column` module by installing `tum_esm_utils[modeling]`.

🦚  New Features

* **`opus.OpusHTTPInterface` class**
Communicate with OPUS using its HTTP interface (see [docs](https://tum-esm-utils.netlify.app/example-usage#opus-http-interface) and [API Reference](https://tum-esm-utils.netlify.app/api-reference#opushttpinterface-objects))

🐜  Internal Changes

* Fix bug when only reading the first channel from OPUS files
* Refine pytests: add test groups, make tests run when `.git` folder is not present
* Add repository to Zenodo

🦚  New Features

* **`opus` Module**
Read OPUS files. Credits to FriedrichKlappenbach for decoding the OPUS file structure.

🐜  Internal Changes

* Switch from YAPF to RUFF formatting (easier to configure and better maintained)
* Rename `polars` dependency group to `em27`. The old name will be kept as an alias until the next breaking release (`3.0.0`)

🦚  New Features

* **`timing.ExponentialBackoff`**
Add class to exponentially increase the waiting time after an error
[see in docs](https://tum-esm-utils.netlify.app/example-usage#exponential-backoff)

* **`StricterBaseModel`, `StrictIPv4Adress`**
More specialized Pydantic base classes
[see in docs](https://tum-esm-utils.netlify.app/api-reference#stricterbasemodel-objects)

* **`timing.date_span_intersection`, `timing.datetime_span_intersection`**
Functions to compute the overlap of two date/datetime periods
[see in docs](https://tum-esm-utils.netlify.app/api-reference#datetime_span_intersection)

🦀  Dependency Updates

* Explicitly add Python 3.13 support (tests, PyPI package)

🦚  New Features

* **`em27.PROFFAST_MULTIPLIERS`, `em27. PROFFAST_UNITS`, ...**
Add EM27/SUN constants for instrument colors, serial numbers, data units, etc.
[see in docs](https://tum-esm-utils.netlify.app/api-reference#tum_esm_utilsem27)

* **`plotting.add_colorpatch_legend`**
A function to add a "Colorpatch Legend" to a plot
[see in docs](https://tum-esm-utils.netlify.app/api-reference#add_colorpatch_legend)

* **`RandomLabelGenerator`**
Generate random names - like Docker container names `curious-einstein`, `wild-picard` and so on
[see in docs](https://tum-esm-utils.netlify.app/api-reference#randomlabelgenerator-objects)

* **`tum_esm_utils.timing.parse_iso_8601_datetime`**
Added because `datetime.datetime.fromisoformat` does not support all ISO 8601 timezone variants
[see in docs](https://tum-esm-utils.netlify.app/api-reference#parse_iso_8601_datetime)

* **`tum_esm_utils.files.list_directory`**
Adds more options the `os.listdir` method - only include directories/files, filter by regex, ignore by Unix shell patterns
[see in docs](https://tum-esm-utils.netlify.app/api-reference#list_directory)

* **`tum_esm_utils.files.render_directory_tree`**
Render a directory tree as a string
[see in docs](https://tum-esm-utils.netlify.app/api-reference#render_directory_tree)

* **`tum_esm_utils.text.simplify_string_characters`**
Simplify a string by replacing special characters with their ASCII counterparts and removing unwanted characters with. For example, simplify_string_characters("Héllo, wörld!") will return "hello-woerld".
[see in docs](https://tum-esm-utils.netlify.app/api-reference#simplify_string_characters)

* **`tum_esm_utils.text.replace_consecutive_characters`**
Remove consecutive whitespaces or other characters with `tum_esm_utils.text.replace_consecutive_characters`
[see in docs](https://tum-esm-utils.netlify.app/api-reference#replace_consecutive_characters)

🦀  Dependency Updates

* Upgrade minimum Python version to 3.10. This follows [SPEC 0 — Minimum Supported Dependencies](https://scientific-python.org/specs/spec-0000/) recommendations.

Upgrade Numpy (v1 to v2) and Polars (v0 to v1).

Add `Version` validator (19).