kycli 0.1.1

**kycli** is a high-performance Python CLI toolkit built with Cython for speed.

🔑 kycli — High-Performance Key-Value Toolkit

kycli is a lightweight, blazing-fast key-value storage engine built with Cython and SQLite. It offers both a robust Command Line Interface (CLI) for terminal productivity and a Pythonic library API for seamless integration into your applications.

---

🚀 Quick Start

Installation

pip install kycli

Basic Terminal Flow

# Save a secret
kys my_api_key "sk-proj-12345"

# Retrieve it
kyg my_api_key

# List everything
kyl

---

💻 CLI Usage

The CLI is designed to be intuitive and safe, featuring overwrite protection and atomic operations.

Command	Action	Example
kys	Save a value	kys username "balu"
kyg	Get a value (supports Regex)	kyg "user.*"
kyl	List keys (supports Regex)	kyl "prod_.*"
kyv	View history/audit logs	kyv username
kyd	Delete a key	kyd old_token
kye	Export data (CSV/JSON)	kye data.json json
kyi	Import data	kyi backup.csv

🛡️ Safety Features

• Interactive Propts: kycli will ask for confirmation (y/n) before overwriting an existing key.
• Normalization: Keys are automatically lowercased and trimmed to prevent "hidden" duplicates.
• Atomic Exports: Uses a temp-and-move strategy so your data is never left in a corrupted state if an export fails.

---

🐍 Python Library API

Use kycli programmatically in your Python projects. It provides a standard dictionary-like interface for maximum ease of use.

Basic Implementation

from kycli import Kycore

# Use as a context manager for safe DB closure
with Kycore() as core:
    # Set and Get (Dict-style)
    core['app:mode'] = 'production'
    print(core['app:mode'])  # Output: production

    # Check for existence
    if 'app:mode' in core:
        print("Configuration found!")

    # Bulk count
    print(f"Total keys: {len(core)}")

Advanced Library Features

with Kycore() as core:
    # 1. Regex Searching
    # Returns a dict of all matching key-values
    matches = core.getkey("app:.*") 
    
    # 2. Audit History
    # Get all previous values and timestamps for a key
    history = core.get_history("app:mode")
    for key, value, timestamp in history:
        print(f"[{timestamp}] {value}")

    # 3. Import/Export Programmatically
    core.import_data("config.json")
    core.export_data("backup.csv", file_format="csv")

---

🛠 Architecture & Performance

• Cython Core: The heavy lifting is done in C-compiled Python for near-native performance.
• SQLite Engine: Leverages the reliability of SQLite3 for persistence, ensuring your data survives crashes.
• Audit Trail: Every single change is logged with a timestamp in a separate audit_log table, giving you a full "undo" history.

---

👤 Author

Balakrishna Maduru

• GitHub
• LinkedIn
• Twitter

---

Generated by Antigravity