pandas-config

A simple utility to load pandas configurations from INI files.

Description

This package provides an elegant solution for managing pandas options through INI configuration files. It allows you to easily define and load different pandas configurations without modifying the source code (at least for the options accepting literal values).

Installation

To install the required dependencies:

Using uv:

uv add pandas-config

Using pip:

pip install pandas-config

Usage

The main module pandas.configfile contains a load() function that loads pandas configurations from an INI file.

Basic Example

1. Create a .pandas.ini configuration file in your current directory:

[display]
width = 200
max_colwidth = 25
max_columns = 20
min_rows = 20
precision = 3

[display.html]
border = 4

2. Load the configuration in your code:

from pandas.configfile import load

# Load configuration from default .pandas.ini file
load()

# Or specify a custom path
load("path/to/config.ini")

Parameters

• path (optional): Path to the configuration file. Default: .pandas.ini
• encoding (optional): File encoding. Default: utf-8

Configuration File Structure

The configuration file must follow the standard INI format:

• Sections define pandas option groups (e.g., [display])
• Values must be valid Python literals
• Subsections use dot as separator (e.g., [display.html])

See the Pandas documentation for more details.

Dependencies

• pandas
• Python 3.10+

Notes

• Values in the configuration file must be valid Python literals (evaluated using ast.literal_eval())
• The default configuration file is .pandas.ini in the current directory
• If no file is found at the specified location, no error will be raised and the default configuration will be used

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.