fuzzyfinder

library2.3.0pypypi✓ verified 86d ago

A lightweight Python library for fuzzy string matching and autocompletion. It uses fuzzy search algorithms to find approximate matches based on Levenshtein distance. Current version 2.3.0, released 2025-03-07. Maintained, with low release cadence.

serialization ai-ml data

pip install fuzzyfinder

github ↗package ↗

INSTALL

IMPORT

SIG · FUZZYFINDER

fuzzyfinder

serializationpythonv2.3.0

Install

1.5s avg

Import

114ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.096s · 17.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.5s · import 0.086s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

fuzzyfinder

✓ from fuzzyfinder import fuzzyfinder

Main function for fuzzy matching.

Basic usage: fuzzyfinder(search_term, list_of_strings) returns list of matches.

from fuzzyfinder import fuzzyfinder # Sample list of strings strings = ['apple', 'banana', 'grape', 'pineapple', 'orange'] # Fuzzy search for 'app' with default threshold results = fuzzyfinder('app', strings) print(results) # Output: ['apple', 'pineapple']

Debug

Known issues

deprecatedThe `accessor` argument is deprecated and will be removed in future versions.

fix

Avoid using `accessor`; pass a list of strings directly.

affects: >=2.0.0,<3.0.0

breakingIn version 2.0.0, the library dropped support for Python 2 and Python <3.10.

fix

Use Python >=3.10.

affects: >=2.0.0

gotchaThe function returns an empty list if no matches are found, not `None`.

fix

Check for empty list rather than None: if not results: ...

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'fuzzyfinder'

The library is not installed or not in the current environment.

fix

Run: pip install fuzzyfinder

AttributeError: module 'fuzzyfinder' has no attribute 'fuzzyfinder'

The import statement is incorrect (e.g., import fuzzyfinder then calling fuzzyfinder.fuzzyfinder).

fix

Use correct import: from fuzzyfinder import fuzzyfinder

Upgrade

Version history

2.3.0latest on PyPI · released Apr 20, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

28 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/amjith/fuzzyfinder ↗

packagehttps://pypi.org/project/fuzzyfinder/ ↗