Skip to main content

Simple tool for pandas data transformation

Project description

data-steps

This projects provides a minmal framework to organize data transformations in pandas.

It is intended to be used in both notebooks and code files.

The main idea is to provide a simple decorator syntax that is easy to maintains when data transfromation steps get changed or added throughout the project. A prime example is data cleaning where only later in the project some required cleaning steps become apparent.

Features

After wrapping a pandas DataFrame in a DataSteps class. The following features are available.

  • register data transformations with the instances .step decorator
  • get an overview of the registered steps with .steps
  • inspect the original data the fully transformed data and any partially transformed data in between
  • change parameters of registered steps
  • interactively redefine or deactivate steps in jupyter notebooks
  • register steps that return secondary results, i.e. the main result is passed alon the pipeline, whereas the secondary result is stored seperately
  • convert data steps pipelines to strings that can more easily be integrated into a non-eda code-base

Usage Example

Wrap your data in an instance

from data_steps import DataSteps

data = DataSteps(my_pandas_df)

#register transformation steps

@data.step
def data_transformation(df):
    #transfromation steps
    ...
    return transformed_df

@data.step
def transform_with_parameters(df,param1,param2=4):
    #transfromation steps
    ...
    return transformed_df

#access original data
data.original

#set or update transformation parameters
data.update_step_kwargs('transform_with_parameters',{'param1':10})

#access data after all transformation steps
data.transformed


#get an overview of the registered steps
data.steps

#only execute some steps to help debugging transformations
data.partial_transform(0)

History

0.0.1 (2021-01-31)

  • First release on PyPi.

0.1.0 (2021-02-11)

  • Changed step decorator to work in bare format, i.e. <instance>.step instead of <instance>.step()

0.2.0 (2021-05-02)

  • support for additional arguments in steps

0.3.0 (2021-05-30)

  • support for exporting a datasteps pipeline as a string
  • Enable steps to contain side results next to the transformed data. These could be summaries for diagnostics or plots for an intermediate result

Possible extensions

No Concrete plans at the moment but feel free to open enhancement issues on github

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

data-steps-0.3.0.tar.gz (7.6 kB view details)

Uploaded Source

File details

Details for the file data-steps-0.3.0.tar.gz.

File metadata

  • Download URL: data-steps-0.3.0.tar.gz
  • Upload date:
  • Size: 7.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/52.0.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1

File hashes

Hashes for data-steps-0.3.0.tar.gz
Algorithm Hash digest
SHA256 42d9f22a3dca333b52dea849bbd4462d905a600e598050b112bb89cd0f16b6f3
MD5 096eafc10f1f5ebf889104ef178f4117
BLAKE2b-256 4a7b8e2b366de61187a3b4228e7241deb51eb0b4814cbf127c0372abf5c9cc72

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page