redmine-reporter/README.md

redmine-reporter

Internal tool to generate Redmine issue reports based on your time entries.

Features

• Secure credential handling via environment variables
• Compact or fancy table output
• Grouping by project and version
• Status translation to Russian
• CLI with intuitive arguments

Installation

git clone https://your-gitea/redmine-reporter.git
cd redmine-reporter
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Configuration

Create .env (not committed!):

REDMINE_URL=https://red.eltex.loc/
REDMINE_USER=artem.kokos
REDMINE_PASSWORD=your_password_here

Or export in shell:

export REDMINE_URL=https://red.eltex.loc/
export REDMINE_USER=artem.kokos
export REDMINE_PASSWORD=...

Usage

# Default date range
redmine-reporter

# Custom date range
redmine-reporter --date 2025-12-01--2026-01-31

# Compact mode
redmine-reporter --compact

Development

pip install -e ".[dev]"
pytest
black .
isort .

🔒 Never commit .env or credentials!

Production SSL Setup (for internal Redmine)

If you get CERTIFICATE_VERIFY_FAILED, your corporate CA is not trusted by Python's certifi.

Fix it once per environment:

source .venv/bin/activate
cat /etc/ssl/certs/ca-certificates.crt >> $(python -m certifi)

This appends system CA bundle to Python's certificate store. Safe and secure.