{"library":"nicknames","title":"Nicknames","description":"The 'nicknames' library provides a hand-curated dataset of English given names and their associated nicknames or diminutive names. It offers a Python API to query these relationships. The current version is 1.0.1, released on March 5, 2026, and follows a release cadence tied to data updates and feature enhancements. It is actively maintained by the Old Dominion University - Web Science and Digital Libraries Research Group. [4, 5]","language":"python","status":"active","last_verified":"Thu Apr 16","install":{"commands":["pip install nicknames"],"cli":null},"imports":["from nicknames import NickNamer","from nicknames import name_triplets"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"from nicknames import NickNamer, name_triplets\n\n# Initialize the NickNamer class\nnn = NickNamer()\n\n# Get nicknames for a given name\nnicks_for_alexander = nn.nicknames_of(\"Alexander\")\nprint(f\"Nicknames for Alexander: {nicks_for_alexander}\")\n# Expected: {'al', 'alex'}\n\n# Get canonical names for a given nickname\ncanonicals_for_al = nn.canonicals_of(\"al\")\nprint(f\"Canonical names for al: {canonicals_for_al}\")\n# Expected: {'alexander', 'alex'}\n\n# Check if two names are interchangeable (via nicknames or canonical forms)\nalexander_is_al_interchangeable = \"alexander\" in (nn.nicknames_of(\"al\") | nn.canonicals_of(\"al\"))\nprint(f\"Is Alexander interchangeable with al? {alexander_is_al_interchangeable}\")\n\n# Access the raw data triplets\nfirst_three_triplets = name_triplets()[:3]\nprint(f\"First three raw name triplets: {first_three_triplets}\")","lang":"python","description":"This quickstart demonstrates how to instantiate the `NickNamer` class to find nicknames for a given name and canonical names for a given nickname. It also shows how to combine these methods to check for interchangeability and how to access the raw `name_triplets` data directly. [4]","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":null}