Skip to content

M-Farag/rawbuilder

Repository files navigation

rawbuilder

Documentation Status https://app.travis-ci.com/M-Farag/rawbuilder.svg?branch=main https://codecov.io/gh/M-Farag/rawbuilder/branch/main/graph/badge.svg?token=H6YCKETJRV

an elegant datasets factory

Features

  • Schema oriented datasets builder

How to Use it

Terminal:

# Import the package into any python app
import rawbuilder as rw

# Init the dataset object as ds
ds = rw.DataSet(
    size=1000,
    task='user',
)

# Build the dataset
ds.build()

# Optionals
ds = rw.DataSet(
    size=1000,
    task='user',
    schema_path='where/to/read/schema/from',
    schema_dict='{'user':{'id':'int'}}'
)

df = ds.build(
    output_path='your/output/directory',
    export_csv=True,
    return_df=True
)

Schema

  • The Schema is a JSON object that describes three main components.
  • The model names, the column names, and the data types per column.
  • Note the below code-block, The model name is "Student", and it contain 4 columns [id,first_name,email,math_test_results].
  • Each property of the model "student" is called a task and it has its columns and data description.

Student data model example:

"student": {
    "id": "int",
    "first_name": "first_name",
    "last_name": "last_name",
    "email": "email",
    "math_test_results": "random_int between,0,30"
}

Data types to use in the schema

  • int: build a column of integers between 1 and requested dataset size.
  • decrement: build a column of decremented integers between the requested size and 1.
  • random_int: build a column of random integers between 0 and 100 by default.
  • random_float: build a column of random floats between 0 and 1 by default.
  • first_name: build a column of first names.
  • last_name: build a column of last names.
  • email: build a column of fake emails.
  • password: build a random string passwords with default length of 12 characters.

Data Modifiers

Combine Data Modifiers to the above data types, it can adjust values, change the data nature, and gives more control over the final output.

Modifiers syntax is simple:

"modifier,argument_1,arg_2,arg_*"

Use the modifier between to generate random integer column between 0 and 30:

"math_test_results": "random_int between,0,30"

All Modifiers

1) Ranges

Use this modifier to set the high-end and low-end for a specific data type

Syntax:

"between,10,1000"

Supported with

random_int:

"math_test_results": "random_int between,0,30"

random_float:

"heights": "random_float between,1.30,1.80"

password:

"password": "password between,12,12"