ruf-common

Overview

A collection of Python utility modules for common tasks including file operations, data format conversions, database interactions, and more.

Feedback welcome via GitHub issues. While I will try to address issues in a timely manner, I only intend to invest in feature requests that align with my project work. Feel free to contribute backward compatible enhancements.

Installation

pip install ruf-common

Usage

# Import the entire library
from ruf_common import *

# Or import specific modules
from ruf_common import data, helper, lfs # etc.

Modules

The following modules are available:

• country_code_converter: Functions for converting between country code formats
• data: Functions for managing and manipulating XML, JSON and YAML content
• database: Functions for interacting with a database. These functions operate the same for all supported databases
• helper: Various helper functions
• html_to_markdown: Functions for converting HTML content to Markdown
• lfs: Functions for interacting with the local file system (LFS)
• logging: Logging configuration and utilities
• network: Functions for network operations
• stats: Statistical helper functions
• timezone_lookup: Functions for timezone lookups based on location
• xml_formatter: Functions for formatting XML content

License

MIT

Use of AI for Creating/Maintaining This Library

No portion of this library was "vibe coded".

Early versions of this library were written entirely without the use of AI tools.

Claude/Claude Code and GitHub Co-pilot have been used in a manner similar to pair-programming. This includes:

• improving alignment with "pythonic" best practices
• targeted code reviews
• resolving linter issues
• aiding in debugging and testing
• drafting individual functions/methods that I refine and test
• drafting portions of documentation
• drafting unit tests