herolib_python

see also ~/code/git.ourworld.tf/tfgrid_research/tfdev has some usefull stuff as well

Installation

You can install herolib directly from the Git repository using uv pip:

uv pip install git+https://git.ourworld.tf/herocode/herolib_python.git

To install in editable mode for development:

uv pip install -e git+https://git.ourworld.tf/herocode/herolib_python.git#egg=herolib

Usage

Once installed, you can import modules from the herolib package:

import herolib.core.loghandler.mylogging
# Or import specific functions/classes
from herolib.core.loghandler.mylogging import MyLogger

how to integrate python in other projects

see Python Herolib Integration

Version Control

This library follows standard Git version control practices. Releases can be managed by tagging specific commits in the Git repository. Users installing directly from the Git URL can specify a particular branch, tag, or commit hash to get a specific version. For example:

# Install from a specific branch
uv pip install git+https://git.ourworld.tf/herocode/herolib_python.git@main

# Install from a specific tag (e.g., v0.1.0)
uv pip install git+https://git.ourworld.tf/herocode/herolib_python.git@v0.1.0

# Install from a specific commit hash
uv pip install git+https://git.ourworld.tf/herocode/herolib_python.git@<commit_hash>

Adding as a Dependency in pyproject.toml

To include herolib as a dependency in another Python project that uses pyproject.toml, you can add it to the dependencies section of your project's pyproject.toml file. This is particularly useful for development or when you need to pin to a specific version or branch.

Example pyproject.toml for another project:

[project]
name = "my-other-project"
version = "0.1.0"
dependencies = [
    "herolib @ git+https://git.ourworld.tf/herocode/herolib_python.git",
]