kumaoni 1.0.0__py3-none-any.whl

kumaoni/__init__.py

@@ -0,0 +1,329 @@
+"""
+Kumaoni (कुमाऊँनी) Language Library for Python
+=============================================
+
+A standard-library-style Python package for the Kumaoni language, providing
+linguistic primitives, phonetics, grammar, verb conjugation, dictionary lookups,
+and universal translation from any language of the world into Kumaoni.
+
+Quick Start:
+------------
+>>> import kumaoni
+>>> kumaoni.translate("How are you?")
+<TranslationResult text='कस छू तुम?' romanized='kas chhoo tum?'>
+>>> kumaoni.conjugate("जाण", tense="past", person=1)
+'ग्यूँ'
+>>> kumaoni.num_to_words(42)
+'बयालीस'
+>>> kumaoni.lookup("ईजा")
+Word(kumaoni='ईजा', roman='ija', english='mother', hindi='माँ', pos='noun', category='kinship')
+"""
+
+__version__ = "1.0.0"
+__author__ = "Akshat Singh Bisht"
+__email__ = "infoakshatsinghbisht@gmail.com"
+__maintainer__ = "Akshat Singh Bisht"
+__website__ = "https://akshatsinghbisht.com/"
+__copyright__ = "Copyright (c) 2026 Akshat Singh Bisht"
+__license__ = "MIT"
+
+# Constants
+from kumaoni.constants import (
+    ISO_639_3,
+    ISO_639_NAME,
+    NATIVE_NAME,
+    Dialect,
+    Script,
+    PartOfSpeech,
+    Tense,
+    Gender,
+    GrammaticalNumber,
+    SEASONS,
+    KUMAONI_MONTHS,
+    DAYS_OF_WEEK,
+    KINSHIP,
+)
+
+# Phonetics & Script Conversion
+from kumaoni.phonetics import (
+    normalize_devanagari as normalize,
+    detect_script,
+    devanagari_to_latin,
+    latin_to_devanagari,
+    tokenize,
+    syllables,
+)
+
+# Numbers & Numerals
+from kumaoni.numbers import (
+    num_to_words,
+    words_to_num,
+    to_devanagari_numerals,
+    from_devanagari_numerals,
+    ordinal,
+    fraction,
+)
+
+# Grammar & Morphology
+from kumaoni.grammar import (
+    extract_root,
+    conjugate,
+    conjugate_to_be,
+    conjunctive_participle,
+    agent_noun,
+    imperative,
+    pluralize,
+    decline_noun,
+    make_diminutive,
+    make_augmentative,
+    to_feminine,
+    to_masculine,
+    to_oblique,
+    attach_case,
+    get_marker,
+    get_pronoun,
+    CASE_MARKERS,
+    PRONOUN_TABLE,
+    SyntaxEngine,
+    causative,
+    passive,
+    medio_passive_inability,
+    compound_verb,
+    echo_word,
+    build_sentence,
+    conditional,
+    relative_correlative,
+    prohibitive,
+    modal_ability,
+    modal_obligation,
+    modal_desiderative,
+    interrogative_sentence,
+)
+
+# Lexicon & Dictionary & 100k+ Morphological Engine
+from kumaoni.lexicon import (
+    Word,
+    Lexicon,
+    get_lexicon,
+    lookup,
+    search,
+    lemmatize,
+    analyze,
+    total_word_forms,
+    MorphAnalysis,
+    KumaoniMorphology,
+    FullFormCorpus,
+)
+
+# Translation Engine
+from kumaoni.translator import (
+    Translator,
+    TranslationResult,
+    translate,
+    RuleBasedTranslator,
+    PivotTranslator,
+    LLMTranslator,
+)
+
+# Culture & Heritage
+from kumaoni.culture import (
+    Festival,
+    get_festival,
+    list_festivals,
+    get_months,
+    get_seasons,
+    get_days_of_week,
+    get_current_season,
+)
+
+
+# Voice & Speech Synthesis
+from kumaoni.voice import (
+    KumaoniVoiceSynthesizer,
+    VoiceTranslator,
+    VoiceTranslationResult,
+    voice_translate,
+)
+
+
+def transliterate(text: str, to_script: str = "devanagari") -> str:
+    """
+    Universal transliterator between Latin and Devanagari scripts for Kumaoni.
+    """
+    to_s = to_script.lower()
+    if to_s in ("devanagari", "dev"):
+        return latin_to_devanagari(text)
+    elif to_s in ("latin", "roman", "eng"):
+        return devanagari_to_latin(text)
+    return text
+
+
+# Cultural convenience facades
+class _ProverbsFacade:
+    def list(self):
+        return get_lexicon().get_proverbs()
+
+    def all(self):
+        return self.list()
+
+    def random(self):
+        return get_lexicon().random_proverb()
+
+
+class _RiddlesFacade:
+    def list(self):
+        return get_lexicon().get_riddles()
+
+    def all(self):
+        return self.list()
+
+    def random(self):
+        return get_lexicon().random_riddle()
+
+
+class _PhrasesFacade:
+    def list(self, category=None):
+        return get_lexicon().get_phrases(category=category)
+
+    def all(self, category=None):
+        return self.list(category=category)
+
+    def random(self):
+        return get_lexicon().random_phrase()
+
+
+class _FestivalsFacade:
+    def list(self):
+        return list_festivals()
+
+    def all(self):
+        return self.list()
+
+    def get(self, name):
+        return get_festival(name)
+
+
+class _LiteratureFacade:
+    def epics(self):
+        from kumaoni.culture.literature import LiteratureTreasury
+        return LiteratureTreasury.list_epics()
+
+    def get_epic(self, epic_id):
+        from kumaoni.culture.literature import LiteratureTreasury
+        return LiteratureTreasury.get_epic(epic_id)
+
+    def poems(self, form=None):
+        from kumaoni.culture.literature import LiteratureTreasury
+        return LiteratureTreasury.list_poems(form=form)
+
+    def authors(self):
+        from kumaoni.culture.literature import LiteratureTreasury
+        return LiteratureTreasury.list_authors()
+
+    def get_author(self, author_id):
+        from kumaoni.culture.literature import LiteratureTreasury
+        return LiteratureTreasury.get_author(author_id)
+
+
+class _VoiceFacade:
+    def translate(self, text: str, source_lang: str = "auto", method: str = "auto", generate_audio: bool = False):
+        return voice_translate(text, source_lang=source_lang, method=method, generate_audio=generate_audio)
+
+    def synthesize_wav(self, duration_seconds: float = 1.0, freq: float = 440.0):
+        return KumaoniVoiceSynthesizer.generate_pcm_wav(duration_seconds=duration_seconds, freq=freq)
+
+    def phrases(self, category=None):
+        from kumaoni.voice.engine import _voice_translator
+        return _voice_translator.get_voice_phrases(category=category)
+
+
+proverbs = _ProverbsFacade()
+riddles = _RiddlesFacade()
+phrases = _PhrasesFacade()
+festivals = _FestivalsFacade()
+literature = _LiteratureFacade()
+voice = _VoiceFacade()
+
+__all__ = [
+    # Top-level functions
+    "translate",
+    "voice_translate",
+    "lookup",
+    "search",
+    "lemmatize",
+    "analyze",
+    "total_word_forms",
+    "MorphAnalysis",
+    "KumaoniMorphology",
+    "FullFormCorpus",
+    "conjugate",
+    "conjugate_to_be",
+    "conjunctive_participle",
+    "agent_noun",
+    "imperative",
+    "causative",
+    "passive",
+    "medio_passive_inability",
+    "compound_verb",
+    "echo_word",
+    "build_sentence",
+    "conditional",
+    "relative_correlative",
+    "prohibitive",
+    "modal_ability",
+    "modal_obligation",
+    "modal_desiderative",
+    "interrogative_sentence",
+    "num_to_words",
+    "words_to_num",
+    "to_devanagari_numerals",
+    "from_devanagari_numerals",
+    "ordinal",
+    "fraction",
+    "normalize",
+    "transliterate",
+    "devanagari_to_latin",
+    "latin_to_devanagari",
+    "tokenize",
+    "syllables",
+    "pluralize",
+    "decline_noun",
+    "make_diminutive",
+    "make_augmentative",
+    "to_feminine",
+    "to_masculine",
+    "to_oblique",
+    "attach_case",
+    "get_marker",
+    "get_pronoun",
+    # Voice classes
+    "KumaoniVoiceSynthesizer",
+    "VoiceTranslator",
+    "VoiceTranslationResult",
+    # Constants
+    "ISO_639_3",
+    "ISO_639_NAME",
+    "NATIVE_NAME",
+    "Dialect",
+    "Script",
+    "PartOfSpeech",
+    "Tense",
+    "Gender",
+    "GrammaticalNumber",
+    "SEASONS",
+    "KUMAONI_MONTHS",
+    "DAYS_OF_WEEK",
+    "KINSHIP",
+    "CASE_MARKERS",
+    "PRONOUN_TABLE",
+    # Facades
+    "proverbs",
+    "riddles",
+    "phrases",
+    "festivals",
+    "literature",
+    "voice",
+]
+
+
+

kumaoni/cli.py

@@ -0,0 +1,148 @@
+"""
+Command-line interface (CLI) for the Kumaoni language library.
+Usage:
+    python -m kumaoni.cli translate "Hello, how are you?"
+    python -m kumaoni.cli lookup "ईजा"
+    python -m kumaoni.cli number 42
+    python -m kumaoni.cli conjugate "जाण" --tense past
+    python -m kumaoni.cli proverb
+    python -m kumaoni.cli riddle
+"""
+
+import sys
+import argparse
+import json
+
+# Ensure UTF-8 output on Windows consoles
+if hasattr(sys.stdout, "reconfigure"):
+    try:
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stderr.reconfigure(encoding="utf-8")
+    except Exception:
+        pass
+
+import kumaoni
+from kumaoni.constants import Tense, Gender, GrammaticalNumber
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="kumaoni",
+        description="Kumaoni Language Standard Library CLI"
+    )
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+
+    # translate
+    trans_parser = subparsers.add_parser("translate", help="Translate text to Kumaoni")
+    trans_parser.add_argument("text", type=str, help="Text to translate")
+    trans_parser.add_argument("--source", "-s", default="auto", help="Source language (default: auto)")
+    trans_parser.add_argument("--method", "-m", default="auto", choices=["auto", "rule_based", "pivot", "llm"])
+    trans_parser.add_argument("--api-key", "-k", default=None, help="Optional Gemini/OpenAI API key")
+
+    # lookup
+    lookup_parser = subparsers.add_parser("lookup", help="Dictionary search")
+    lookup_parser.add_argument("word", type=str, help="Word to look up")
+
+    # number
+    num_parser = subparsers.add_parser("number", help="Convert numbers to Kumaoni words")
+    num_parser.add_argument("num", type=int, help="Integer to convert")
+    num_parser.add_argument("--script", default="devanagari", choices=["devanagari", "latin"])
+
+    # conjugate
+    conj_parser = subparsers.add_parser("conjugate", help="Conjugate Kumaoni verbs")
+    conj_parser.add_argument("verb", type=str, help="Infinitive verb (e.g., खाण, जाण)")
+    conj_parser.add_argument("--tense", "-t", default="present", choices=["present", "past", "future", "present_continuous"])
+    conj_parser.add_argument("--person", "-p", type=int, default=3, choices=[1, 2, 3])
+    conj_parser.add_argument("--gender", "-g", default="m", choices=["m", "f"])
+
+    # proverb
+    subparsers.add_parser("proverb", help="Display a traditional Kumaoni proverb (Akhaan)")
+
+    # riddle
+    subparsers.add_parser("riddle", help="Display a traditional Kumaoni riddle (Aana)")
+
+    # voice
+    voice_parser = subparsers.add_parser("voice", help="Voice translation with phonetics, syllables, and SSML")
+    voice_parser.add_argument("text", type=str, help="Text or transcript to translate for voice")
+    voice_parser.add_argument("--source", "-s", default="auto", help="Source language (default: auto)")
+
+    # transliterate
+    translit_parser = subparsers.add_parser("transliterate", help="Transliterate between Devanagari and Latin")
+    translit_parser.add_argument("text", type=str, help="Text to transliterate")
+    translit_parser.add_argument("--to", default="devanagari", choices=["devanagari", "latin"])
+
+    args = parser.parse_args()
+
+    if not args.command:
+        parser.print_help()
+        sys.exit(0)
+
+    if args.command == "voice":
+        res = kumaoni.voice.translate(args.text, source_lang=args.source, generate_audio=False)
+        print(f"\n[Voice Input ({res.source_lang})]: {res.source_text}")
+        print(f"[Kumaoni Spoken]:   {res.translated_text}")
+        print(f"[Phonetic Cadence]: {res.romanized}")
+        print(f"[Syllable Stress]:  {' · '.join(res.syllables)}")
+        print(f"[SSML Markup]:      {res.ssml}")
+        print(f"[Intent Category]:  {res.category}\n")
+
+    if args.command == "translate":
+        res = kumaoni.translate(args.text, source=args.source, method=args.method, api_key=args.api_key)
+        print(f"\n[Source ({res.source_lang})]: {res.source}")
+        print(f"[Kumaoni]:        {res.text}")
+        print(f"[Phonetic]:       {res.romanized}")
+        print(f"[Method]:         {res.method} (confidence: {res.confidence:.2f})\n")
+
+    elif args.command == "lookup":
+        w = kumaoni.lookup(args.word)
+        if w:
+            print(f"\nKumaoni:     {w.kumaoni} ({w.roman})")
+            print(f"English:     {w.english}")
+            print(f"Hindi:       {w.hindi}")
+            print(f"Part of Sp.: {w.pos} [{w.category}]\n")
+        else:
+            results = kumaoni.search(args.word)
+            if results:
+                print(f"\nFound {len(results)} matches:")
+                for r in results:
+                    print(f"- {r.kumaoni} ({r.roman}): {r.english} | {r.hindi}")
+                print()
+            else:
+                print(f"\nNo dictionary match found for '{args.word}'.\n")
+
+    elif args.command == "number":
+        w = kumaoni.num_to_words(args.num, script=args.script)
+        dev_num = kumaoni.to_devanagari_numerals(args.num)
+        print(f"\nNumber:    {args.num} ({dev_num})")
+        print(f"In words:  {w}\n")
+
+    elif args.command == "conjugate":
+        t = Tense(args.tense)
+        g = Gender.MASCULINE if args.gender == "m" else Gender.FEMININE
+        res = kumaoni.conjugate(args.verb, tense=t, person=args.person, gender=g)
+        print(f"\nVerb:       {args.verb}")
+        print(f"Tense:      {args.tense}")
+        print(f"Conjugated: {res}\n")
+
+    elif args.command == "proverb":
+        p = kumaoni.proverbs.random()
+        print(f"\nअखाण (Akhaan): {p.get('kumaoni')}")
+        print(f"Phonetic:      {p.get('roman')}")
+        print(f"Meaning:       {p.get('figurative_meaning')}")
+        print(f"Hindi:         {p.get('hindi_equivalent')}")
+        print(f"English:       {p.get('english_equivalent')}\n")
+
+    elif args.command == "riddle":
+        r = kumaoni.riddles.random()
+        print(f"\nआणा (Aana):     {r.get('riddle')}")
+        print(f"English:       {r.get('english_translation')}")
+        print(f"Answer:        {r.get('answer_kumaoni')} ({r.get('answer_english')})\n")
+
+    elif args.command == "transliterate":
+        out = kumaoni.transliterate(args.text, to_script=args.to)
+        print(f"\nInput:  {args.text}")
+        print(f"Output: {out}\n")
+
+
+if __name__ == "__main__":
+    main()

kumaoni/constants.py

@@ -0,0 +1,123 @@
+"""
+Linguistic and cultural constants for the Kumaoni language library.
+"""
+
+from enum import Enum
+
+
+class Dialect(str, Enum):
+    """Major regional dialects of the Kumaoni language."""
+    STANDARD = "standard"          # Central / Almora / Majh-Kumaiya standard
+    KHASPARJIYA = "khasparjiya"    # Almora and surrounding hilly heartland
+    SORYALI = "soryali"            # Pithoragarh / Soar valley
+    GANGOLI = "gangoli"            # Gangolihat region
+    ASKOTI = "askoti"              # Askot / Didihat region
+    DANPURIYA = "danpuriya"        # Danpur / Bageshwar region
+    SIRWALI = "sirwali"            # Siragadh region
+    CHAUGAARKHIYA = "chaugaarkhiya" # Champawat / Kali Kumaon
+    JOHARI = "johari"              # Johar valley / Munsiyari (northern borderland)
+
+
+class Script(str, Enum):
+    """Scripts supported for Kumaoni."""
+    DEVANAGARI = "devanagari"
+    LATIN = "latin"                # Romanized / English phonetic
+    IAST = "iast"                  # International Alphabet of Sanskrit Transliteration
+
+
+class PartOfSpeech(str, Enum):
+    """Linguistic parts of speech."""
+    NOUN = "noun"
+    PRONOUN = "pronoun"
+    VERB = "verb"
+    ADJECTIVE = "adjective"
+    ADVERB = "adverb"
+    POSTPOSITION = "postposition"
+    CONJUNCTION = "conjunction"
+    INTERJECTION = "interjection"
+    PARTICLE = "particle"
+    NUMBER = "number"
+
+
+class Tense(str, Enum):
+    """Grammatical tenses."""
+    PRESENT = "present"
+    PAST = "past"
+    FUTURE = "future"
+    PRESENT_CONTINUOUS = "present_continuous"
+    PAST_CONTINUOUS = "past_continuous"
+    FUTURE_CONTINUOUS = "future_continuous"
+    IMPERATIVE = "imperative"
+
+
+class Gender(str, Enum):
+    """Grammatical genders."""
+    MASCULINE = "masculine"
+    FEMININE = "feminine"
+    NEUTER = "neuter"
+
+
+class GrammaticalNumber(str, Enum):
+    """Grammatical numbers."""
+    SINGULAR = "singular"
+    PLURAL = "plural"
+
+
+# ISO language code for Kumaoni
+ISO_639_3 = "kfy"
+ISO_639_NAME = "Kumaoni"
+NATIVE_NAME = "कुमाऊँनी"
+
+# Traditional Kumaoni Seasons (ऋतु / Ritu)
+SEASONS = {
+    "basant": {"name_kmy": "बसंत", "english": "Spring", "months": ["फागुन", "चैत"]},
+    "grishma": {"name_kmy": "रूड़ि", "english": "Summer", "months": ["बैसाख", "जेठ"]},
+    "varsha": {"name_kmy": "चौमास", "english": "Monsoon / Rainy", "months": ["असाड़", "साउन", "भादौ"]},
+    "sharad": {"name_kmy": "सरद", "english": "Autumn", "months": ["आसोज", "कातिक"]},
+    "hemant": {"name_kmy": "स्यूँद", "english": "Early Winter", "months": ["मंगसिर", "पूस"]},
+    "shishir": {"name_kmy": "जाड़", "english": "Late Winter", "months": ["माघ", "फागुन"]},
+}
+
+# Kumaoni Solar Calendar Months (सौर मास)
+KUMAONI_MONTHS = [
+    {"index": 1, "kumaoni": "चैत", "roman": "Chait", "gregorian": "March-April"},
+    {"index": 2, "kumaoni": "बैसाख", "roman": "Baisakh", "gregorian": "April-May"},
+    {"index": 3, "kumaoni": "जेठ", "roman": "Jeth", "gregorian": "May-June"},
+    {"index": 4, "kumaoni": "असाड़", "roman": "Asadh", "gregorian": "June-July"},
+    {"index": 5, "kumaoni": "साउन", "roman": "Saun", "gregorian": "July-August"},
+    {"index": 6, "kumaoni": "भादौ", "roman": "Bhado", "gregorian": "August-September"},
+    {"index": 7, "kumaoni": "आसोज", "roman": "Aasoj", "gregorian": "September-October"},
+    {"index": 8, "kumaoni": "कातिक", "roman": "Kaatik", "gregorian": "October-November"},
+    {"index": 9, "kumaoni": "मंगसिर", "roman": "Mangasir", "gregorian": "November-December"},
+    {"index": 10, "kumaoni": "पूस", "roman": "Poos", "gregorian": "December-January"},
+    {"index": 11, "kumaoni": "माघ", "roman": "Maagh", "gregorian": "January-February"},
+    {"index": 12, "kumaoni": "फागुन", "roman": "Faagun", "gregorian": "February-March"},
+]
+
+# Days of the Week
+DAYS_OF_WEEK = [
+    {"day": 0, "kumaoni": "इतवार", "roman": "Itwaar", "english": "Sunday"},
+    {"day": 1, "kumaoni": "सोमवार", "roman": "Somwaar", "english": "Monday"},
+    {"day": 2, "kumaoni": "मंगलवार", "roman": "Mangalwaar", "english": "Tuesday"},
+    {"day": 3, "kumaoni": "बुधवार", "roman": "Budhwaar", "english": "Wednesday"},
+    {"day": 4, "kumaoni": "बिसवार", "roman": "Biswaar", "english": "Thursday"},
+    {"day": 5, "kumaoni": "सुकरवार", "roman": "Sukarwaar", "english": "Friday"},
+    {"day": 6, "kumaoni": "सनिच्चर", "roman": "Sanicchar", "english": "Saturday"},
+]
+
+# Common Kinship Terms
+KINSHIP = {
+    "father": {"kumaoni": "बाबु", "variants": ["बौजी", "बुबा"], "roman": "Babu / Bauji"},
+    "mother": {"kumaoni": "ईजा", "variants": ["म्यात"], "roman": "Ija"},
+    "elder_brother": {"kumaoni": "दाज्यू", "variants": ["दाजू"], "roman": "Dajyu"},
+    "younger_brother": {"kumaoni": "भै", "variants": ["भैया"], "roman": "Bhai"},
+    "elder_sister": {"kumaoni": "दीदी", "variants": ["दिदी"], "roman": "Didi"},
+    "younger_sister": {"kumaoni": "भुली", "variants": ["बैणी"], "roman": "Bhuli / Baini"},
+    "grandfather": {"kumaoni": "बूबू", "variants": ["बारबाबू"], "roman": "Bubu"},
+    "grandmother": {"kumaoni": "आमा", "variants": ["अम्मा"], "roman": "Aama"},
+    "son": {"kumaoni": "च्याल", "variants": ["च्यल"], "roman": "Chyal"},
+    "daughter": {"kumaoni": "चेलि", "variants": ["चेली"], "roman": "Cheli"},
+    "uncle_paternal": {"kumaoni": "काका", "variants": ["काकू"], "roman": "Kaka"},
+    "aunt_paternal": {"kumaoni": "काकी", "variants": [], "roman": "Kaki"},
+    "children": {"kumaoni": "नान्तिन", "variants": ["नतुवे"], "roman": "Naantin"},
+}

kumaoni/culture/__init__.py

@@ -0,0 +1,33 @@
+"""
+Cultural heritage and calendar module for Kumaon.
+"""
+
+from kumaoni.culture.festivals import Festival, get_festival, list_festivals
+from kumaoni.culture.calendar import get_months, get_seasons, get_days_of_week, get_current_season
+from kumaoni.culture.literature import (
+    FolkEpic,
+    FolkPoem,
+    KumaoniAuthor,
+    LiteratureTreasury,
+    EPICS,
+    POEMS,
+    AUTHORS,
+)
+
+__all__ = [
+    "Festival",
+    "get_festival",
+    "list_festivals",
+    "get_months",
+    "get_seasons",
+    "get_days_of_week",
+    "get_current_season",
+    "FolkEpic",
+    "FolkPoem",
+    "KumaoniAuthor",
+    "LiteratureTreasury",
+    "EPICS",
+    "POEMS",
+    "AUTHORS",
+]
+

kumaoni/culture/calendar.py

@@ -0,0 +1,29 @@
+"""
+Kumaoni solar calendar and seasonal calculations.
+"""
+
+from typing import Dict, List, Optional
+from kumaoni.constants import KUMAONI_MONTHS, SEASONS, DAYS_OF_WEEK
+
+
+def get_months() -> List[Dict]:
+    """Returns the twelve months of the Kumaoni solar calendar."""
+    return list(KUMAONI_MONTHS)
+
+
+def get_seasons() -> Dict[str, Dict]:
+    """Returns the traditional Himalayan seasonal divisions."""
+    return dict(SEASONS)
+
+
+def get_days_of_week() -> List[Dict]:
+    """Returns days of the week in Kumaoni."""
+    return list(DAYS_OF_WEEK)
+
+
+def get_current_season(month_name: str) -> Optional[Dict]:
+    """Find the traditional season associated with a Kumaoni month."""
+    for s_key, s_info in SEASONS.items():
+        if month_name in s_info["months"]:
+            return s_info
+    return None