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

Development Status
- 5 - Production/Stable
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
- Python :: 3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ruf_common-2.2.0.tar.gz (36.9 kB view details)

Uploaded Jul 12, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ruf_common-2.2.0-py3-none-any.whl (40.4 kB view details)

Uploaded Jul 12, 2026 Python 3

File details

Details for the file ruf_common-2.2.0.tar.gz.

File metadata

Download URL: ruf_common-2.2.0.tar.gz
Upload date: Jul 12, 2026
Size: 36.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ruf_common-2.2.0.tar.gz
Algorithm	Hash digest
SHA256	`370a700ab0b58f03c6a87febefb49dacbee54db2928f002931253c44df836640`
MD5	`f3c7e42478c7592fec104cab7fdb86f0`
BLAKE2b-256	`d8d2afa126fc5520bc4a3fcefadb136a24844d8ee7af91fd02480a2644e78bbc`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ruf_common-2.2.0.tar.gz:

Publisher: publish.yml on brian-ruf/ruf-common-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ruf_common-2.2.0.tar.gz
- Subject digest: 370a700ab0b58f03c6a87febefb49dacbee54db2928f002931253c44df836640
- Sigstore transparency entry: 2148108785
- Sigstore integration time: Jul 12, 2026
Source repository:
- Permalink: brian-ruf/ruf-common-python@714c267912b8b8bc57cfebd5c12a6dbc41023a12
- Branch / Tag: refs/tags/v2.2.0
- Owner: https://github.com/brian-ruf
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@714c267912b8b8bc57cfebd5c12a6dbc41023a12
- Trigger Event: release