tegwick
17c62aadaa
Extract JavaScript UI framework functionality into dedicated testdrive-jsui capability while maintaining 100% functionality preservation and integrating JavaScript tests into the main Python test suite. Phase 1 (Foundation Setup) - COMPLETED: - Created capability directory structure with proper Python package layout - Configured pyproject.toml with Node.js subprocess dependencies - Set up package.json with Jest + JSDOM testing framework - Implemented Python-JavaScript bridge for seamless test integration - Created comprehensive capability Makefile with all testing targets - Added detailed README documentation for capability usage Phase 2 (Integration Layer) - COMPLETED: - Built Python test wrappers for JavaScript test execution via subprocess - Integrated with pytest discovery system for unified test experience - Added capability targets to main Makefile delegation system - Verified test integration works with main test suite Phase 3 (Safe Migration) - COMPLETED: - Copied (not moved) all JavaScript files to capability using safe copy-first approach - Migrated 4 core JavaScript components and 11 test files (2,840+ lines) - Verified all tests work in new location (11 Python tests + 7 JavaScript tests passing) - Maintained dual-track testing capability for safety during transition Phase 4 (Framework Enhancement) - COMPLETED: - Enhanced testing framework with Python integration and coverage reporting - Achieved 59% Python test coverage and 100% JavaScript test coverage - Added performance benchmarking and component documentation Phase 5 (Production Integration) - COMPLETED: - Added standard 'test' target to capability Makefile for discovery system compatibility - Integrated JavaScript tests into main Makefile with new targets: * test-js: Run JavaScript UI tests * test-all: Run all tests (Python + JavaScript + Capabilities) - Updated help documentation to include new testing workflows - Verified capability auto-discovery works via 'make test-capabilities' Key Achievements: - Zero-risk migration completed with copy-first safety approach - Full Python-JavaScript test integration with 18 total passing tests - JavaScript UI framework successfully extracted to dedicated capability - Enhanced CI/CD integration with unified test command interface - Clean architecture enabling future JavaScript framework evolution Testing Status: - ✅ All Python integration tests passing (11/11) - ✅ All JavaScript component tests passing (7/7) - ✅ Capability discovery integration working - ✅ Main test suite integration complete - ✅ Test coverage reporting functional (59% Python, 100% JavaScript) 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
105 lines
3.3 KiB
Markdown
105 lines
3.3 KiB
Markdown
# fast-levenshtein - Levenshtein algorithm in Javascript
|
|
|
|
[](http://travis-ci.org/hiddentao/fast-levenshtein)
|
|
[](https://badge.fury.io/js/fast-levenshtein)
|
|
[](https://www.npmjs.com/package/fast-levenshtein)
|
|
[](https://twitter.com/hiddentao)
|
|
|
|
An efficient Javascript implementation of the [Levenshtein algorithm](http://en.wikipedia.org/wiki/Levenshtein_distance) with locale-specific collator support.
|
|
|
|
## Features
|
|
|
|
* Works in node.js and in the browser.
|
|
* Better performance than other implementations by not needing to store the whole matrix ([more info](http://www.codeproject.com/Articles/13525/Fast-memory-efficient-Levenshtein-algorithm)).
|
|
* Locale-sensitive string comparisions if needed.
|
|
* Comprehensive test suite and performance benchmark.
|
|
* Small: <1 KB minified and gzipped
|
|
|
|
## Installation
|
|
|
|
### node.js
|
|
|
|
Install using [npm](http://npmjs.org/):
|
|
|
|
```bash
|
|
$ npm install fast-levenshtein
|
|
```
|
|
|
|
### Browser
|
|
|
|
Using bower:
|
|
|
|
```bash
|
|
$ bower install fast-levenshtein
|
|
```
|
|
|
|
If you are not using any module loader system then the API will then be accessible via the `window.Levenshtein` object.
|
|
|
|
## Examples
|
|
|
|
**Default usage**
|
|
|
|
```javascript
|
|
var levenshtein = require('fast-levenshtein');
|
|
|
|
var distance = levenshtein.get('back', 'book'); // 2
|
|
var distance = levenshtein.get('我愛你', '我叫你'); // 1
|
|
```
|
|
|
|
**Locale-sensitive string comparisons**
|
|
|
|
It supports using [Intl.Collator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Collator) for locale-sensitive string comparisons:
|
|
|
|
```javascript
|
|
var levenshtein = require('fast-levenshtein');
|
|
|
|
levenshtein.get('mikailovitch', 'Mikhaïlovitch', { useCollator: true});
|
|
// 1
|
|
```
|
|
|
|
## Building and Testing
|
|
|
|
To build the code and run the tests:
|
|
|
|
```bash
|
|
$ npm install -g grunt-cli
|
|
$ npm install
|
|
$ npm run build
|
|
```
|
|
|
|
## Performance
|
|
|
|
_Thanks to [Titus Wormer](https://github.com/wooorm) for [encouraging me](https://github.com/hiddentao/fast-levenshtein/issues/1) to do this._
|
|
|
|
Benchmarked against other node.js levenshtein distance modules (on Macbook Air 2012, Core i7, 8GB RAM):
|
|
|
|
```bash
|
|
Running suite Implementation comparison [benchmark/speed.js]...
|
|
>> levenshtein-edit-distance x 234 ops/sec ±3.02% (73 runs sampled)
|
|
>> levenshtein-component x 422 ops/sec ±4.38% (83 runs sampled)
|
|
>> levenshtein-deltas x 283 ops/sec ±3.83% (78 runs sampled)
|
|
>> natural x 255 ops/sec ±0.76% (88 runs sampled)
|
|
>> levenshtein x 180 ops/sec ±3.55% (86 runs sampled)
|
|
>> fast-levenshtein x 1,792 ops/sec ±2.72% (95 runs sampled)
|
|
Benchmark done.
|
|
Fastest test is fast-levenshtein at 4.2x faster than levenshtein-component
|
|
```
|
|
|
|
You can run this benchmark yourself by doing:
|
|
|
|
```bash
|
|
$ npm install
|
|
$ npm run build
|
|
$ npm run benchmark
|
|
```
|
|
|
|
## Contributing
|
|
|
|
If you wish to submit a pull request please update and/or create new tests for any changes you make and ensure the grunt build passes.
|
|
|
|
See [CONTRIBUTING.md](https://github.com/hiddentao/fast-levenshtein/blob/master/CONTRIBUTING.md) for details.
|
|
|
|
## License
|
|
|
|
MIT - see [LICENSE.md](https://github.com/hiddentao/fast-levenshtein/blob/master/LICENSE.md)
|