botslt 1.0.0__tar.gz

botslt-1.0.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: botslt
+Version: 1.0.0
+Summary: Official CLI for Bots.LT — sync your bot commands like Git
+Author-email: "Bots.LT Team" <support@bots.lt>
+License: MIT
+Project-URL: Homepage, https://bots.lt
+Project-URL: Documentation, https://bots.lt/docs
+Keywords: telegram,bot,botslt,cli,sync
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: click>=8.1.0
+
+# blp — Official Bots.LT CLI
+
+> Sync your Telegram bot commands like Git.
+
+```bash
+pip install botslt
+```
+
+---
+
+## Quick Start
+
+```bash
+# 1. Save your API key (from Settings → Security on bots.lt)
+blp login
+
+# 2. Create a project in your bot's folder
+mkdir my-bot && cd my-bot
+blp init
+
+# 3. Map your commands to .py files
+blp add /start start.py
+blp add /help  help.py
+blp add @       at_handler.py
+
+# 4. Write your code, then push!
+blp push
+```
+
+---
+
+## How it Works
+
+Your project folder will look like this:
+
+```
+my-telegram-bot/
+├── botslt.json        ← Bot ID + command mappings (safe to commit to Git)
+├── botslt.lock        ← Hash cache for change detection (Git-ignored)
+├── start.py           ← Code for /start command
+├── help.py            ← Code for /help command
+└── at_handler.py      ← Code for @ (global) handler
+```
+
+Your **API key is stored globally** in `~/.botslt/credentials.json` — never in the project folder, so it's never accidentally committed to Git.
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `blp login` | Save your API key |
+| `blp logout` | Remove saved credentials |
+| `blp init` | Create `botslt.json` in current folder |
+| `blp add /cmd file.py` | Map a command to a local file |
+| `blp push` | Push changed commands to server |
+| `blp push file.py` | Push a specific file |
+| `blp push --all` | Push all commands (ignore change detection) |
+| `blp pull` | Pull all server commands to local files |
+| `blp status` | Show which files have changed |
+| `blp logs` | Show recent bot error logs |
+| `blp bots` | List all your bots |
+
+---
+
+## Example `botslt.json`
+
+```json
+{
+    "bot_id": "12345678",
+    "commands": {
+        "/start": "start.py",
+        "/help":  "help.py",
+        "/balance": "balance.py",
+        "@":      "at_handler.py",
+        "*":      "fallback.py"
+    }
+}
+```
+
+---
+
+## Example Bot Command (start.py)
+
+```python
+bot.sendMessage(
+    text=f"<b>Welcome, {user.first_name}!</b>\n\nHow can I help you?",
+    parse_mode="html",
+    reply_markup={
+        "keyboard": [
+            [{"text": "💰 Balance"}],
+            [{"text": "❓ Help"}]
+        ],
+        "resize_keyboard": True
+    }
+)
+```
+
+---
+
+## .gitignore
+
+`blp init` automatically adds `botslt.lock` to your `.gitignore`:
+
+```gitignore
+# BotsLT
+botslt.lock
+```
+
+> **Never commit `~/.botslt/credentials.json`** — it contains your API key.
+
+---
+
+## Links
+
+- Platform: [https://bots.lt](https://bots.lt)
+- Documentation: [https://bots.lt/docs](https://bots.lt/docs)
+- Support: [https://t.me/JSOrganization](https://t.me/JSOrganization)

botslt-1.0.0/README.md

@@ -0,0 +1,119 @@
+# blp — Official Bots.LT CLI
+
+> Sync your Telegram bot commands like Git.
+
+```bash
+pip install botslt
+```
+
+---
+
+## Quick Start
+
+```bash
+# 1. Save your API key (from Settings → Security on bots.lt)
+blp login
+
+# 2. Create a project in your bot's folder
+mkdir my-bot && cd my-bot
+blp init
+
+# 3. Map your commands to .py files
+blp add /start start.py
+blp add /help  help.py
+blp add @       at_handler.py
+
+# 4. Write your code, then push!
+blp push
+```
+
+---
+
+## How it Works
+
+Your project folder will look like this:
+
+```
+my-telegram-bot/
+├── botslt.json        ← Bot ID + command mappings (safe to commit to Git)
+├── botslt.lock        ← Hash cache for change detection (Git-ignored)
+├── start.py           ← Code for /start command
+├── help.py            ← Code for /help command
+└── at_handler.py      ← Code for @ (global) handler
+```
+
+Your **API key is stored globally** in `~/.botslt/credentials.json` — never in the project folder, so it's never accidentally committed to Git.
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `blp login` | Save your API key |
+| `blp logout` | Remove saved credentials |
+| `blp init` | Create `botslt.json` in current folder |
+| `blp add /cmd file.py` | Map a command to a local file |
+| `blp push` | Push changed commands to server |
+| `blp push file.py` | Push a specific file |
+| `blp push --all` | Push all commands (ignore change detection) |
+| `blp pull` | Pull all server commands to local files |
+| `blp status` | Show which files have changed |
+| `blp logs` | Show recent bot error logs |
+| `blp bots` | List all your bots |
+
+---
+
+## Example `botslt.json`
+
+```json
+{
+    "bot_id": "12345678",
+    "commands": {
+        "/start": "start.py",
+        "/help":  "help.py",
+        "/balance": "balance.py",
+        "@":      "at_handler.py",
+        "*":      "fallback.py"
+    }
+}
+```
+
+---
+
+## Example Bot Command (start.py)
+
+```python
+bot.sendMessage(
+    text=f"<b>Welcome, {user.first_name}!</b>\n\nHow can I help you?",
+    parse_mode="html",
+    reply_markup={
+        "keyboard": [
+            [{"text": "💰 Balance"}],
+            [{"text": "❓ Help"}]
+        ],
+        "resize_keyboard": True
+    }
+)
+```
+
+---
+
+## .gitignore
+
+`blp init` automatically adds `botslt.lock` to your `.gitignore`:
+
+```gitignore
+# BotsLT
+botslt.lock
+```
+
+> **Never commit `~/.botslt/credentials.json`** — it contains your API key.
+
+---
+
+## Links
+
+- Platform: [https://bots.lt](https://bots.lt)
+- Documentation: [https://bots.lt/docs](https://bots.lt/docs)
+- Support: [https://t.me/JSOrganization](https://t.me/JSOrganization)

botslt-1.0.0/botslt/__init__.py

@@ -0,0 +1,4 @@
+"""
+botslt — Official CLI for Bots.LT
+Sync your Telegram bot commands like Git.
+"""

botslt-1.0.0/botslt/api.py

@@ -0,0 +1,77 @@
+"""
+api.py — All API calls to the Bots.LT backend.
+Uses X-API-Key header for authentication.
+"""
+import requests
+from .auth import get_api_key, get_base_url
+
+
+def _headers() -> dict:
+    return {"X-API-Key": get_api_key()}
+
+
+def _url(path: str) -> str:
+    return f"{get_base_url()}{path}"
+
+
+def verify_api_key() -> dict:
+    """Verify that the stored API key is valid by calling /api/account."""
+    try:
+        r = requests.get(_url("/account"), headers=_headers(), timeout=10)
+        if r.status_code == 200:
+            return r.json()
+        return {"ok": False, "error": f"HTTP {r.status_code}"}
+    except Exception as e:
+        return {"ok": False, "error": str(e)}
+
+
+def list_bots() -> dict:
+    """List all bots for the authenticated user."""
+    r = requests.get(_url("/bots-list"), headers=_headers(), timeout=10)
+    return r.json()
+
+
+def get_all_commands(bot_id: str) -> dict:
+    """Get all commands for a bot."""
+    r = requests.get(_url(f"/bots/{bot_id}/commands"), headers=_headers(), timeout=10)
+    return r.json()
+
+
+def get_command_code(bot_id: str, command_name: str) -> str | None:
+    """Get the code for a single command."""
+    import base64
+    encoded = base64.b64encode(command_name.encode("utf-8")).decode("utf-8")
+    r = requests.get(_url(f"/bots/{bot_id}/commands/{encoded}"), headers=_headers(), timeout=10)
+    if r.status_code == 200:
+        data = r.json()
+        return data.get("code") or data.get("result", {}).get("code")
+    return None
+
+
+def push_command(bot_id: str, command_name: str, code: str) -> dict:
+    """Create or update a command on the server."""
+    import base64
+    encoded = base64.b64encode(command_name.encode("utf-8")).decode("utf-8")
+    # Try update first
+    r = requests.put(
+        _url(f"/bots/{bot_id}/commands/{encoded}"),
+        headers=_headers(),
+        json={"code": code},
+        timeout=15
+    )
+    if r.status_code == 200:
+        return r.json()
+    # If not found, create it
+    r2 = requests.post(
+        _url(f"/bots/{bot_id}/commands"),
+        headers=_headers(),
+        json={"command": command_name, "code": code},
+        timeout=15
+    )
+    return r2.json()
+
+
+def get_bot_errors(bot_id: str) -> dict:
+    """Get recent error logs for a bot."""
+    r = requests.get(_url(f"/bots/{bot_id}/errors"), headers=_headers(), timeout=10)
+    return r.json()

botslt-1.0.0/botslt/auth.py

@@ -0,0 +1,45 @@
+"""
+auth.py — Handles login and credential storage.
+Credentials are stored in ~/.botslt/credentials.json (never in the project folder).
+"""
+import os
+import json
+from pathlib import Path
+
+CRED_DIR = Path.home() / ".botslt"
+CRED_FILE = CRED_DIR / "credentials.json"
+
+
+def get_credentials() -> dict:
+    """Load credentials from ~/.botslt/credentials.json"""
+    if not CRED_FILE.exists():
+        return {}
+    try:
+        with open(CRED_FILE, "r", encoding="utf-8") as f:
+            return json.load(f)
+    except Exception:
+        return {}
+
+
+def save_credentials(api_key: str, base_url: str = "https://bots.lt/api"):
+    """Save credentials to ~/.botslt/credentials.json"""
+    CRED_DIR.mkdir(parents=True, exist_ok=True)
+    data = {"api_key": api_key, "base_url": base_url}
+    with open(CRED_FILE, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=4)
+
+
+def get_api_key() -> str | None:
+    """Return the stored API key, or None if not logged in."""
+    return get_credentials().get("api_key")
+
+
+def get_base_url() -> str:
+    """Return the stored base URL (defaults to bots.lt)."""
+    return get_credentials().get("base_url", "https://bots.lt/api")
+
+
+def clear_credentials():
+    """Remove stored credentials (logout)."""
+    if CRED_FILE.exists():
+        CRED_FILE.unlink()

botslt-1.0.0/botslt/cli.py

@@ -0,0 +1,397 @@
+"""
+cli.py — Main entry point for the blp CLI.
+Command: blp <subcommand>
+"""
+import click
+import sys
+from pathlib import Path
+from . import auth, config, api
+
+
+# ─── Helpers ────────────────────────────────────────────────────────────────
+
+def require_login():
+    """Abort with a helpful message if not logged in."""
+    key = auth.get_api_key()
+    if not key:
+        click.echo(click.style("[-] Not logged in.", fg="red"))
+        click.echo("  Run: blp login")
+        sys.exit(1)
+
+def require_config():
+    """Abort with a helpful message if botslt.json is missing."""
+    if not config.config_exists():
+        click.echo(click.style("[-] No botslt.json found in current directory.", fg="red"))
+        click.echo("  Run: blp init")
+        sys.exit(1)
+
+
+# ─── CLI Group ───────────────────────────────────────────────────────────────
+
+@click.group()
+@click.version_option("1.0.0", prog_name="blp")
+def cli():
+    """
+    blp — Official CLI for Bots.LT
+
+    Sync your Telegram bot commands like Git.
+
+    \b
+    Quick start:
+      blp login          Save your API key
+      blp init           Setup a project in the current folder
+      blp push           Push all changed commands to server
+      blp pull           Pull all commands from server
+      blp status         Show which files have changed
+
+    Get your API Key from: https://bots.lt/dashboard -> Settings -> Security
+    """
+    pass
+
+
+# ─── login ───────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("--key", "-k", prompt=False, default=None, help="API Key (from Settings -> Security)")
+def login(key):
+    """Save your Bots.LT API key to ~/.botslt/credentials.json"""
+    if not key:
+        click.echo("Get your API Key from: https://bots.lt/dashboard -> Settings -> Security")
+        key = click.prompt("API Key", hide_input=True)
+
+    key = key.strip()
+    if not key:
+        click.echo(click.style("[-] API Key cannot be empty.", fg="red"))
+        sys.exit(1)
+
+    # Validate key against server
+    click.echo("Verifying API key...")
+    auth.save_credentials(key)
+    result = api.verify_api_key()
+
+    if result.get("ok"):
+        acc = result.get("result", {}).get("account", {})
+        email = acc.get("email", "unknown")
+        click.echo(click.style(f"[+] Logged in as: {email}", fg="green"))
+        click.echo(click.style(f"  Credentials saved to: {auth.CRED_FILE}", fg="bright_black"))
+    else:
+        auth.clear_credentials()
+        click.echo(click.style(f"[-] Invalid API key: {result.get('error', 'Unknown error')}", fg="red"))
+        sys.exit(1)
+
+
+# ─── logout ──────────────────────────────────────────────────────────────────
+
+@cli.command()
+def logout():
+    """Remove stored credentials from ~/.botslt/credentials.json"""
+    auth.clear_credentials()
+    click.echo(click.style("[+] Logged out successfully.", fg="green"))
+
+
+# ─── init ────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("--bot-id", "-b", prompt="Bot ID", help="Your Bots.LT Bot ID")
+def init(bot_id):
+    """Create a botslt.json config file in the current directory."""
+    require_login()
+
+    if config.config_exists():
+        if not click.confirm("botslt.json already exists. Overwrite?"):
+            click.echo("Aborted.")
+            sys.exit(0)
+
+    bot_id = bot_id.strip()
+    data = {
+        "bot_id": bot_id,
+        "commands": {}
+    }
+    config.save_config(data)
+    config.ensure_gitignore()
+
+    click.echo(click.style(f"[+] Initialized project for bot ID: {bot_id}", fg="green"))
+    click.echo(click.style("  botslt.json created. Add commands with: blp add /start start.py", fg="bright_black"))
+
+
+# ─── add ─────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.argument("command_name")
+@click.argument("filename")
+def add(command_name, filename):
+    """Map a command name to a local .py file.
+
+    \b
+    Example:
+      blp add /start start.py
+      blp add @ at_handler.py
+    """
+    require_config()
+
+    cfg = config.load_config()
+    commands = cfg.setdefault("commands", {})
+    commands[command_name] = filename
+    config.save_config(cfg)
+
+    click.echo(click.style(f"[+] Mapped '{command_name}' -> '{filename}'", fg="green"))
+    click.echo("  Remember to create the file, then run: blp push")
+
+
+# ─── status ──────────────────────────────────────────────────────────────────
+
+@cli.command()
+def status():
+    """Show which local files have changed since last push."""
+    require_login()
+    require_config()
+
+    cfg = config.load_config()
+    commands = cfg.get("commands", {})
+
+    if not commands:
+        click.echo("No commands mapped. Use: blp add /start start.py")
+        return
+
+    changed = config.get_changed_files()
+    changed_files = {c["file"] for c in changed}
+
+    click.echo(f"\n  Bot ID: {click.style(cfg.get('bot_id', '?'), fg='cyan')}\n")
+
+    modified = []
+    ok = []
+    missing = []
+
+    for cmd_name, filename in commands.items():
+        if not Path(filename).exists():
+            missing.append((cmd_name, filename))
+        elif filename in changed_files:
+            modified.append((cmd_name, filename))
+        else:
+            ok.append((cmd_name, filename))
+
+    if modified:
+        click.echo(click.style("  Modified (not pushed):", fg="yellow"))
+        for cmd, f in modified:
+            click.echo(f"    {click.style('M', fg='yellow')}  {f:<25} -> {cmd}")
+
+    if missing:
+        click.echo(click.style("\n  File not found:", fg="red"))
+        for cmd, f in missing:
+            click.echo(f"    {click.style('!', fg='red')}  {f:<25} -> {cmd}")
+
+    if ok:
+        click.echo(click.style("\n  Up to date:", fg="green"))
+        for cmd, f in ok:
+            click.echo(f"    {click.style('[+]', fg='green')}  {f:<25} -> {cmd}")
+
+    if not modified and not missing:
+        click.echo(click.style("\n  Everything is up to date!", fg="green"))
+    else:
+        click.echo(f"\n  Run {click.style('blp push', fg='cyan')} to sync changes.")
+
+
+# ─── push ────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.argument("files", nargs=-1)
+@click.option("--all", "-a", "push_all", is_flag=True, help="Push all commands, even if unchanged")
+@click.option("--force", "-f", is_flag=True, help="Same as --all")
+def push(files, push_all, force):
+    """Push changed commands to Bots.LT server.
+
+    \b
+    Examples:
+      blp push                   Push only changed files
+      blp push start.py          Push a specific file
+      blp push --all             Push all commands regardless of changes
+    """
+    require_login()
+    require_config()
+
+    cfg = config.load_config()
+    bot_id = cfg.get("bot_id")
+    commands = cfg.get("commands", {})
+
+    if not commands:
+        click.echo("No commands configured. Run: blp add /start start.py")
+        return
+
+    push_all = push_all or force
+
+    # If specific files given, only push those
+    if files:
+        to_push = [(cmd, f) for cmd, f in commands.items() if f in files]
+        if not to_push:
+            click.echo(click.style("[-] No matching commands found for the given files.", fg="red"))
+            click.echo("  Check your botslt.json mappings.")
+            sys.exit(1)
+    elif push_all:
+        to_push = list(commands.items())
+    else:
+        changed = config.get_changed_files()
+        changed_files = {c["file"] for c in changed}
+        to_push = [(cmd, f) for cmd, f in commands.items() if f in changed_files]
+
+    if not to_push:
+        click.echo(click.style("[+] Nothing to push. Everything is up to date.", fg="green"))
+        return
+
+    click.echo(f"\n  Syncing bot {click.style(bot_id, fg='cyan')}...\n")
+
+    updated = 0
+    failed = 0
+
+    for cmd_name, filename in to_push:
+        if not Path(filename).exists():
+            click.echo(f"  {click.style('!', fg='red')}  {filename:<25} -> {cmd_name} (file not found, skipped)")
+            failed += 1
+            continue
+
+        with open(filename, "r", encoding="utf-8") as f:
+            code = f.read()
+
+        try:
+            result = api.push_command(bot_id, cmd_name, code)
+            if result.get("ok"):
+                click.echo(f"  {click.style('[+]', fg='green')}  {filename:<25} -> {cmd_name}")
+                config.update_lock_for_file(filename)
+                updated += 1
+            else:
+                err = result.get("error") or result.get("detail", "Unknown error")
+                click.echo(f"  {click.style('[-]', fg='red')}  {filename:<25} -> {cmd_name} ({err})")
+                failed += 1
+        except Exception as e:
+            click.echo(f"  {click.style('[-]', fg='red')}  {filename:<25} -> {cmd_name} (Error: {e})")
+            failed += 1
+
+    click.echo()
+    click.echo(f"  Done! {click.style(str(updated), fg='green')} pushed, {click.style(str(failed), fg='red' if failed else 'bright_black')} failed.")
+
+
+# ─── pull ────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("--overwrite", is_flag=True, help="Overwrite local files without asking")
+def pull(overwrite):
+    """Pull all commands from server and create local .py files."""
+    require_login()
+    require_config()
+
+    cfg = config.load_config()
+    bot_id = cfg.get("bot_id")
+
+    click.echo(f"\n  Pulling from bot {click.style(bot_id, fg='cyan')}...\n")
+
+    result = api.get_all_commands(bot_id)
+    if not result.get("ok"):
+        click.echo(click.style(f"[-] Failed to fetch commands: {result.get('error', 'Unknown error')}", fg="red"))
+        sys.exit(1)
+
+    commands_data = result.get("commands") or result.get("result", {}).get("commands", [])
+
+    if not commands_data:
+        click.echo("  No commands found on the server.")
+        return
+
+    cfg_commands = cfg.setdefault("commands", {})
+    created = 0
+    skipped = 0
+
+    for cmd in commands_data:
+        cmd_name = cmd.get("command") or cmd.get("name") or cmd.get("trigger", "")
+        code = cmd.get("code", "")
+
+        if not cmd_name:
+            continue
+
+        # Generate a safe filename from the command name
+        safe_name = cmd_name.lstrip("/").replace(" ", "_").replace("*", "star").replace("@", "at") or "command"
+        filename = f"{safe_name}.py"
+
+        if Path(filename).exists() and not overwrite:
+            if not click.confirm(f"  '{filename}' already exists. Overwrite?"):
+                click.echo(f"  {click.style('-', fg='yellow')}  {filename:<25} skipped")
+                skipped += 1
+                continue
+
+        with open(filename, "w", encoding="utf-8") as f:
+            f.write(code)
+
+        cfg_commands[cmd_name] = filename
+        config.update_lock_for_file(filename)
+        click.echo(f"  {click.style('[+]', fg='green')}  {filename:<25} <- {cmd_name}")
+        created += 1
+
+    config.save_config(cfg)
+    click.echo()
+    click.echo(f"  Done! {click.style(str(created), fg='green')} pulled, {skipped} skipped.")
+
+
+# ─── logs ────────────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("--limit", "-n", default=10, help="Number of recent errors to show (default: 10)")
+def logs(limit):
+    """Show recent error logs for your bot."""
+    require_login()
+    require_config()
+
+    cfg = config.load_config()
+    bot_id = cfg.get("bot_id")
+
+    result = api.get_bot_errors(bot_id)
+    if not result.get("ok"):
+        click.echo(click.style(f"[-] Failed to fetch logs: {result.get('error', 'Unknown error')}", fg="red"))
+        sys.exit(1)
+
+    errors = result.get("errors") or result.get("result", {}).get("errors", [])
+
+    if not errors:
+        click.echo(click.style("[+] No recent errors. Your bot is running clean!", fg="green"))
+        return
+
+    click.echo(f"\n  Recent errors for bot {click.style(bot_id, fg='cyan')}:\n")
+
+    for i, err in enumerate(errors[:limit]):
+        cmd = err.get("command_name", "?")
+        msg = err.get("error_message", "?")
+        ts = err.get("created_at", "")
+        click.echo(f"  [{click.style(str(i+1), fg='yellow')}] {click.style(cmd, fg='cyan')} — {ts}")
+        for line in msg.splitlines():
+            click.echo(f"      {line}")
+        click.echo()
+
+
+# ─── bots ────────────────────────────────────────────────────────────────────
+
+@cli.command()
+def bots():
+    """List all your bots."""
+    require_login()
+
+    result = api.list_bots()
+    if not result.get("ok"):
+        click.echo(click.style(f"[-] {result.get('error', 'Failed to list bots')}", fg="red"))
+        sys.exit(1)
+
+    bots_list = result.get("result", {}).get("bots", [])
+
+    if not bots_list:
+        click.echo("No bots found.")
+        return
+
+    click.echo(f"\n  {click.style(str(len(bots_list)), fg='cyan')} bot(s) found:\n")
+    for b in bots_list:
+        status_color = "green" if b.get("is_active") else "red"
+        status = "Running" if b.get("is_active") else "Stopped"
+        click.echo(
+            f"  {click.style(str(b.get('id', '?')), fg='cyan'):<12}"
+            f"  @{str(b.get('username', '?')):<25}"
+            f"  {click.style(status, fg=status_color)}"
+        )
+    click.echo()
+
+
+if __name__ == "__main__":
+    cli()

botslt-1.0.0/botslt/config.py

@@ -0,0 +1,94 @@
+"""
+config.py — Reads and writes botslt.json in the current project directory.
+This file is safe to commit to Git — it only contains bot_id and command mappings.
+"""
+import json
+from pathlib import Path
+
+CONFIG_FILE = Path("botslt.json")
+LOCK_FILE = Path("botslt.lock")
+
+
+def config_exists() -> bool:
+    return CONFIG_FILE.exists()
+
+
+def load_config() -> dict:
+    """Load botslt.json from current directory."""
+    if not CONFIG_FILE.exists():
+        return {}
+    with open(CONFIG_FILE, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def save_config(data: dict):
+    """Save botslt.json to current directory."""
+    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=4)
+
+
+def load_lock() -> dict:
+    """Load botslt.lock (local hash cache, NOT for Git)."""
+    if not LOCK_FILE.exists():
+        return {"files": {}}
+    try:
+        with open(LOCK_FILE, "r", encoding="utf-8") as f:
+            return json.load(f)
+    except Exception:
+        return {"files": {}}
+
+
+def save_lock(data: dict):
+    """Save botslt.lock."""
+    with open(LOCK_FILE, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=4)
+
+
+def get_file_hash(filepath: str) -> str:
+    """Return SHA256 hash of a local file."""
+    import hashlib
+    h = hashlib.sha256()
+    try:
+        with open(filepath, "rb") as f:
+            h.update(f.read())
+        return h.hexdigest()
+    except FileNotFoundError:
+        return ""
+
+
+def update_lock_for_file(filename: str):
+    """Update the hash entry for a specific file in botslt.lock."""
+    lock = load_lock()
+    lock.setdefault("files", {})[filename] = get_file_hash(filename)
+    save_lock(lock)
+
+
+def get_changed_files() -> list[dict]:
+    """Compare local files with botslt.lock hashes. Returns list of changed files."""
+    config = load_config()
+    lock = load_lock()
+    cached_hashes = lock.get("files", {})
+    commands = config.get("commands", {})
+
+    changed = []
+    for cmd_name, filename in commands.items():
+        if not Path(filename).exists():
+            continue
+        current_hash = get_file_hash(filename)
+        cached_hash = cached_hashes.get(filename, "")
+        if current_hash != cached_hash:
+            changed.append({"command": cmd_name, "file": filename})
+    return changed
+
+
+def ensure_gitignore():
+    """Add botslt.lock to .gitignore if it's not already there."""
+    gitignore = Path(".gitignore")
+    entries_to_add = ["# BotsLT", "botslt.lock"]
+    if gitignore.exists():
+        content = gitignore.read_text(encoding="utf-8")
+        if "botslt.lock" not in content:
+            with open(gitignore, "a", encoding="utf-8") as f:
+                f.write("\n" + "\n".join(entries_to_add) + "\n")
+    else:
+        gitignore.write_text("\n".join(entries_to_add) + "\n", encoding="utf-8")

botslt-1.0.0/botslt.egg-info/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: botslt
+Version: 1.0.0
+Summary: Official CLI for Bots.LT — sync your bot commands like Git
+Author-email: "Bots.LT Team" <support@bots.lt>
+License: MIT
+Project-URL: Homepage, https://bots.lt
+Project-URL: Documentation, https://bots.lt/docs
+Keywords: telegram,bot,botslt,cli,sync
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: click>=8.1.0
+
+# blp — Official Bots.LT CLI
+
+> Sync your Telegram bot commands like Git.
+
+```bash
+pip install botslt
+```
+
+---
+
+## Quick Start
+
+```bash
+# 1. Save your API key (from Settings → Security on bots.lt)
+blp login
+
+# 2. Create a project in your bot's folder
+mkdir my-bot && cd my-bot
+blp init
+
+# 3. Map your commands to .py files
+blp add /start start.py
+blp add /help  help.py
+blp add @       at_handler.py
+
+# 4. Write your code, then push!
+blp push
+```
+
+---
+
+## How it Works
+
+Your project folder will look like this:
+
+```
+my-telegram-bot/
+├── botslt.json        ← Bot ID + command mappings (safe to commit to Git)
+├── botslt.lock        ← Hash cache for change detection (Git-ignored)
+├── start.py           ← Code for /start command
+├── help.py            ← Code for /help command
+└── at_handler.py      ← Code for @ (global) handler
+```
+
+Your **API key is stored globally** in `~/.botslt/credentials.json` — never in the project folder, so it's never accidentally committed to Git.
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `blp login` | Save your API key |
+| `blp logout` | Remove saved credentials |
+| `blp init` | Create `botslt.json` in current folder |
+| `blp add /cmd file.py` | Map a command to a local file |
+| `blp push` | Push changed commands to server |
+| `blp push file.py` | Push a specific file |
+| `blp push --all` | Push all commands (ignore change detection) |
+| `blp pull` | Pull all server commands to local files |
+| `blp status` | Show which files have changed |
+| `blp logs` | Show recent bot error logs |
+| `blp bots` | List all your bots |
+
+---
+
+## Example `botslt.json`
+
+```json
+{
+    "bot_id": "12345678",
+    "commands": {
+        "/start": "start.py",
+        "/help":  "help.py",
+        "/balance": "balance.py",
+        "@":      "at_handler.py",
+        "*":      "fallback.py"
+    }
+}
+```
+
+---
+
+## Example Bot Command (start.py)
+
+```python
+bot.sendMessage(
+    text=f"<b>Welcome, {user.first_name}!</b>\n\nHow can I help you?",
+    parse_mode="html",
+    reply_markup={
+        "keyboard": [
+            [{"text": "💰 Balance"}],
+            [{"text": "❓ Help"}]
+        ],
+        "resize_keyboard": True
+    }
+)
+```
+
+---
+
+## .gitignore
+
+`blp init` automatically adds `botslt.lock` to your `.gitignore`:
+
+```gitignore
+# BotsLT
+botslt.lock
+```
+
+> **Never commit `~/.botslt/credentials.json`** — it contains your API key.
+
+---
+
+## Links
+
+- Platform: [https://bots.lt](https://bots.lt)
+- Documentation: [https://bots.lt/docs](https://bots.lt/docs)
+- Support: [https://t.me/JSOrganization](https://t.me/JSOrganization)

botslt-1.0.0/botslt.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+botslt/__init__.py
+botslt/api.py
+botslt/auth.py
+botslt/cli.py
+botslt/config.py
+botslt.egg-info/PKG-INFO
+botslt.egg-info/SOURCES.txt
+botslt.egg-info/dependency_links.txt
+botslt.egg-info/entry_points.txt
+botslt.egg-info/requires.txt
+botslt.egg-info/top_level.txt

botslt-1.0.0/botslt.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

botslt-1.0.0/botslt.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+blp = botslt.cli:cli

botslt-1.0.0/botslt.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests>=2.28.0
+click>=8.1.0

botslt-1.0.0/botslt.egg-info/top_level.txt

@@ -0,0 +1 @@
+botslt

botslt-1.0.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "botslt"
+version = "1.0.0"
+description = "Official CLI for Bots.LT — sync your bot commands like Git"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "Bots.LT Team", email = "support@bots.lt" }
+]
+keywords = ["telegram", "bot", "botslt", "cli", "sync"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Topic :: Communications :: Chat",
+]
+dependencies = [
+    "requests>=2.28.0",
+    "click>=8.1.0",
+]
+
+[project.scripts]
+blp = "botslt.cli:cli"
+
+[project.urls]
+Homepage = "https://bots.lt"
+Documentation = "https://bots.lt/docs"

botslt-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+