Nişanyan CLI

Explore the origins, history, and development of Turkish words directly from your terminal. This tool provides access to Sevan Nişanyan's comprehensive etymological database, including the "Adlar" (names) dictionary.

• Etymology Tree: Visualize the lineage of words with the --tree flag.
• Random Word: Discover new words and their origins with --random.
• Adlar Support: Access the Turkish names dictionary (nisanyanadlar.com) using -ad.
• Rich Output: Beautifully formatted terminal output thanks to Rich.
• Plain Mode: Clean, unformatted text output for scripts and piping.

Installation

pip install nisanyan-cli

or

uv tool install nisanyan-cli

Usage

Basic Search

Simply provide the word you want to look up:

nis anadolu

Etymology Tree (-t, --tree)

View the word's history as a hierarchical tree:

nis çikolata --tree

Output Example:

çikolata (Günümüz Türkçesi)
└── cioccolata (İtalyanca): kakao yağı ve şekerle imal edilen yiyecek maddesi.
    └── chocolate (İspanyolca): ~.
        └── xocolatl (Aztekçe): kakaodan yapılan içecek.
            ├── xocolli (Aztekçe): acı.
            └── atl (Aztekçe): su.

Nişanyan Adlar (-ad)

Query the names dictionary for meanings and origins:

nis gökçe -ad

Combine with random for inspiration: nis -ad -r

Discover Random Words (-r, --random)

Explore the dictionary randomly:

nis -r -t

Commands & Arguments

Development

Prerequisites

• Poetry (Dependency Management)

Setup

1. Clone the repository:

   git clone https://github.com/agmmnn/nisanyan-cli.git
   cd nisanyan-cli
   

2. Install dependencies:

   poetry install
   

3. Run the CLI in development mode:

   poetry run nis <word>
   

TODO

• Better processing of API results for better alignment with the website's format.
• Expansion of abbreviations in supplementary descriptions to their full forms.

Dependencies

• Rich - Terminal formatting.
• importlib-metadata - Version management.