{"id":23767,"library":"friendlywords","title":"friendlywords","description":"A Python library for generating random human-readable strings, such as project names, experiment names, or memorable identifiers. Version 1.2.0 supports Python >=3.6 and provides two-word combinations from adjective-noun pairs. The package is actively maintained with a stable API.","status":"active","version":"1.2.0","language":"python","source_language":"en","source_url":"https://github.com/the-lay/py-friendly-words","tags":["random","human-readable","names","generator","strings"],"install":[{"cmd":"pip install friendlywords","lang":"bash","label":"install from PyPI"}],"dependencies":[],"imports":[{"note":"Direct module import does not expose the function; must import from submodule.","wrong":"import friendlywords","symbol":"generate","correct":"from friendlywords import generate"}],"quickstart":{"code":"from friendlywords import generate\n\n# Generate a random friendly word pair\nresult = generate()\nprint(result)  # e.g., 'happy-eagle'","lang":"python","description":"Generate a single random human-readable string (adjective-noun pair)."},"warnings":[{"fix":"Use generate(separator=' ') for space-separated output, or call .split('-') if hyphen is used.","message":"The generate() function returns a string with a hyphen by default, not a tuple or list. Users expecting multiple words may need to split on '-' or call generate(separator=' ').","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Change import to: from friendlywords import generate","message":"The older import pattern 'import friendlywords' may work but is not recommended; the correct API requires 'from friendlywords import generate'. Future versions may drop the top-level module.","severity":"deprecated","affected_versions":"<1.2.0"},{"fix":"If you need longer strings, call generate() multiple times and join with a separator.","message":"The library does not provide a way to generate more than two words. All outputs are exactly an adjective and a noun.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Change to: from friendlywords import generate","cause":"Using 'import friendlywords' instead of 'from friendlywords import generate'","error":"AttributeError: module 'friendlywords' has no attribute 'generate'"},{"fix":"Run: pip install friendlywords","cause":"Package not installed","error":"ModuleNotFoundError: No module named 'friendlywords'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}