Skip to main content

Wrangles

Full documentation available at wrangles.io.

What are Wrangles?

Wrangles are a set of modular transformations for data cleaning and enrichment. Each Wrangle is optimized for a particular job, many of which are backed by sophisticated machine learning models.

With Wrangles, you can:

  • Extract information from a set of messy descriptions.
  • Predict which category items belong to.
  • Standardize text data to a desired format.
  • Move data from one system to another.
  • Much more...

Wrangles are system independent, and allow you to pull data from one system, transform it and push it to another. Wrangles can be incorporated directly into python code, or an automated sequence of wrangles can be run as a recipe.

Installation

The python package can be installed using pip.

pip install wrangles

Once installed, import the package into your code.

import wrangles

Authentication

Some Wrangles use cloud based machine learning models. To use them a WrangleWorks account is required.

Create a WrangleWorks account: Register

There are two ways to provide the credentials:

Environment Variables

The credentials can be saved as the environment variables:

  • WRANGLES_USER
  • WRANGLES_PASSWORD

Method

The credentials can be provided within the python code using the authenticate method, prior to calling other functions.

wrangles.authenticate('<user>', '<password>')

Usage

Functions

Wrangles can be used as functions, directly incorporated into python code.

Wrangles broadly accept a single input string, or a list of strings. If a list is provided, the results will be returned in an equivalent list in the same order and length as the original.

# Extract alphanumeric codes from a free text strings - e.g. find all part numbers in a set of product description
>>> import wrangles

>>> wrangles.extract.codes('replacement part ABCD1234ZZ')
['ABCD1234ZZ']

>>> wrangles.extract.codes(['replacement part ABCD1234ZZ', 'NNN555BBB this one has two XYZ789'])
[
    ['ABCD1234ZZ'],
    ['NNN555BBB', 'XYZ789']
]

Recipes

Recipes are written in YAML and allow a series of Wrangles to be run as an automated sequence.

Recipes can be triggered either from python code or a terminal command.

Run

# PYTHON
import wrangles
wrangles.recipe.run('recipe.wrgl.yml')
# TERMINAL
wrangles.recipe recipe.wrgl.yml

Recipe

# file: recipe.wrgl.yml
# ---
# Convert a CSV file to an Excel file
# and change the case of a column.
read:
  - file:
      name: file.csv

wrangles:
  - convert.case:
      input: my column
      case: upper

write:
  - file:
      name: file.xlsx

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wrangles-1.19.6.tar.gz (154.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wrangles-1.19.6-py3-none-any.whl (179.6 kB view details)

Uploaded Python 3

File details

Details for the file wrangles-1.19.6.tar.gz.

File metadata

  • Download URL: wrangles-1.19.6.tar.gz
  • Upload date:
  • Size: 154.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for wrangles-1.19.6.tar.gz
Algorithm Hash digest
SHA256 7d5860c89ea3bcc1afc850dabbacd6844e09dba5d1c5ab912485cf08ac82c85c
MD5 fb95cf3ba3969f739888ffe1a3241368
BLAKE2b-256 28f0c6cef58cb4b93d8b4592540aa87759b91225805a73455ba85d7c859bde37

See more details on using hashes here.

Provenance

The following attestation bundles were made for wrangles-1.19.6.tar.gz:

Publisher: publish-tagged.yml on wrangleworks/WranglesPY

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file wrangles-1.19.6-py3-none-any.whl.

File metadata

  • Download URL: wrangles-1.19.6-py3-none-any.whl
  • Upload date:
  • Size: 179.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for wrangles-1.19.6-py3-none-any.whl
Algorithm Hash digest
SHA256 37567bf811a60c59b49c983f1b4dab316d27de68695fd56d592dc4bb541e1386
MD5 a6644e831230c83be2a17ac9d335c797
BLAKE2b-256 0a0ea594a480698265309e9e0504725cca141b7b843065c923868c5efa895faa

See more details on using hashes here.

Provenance

The following attestation bundles were made for wrangles-1.19.6-py3-none-any.whl:

Publisher: publish-tagged.yml on wrangleworks/WranglesPY

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page