Registry / data / feather-format

feather-format

library0.4.1pypypi✓ verified 85d ago

Simple wrapper library to the Apache Arrow-based Feather File Format. Current version 0.4.1. Development is in maintenance mode; users are encouraged to use pyarrow directly.

data serialization

pip install feather-format

github ↗package ↗

INSTALL

IMPORT

SIG · FEATHER-FORMAT

feather-format

datapythonv0.4.1

Install

4.2s avg

Import

116ms

Disk

178MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.4.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.124s · 194.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.2s · import 0.108s · 170MB

178MB installed

● package 178MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

read_dataframe

✓ from feather import read_dataframe

✗ import feather; feather.read_dataframe(...)

Legacy API was feather.read_dataframe; the recommended import is from feather import read_dataframe to avoid namespace confusion.

write_dataframe

✓ from feather import write_dataframe

✗ import feather; feather.write_dataframe(...)

Same as read_dataframe.

Write and read a Feather file using feather-format.

import pandas as pd from feather import read_dataframe, write_dataframe df = pd.DataFrame({'x': [1,2,3], 'y': ['a','b','c']}) write_dataframe(df, 'test.feather') df2 = read_dataframe('test.feather') print(df2)

Debug

Known issues

deprecatedFeather-format (library) is deprecated; use pyarrow.feather directly. Development moved to Apache Arrow.

fix

Replace `from feather import read_dataframe` with `from pyarrow.feather import read_feather` and adjust function names accordingly.

affects: >=0.4.0

breakingVersion 0.4.0 switched from a custom C++ implementation to pyarrow-based backend. Backward compatibility with files written by older versions is maintained but the API changed slightly.

fix

Ensure you use the new API (`from feather import read_dataframe`). Old `feather.read_dataframe` still works but is less explicit.

affects: 0.4.0+

gotchaThe feather-format library from PyPI is NOT the same as the 'feather' R package or the 'feather' specification. Use pyarrow for updated features.

fix

Use `pip install pyarrow` and import from `pyarrow.feather` for the latest Feather format support.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'feather'

You installed `feather` (a different, unrelated package) instead of `feather-format`.

fix

Run `pip uninstall feather` then `pip install feather-format` or `pip install pyarrow`.

AttributeError: module 'feather' has no attribute 'read_dataframe'

Common name collision: `import feather` often imports the wrong `feather` package (an IRC bot library) instead of feather-format.

fix

Use explicit import: `from feather import read_dataframe` ensures you get the right module.

feather.libfeather.FeatherError: Unsupported Feather version

The file was written by a newer Feather specification (V2) that feather-format cannot read. feather-format only supports V1.

fix

Use pyarrow.feather.read_feather to read modern Feather files: `pip install pyarrow` then `from pyarrow.feather import read_feather`.

Upgrade

Version history

0.4.1latest on PyPI · released Apr 27, 2020

Audit

Dependencies

pyarrowrequiredCore dependency for reading/writing Feather files

Agent activity

12 hits · last 30 days

node

Resources

githubhttp://github.com/wesm/feather ↗

packagehttps://pypi.org/project/feather-format/ ↗