rustdash 0.1.0

Lodash for Python - blazing fast JSON/array manipulation (Rust-powered)

rustdash

Lodash-inspired utility library for Python, powered by Rust.

rustdash provides fast, familiar helper functions for strings, numbers, arrays, and objects. The core logic is written in Rust and exposed to Python via PyO3, compiled with maturin.

Installation

pip install rustdash

Build from source

Requires Rust toolchain and maturin:

pip install maturin
maturin develop

Quick start

import rustdash as _

# Strings
_.camel_case("hello world")       # "helloWorld"
_.snake_case("helloWorld")         # "hello_world"

# Numbers
_.sum([1, 2, 3])                   # 6
_.mean([10, 20, 30])               # 20.0

# Arrays
_.chunk([1, 2, 3, 4, 5], 2)       # [[1, 2], [3, 4], [5]]
_.unique([1, 2, 2, 3])            # [1, 2, 3]
_.flatten_deep([[1, [2]], [3]])    # [1, 2, 3]

# Objects
_.get({"a": {"b": 1}}, "a.b", None)           # 1
_.pick({"a": 1, "b": 2, "c": 3}, ["a", "c"])  # {"a": 1, "c": 3}
_.merge([{"a": 1}, {"b": 2}])                 # {"a": 1, "b": 2}

API Reference

Strings

Function	Description
camel_case(input)	Convert to camelCase
snake_case(input)	Convert to snake_case
kebab_case(input)	Convert to kebab-case
pascal_case(input)	Convert to PascalCase
capitalize(input)	Capitalize first letter
upper_case(input)	Convert to UPPER CASE
lower_case(input)	Convert to lower case
trim(input)	Remove leading/trailing whitespace
trim_start(input)	Remove leading whitespace
trim_end(input)	Remove trailing whitespace
words(input)	Split string into words

All string functions accept a single string or a list of strings.

Numbers

Function	Description
sum(values)	Sum a list of numbers
mean(values)	Arithmetic mean (always returns float)
min(values)	Minimum value
max(values)	Maximum value
round(value, decimals)	Round to decimals places. Accepts a single number or a list
sum_by(values, fn)	Sum by callback result
min_by(values, fn)	Element whose callback returns the smallest value
max_by(values, fn)	Element whose callback returns the largest value

Lists can contain integers, floats, or a mix of both.

Arrays

Function	Description
chunk(array, size)	Split into groups of size
compact(array)	Remove None/null values
flatten_deep(array)	Recursively flatten nested lists
unique(array)	Deduplicate elements (preserves order)
group_by(array, fn)	Group elements by callback key
map(array, fn)	Transform each element
filter(array, fn)	Keep elements where callback returns True
find(array, fn)	First element where callback returns True
sort_by(array, fn)	Sort by callback key
reduce(array, fn, initial)	Fold left with an accumulator
zip(a, b)	Pair elements from two lists
intersection(a, b)	Elements present in both lists

Arrays support heterogeneous types (e.g. [1, "two", 3.0, True, None]).

Objects

Function	Description
get(obj, path, default)	Access nested value by dotted path
has(obj, path)	Check if path exists
get_all(obj, pattern)	Collect all values matching a [*] wildcard path
has_all(obj, pattern)	Check that every [*] expansion exists
pick(obj, keys)	New object with only the listed keys
omit(obj, keys)	New object without the listed keys
merge(objects)	Shallow-merge a list of objects (last wins)
keys(obj)	Top-level keys
values(obj)	Top-level values

Path syntax

Paths support dotted notation, bracket indexes, and wildcards:

_.get(data, "user.name", None)             # dotted keys
_.get(data, "items[0].price", 0)           # array index
_.get(data, "matrix[0][1]", 0)             # nested indexes
_.get_all(data, "users[*].name")           # wildcard expansion
_.get_all(data, "departments[*].staff[*]") # multiple wildcards

Supported Python versions

• CPython 3.8, 3.9, 3.10, 3.11, 3.12, 3.13
• Pre-built wheels for Linux, macOS, and Windows (3.10+ on Windows)

License

MIT