Common

A collection of personal utility functions reused across multiple repositories.

Requires Python >= 3.12.

Features

• Regular expression helpers (re)
• Plotting utilities built on Matplotlib (plot)
• Date formatting utilities (dates)
• HDF5 file handling (hdf5)
• YAML configuration loading (yaml_utils)
• PNG-to-video conversion (png_to_video)
• Array manipulation (array_manipulation)
• Pandas helpers (pandas)
• SPICE and STEREO data utilities (spice, stereo)
• Server connection helpers (server_connection)
• Personal decorators (decorators)
• Path management (main_paths)
• Package-specific type annotations (typing)

Installation

git clone https://github.com/voyeuxalfred/common.git
cd common

Create a Python virtual environment (Recommended)

Using python venv (traditional):

Linux and macOS:

python3 -m venv .venv
source .venv/bin/activate

Windows:

python3 -m venv .venv
.venv\Scripts\activate

Using uv venv (recommended):

Linux and macOS:

uv venv
source .venv/bin/activate

Windows:

uv venv
.venv\Scripts\activate

Install

Using pip (traditional):

pip install .

Using uv (recommended):

uv pip install .

Using uv with sync:

uv sync

Usage

import common

License

This project is licensed under the MIT License — see the LICENSE file for details.