Python interface to the Apache Arrow-based Feather File Format
Project description
## Python interface to the Apache Arrow-based Feather File Format
Feather efficiently stores pandas DataFrame objects on disk.
## Build
Building Feather requires a C++11 compiler. We've simplified the PyPI packaging
to include libfeather (the C++ core library) to be built statically as part of
the Python extension build, but this may change in the future.
### Static builds for easier packaging
At the moment, the libfeather sources are being built and linked with the
Cython extension, rather than building the `libfeather` shared library and
linking to that.
While we continue to do this, building from source requires you to symlink (or
copy) the C++ sources. See:
```shell
# Symlink the C++ library for the static build
ln -s ../cpp/src src
python setup.py build
# To install it locally
python setup.py install
# Source distribution
python setup.py sdist
```
To change this and instead link to an installed `libfeather.so`, look in
`setup.py` and make the following change:
```python
FEATHER_STATIC_BUILD = False
```
## Limitations
Some features of pandas are not supported in Feather:
* Non-string column names
* Row indexes
* Object-type columns with non-homogeneous data
## Mac notes
Anaconda uses a default 10.5 deployment target which does not have C++11
properly available. This can be fixed by setting:
```
export MACOSX_DEPLOYMENT_TARGET=10.10
```
Feather efficiently stores pandas DataFrame objects on disk.
## Build
Building Feather requires a C++11 compiler. We've simplified the PyPI packaging
to include libfeather (the C++ core library) to be built statically as part of
the Python extension build, but this may change in the future.
### Static builds for easier packaging
At the moment, the libfeather sources are being built and linked with the
Cython extension, rather than building the `libfeather` shared library and
linking to that.
While we continue to do this, building from source requires you to symlink (or
copy) the C++ sources. See:
```shell
# Symlink the C++ library for the static build
ln -s ../cpp/src src
python setup.py build
# To install it locally
python setup.py install
# Source distribution
python setup.py sdist
```
To change this and instead link to an installed `libfeather.so`, look in
`setup.py` and make the following change:
```python
FEATHER_STATIC_BUILD = False
```
## Limitations
Some features of pandas are not supported in Feather:
* Non-string column names
* Row indexes
* Object-type columns with non-homogeneous data
## Mac notes
Anaconda uses a default 10.5 deployment target which does not have C++11
properly available. This can be fixed by setting:
```
export MACOSX_DEPLOYMENT_TARGET=10.10
```
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
feather-format-0.1.2.tar.gz
(99.2 kB
view details)
File details
Details for the file feather-format-0.1.2.tar.gz.
File metadata
- Download URL: feather-format-0.1.2.tar.gz
- Upload date:
- Size: 99.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2fb5610f1e8f7eaef4eec9f82ef6c7689b8ef55d593bc8eae70e2fd0611e86ce
|
|
| MD5 |
915c9d9d1c60f8c539c5aeeeb8a0012f
|
|
| BLAKE2b-256 |
2576643344d1834bd56b8091fb30fa52dfbd9f47a920a4433b26fdf8b8318976
|