When should I use tomlkit instead of Python's built-in tomllib?

You should use tomlkit when you need to write or modify TOML files while preserving comments and formatting. Use tomllib only when you need read-only access in Python 3.11+ and want to avoid external dependencies.

Can I use this for XDG-compliant configuration management?

Yes, the skill includes integration patterns for the XDG Base Directory specification to ensure your Python application stores configuration in the standard user directories.

How does the skill handle atomic updates?

It provides a robust pattern that writes changes to a temporary file before moving it to the final destination, preventing configuration corruption if a write process is interrupted.

Does this skill help with pyproject.toml files?

Yes, it provides specific patterns and best practices for reading and writing pyproject.toml files, ensuring that the tool-specific configurations and comments remain intact.

TOML Python Integration

Name: TOML Python Integration
Author: Jamie-BitFlight

byJamie-BitFlight

•

開発者ツール

Manages TOML configuration files in Python projects while preserving comments, formatting, and structural integrity.

概要

This skill provides expert guidance for working with TOML files in Python, focusing on the use of the tomlkit library for comment-preserving read-modify-write cycles and tomllib for high-performance read-only access. It equips Claude with the patterns necessary to handle complex configuration tasks, including atomic updates, XDG-compliant file locations, and the programmatic creation of tables and arrays, ensuring that developer-authored comments and formatting are never lost during automated edits.

主な機能

Preserves comments and formatting during TOML write operations
Support for XDG Base Directory specification compliance
Implementation patterns for atomic configuration file updates
Handling of complex TOML structures like nested tables and arrays
Expert selection between tomlkit and native tomllib libraries
10 GitHub stars

ユースケース

Building CLI tools that manage user-editable configuration files
Modifying pyproject.toml files without losing manual developer comments
Implementing safe, atomic updates to application settings to prevent corruption

概要

主な機能

Preserves comments and formatting during TOML write operations
Support for XDG Base Directory specification compliance
Implementation patterns for atomic configuration file updates
Handling of complex TOML structures like nested tables and arrays
Expert selection between tomlkit and native tomllib libraries
10 GitHub stars

ユースケース

Building CLI tools that manage user-editable configuration files
Modifying pyproject.toml files without losing manual developer comments
Implementing safe, atomic updates to application settings to prevent corruption