---
id: triad
version: "1.0.2"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# triad — A collection of python utils for Fugue projects

License: permissive · Maintenance: active · Downloads: 2.4M/mo

## What it is and what it does

Triad is a collection of utility functions built to support Fugue projects, with a focus on bridging pandas and PyArrow operations. It provides schema handling, type conversion, dataframe manipulation helpers, and filesystem abstraction through fsspec. The package handles compatibility across pandas and PyArrow versions, including recent changes in pandas 2.2+ and PyArrow type systems.

The package is maintained actively and supports modern Python versions (3.9 through 3.14). Its main dependencies are numpy, pandas, six, pyarrow, and fsspec, making it suitable for data processing workflows that need reliable type casting and schema validation across different dataframe libraries.

Use it for:

- Convert between pandas and PyArrow data types while maintaining schema consistency in data pipelines.
- Enforce type safety on dataframes during ETL operations within Fugue workflows.
- Abstract filesystem operations across local and remote storage using fsspec integration.
- Parse and manipulate schema definitions for structured data validation.
- Handle pandas and PyArrow compatibility issues across version upgrades.

## Worth the install?

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

Triad provides utility functions for working with pandas, PyArrow, and schemas, designed to support Fugue projects with type conversion, dataframe manipulation, and filesystem operations.

Yes. Triad is actively maintained, has no known vulnerabilities, uses a permissive Apache-2.0 license, and installs with low friction. It is well-suited for projects using Fugue or those needing reliable pandas/PyArrow interoperability and type utilities. The recent version history shows ongoing compatibility work with current Python and library versions.

## Install

pip install triad
uv add triad
poetry add triad

## Installing triad

Before you install: Low install friction with a pure-Python wheel. Actively maintained with recent releases supporting current Python versions (3.9–3.14) and recent pandas/PyArrow compatibility updates.

License in practice: Apache-2.0 permissive license allows commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install triad

import triad
from triad.utils.pandas_like import PandasLikeUtils

# Example: type enforcement on a pandas DataFrame
df = PandasLikeUtils.enforce_type(df, schema)

Requires Python 3.9 or later; depends on numpy, pandas, pyarrow, six, and fsspec at runtime.

Verify before relying:

- Specific utility functions available in the public API beyond type conversion and schema handling.
- Performance characteristics or scale limits for large dataframes or PyArrow tables.
- Integration patterns with Fugue beyond being a utility dependency.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 2.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pandas pyarrow utilities, schema type conversion, dataframe utilities, fugue project tools, type casting helpers, filesystem abstraction, data transformation utils, data-processing, type-conversion, fugue-ecosystem

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