---
id: jaraco-logging
version: "3.4.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# jaraco.logging — Support for Python logging facility

License: permissive · Maintenance: active · Downloads: 147.6K/mo

## What it is and what it does

jaraco.logging is a small utility that bridges Python's argparse and logging modules. It provides two main functions: add_arguments() to inject logging-related command-line flags into an ArgumentParser, and setup() to apply those parsed arguments to configure the logging system. This eliminates boilerplate when you want users to control log levels or other logging behavior from the command line.

The package depends only on tempora and requires Python 3.9 or later. It's maintained actively and carries no known security vulnerabilities. The MIT license places no restrictions on use. It's best suited for CLI applications where you want to expose logging configuration to end users without writing repetitive argument-parsing code yourself.

Use it for:

- Add log-level control to a CLI tool without manually defining argparse arguments for logging.
- Quickly prototype a command-line application that needs adjustable verbosity from the start.
- Integrate logging configuration into an existing argparse-based CLI with minimal code changes.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds command-line argument parsing for Python logging configuration, letting you quickly set log levels and other logging parameters from the command line.

Yes, if you're building a command-line tool and want to let users control logging verbosity without writing boilerplate. The package is lightweight, actively maintained, permissively licensed, and has no security issues. Install it if you use argparse and logging together; skip it if your CLI doesn't expose logging control to users.

## Install

pip install jaraco-logging
uv add jaraco-logging
poetry add jaraco-logging

## Installing jaraco.logging

Before you install: Low friction install with a single runtime dependency (tempora). Active maintenance as of April 2026, marked Production/Stable since early releases.

License in practice: MIT license permits commercial and private use with minimal restrictions—standard permissive terms.

Quickstart:

import argparse
import jaraco.logging

parser = argparse.ArgumentParser()
jaraco.logging.add_arguments(parser)
args = parser.parse_args()
jaraco.logging.setup(args)

Requires Python 3.9 or later.

Verify before relying:

- Whether the package supports log format customization beyond level selection via command-line arguments.
- Whether it integrates with standard Python logging handlers or only the root logger.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 147.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

command line logging setup, argparse logging integration, log level from cli, logging configuration parser, command-line log control, cli-logging, argparse-helper

[View on SkillFed](https://skillfed.io/packages/jaraco-logging) · [View on PyPI](https://pypi.org/project/jaraco-logging/)