Metadata-Version: 2.1
Name: pandex
Version: 0.2
Summary: Extension framework for pandas
Home-page: http://github.com/connectedblue/pdext
Author: Chris Shaw
Author-email: chris@connectedblue.com
License: UNKNOWN
Keywords: pandas,extensions
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Natural Language :: English
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3
Description-Content-Type: text/markdown
Requires-Dist: pandas
Requires-Dist: pyyaml

# pandex - An Extension Framework for pandas

`pandex` is a framework for creating, managing and sharing extensions
for the `pandas` package.

There is a built-in extension system in `pandas` but it is not
straightforward to share these between projects, virtual environments,
other users on the same server or indeed, the wider world.

`pandex` allows extensions to be installed from local files, directories
or directly from public GitHub repositories.  Once installed, they persist 
for a user across multiple virtual environments.

Any existing script can be upgraded to support extensions with a single 
line change. Simply replace:

```
import pandas as pd
```

with:

```
   import pandex as pd
```

and all dataframes created from `pd` will be able to access installed extensions.

An demo extension which calculates the circumference and area of circles from a
column of radius values can be installed:

```
    pd.ext.import_extension('github:connectedblue/pdext_collection -> circle_calculations')
```

Whenever these calculations are required for a dataframe `df` which contains
a column `radius`, the extension can be called:

```
   df.ext.circle_calculations()
```

To see the currently installed extensions:

```
   pd.ext.show_extensions()
```


