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.2.tar.gz (10.8 kB view details)

Uploaded Source

File details

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

File metadata

  • Download URL: data-steps-0.3.2.tar.gz
  • Upload date:
  • Size: 10.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.8.10

File hashes

Hashes for data-steps-0.3.2.tar.gz
Algorithm Hash digest
SHA256 5a2f7bde7c30d7b0f736365eca0f0ac3bff64f913422708721438533a35c7641
MD5 4e4c5ee2ee584fdc6d216650f231385d
BLAKE2b-256 52d95197f3b4df6b03d717c5f38e89add3cea8097c1e6aa48b388c681e5ddb72

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