crosszip

crosszip is a Python utility that makes it easy to apply a function to all possible combinations of elements from multiple iterables. It combines the power of the Cartesian product and functional programming into a single, intuitive tool.

Additionally, @pytest.mark.crosszip_parametrize is a pytest marker that simplifies running tests with all possible combinations of parameter values.

Installation

uv add crosszip

Usage

Example of using crosszip:

# @pyodide
# Label Generation for Machine Learning

from crosszip import crosszip


def create_label(category, subcategory, version):
    return f"{category}_{subcategory}_v{version}"


categories = ["cat", "dog"]
subcategories = ["small", "large"]
versions = ["1.0", "2.0"]

labels = crosszip(create_label, categories, subcategories, versions)
print(labels)

['cat_small_v1.0', 'cat_small_v2.0', 'cat_large_v1.0', 'cat_large_v2.0', 'dog_small_v1.0', 'dog_small_v2.0', 'dog_large_v1.0', 'dog_large_v2.0']

Example of using pytest marker crosszip_parametrize:

# @pyodide
# Testing Power Function

import math
import crosszip
import pytest


@pytest.mark.crosszip_parametrize(
    "base",
    [2, 10],
    "exponent",
    [-1, 0, 1],
)
def test_power_function(base, exponent):
    result = math.pow(base, exponent)
    assert result == base**exponent


print("Tests executed successfully.")

Tests executed successfully.

For more examples, check out the package documentation at: https://www.indrapatil.com/crosszip/

Key Features

• Flexible Input: Works with any iterables, including lists, tuples, sets, and generators.
• pytest Plugin: Provides a crosszip_parametrize marker for running tests with all possible combinations of parameter values.
• Simple API: Minimalist, intuitive design for quick integration into your projects.
• Advanced patterns: See the Advanced Usage guide for memory efficiency strategies, managing test explosion, and testing validation functions across input types and edge cases.

License

This project is licensed under the MIT License.

Code of Conduct

Please note that the crosszip project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

Acknowledgements

Hex sticker font is Rubik, and the image is taken from icon made by Freepik and available at flaticon.com.