create-tg-shop 0.1.0__tar.gz

create_tg_shop-0.1.0/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: create-tg-shop
+Version: 0.1.0
+Summary: Turn any online shop into a Telegram storefront bot — scaffold, scrape, and launch in under a minute
+Author-email: Zak Krevitt <zakkrevitt@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ZakKrevitt/shop-to-telegram-template
+Project-URL: Repository, https://github.com/ZakKrevitt/shop-to-telegram-template
+Keywords: telegram,bot,shop,ecommerce,scraper,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: python-telegram-bot
+Requires-Dist: requests
+Requires-Dist: beautifulsoup4
+Requires-Dist: playwright
+Requires-Dist: python-dotenv
+
+# create-tg-shop
+
+Turn any online shop into a Telegram storefront bot — scrape products, let users browse, add to cart, and checkout, all inside Telegram.
+
+## Quickstart
+
+**Python (pip):**
+```bash
+pip install create-tg-shop
+create-tg-shop
+```
+
+**Node (npx) — no install needed:**
+```bash
+npx create-tg-shop
+```
+
+The wizard scaffolds a project, asks for your Telegram bot token and shop URL, installs dependencies, and gets you running in under a minute.
+
+## What it sets up
+
+- `bot.py` — ShopEngine + CartManager + Telegram message formatting
+- `scraper.py` — base scraper class (plug in Playwright or BeautifulSoup)
+- `products.json` — product catalog (edit directly or regenerate via scraper)
+- `.env` — your bot token and shop config
+
+## Customizing
+
+- Implement `ShopScraper.scrape()` to pull real products from your shop
+- Wire the checkout callback to Stripe, Shopify, or your payment provider
+- Swap CartManager for Redis/database for persistent carts
+
+## License
+
+MIT

create_tg_shop-0.1.0/README.md

@@ -0,0 +1,35 @@
+# create-tg-shop
+
+Turn any online shop into a Telegram storefront bot — scrape products, let users browse, add to cart, and checkout, all inside Telegram.
+
+## Quickstart
+
+**Python (pip):**
+```bash
+pip install create-tg-shop
+create-tg-shop
+```
+
+**Node (npx) — no install needed:**
+```bash
+npx create-tg-shop
+```
+
+The wizard scaffolds a project, asks for your Telegram bot token and shop URL, installs dependencies, and gets you running in under a minute.
+
+## What it sets up
+
+- `bot.py` — ShopEngine + CartManager + Telegram message formatting
+- `scraper.py` — base scraper class (plug in Playwright or BeautifulSoup)
+- `products.json` — product catalog (edit directly or regenerate via scraper)
+- `.env` — your bot token and shop config
+
+## Customizing
+
+- Implement `ShopScraper.scrape()` to pull real products from your shop
+- Wire the checkout callback to Stripe, Shopify, or your payment provider
+- Swap CartManager for Redis/database for persistent carts
+
+## License
+
+MIT

create_tg_shop-0.1.0/create_tg_shop/__init__.py

@@ -0,0 +1,2 @@
+# create-tg-shop
+__version__ = "0.1.0"

create_tg_shop-0.1.0/create_tg_shop/cli.py

@@ -0,0 +1,250 @@
+import os
+import sys
+import subprocess
+import shutil
+
+BOLD  = "\033[1m"
+GREEN = "\033[0;32m"
+CYAN  = "\033[0;36m"
+YELLOW= "\033[1;33m"
+RED   = "\033[0;31m"
+RESET = "\033[0m"
+
+TEMPLATE_FILES = {
+    "bot.py": '''\
+import os
+import json
+from typing import Dict, List, Optional
+from scraper import Product, load_products
+
+class CartManager:
+    def __init__(self):
+        self.carts: Dict[int, Dict[str, int]] = {}
+
+    def add_to_cart(self, user_id: int, product_id: str):
+        if user_id not in self.carts:
+            self.carts[user_id] = {}
+        self.carts[user_id][product_id] = self.carts[user_id].get(product_id, 0) + 1
+
+    def get_cart(self, user_id: int) -> Dict[str, int]:
+        return self.carts.get(user_id, {})
+
+    def clear_cart(self, user_id: int):
+        self.carts[user_id] = {}
+
+class ShopEngine:
+    def __init__(self, products_path: str):
+        self.products = load_products(products_path)
+        self.cart_manager = CartManager()
+
+    def search(self, query: str) -> List[Product]:
+        if not query:
+            return self.products
+        query = query.lower()
+        return [p for p in self.products if
+                query in p.name.lower() or
+                query in p.description.lower() or
+                any(query in t.lower() for t in p.tags)]
+
+    def get_product_by_id(self, product_id: str) -> Optional[Product]:
+        return next((p for p in self.products if p.id == product_id), None)
+
+def get_product_markup(product):
+    return [
+        [{"text": f"Add to Cart - ${product.price}", "callback_data": f"add_{product.id}"}],
+        [{"text": "View on Site", "url": product.url}]
+    ]
+
+def get_cart_markup():
+    return [
+        [{"text": "🛒 View Cart", "callback_data": "view_cart"}],
+        [{"text": "💳 Checkout", "callback_data": "checkout"}]
+    ]
+
+def format_product_caption(product) -> str:
+    return (
+        f"**{product.name}**\\n\\n"
+        f"{product.description}\\n\\n"
+        f"Price: {product.currency} {product.price}\\n"
+        f"Tags: {', '.join(product.tags)}"
+    )
+
+if __name__ == "__main__":
+    engine = ShopEngine("products.json")
+    print(f"Loaded {len(engine.products)} products.")
+''',
+
+    "scraper.py": '''\
+import json
+from dataclasses import dataclass, asdict
+from typing import List
+
+@dataclass
+class Product:
+    id: str
+    name: str
+    description: str
+    price: float
+    currency: str
+    image_url: str
+    url: str
+    tags: List[str]
+
+class ShopScraper:
+    """
+    Base scraper. Replace scrape() with real Playwright or BeautifulSoup logic.
+    """
+    def __init__(self, shop_url: str):
+        self.shop_url = shop_url
+
+    def scrape(self) -> List[Product]:
+        return [
+            Product("p1", "Minimalist Desk Lamp",
+                    "Elegant LED lamp with adjustable brightness.",
+                    89.0, "USD", "https://images.unsplash.com/photo-1534073828943-f801091bb18c",
+                    f"{self.shop_url}/products/lamp", ["lighting", "minimalist", "office"]),
+            Product("p2", "Ergonomic Walnut Stand",
+                    "Hand-crafted walnut wood laptop stand.",
+                    120.0, "USD", "https://images.unsplash.com/photo-1527443224154-c4a3942d3acf",
+                    f"{self.shop_url}/products/stand", ["accessories", "wood", "ergonomic"]),
+            Product("p3", "Mechanical Keyboard",
+                    "Compact 65% layout with hot-swappable switches.",
+                    150.0, "USD", "https://images.unsplash.com/photo-1511467687858-23d96c32e4ae",
+                    f"{self.shop_url}/products/keyboard", ["tech", "peripheral", "keyboard"]),
+        ]
+
+def save_products(products: List[Product], filepath: str):
+    with open(filepath, "w") as f:
+        json.dump([asdict(p) for p in products], f, indent=2)
+
+def load_products(filepath: str) -> List[Product]:
+    try:
+        with open(filepath, "r") as f:
+            return [Product(**p) for p in json.load(f)]
+    except FileNotFoundError:
+        return []
+
+if __name__ == "__main__":
+    import os
+    url = os.getenv("SHOP_URL", "https://example.com")
+    scraper = ShopScraper(url)
+    products = scraper.scrape()
+    save_products(products, "products.json")
+    print(f"Saved {len(products)} products to products.json")
+''',
+
+    "products.json": '''\
+[
+  {
+    "id": "p1",
+    "name": "Minimalist Desk Lamp",
+    "description": "Elegant LED lamp with adjustable brightness and warm color temperature.",
+    "price": 89.0,
+    "currency": "USD",
+    "image_url": "https://images.unsplash.com/photo-1534073828943-f801091bb18c",
+    "url": "https://example.com/products/lamp",
+    "tags": ["lighting", "minimalist", "office"]
+  },
+  {
+    "id": "p2",
+    "name": "Ergonomic Walnut Stand",
+    "description": "Hand-crafted walnut wood laptop stand.",
+    "price": 120.0,
+    "currency": "USD",
+    "image_url": "https://images.unsplash.com/photo-1527443224154-c4a3942d3acf",
+    "url": "https://example.com/products/stand",
+    "tags": ["accessories", "wood", "ergonomic"]
+  }
+]
+''',
+
+    ".env.example": '''\
+TELEGRAM_BOT_TOKEN=your_token_here
+SHOP_URL=https://yourshop.com
+SHOP_NAME=My Shop
+''',
+
+    "requirements.txt": '''\
+python-telegram-bot
+requests
+beautifulsoup4
+playwright
+python-dotenv
+''',
+}
+
+def wizard():
+    print()
+    print(f"{BOLD}──────────────────────────────────────────{RESET}")
+    print(f"{BOLD}  🛍️  agentic-shop-tg  |  setup wizard{RESET}")
+    print(f"{BOLD}──────────────────────────────────────────{RESET}")
+    print()
+
+    # Directory
+    default_dir = "my-shop-bot"
+    raw = input(f"{CYAN}Project folder name [{default_dir}]: {RESET}").strip()
+    target = raw or default_dir
+
+    if os.path.exists(target):
+        print(f"{YELLOW}⚠  '{target}' already exists.{RESET}")
+        confirm = input("  Overwrite? [y/N]: ").strip().lower()
+        if confirm != "y":
+            sys.exit(0)
+        shutil.rmtree(target)
+
+    os.makedirs(target)
+
+    # Write template files
+    for filename, content in TEMPLATE_FILES.items():
+        filepath = os.path.join(target, filename)
+        with open(filepath, "w") as f:
+            f.write(content)
+
+    print(f"{GREEN}✔ Project scaffolded in ./{target}{RESET}")
+    print()
+
+    # Bot token
+    print(f"  Get your token from {CYAN}@BotFather{RESET} on Telegram (/newbot)")
+    token = input("  Telegram Bot Token: ").strip()
+
+    # Shop URL
+    shop_url = input("  Your shop URL [https://example.com]: ").strip() or "https://example.com"
+    shop_name = input("  Shop name [My Shop]: ").strip() or "My Shop"
+
+    # Write .env
+    with open(os.path.join(target, ".env"), "w") as f:
+        f.write(f"TELEGRAM_BOT_TOKEN={token}\n")
+        f.write(f"SHOP_URL={shop_url}\n")
+        f.write(f"SHOP_NAME={shop_name}\n")
+
+    print(f"{GREEN}✔ .env written{RESET}")
+    print()
+
+    # Install deps
+    venv_path = os.path.join(target, ".venv")
+    print(f"{CYAN}Creating virtual environment...{RESET}")
+    subprocess.run([sys.executable, "-m", "venv", venv_path], check=True)
+
+    pip = os.path.join(venv_path, "bin", "pip") if os.name != "nt" else os.path.join(venv_path, "Scripts", "pip")
+    print(f"{CYAN}Installing dependencies...{RESET}")
+    subprocess.run([pip, "install", "--quiet", "-r", os.path.join(target, "requirements.txt")], check=True)
+    print(f"{GREEN}✔ Dependencies installed{RESET}")
+
+    # Done
+    print()
+    print(f"{BOLD}──────────────────────────────────────────{RESET}")
+    print(f"{BOLD}  ✅  Ready!{RESET}")
+    print(f"{BOLD}──────────────────────────────────────────{RESET}")
+    print()
+    print(f"  {CYAN}cd {target}{RESET}")
+    print(f"  {CYAN}source .venv/bin/activate{RESET}  (or .venv\\Scripts\\activate on Windows)")
+    print()
+    print(f"  Scrape your shop:  {CYAN}python scraper.py{RESET}")
+    print(f"  Start the bot:     {CYAN}python bot.py{RESET}")
+    print()
+
+def main():
+    wizard()
+
+if __name__ == "__main__":
+    main()

create_tg_shop-0.1.0/create_tg_shop.egg-info/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: create-tg-shop
+Version: 0.1.0
+Summary: Turn any online shop into a Telegram storefront bot — scaffold, scrape, and launch in under a minute
+Author-email: Zak Krevitt <zakkrevitt@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ZakKrevitt/shop-to-telegram-template
+Project-URL: Repository, https://github.com/ZakKrevitt/shop-to-telegram-template
+Keywords: telegram,bot,shop,ecommerce,scraper,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: python-telegram-bot
+Requires-Dist: requests
+Requires-Dist: beautifulsoup4
+Requires-Dist: playwright
+Requires-Dist: python-dotenv
+
+# create-tg-shop
+
+Turn any online shop into a Telegram storefront bot — scrape products, let users browse, add to cart, and checkout, all inside Telegram.
+
+## Quickstart
+
+**Python (pip):**
+```bash
+pip install create-tg-shop
+create-tg-shop
+```
+
+**Node (npx) — no install needed:**
+```bash
+npx create-tg-shop
+```
+
+The wizard scaffolds a project, asks for your Telegram bot token and shop URL, installs dependencies, and gets you running in under a minute.
+
+## What it sets up
+
+- `bot.py` — ShopEngine + CartManager + Telegram message formatting
+- `scraper.py` — base scraper class (plug in Playwright or BeautifulSoup)
+- `products.json` — product catalog (edit directly or regenerate via scraper)
+- `.env` — your bot token and shop config
+
+## Customizing
+
+- Implement `ShopScraper.scrape()` to pull real products from your shop
+- Wire the checkout callback to Stripe, Shopify, or your payment provider
+- Swap CartManager for Redis/database for persistent carts
+
+## License
+
+MIT

create_tg_shop-0.1.0/create_tg_shop.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+create_tg_shop/__init__.py
+create_tg_shop/cli.py
+create_tg_shop.egg-info/PKG-INFO
+create_tg_shop.egg-info/SOURCES.txt
+create_tg_shop.egg-info/dependency_links.txt
+create_tg_shop.egg-info/entry_points.txt
+create_tg_shop.egg-info/requires.txt
+create_tg_shop.egg-info/top_level.txt

create_tg_shop-0.1.0/create_tg_shop.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

create_tg_shop-0.1.0/create_tg_shop.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+create-tg-shop = create_tg_shop.cli:main

create_tg_shop-0.1.0/create_tg_shop.egg-info/requires.txt

@@ -0,0 +1,5 @@
+python-telegram-bot
+requests
+beautifulsoup4
+playwright
+python-dotenv

create_tg_shop-0.1.0/create_tg_shop.egg-info/top_level.txt

@@ -0,0 +1 @@
+create_tg_shop

create_tg_shop-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "create-tg-shop"
+version = "0.1.0"
+description = "Turn any online shop into a Telegram storefront bot — scaffold, scrape, and launch in under a minute"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+  {name = "Zak Krevitt", email = "zakkrevitt@gmail.com"}
+]
+keywords = ["telegram", "bot", "shop", "ecommerce", "scraper", "cli"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+  "Environment :: Console",
+]
+dependencies = [
+  "python-telegram-bot",
+  "requests",
+  "beautifulsoup4",
+  "playwright",
+  "python-dotenv",
+]
+
+[project.scripts]
+create-tg-shop = "create_tg_shop.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/ZakKrevitt/shop-to-telegram-template"
+Repository = "https://github.com/ZakKrevitt/shop-to-telegram-template"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["create_tg_shop*"]

create_tg_shop-0.1.0/setup.cfg

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