birthdays-cli 0.1.0__py3-none-any.whl

birthdays/__init__.py

@@ -0,0 +1,32 @@
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("birthdays-cli")
+except PackageNotFoundError:
+    __version__ = "unknown"
+
+__about__ = rf"""
+    ✦         ̲     ✦      ✦         🔥          ✦
+        '    (o)       .     🔥     /^\    🔥        ✦
+             ╱:╲           __/^\____|_|____/^\__   *
+    +    ✦  ╱.:|╲    ✦    /  |_|           |_|  \
+           ╱..::|╲        \_____________________/     ✦
+          ╱...:::|╲    ✦  |  . . . . . . . . .  |
+     .   (_________)      | -~-~-~-~-~-~-~-~-~- | ✦
+        ╭╯       ╭─╯      | ~-~-~-~-~-~-~-~-~-~ |     *
+        ╰────────╯        *_____________________*
+
+  birthdays: Your birthday list is in your hands only.
+  ----------------------------------------------------------
+  Version:      {__version__}
+  Author:       Volodymyr Horshenin (@l1asis)
+  License:      MIT
+  Repository:   https://github.com/l1asis/birthdays
+
+  Description: 
+  A command-line utility for displaying and managing birthdays
+  from JSON- or vCard-based contacts.
+
+  Usage:
+  Run `python -m birthdays --help` to see available commands.
+"""

birthdays/__main__.py

@@ -0,0 +1,4 @@
+from .birthdays import main
+
+if __name__ == "__main__":
+    main()

birthdays/birthdays.py

@@ -0,0 +1,979 @@
+import argparse
+import base64
+import calendar
+import datetime
+import difflib
+import json
+import os
+import quopri
+import re
+import sys
+import uuid
+from collections import defaultdict
+from collections.abc import Collection
+from dataclasses import asdict, dataclass
+from operator import attrgetter
+from pathlib import Path
+from typing import Any, List, Literal, Optional, overload
+
+from dateutil.relativedelta import relativedelta
+from platformdirs import user_data_path
+
+from . import __about__, __version__
+from .emojis import date_to_emoji
+
+VCARD = re.compile(r"BEGIN:VCARD.*?END:VCARD", flags=re.DOTALL | re.IGNORECASE)
+FULL_NAME = re.compile(r"^FN(;[^:]*)?:(.*)$", flags=re.MULTILINE | re.IGNORECASE)
+BIRTHDAY = re.compile(r"^BDAY(?:;[^:]*)?:(.*)$", flags=re.MULTILINE | re.IGNORECASE)
+DATE = re.compile(r"^(\d{4}|--)?-?(0[1-9]|1[0-2])-?(0[1-9]|[12]\d|3[01])$")
+NOTE = re.compile(r"^NOTE(;[^:]*)?:(.*)$", flags=re.MULTILINE | re.IGNORECASE)
+UNFOLD = re.compile(r"\r?\n[ \t]")  # glues lines that start with a space or tab
+UNFOLD_SOFT = re.compile(r"=\r?\n")  # glues lines that end with an '='
+
+# ==========================================
+#               DATA MODELS
+# ==========================================
+
+
+@dataclass
+class BirthdayEntry:
+    """A single birthday entry in the database."""
+
+    id: str
+    full_name: str
+    month: int
+    day: int
+    year: Optional[int] = None
+    notes: Optional[str] = None
+    leap_system: Literal["after", "before"] = "before"
+
+    def get_age(self) -> int | None:
+        """Return the person's current age, or None if the year is unknown."""
+        if self.year is None:
+            return None
+        today = datetime.date.today()
+        this_year = leapling_safe_date(
+            today.year, self.month, self.day, self.leap_system
+        )
+        had_birthday = today >= this_year
+        return today.year - self.year - (0 if had_birthday else 1)
+
+    def is_today(self) -> bool:
+        """Check if today is the person's birthday."""
+        today = datetime.date.today()
+        this_year = leapling_safe_date(
+            today.year, self.month, self.day, self.leap_system
+        )
+        return this_year.month == today.month and this_year.day == today.day
+
+    def get_next_occurrence(self, from_date: datetime.date) -> datetime.date:
+        """Calculate the exact date of the next birthday."""
+        this_year = leapling_safe_date(
+            from_date.year, self.month, self.day, self.leap_system
+        )
+        if from_date.month < this_year.month or (
+            from_date.month == this_year.month and from_date.day <= this_year.day
+        ):
+            return this_year
+        return leapling_safe_date(
+            from_date.year + 1, self.month, self.day, self.leap_system
+        )
+
+    def get_prev_occurrence(self, from_date: datetime.date) -> datetime.date:
+        """Calculate the exact date of the previous birthday."""
+        this_year = leapling_safe_date(
+            from_date.year, self.month, self.day, self.leap_system
+        )
+        if from_date.month < this_year.month or (
+            from_date.month == this_year.month and from_date.day < this_year.day
+        ):
+            return leapling_safe_date(
+                from_date.year - 1, self.month, self.day, self.leap_system
+            )
+        return this_year
+
+    def next_occurrence_in(self, from_date: datetime.date) -> relativedelta:
+        """Calculate the exact distance to the next birthday."""
+        return relativedelta(self.get_next_occurrence(from_date), from_date)
+
+    def prev_occurrence_in(self, from_date: datetime.date) -> relativedelta:
+        """Calculate the exact distance to the previous birthday."""
+        return relativedelta(from_date, self.get_prev_occurrence(from_date))
+
+    def __post_init__(self):
+        if not day_might_exist(self.year, self.month, self.day):
+            raise ValueError(
+                f"Date is out of range. "
+                f"Got: {f'{self.year}-' if self.year is not None else ''}"
+                f"{self.month}-{self.day}"
+            )
+
+    def __str__(self) -> str:
+        year_str = f"{self.year}-" if self.year else ""
+        date_str = f"{year_str}{self.month:02d}-{self.day:02d}"
+
+        base = f"{self.full_name} ({date_str})"
+        if self.notes:
+            base = f"{base} - {self.notes}"
+        return base
+
+    def __repr__(self) -> str:
+        return (
+            f"BirthdayEntry({repr(self.id)}, "
+            f"{repr(self.full_name)}, "
+            f"{self.month}, "
+            f"{self.day}, "
+            f"{self.year}, "
+            f"{repr(self.notes) if self.notes else 'None'})"
+        )
+
+    def __lt__(self, other: "BirthdayEntry | datetime.date") -> bool:
+        if self.year is not None and other.year is not None:
+            if self.year != other.year:
+                return self.year < other.year
+        return self.month < other.month or (
+            self.month == other.month and self.day < other.day
+        )
+
+    def __gt__(self, other: "BirthdayEntry | datetime.date") -> bool:
+        if self.year is not None and other.year is not None:
+            if self.year != other.year:
+                return self.year > other.year
+        return self.month > other.month or (
+            self.month == other.month and self.day > other.day
+        )
+
+    def __le__(self, other: "BirthdayEntry | datetime.date") -> bool:
+        if self.year is not None and other.year is not None:
+            if self.year != other.year:
+                return self.year < other.year
+        return self.month < other.month or (
+            self.month == other.month and self.day <= other.day
+        )
+
+    def __ge__(self, other: "BirthdayEntry | datetime.date") -> bool:
+        if self.year is not None and other.year is not None:
+            if self.year != other.year:
+                return self.year > other.year
+        return self.month > other.month or (
+            self.month == other.month and self.day >= other.day
+        )
+
+
+# ==========================================
+#               STORAGE APIs
+# ==========================================
+
+
+def get_database_path() -> Path:
+    """Resolve OS-specific config path."""
+    if custom_path := os.getenv("BIRTHDAYS_HOME"):
+        dir_path = Path(custom_path)
+    else:
+        dir_path = user_data_path(
+            "birthdays",
+            "l1asis",
+            ensure_exists=True,
+        )
+
+    dir_path.mkdir(parents=True, exist_ok=True)
+
+    return dir_path / "birthdays.json"
+
+
+def as_birthday_entry(dictionary: dict[str, Any]) -> BirthdayEntry:
+    """Read a JSON dictionary and safely convert it into BirthdayEntry."""
+    return BirthdayEntry(
+        dictionary["id"],
+        dictionary["full_name"],
+        dictionary["month"],
+        dictionary["day"],
+        dictionary.get("year"),
+        dictionary.get("notes"),
+        dictionary.get("leap_system", "before"),
+    )
+
+
+def load_database(db_path: Path) -> List[BirthdayEntry]:
+    """Read the JSON file and inflate it into BirthdayEntry objects."""
+    if not db_path.exists():
+        return []
+
+    with open(db_path, "r", encoding="utf-8") as file:
+        return json.load(file, object_hook=as_birthday_entry)
+
+
+def save_database(entries: List[BirthdayEntry], db_path: Path) -> None:
+    """Serialize BirthdayEntry objects and write them to the JSON file."""
+    dictionaries = tuple(asdict(entry) for entry in entries)
+    with open(db_path, "w", encoding="utf-8") as file:
+        json.dump(dictionaries, file, indent=4)
+
+
+# ==========================================
+#            CORE LOGIC APIs
+# ==========================================
+
+
+def decode_vcard_text(raw_text: str, parameters: str | None) -> str:
+    """Safely decode Quoted-Printable or Base64 vCard strings."""
+    if not parameters:
+        return raw_text.strip()
+
+    parameters = parameters.upper()
+    if "ENCODING=QUOTED-PRINTABLE" in parameters:
+        unquoted = quopri.decodestring(raw_text)
+        if "CHARSET=UTF-8" in parameters:
+            return unquoted.decode("utf-8", errors="replace").strip()
+        return unquoted.decode("latin1", errors="replace").strip()
+
+    elif "ENCODING=B" in parameters:
+        unbased = base64.standard_b64decode(raw_text)
+        if "CHARSET=UTF-8" in parameters:
+            return unbased.decode("utf-8", errors="replace").strip()
+        return unbased.decode("latin1", errors="replace").strip()
+
+    return raw_text.strip()
+
+
+def leapling_safe_date(
+    year: int, month: int, day: int, leap_system: Literal["after", "before"] = "before"
+) -> datetime.date:
+    if not is_leap(year) and month == 2 and day == 29:
+        if leap_system == "before":
+            return datetime.date(year, 2, 28)
+        return datetime.date(year, 3, 1)
+    return datetime.date(year, month, day)
+
+
+def is_leap(year: int) -> bool:
+    return year % 4 == 0 and (year % 100 != 0 or year % 400 == 0)
+
+
+def day_might_exist(year: int | None, month: int, day: int) -> bool:
+    """Check if a day is valid for a given month, handling missing years safely."""
+    _, num_days = calendar.monthrange(year if year is not None else 2024, month)
+    return 1 <= day <= num_days
+
+
+def parse_vcards(
+    vcf_file: Path, leap_system: Literal["after", "before"]
+) -> List[BirthdayEntry]:
+    """Extract names, birthdays, and notes from all vCard formats."""
+    with open(vcf_file, "r", encoding="utf-8") as file:
+        raw_text = file.read()
+
+    unfolded_text = UNFOLD.sub("", raw_text)
+    unfolded_text = UNFOLD_SOFT.sub("", raw_text)
+
+    vcards: list[str] = VCARD.findall(unfolded_text)
+    birthdays: List[BirthdayEntry] = []
+
+    for vcard in vcards:
+        fn_match = FULL_NAME.search(vcard)
+        bday_match = BIRTHDAY.search(vcard)
+        note_match = NOTE.search(vcard)
+
+        if fn_match is not None:
+            full_name = decode_vcard_text(fn_match.group(2), fn_match.group(1))
+
+            if bday_match is not None:
+                date_str = bday_match.group(1)
+                year = month = day = None
+
+                try:
+                    date = datetime.date.fromisoformat(date_str)
+                    year, month, day = date.year, date.month, date.day
+
+                except ValueError:
+                    date_match = DATE.match(date_str)
+
+                    if date_match is not None:
+                        year, month, day = (
+                            int(year_match)
+                            if (year_match := date_match.group(1)).isdecimal()
+                            else None,
+                            int(date_match.group(2)),
+                            int(date_match.group(3)),
+                        )
+
+                if month is not None and day is not None:
+                    notes = None
+                    if note_match is not None:
+                        raw_note = decode_vcard_text(
+                            note_match.group(2), note_match.group(1)
+                        )
+                        notes = raw_note.replace(r"\n", " ").replace(r"\,", ",")
+
+                    birthdays.append(
+                        BirthdayEntry(
+                            uuid.uuid4().hex,
+                            full_name,
+                            month,
+                            day,
+                            year,
+                            notes,
+                            leap_system,
+                        )
+                    )
+
+    return birthdays
+
+
+def merge_pair(
+    existing: BirthdayEntry, incoming: BirthdayEntry, interactive: bool = True
+) -> BirthdayEntry:
+    """Combine data of two entries meaningfully."""
+
+    merged_notes = tuple(n for n in (existing.notes, incoming.notes) if n)
+    merged_notes = "; ".join(merged_notes) if merged_notes else None
+
+    if interactive:
+        notes_choice = choose(("Existing", "Incoming", "Merge"))
+        if notes_choice == "1":
+            final_notes = existing.notes
+        elif notes_choice == "2":
+            final_notes = incoming.notes
+        else:
+            final_notes = merged_notes
+
+        return BirthdayEntry(
+            existing.id,
+            incoming.full_name
+            if existing.full_name != incoming.full_name
+            and confirm("Change the full name?")
+            else existing.full_name,
+            incoming.month
+            if existing.month != incoming.month and confirm("Change the month?")
+            else existing.month,
+            incoming.day
+            if existing.day != incoming.day and confirm("Change the day?")
+            else existing.day,
+            incoming.year
+            if existing.year is None
+            or (existing.year != incoming.year and confirm("Change the year?"))
+            else existing.year,
+            final_notes,
+            incoming.leap_system
+            if existing.leap_system != incoming.leap_system
+            and confirm("Change the leap system?")
+            else existing.leap_system,
+        )
+    return BirthdayEntry(
+        existing.id,
+        incoming.full_name,
+        incoming.month,
+        incoming.day,
+        incoming.year if existing.year is None else existing.year,
+        merged_notes,
+        incoming.leap_system,
+    )
+
+
+def merge_entries(
+    existing: List[BirthdayEntry],
+    incoming: List[BirthdayEntry],
+    interactive: bool = True,
+) -> List[BirthdayEntry]:
+    """Merge two lists using fuzzy string matching to detect similar names."""
+
+    existing_map: dict[str, list[BirthdayEntry]] = defaultdict(list)
+    for entry in existing:
+        existing_map[entry.full_name].append(entry)
+
+    existing_names = tuple(existing_map.keys())
+
+    final_db = {entry.id: entry for entry in existing}
+
+    for new_entry in incoming:
+        if new_entry.full_name in existing_map:
+            if len(existing_map[new_entry.full_name]) > 1:
+                choice = choose(
+                    existing_map[new_entry.full_name],
+                    prompt=(
+                        f"\nMultiple exact matches for '{new_entry.full_name}'. "
+                        "Which one to merge into?"
+                    ),
+                    extra={"S": "Skip this contact entirely"},
+                    required=True,
+                )
+
+                if choice == "S":
+                    continue
+
+                match = existing_map[new_entry.full_name][int(choice) - 1]
+            else:
+                match = existing_map[new_entry.full_name][0]
+
+            if (
+                match.month == new_entry.month
+                and match.day == new_entry.day
+                and match.year == new_entry.year
+                and match.notes == new_entry.notes
+            ):
+                continue
+
+            if interactive:
+                print(
+                    (
+                        f"\nExact name match found for '{new_entry.full_name}', "
+                        "but data differs."
+                    )
+                )
+                print(f"Existing: {match}")
+                print(f"Incoming: {new_entry}")
+                if confirm("Update existing entry?"):
+                    final_db[match.id] = merge_pair(match, new_entry)
+            else:
+                final_db[match.id] = merge_pair(match, new_entry, interactive=False)
+
+        else:
+            close_names = difflib.get_close_matches(
+                new_entry.full_name, existing_names, n=3, cutoff=0.8
+            )
+
+            if not close_names:
+                final_db[new_entry.id] = new_entry
+                continue
+
+            if interactive:
+                print(f"\nIncoming contact: {new_entry}")
+                print("Found similar existing names:")
+
+                options: List[BirthdayEntry] = [
+                    entry for name in close_names for entry in existing_map[name]
+                ]
+
+                choice = choose(
+                    options,
+                    extra={
+                        "A": "Add as completely new entry",
+                        "S": "Skip this contact entirely",
+                    },
+                    required=True,
+                )
+
+                if choice == "A":
+                    final_db[new_entry.id] = new_entry
+                elif choice == "S":
+                    pass
+                elif choice.isdigit():
+                    selected_match = options[int(choice) - 1]
+                    final_db[selected_match.id] = merge_pair(selected_match, new_entry)
+            else:
+                final_db[new_entry.id] = new_entry
+
+    return list(final_db.values())
+
+
+def find_entry(db: List[BirthdayEntry], identifier: str) -> BirthdayEntry | None:
+    """Locate an entry by UUID, name, date, or fuzzy match."""
+
+    for entry in db:
+        if entry.id == identifier:
+            return entry
+
+    matches: list[BirthdayEntry] = []
+    ident_lower = identifier.casefold()
+
+    date_match = DATE.match(identifier)
+    year = month = day = None
+    if date_match:
+        year_group = date_match.group(1)
+        year = int(year_group) if year_group and year_group != "--" else None
+        month = int(date_match.group(2))
+        day = int(date_match.group(3))
+
+    for entry in db:
+        if entry.full_name.casefold() == ident_lower:
+            matches.append(entry)
+        elif (
+            date_match
+            and entry.month == month
+            and entry.day == day
+            and (not year or entry.year == year)
+        ):
+            matches.append(entry)
+        elif ident_lower in entry.full_name.casefold():
+            matches.append(entry)
+        elif entry.notes and ident_lower in entry.notes.casefold():
+            matches.append(entry)
+
+    if not matches:
+        db_names = [e.full_name for e in db]
+        close_names = difflib.get_close_matches(identifier, db_names, n=5, cutoff=0.6)
+
+        if close_names:
+            close_names_set = set(close_names)
+            for entry in db:
+                if entry.full_name in close_names_set:
+                    matches.append(entry)
+
+    if not matches:
+        print(f"Error: No entry found matching '{identifier}'.")
+        return None
+
+    if len(matches) == 1:
+        return matches[0]
+
+    choice = choose(
+        matches,
+        prompt=f"\nMultiple entries found for '{identifier}'. Which one did you mean?",
+        extra={"S": "Skip/Cancel"},
+        required=True,
+    )
+    if choice == "S":
+        return None
+
+    return matches[int(choice) - 1]
+
+
+# ==========================================
+#             PRESENTATION APIs
+# ==========================================
+
+
+def confirm(
+    prompt: str = "Are you sure?",
+    default_no: bool = True,
+    required: bool = False,
+    allow_skip: bool = False,
+) -> bool | None:
+    """Prompt user for a confirmation."""
+
+    if required:
+        suffix = "(y/n/s)" if allow_skip else "(y/n)"
+    else:
+        if allow_skip:
+            suffix = "(y/N/s)" if default_no else "(Y/n/s)"
+        else:
+            suffix = "(y/N)" if default_no else "(Y/n)"
+
+    while True:
+        user_input = input(f"{prompt} {suffix}: ").strip().lower()
+
+        if not user_input:
+            if required:
+                print("Input is required. Please choose an option.")
+                continue
+            return not default_no
+
+        elif user_input in {"yes", "y"}:
+            return True
+
+        elif allow_skip and user_input in {"skip", "s"}:
+            return None
+
+        elif user_input in {"no", "n"}:
+            return False
+
+        if required:
+            print("Invalid input. Please choose a valid option.")
+            continue
+
+        return False
+
+
+@overload
+def choose(
+    options: Collection[Any],
+    extra: dict[str, str] | None = None,
+    prompt: str = "Choose an option:",
+    start: int = 1,
+    required: Literal[True] = True,
+) -> str: ...
+
+
+@overload
+def choose(
+    options: Collection[Any],
+    extra: dict[str, str] | None = None,
+    prompt: str = "Choose an option:",
+    start: int = 1,
+    required: Literal[False] = ...,
+) -> str | None: ...
+
+
+def choose(
+    options: Collection[Any],
+    extra: dict[str, str] | None = None,
+    prompt: str = "Choose an option:",
+    start: int = 1,
+    required: bool = False,
+) -> str | None:
+    """Prompt user to make a choice."""
+    print(prompt)
+    for position, option in enumerate(options, start):
+        print(f"[{position}] - {option}")
+
+    if extra:
+        for key, value in extra.items():
+            print(f"[{key}] - {value}")
+
+    while True:
+        choice = input("-> My choice is... ").strip()
+
+        if not choice:
+            if required:
+                print("Input is required. Please choose a valid option.")
+                continue
+            return None
+
+        if choice.isdecimal():
+            if start <= int(choice) < start + len(options):
+                return choice
+
+        if extra:
+            choice_lower = choice.lower()
+            for key in extra:
+                if key.lower() == choice_lower:
+                    return key
+
+        if required:
+            print("Invalid choice. Please try again.")
+        else:
+            return None
+
+
+def to_ordinal(number: int) -> str:
+    """Convert a cardinal number into its ordinal form."""
+    n = abs(number)
+    if n % 100 in (11, 12, 13):
+        return f"{n}th"
+    elif n % 10 == 1:
+        return f"{n}st"
+    elif n % 10 == 2:
+        return f"{n}nd"
+    elif n % 10 == 3:
+        return f"{n}rd"
+    return f"{n}th"
+
+
+def display_birthdays(
+    entries: List[BirthdayEntry],
+    sort_by: Literal["name", "date", "upcoming", "recent", "age"] = "upcoming",
+    sort_order: Literal["asc", "desc"] = "desc",
+    view_style: Literal["simple", "table", "calendar"] = "simple",
+) -> None:
+    """Handle all terminal printing."""
+    today = datetime.date.today()
+
+    if sort_by == "name":
+        entries.sort(
+            key=lambda entry: entry.full_name.casefold(), reverse=sort_order == "desc"
+        )
+    elif sort_by == "date":
+        entries.sort(
+            key=lambda entry: (
+                entry.year
+                if entry.year is not None
+                else float("inf" if sort_order == "asc" else "-inf"),
+                entry.month,
+                entry.day,
+            ),
+            reverse=sort_order == "desc",
+        )
+    elif sort_by == "upcoming":
+        entries.sort(
+            key=lambda entry: attrgetter("years", "months", "days")(
+                entry.next_occurrence_in(today)
+            ),
+            reverse=sort_order == "desc",
+        )
+    elif sort_by == "recent":
+        entries.sort(
+            key=lambda entry: attrgetter("years", "months", "days")(
+                entry.prev_occurrence_in(today)
+            ),
+            reverse=sort_order == "desc",
+        )
+    elif sort_by == "age":
+        entries.sort(
+            key=lambda entry: (
+                age
+                if (age := entry.get_age()) is not None
+                else float("inf" if sort_order == "asc" else "-inf")
+            ),
+            reverse=sort_order == "desc",
+        )
+
+    if view_style == "simple":
+        print("Birthdays 🎂")
+        for entry in entries:
+            emoji = date_to_emoji(entry.year, entry.month, entry.day)
+            age = entry.get_age()
+            next_in = entry.next_occurrence_in(today)
+            prev_in = entry.prev_occurrence_in(today)
+
+            print(f"{emoji:<2} {entry}")
+            if entry.is_today():
+                age = f"{to_ordinal(age)} " if age is not None else ""
+                print(f"Has a {age}birthday today 🥳")
+            else:
+                age = f"{age} y.o., " if age is not None else ""
+                months = tuple(
+                    f" {delta.months} month{'s' if delta.months > 1 else ''}"
+                    if delta.months > 0
+                    else ""
+                    for delta in (next_in, prev_in)
+                )
+                days = tuple(
+                    (
+                        f"{' and' if delta.months else ''} "
+                        f"{delta.days} day{'s' if delta.days > 1 else ''}"
+                    )
+                    if delta.days > 0
+                    else ""
+                    for delta in (next_in, prev_in)
+                )
+                if sort_by != "recent":
+                    print(f"{age}Next in{months[0]}{days[0]}")
+                elif sort_by == "recent":
+                    print(f"{age}Previous:{months[1]}{days[1]} ago")
+
+
+# ==========================================
+#               ARGPARSE CLI
+# ==========================================
+
+
+def setup_parser() -> argparse.ArgumentParser:
+    """Build the CLI interface."""
+
+    parser = argparse.ArgumentParser(
+        prog="birthdays",
+        description="A robust CLI tool to manage, merge, and track birthdays.",
+    )
+
+    parser.add_argument(
+        "--version",
+        action="version",
+        help="Show program's version number and exit",
+        version=f"%(prog)s {__version__}",
+    )
+    parser.add_argument(
+        "--about",
+        action="store_true",
+        help="Show information about this program",
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+    subparsers.required = True
+
+    parser_list = subparsers.add_parser("list", help="Display saved birthdays")
+    parser_list.add_argument(
+        "--sort",
+        choices=["name", "date", "upcoming", "recent", "age"],
+        default="upcoming",
+        help="How to sort the output",
+    )
+    parser_list.add_argument(
+        "--order",
+        choices=["asc", "desc"],
+        default="desc",
+        help="In which order to sort the output",
+    )
+    parser_list.add_argument(
+        "--view",
+        choices=["simple", "table", "calendar"],
+        default="simple",
+        help="Visual presentation style",
+    )
+    parser_list.add_argument(
+        "-f",
+        "--file",
+        type=Path,
+        help="Read directly from a .vcf or .json file without modifying the database",
+    )
+    parser_list.add_argument(
+        "--leap-system",
+        choices=["before", "after"],
+        default="before",
+        help="Fallback leap system when reading dynamically from a .vcf file",
+    )
+
+    parser_add = subparsers.add_parser("add", help="Manually add a new birthday")
+    parser_add.add_argument("name", type=str, help="Full name of the person")
+    parser_add.add_argument("date", type=str, help="Birthday (YYYY-MM-DD | MM-DD)")
+    parser_add.add_argument("--note", type=str, help="Optional note to attach")
+    parser_add.add_argument(
+        "--leap-system",
+        dest="leap_system",
+        choices=["before", "after"],
+        default="before",
+        help="When leaplings celebrate in non-leap years (default: before)",
+    )
+
+    parser_edit = subparsers.add_parser("edit", help="Modify an existing entry")
+    parser_edit.add_argument("identifier", type=str, help="Name or UUID of the person")
+    parser_edit.add_argument("--name", type=str, help="Update the full name")
+    parser_edit.add_argument(
+        "--date", type=str, help="Update the birthday (YYYY-MM-DD | MM-DD)"
+    )
+    parser_edit.add_argument("--note", type=str, help="Update the attached note")
+    parser_edit.add_argument(
+        "--leap-system",
+        dest="leap_system",
+        choices=["before", "after"],
+        help="Update when this leapling celebrates in non-leap years",
+    )
+
+    parser_delete = subparsers.add_parser("delete", help="Delete an entry")
+    parser_delete.add_argument(
+        "identifier", type=str, help="Name or UUID of the person"
+    )
+    parser_delete.add_argument(
+        "-y", "--yes", action="store_true", help="Skip the confirmation prompt"
+    )
+
+    parser_import = subparsers.add_parser(
+        "import", help="Import birthdays from a vCard or JSON file"
+    )
+    parser_import.add_argument("file", type=Path, help="Path to the .vcf file")
+    parser_import.add_argument(
+        "-y",
+        "--yes",
+        action="store_true",
+        help="Skip interactive collision prompts and auto-merge safe entries",
+    )
+    parser_import.add_argument(
+        "--leap-system",
+        dest="leap_system",
+        choices=["before", "after"],
+        default="before",
+        help="Default leap system to assign to imported contacts",
+    )
+
+    return parser
+
+
+def main():
+    if "--about" in sys.argv:
+        print(__about__)
+        sys.exit(0)
+
+    parser = setup_parser()
+    args = parser.parse_args()
+
+    db_path = get_database_path()
+
+    if args.command == "list":
+        if args.file:
+            if not args.file.exists():
+                print(f"Error: File '{args.file}' not found.")
+                sys.exit(1)
+            if args.file.suffix.lower() in [".vcf", ".vcard"]:
+                entries = parse_vcards(args.file, args.leap_system)
+            else:
+                entries = load_database(args.file)
+        else:
+            entries = load_database(db_path)
+
+        if not entries:
+            print("No birthdays found.")
+            return
+
+        display_birthdays(
+            entries, sort_by=args.sort, sort_order=args.order, view_style=args.view
+        )
+
+    elif args.command == "add":
+        db = load_database(db_path)
+
+        date_match = DATE.match(args.date)
+        if not date_match:
+            print("Error: Invalid date format. Use YYYY-MM-DD or MM-DD.")
+            sys.exit(1)
+
+        year_group = date_match.group(1)
+        year = int(year_group) if year_group and year_group != "--" else None
+        month = int(date_match.group(2))
+        day = int(date_match.group(3))
+
+        try:
+            new_entry = BirthdayEntry(
+                id=uuid.uuid4().hex,
+                full_name=args.name,
+                month=month,
+                day=day,
+                year=year,
+                notes=args.note,
+                leap_system=args.leap_system,
+            )
+        except ValueError as e:
+            print(f"Error creating entry: {e}")
+            sys.exit(1)
+
+        db.append(new_entry)
+        save_database(db, db_path)
+        print(f"Added: {new_entry}")
+
+    elif args.command == "edit":
+        db = load_database(db_path)
+        target = find_entry(db, args.identifier)
+        if not target:
+            sys.exit(1)
+
+        if args.name:
+            target.full_name = args.name
+
+        if args.date:
+            date_match = DATE.match(args.date)
+            if not date_match:
+                print("Error: Invalid date format. Use YYYY-MM-DD or MM-DD.")
+                sys.exit(1)
+
+            year_group = date_match.group(1)
+            target.year = int(year_group) if year_group and year_group != "--" else None
+            target.month = int(date_match.group(2))
+            target.day = int(date_match.group(3))
+
+        if args.note is not None:
+            target.notes = args.note if args.note.strip() else None
+
+        if args.leap_system:
+            target.leap_system = args.leap_system
+
+        save_database(db, db_path)
+        print(f"Updated: {target}")
+
+    elif args.command == "delete":
+        db = load_database(db_path)
+        target = find_entry(db, args.identifier)
+        if not target:
+            sys.exit(1)
+
+        if not args.yes:
+            if not confirm(f"Are you sure you want to delete {target}?"):
+                print("Deletion cancelled.")
+                return
+
+        db = [e for e in db if e.id != target.id]
+        save_database(db, db_path)
+        print(f"Deleted '{target.full_name}'.")
+
+    elif args.command == "import":
+        if not args.file.exists():
+            print(f"Error: File '{args.file}' not found.")
+            sys.exit(1)
+
+        db = load_database(db_path)
+
+        if args.file.suffix.lower() in [".vcf", ".vcard"]:
+            incoming = parse_vcards(args.file, args.leap_system)
+        else:
+            incoming = load_database(args.file)
+
+        print(f"Loaded {len(incoming)} contacts from {args.file.name}.")
+
+        merged_db = merge_entries(db, incoming, interactive=not args.yes)
+        save_database(merged_db, db_path)
+
+        added_count = len(merged_db) - len(db)
+        print(f"\nImport complete. The database grew by {added_count} entries.")
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

birthdays/emojis.py

@@ -0,0 +1,132 @@
+from hashlib import sha256
+
+# fmt: off
+POSITIVE_FACES = (
+    # Basic Smiles
+    '😀', '😃', '😄', '😁', '😆', '😅', '🤣', '😂', '🙂', '🙃', '🫠', '😉', '😊',
+    '😇', '🥰', '😍', '🤩', '😘', '😗', '☺️', '😚', '😙', '🥲',
+    
+    # Tongues, Hands, and Accessories
+    '😋', '😛', '😝', '😜', '🤪', '🤑', '🤗', '🤭', '🤫', '🤔', '🫡', '🤐', '🤨',
+    '🥳', '🥸', '😎', '🤓', '🧐',
+    
+    # Neutral and skeptical
+    '😐', '😑', '😶', '🫥', '😶‍🌫️', '😏', '😌',
+    
+    # Costumes, Creatures, and Animals
+    '😺', '😸', '😹', '😻', '😼', '😽', '🙈', '🙉', '🙊'
+)
+
+ANIMALS_AND_NATURE = (
+    # Mammals & Marsupials
+    '🐵', '🐒', '🦍', '🦧', '🐶', '🐕', '🦮', '🐕‍🦺', '🐩', '🐺', '🦊', '🦝', '🐱',
+    '🐈', '🐈‍⬛', '🦁', '🐯', '🐅', '🐆', '🐴', '🫎', '🫏', '🐎', '🦄', '🦓', '🦌',
+    '🦬', '🐮', '🐂', '🐃', '🐄', '🐷', '🐖', '🐗', '🐽', '🐏', '🐑', '🐐', '🐪',
+    '🐫', '🦙', '🦒', '🐘', '🦣', '🦏', '🦛', '🐭', '🐁', '🐀', '🐹', '🐰', '🐇',
+    '🐿️', '🦫', '🦔', '🦇', '🐻', '🐻‍❄️', '🐨', '🐼', '🦥', '🦦', '🦨', '🦘', '🦡',
+    '🐾',
+
+    # Birds
+    '🦃', '🐔', '🐓', '🐣', '🐤', '🐥', '🐦', '🐧', '🕊️', '🦅', '🦆', '🦢', '🦉',
+    '🦤', '🪶', '🦩', '🦚', '🦜', '🪽', '🐦‍⬛', '🪿', '🐦‍🔥', '🪹', '🪺',
+
+    # Marine Life and Reptiles
+    '🐸', '🐊', '🐢', '🦎', '🐍', '🐲', '🐉', '🦕', '🦖', '🐳', '🐋', '🐬', '🦭',
+    '🐟', '🐠', '🐡', '🦈', '🐙', '🐚', '🪸', '🪼', '🦀', '🦞', '🦐', '🦑', '🦪',
+
+    # Insects
+    '🐌', '🦋', '🐛', '🐜', '🐝', '🪲', '🐞', '🦗', '🪳', '🕷️', '🕸️', '🦂', '🦟',
+    '🪰', '🪱', '🦠',
+
+    # Plants, Flowers, and Nature
+    '💐', '🌸', '💮', '🪷', '🏵️', '🌹', '🥀', '🌺', '🌻', '🌼', '🌷', '🪻', '🌱',
+    '🪴', '🌲', '🌳', '🌴', '🌵', '🌾', '🌿', '☘️', '🍀', '🍁', '🍂', '🍃', '🍄',
+    '🫚', '🪨', '🪵',
+
+    # Sky and Weather
+    '🌑', '🌒', '🌓', '🌔', '🌕', '🌖', '🌗', '🌘', '🌙', '🌚', '🌛', '🌜', '☀️',
+    '🌝', '🌞', '🪐', '⭐', '🌟', '🌠', '🌌', '☁️', '⛅', '⛈️', '🌤️', '🌥️', '🌦️',
+    '🌧️', '🌨️', '🌩️', '🌪️', '🌫️', '🌬️', '🌀', '🌈', '🌂', '☂️', '☔', '⛱️', '⚡',
+    '❄️', '☃️', '⛄', '☄️', '🔥', '💧', '🌊'
+)
+
+FOOD_AND_DRINK = (
+    # Fruits
+    '🍇', '🍈', '🍉', '🍊', '🍋', '🍋‍🟩', '🍌', '🍍', '🥭', '🍎', '🍏', '🍐', '🍑',
+    '🍒', '🍓', '🫐', '🥝', '🍅', '🫒', '🥥',
+
+    # Vegetables
+    '🥑', '🍆', '🥔', '🥕', '🌽', '🌶️', '🫑', '🥒', '🥬', '🥦', '🧄', '🧅', '🥜',
+    '🫘', '🌰', '🫚', '🫛', '🍄‍🟫', '🍠', 
+
+    # Dishes
+    '🍞', '🥐', '🥖', '🫓', '🥨', '🥯', '🥞', '🧇', '🧀', '🍖', '🍗', '🥩', '🥓',
+    '🍔', '🍟', '🍕', '🌭', '🥪', '🌮', '🌯', '🫔', '🥙', '🧆', '🥚', '🍳', '🥘',
+    '🍲', '🫕', '🥣', '🥗', '🍿', '🧈', '🧂', '🥫', '🍝',
+
+    # Asian Dishes
+    '🍱', '🍘', '🍙', '🍚', '🍛', '🍜', '🍠', '🍢', '🍣', '🍤', '🍥', '🥮', '🍡',
+    '🥟', '🥠', '🥡',
+
+    # Sweets and Desserts
+    '🍦', '🍧', '🍨', '🍩', '🍪', '🎂', '🍰', '🧁', '🥧', '🍫', '🍬', '🍭', '🍮',
+    '🍯',
+
+    # Beverages and Tableware
+    '🍼', '🥛', '☕', '🫖', '🍵', '🍶', '🍾', '🍷', '🍸', '🍹', '🍺', '🍻', '🥂',
+    '🥃', '🫗', '🥤', '🧋', '🧃', '🧉', '🥢', '🍽️', '🍴', '🥄', '🔪', '🫙', '🏺'
+)
+
+ACTIVITIES = (
+    # Events and Celebrations
+    '🎃', '🎄', '🎆', '🎇', '🧨', '✨', '🎈', '🎉', '🎊', '🎋', '🎍', '🎎', '🎏',
+    '🎐', '🎑', '🧧', '🎁', '🎟️', '🎫', '🏮', '🪔',
+
+    # Sports and Awards
+    '🏅', '🏆', '🎖️', '🥇', '🥈', '🥉', '⚽', '⚾', '🥎', '🏀', '🏐', '🏈', '🏉',
+    '🎾', '🥏', '🎳', '🏏', '🏑', '🏒', '🥍', '🏓', '🏸', '🥊', '🥋', '🥅', '⛳',
+    '⛸️', '🎣', '🤿', '🎽', '🎿', '🛷', '🥌', '🎯',
+
+    # Games and Culture
+    '🪀', '🪁', '🔫', '🎱', '🔮', '🪄', '🎮', '🕹️', '🎰', '🎲', '🧩', '🪅', '🪩',
+    '🪆', '♠️', '♥️', '♦️', '♣️', '♟️', '🃏', '🀄', '🎴', '🎭', '🖼️', '🎨'
+)
+
+TRAVEL_AND_PLACES = (
+    # Maps and Geography
+    '🌍', '🌎', '🌏', '🌐', '🗺️', '🗾', '🧭', '🏔️', '⛰️', '🌋', '🗻', '🏕️', '🏖️',
+    '🏜️', '🏝️', '🏞️', '🏯', '🏰', '💒', '🗼', '🗽', '⛪', '🕌', '🛕', '🕍', '⛩️',
+    '🕋', '⛲', '⛺', '🌁', '🌃', '🏙️', '🌄', '🌅', '🌆', '🌇', '🌉', '♨️', '🎠',
+    '🎡', '🎢', '💈', '🎪', '🛎️', '🗿',
+
+    # Land Travel
+    '🚂', '🚃', '🚄', '🚅', '🚆', '🚇', '🚈', '🚉', '🚊', '🚝', '🚞', '🚋', '🚌',
+    '🚍', '🚎', '🚐', '🚑', '🚒', '🚓', '🚔', '🚕', '🚖', '🚗', '🚘', '🚙', '🛻',
+    '🚚', '🚛', '🚜', '🏎️', '🏍️', '🛵', '🦽', '🦼', '🛺', '🚲', '🛴', '🛹', '🛼',
+    '🚏', '🛣️', '🛤️', '🛢️', '⛽', '🛞', '🚨', '🚥', '🚦', '🛑', '🚧',
+
+    # Air and Sea Travel
+    '⚓', '🛟', '⛵', '🛶', '🚤', '🛳️', '⛴️', '🛥️', '🚢', '✈️', '🛩️', '🛫', '🛬',
+    '🪂', '💺', '🚁', '🚟', '🚠', '🚡', '🛰️', '🚀', '🛸'
+)
+# fmt:on
+
+ALL_EMOJIS = (
+    POSITIVE_FACES
+    + ANIMALS_AND_NATURE
+    + FOOD_AND_DRINK
+    + ACTIVITIES
+    + TRAVEL_AND_PLACES
+)
+
+
+def date_to_emoji(year: int | None, month: int, day: int) -> str:
+    """Get a unique emoji for the specified date."""
+    if isinstance(year, int):
+        encoded = f"{year}-{month}-{day}".encode("utf-8")
+    else:
+        encoded = f"{month}-{day}".encode("utf-8")
+
+    hashed = sha256(encoded).hexdigest()
+
+    return ALL_EMOJIS[int(hashed, 16) % len(ALL_EMOJIS)]

birthdays_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: birthdays-cli
+Version: 0.1.0
+Summary: A command-line utility for displaying and managing birthdays from JSON- or vCard-based contacts.
+Project-URL: Repository, https://github.com/l1asis/birthdays.git
+Project-URL: Issues, https://github.com/l1asis/birthdays/issues
+Author: Volodymyr Horshenin
+License-Expression: MIT
+License-File: LICENSE
+Keywords: address-book,birthday-tracker,birthdays,calendar,cli,command-line,contacts,vcard,vcf
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: python-dateutil>=2.8.2
+Description-Content-Type: text/markdown
+
+# birthdays
+
+![birthdays GIF demo](https://raw.githubusercontent.com/l1asis/birthdays/refs/heads/main/examples/demo.gif)
+
+[![PyPI Version](https://img.shields.io/pypi/v/birthdays-cli.svg)](https://pypi.org/project/birthdays-cli/)
+[![PyPI Python version](https://img.shields.io/pypi/pyversions/birthdays-cli.svg)](https://pypi.org/project/birthdays-cli/)
+![PyPI downloads](https://img.shields.io/pypi/dm/birthdays-cli)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+
+`birthdays` is a robust Python command-line tool designed to conveniently manage, track, and celebrate your contacts' birthdays.
+
+## Features
+
+- **Customizable Sorting:** List birthdays exactly how you want to see them (by upcoming, recent, age, name, or date)
+- **CRUD Operations:** Easily `add`, `edit`, and `delete` entries. The deletion and edit commands feature a convenient fuzzy search so you don't have to type out exact names
+- **Smart Imports:** Import contacts directly from `.vcf` vCard files or JSON databases
+- **Interactive Merging:** During imports, the CLI intelligently detects duplicates or data collisions and prompts you to safely merge them
+- **Leapling Support:** Configure how leap year birthdays (February 29th) are handled in non-leap years, choosing to celebrate either the day before or the day after
+- **Festive UI:** Every date is assigned a unique, deterministic emoji to keep the terminal vibe bright and colorful
+
+## Requirements
+
+- Python 3.11+
+
+## Installation
+
+Install the package from PyPI using your favorite package management tool such as pip, pipx, or uv:
+
+```bash
+pip install birthdays-cli
+```
+
+Or install the latest version from source:
+
+```bash
+git clone https://github.com/l1asis/birthdays.git
+cd birthdays
+pip install .
+```
+
+## Usage
+
+`birthdays` uses simple subcommands to organize different operations. You can append `--help` to any command to see its available arguments.
+
+### Listing Birthdays
+
+> [!NOTE]
+> By default, this sorts by upcoming birthdays in descending order so the most immediate celebrations are right at your cursor.
+
+```bash
+birthdays list
+```
+
+**Options:**
+
+- `--sort`: Choose from `name`, `date`, `upcoming`, `recent`, or `age`.
+- `--order`: Choose `asc` or `desc`.
+- `-f`, `--file`: Temporarily read and display birthdays directly from a `.vcf` or `.json` file without modifying your local database.
+
+### Adding an Entry
+
+> [!NOTE]
+> The date can be formatted as `YYYY-MM-DD`, or simply `MM-DD` if the year is unknown.
+
+```bash
+birthdays add "John Doe" 1990-05-14 --note "Loves chocolate cake"
+```
+
+### Editing an Entry
+
+> [!NOTE]
+> You can use either the name or UUID. You only need to pass the flags for the specific data you want to change.
+
+```bash
+birthdays edit "John Doe" --date 1991-05-14
+```
+
+### Deleting an Entry
+
+> [!TIP]
+> The CLI uses fuzzy matching, so typing a partial name usually works! Append `-y` to skip the confirmation prompt.
+
+```bash
+birthdays delete "John Doe"
+```
+
+### Importing Contacts
+
+> [!TIP]
+> The interactive prompt will guide you through any data collisions. Append `-y` to automatically skip these prompts and blindly merge safe entries.
+
+```bash
+birthdays import ./contacts.vcf
+```
+
+## Contributing
+
+Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feat/amazing-feature`)
+3. Commit your Changes (`git commit -m 'feat: ✨ add some amazing-feature'`)
+4. Push to the Branch (`git push origin feat/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+Distributed under the MIT License. See `LICENSE` for more information.

birthdays_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+birthdays/__init__.py,sha256=zCzEvxnhtLPJjnQv1MmTa_Z1ow2tfBWRlyYeyBs-STs,1223
+birthdays/__main__.py,sha256=W8FOgBbwE2kWvGA6X1bjPK5YMLr_4nN0Pkba7d57e1U,71
+birthdays/birthdays.py,sha256=xE5lGQiIQhh_4QQpuP0cuqdPxazpvol_RpsNLSY69Zs,33150
+birthdays/emojis.py,sha256=FVbIjE7oCw2gStRLcMNG_JM4KjUPqE_Gl9G84rdJylo,6486
+birthdays_cli-0.1.0.dist-info/METADATA,sha256=QTRK4G3-tGaC4RQzeS5Uws0O0KbS9jipiqLg5TKwj30,4947
+birthdays_cli-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+birthdays_cli-0.1.0.dist-info/entry_points.txt,sha256=41u_T1XtdlnPo1gIfAxWKb4ykfUTpSv23Uu-TbiJCEY,87
+birthdays_cli-0.1.0.dist-info/licenses/LICENSE,sha256=1qxp5_4r7H7IrQTXGxvpUx_Ik20Cr6XIBE3CfRxxTLU,1097
+birthdays_cli-0.1.0.dist-info/RECORD,,

birthdays_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

birthdays_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+bday = birthdays.birthdays:main
+birthdays = birthdays.birthdays:main

birthdays_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Volodymyr Horshenin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.