text-metrics

Calculate various string metrics efficiently

https://github.com/mrkkrp/text-metrics

LTS Haskell 23.1:0.3.3
Stackage Nightly 2024-12-21:0.3.3
Latest on Hackage:0.3.3

See all snapshots text-metrics appears in

BSD-3-Clause licensed and maintained by Mark Karpov
This version can be pinned in stack with:text-metrics-0.3.3@sha256:30aaca8f59579ffdf18d109d32965775dcf400b1a778c8bf32174f349da11d47,2736

Module documentation for 0.3.3

Used by 4 packages in lts-23.1(full list with versions):
fuzzyset, infer-license, mmark, pantry

Text Metrics

License BSD3 Hackage Stackage Nightly Stackage LTS CI

The library provides efficient implementations of various strings metric algorithms. It works with strict Text values.

The current version of the package implements:

Comparison with the edit-distance package

There is edit-distance package whose scope overlaps with the scope of this package. The differences are:

  • edit-distance allows to specify costs for every operation when calculating Levenshtein distance (insertion, deletion, substitution, and transposition). This is rarely needed though in real-world applications, IMO.

  • edit-distance only provides Levenshtein distance, text-metrics aims to provide implementations of most string metrics algorithms.

  • edit-distance works on Strings, while text-metrics works on strict Text values.

Implementation

Although we originally used C for speed, currently all functions are pure Haskell tuned for performance. See this blog post for more info.

Contribution

Issues, bugs, and questions may be reported in the GitHub issue tracker for this project.

Pull requests are also welcome.

License

Copyright © 2016–present Mark Karpov

Distributed under BSD 3 clause license.

Changes

Text Metrics 0.3.3

  • Slightly optimized the levenshtein and levenshteinNorm functions. PR 50.

Text Metrics 0.3.2

  • Works with text-2.0.

Text Metrics 0.3.1

  • Fixed a bug in the implementation of Jaro-Winkler distance when two strings share a long prefix. PR 21.

  • Dropped support for GHC 8.6 and older.

Text Metrics 0.3.0

  • All functions are now implemented in pure Haskell.

  • All functions return Int or Ratio Int instead of Natural and Ratio Natural.

  • Added overlap (returns overlap coefficient) and jaccard (returns Jaccard similarity coefficient).

Text Metrics 0.2.0

  • Made the levenshtein, levenshteinNorm, damerauLevenshtein, and demerauLevenshtein more efficient.

  • Added jaro and jaroWinkler functions.

Text Metrics 0.1.0

  • Initial release.