retail.sku-generate

def generate_sku(prefix: str, attributes: Sequence[str], segment_length: int) -> str

from fune.retail.sku_generate import generate_sku  # retail.sku-generate@^1

from typing import Sequence


def _clean(part: str) -> str:
    # Keep ASCII letters and digits only, then uppercase. Filtering first
    # matters: "ß".upper() is "SS", which would make the SKU depend on how each
    # language's Unicode tables treat one letter.
    return "".join(c for c in part if ("A" <= c <= "Z") or ("a" <= c <= "z") or ("0" <= c <= "9")).upper()


def generate_sku(prefix: str, attributes: Sequence[str], segment_length: int) -> str:
    """A deterministic SKU: the cleaned prefix and attributes, joined by hyphens.

    Each attribute is cut to ``segment_length`` characters (0 keeps it whole).
    """
    if isinstance(segment_length, bool) or not isinstance(segment_length, int) or segment_length < 0:
        raise ValueError("segmentLength must be 0 or more, received %r" % (segment_length,))
    if len(attributes) == 0:
        raise ValueError("a SKU needs at least one attribute")
    parts = []
    if prefix != "":
        cleaned = _clean(prefix)
        if cleaned == "":
            raise ValueError('prefix ("%s") has no letters or digits' % prefix)
        parts.append(cleaned)
    for index, attribute in enumerate(attributes):
        cleaned = _clean(attribute)
        if cleaned == "":
            raise ValueError('attribute %d ("%s") has no letters or digits' % (index + 1, attribute))
        parts.append(cleaned if segment_length == 0 else cleaned[:segment_length])
    return "-".join(parts)

Install

fune build

With that line in your source, in a Python project (language python in fune.project), fune build resolves it and nothing else, pins them in fune.lock, downloads only the Python package of each, and builds the code above into your project’s .fune/build, one readable file per capability with a header linking back here. Or pin a range in fune.project and build in one step:

fune add retail.sku-generate

The manifest, vectors and README with only the Python implementation. Install it without the registry with fune add ./retail.sku-generate-1.0.0-python.fune, or fetch it from a terminal with fune pull retail.sku-generate@1.0.0:python.

The whole function, every language, is one file too: retail.sku-generate-1.0.0.fune, 10,804 bytes, sha256 7ef658222abadfe67f4a35e4484720e326cfec7c0c1a48b09861c4ff9050d9db. It installs into a project of any language.

# fune: before retail.sku-generate

# fune: after retail.sku-generate

# fune: step retail.sku-generate after <n|label>

More from the author

1. Each part (the prefix, then each attribute in the order given) keeps only the ASCII letters and digits `A-Z a-z 0-9`, in order. Spaces, punctuation and every non-ASCII character are dropped. 2. What is left is uppercased. 3. Each attribute, not the prefix, is cut to its first `segmentLength` characters. `0` keeps it whole. 4. The parts are joined with `-`. An empty prefix is left out.

Filtering happens before uppercasing on purpose: German sharp s uppercases to "SS" in all three languages, so uppercasing first would turn "Straße" into `STRASSE` in some places and `STRAE` in others. Here it is always `STRAE`. Accented letters are dropped, not transliterated ("Crème" is `CRME`); run the attribute through `text.slugify` first if you want `CREME`.

## What it does not do

It does not guarantee uniqueness. Two attributes that agree in their first `segmentLength` characters collide ("Brown" and "Bronze" are both `BRO` at 3), and so do "10.5" and "105" (both `105`). A SKU scheme with a fixed segment length needs a catalogue-level check, or a longer segment, and that belongs to whoever owns the catalogue. The order of the attributes is part of the SKU, so fix it per product family (colour, then size, then material).

## Errors

No attributes, a negative `segmentLength`, or a prefix or attribute with no letters or digits at all (`"***"`) are errors, because a SKU with an empty segment would silently collide with its neighbours.

Files