{"id":27759,"library":"fzflib","title":"fzflib","description":"A Python library for interacting with FZF (fuzzy finder) by wrapping its command-line interface. Currently at version 0.1.17, with infrequent releases. Requires Python >=3.6.","status":"active","version":"0.1.17","language":"python","source_language":"en","source_url":"https://github.com/AceofSpades5757/fzflib","tags":["fzf","fuzzy-finder","terminal-ui","cli-wrapper"],"install":[{"cmd":"pip install fzflib","lang":"bash","label":"pip"}],"dependencies":[],"imports":[{"note":"Primary class for interacting with FZF.","symbol":"Fzf","correct":"from fzflib import Fzf"}],"quickstart":{"code":"from fzflib import Fzf\n\nfzf = Fzf()\nresult = fzf.run(['option1', 'option2', 'option3']).output\nprint(result)","lang":"python","description":"Basic usage: create an Fzf instance and call run() with a list of choices."},"warnings":[{"fix":"Install fzf (e.g., `brew install fzf` on macOS, or via your package manager) before using fzflib.","message":"The `Fzf` object runs an external `fzf` process; ensure `fzf` is installed and on PATH, otherwise it will fail silently or raise an error.","severity":"gotcha","affected_versions":"all"},{"fix":"Use the public API methods instead of directly accessing subprocess internals.","message":"Direct access to internal attributes like `process.pid` may change in future versions; prefer using methods like `wait()` or `close()`.","severity":"deprecated","affected_versions":"0.1.x"},{"fix":"Use `.output` to get the list of selected items, or `.raw_lines()` for more control.","message":"The `run` method returns a `ProcessResult` object; calling `.output` returns a list of strings, not a single string. Using `.stdout` may be confused with raw bytes.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Install fzf: https://github.com/junegunn/fzf#installation","cause":"The `fzf` binary is not installed or not on the system PATH.","error":"FileNotFoundError: [Errno 2] No such file or directory: 'fzf'"},{"fix":"Ensure you have version 0.1.x installed and use `from fzflib import Fzf`.","cause":"Using an older version of fzflib where the method was named differently or the class was not imported correctly.","error":"AttributeError: 'Fzf' object has no attribute 'run'"},{"fix":"Pass a list (or iterable) as the first argument to `run()`, e.g., `fzf.run(['a'])`.","cause":"Using parentheses after `fzf.run` instead of calling with arguments correctly, e.g., `fzf.run(['a'])` vs `fzf.run(('a'))`.","error":"TypeError: 'tuple' object is not callable"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}