conversession 2.0.0__tar.gz

conversession-2.0.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: conversession
+Version: 2.0.0
+Author-email: Jordi Carrera Ventura <jordi.carrera.ventura@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: build
+Requires-Dist: twine
+Requires-Dist: openai
+Requires-Dist: python-dotenv
+Requires-Dist: playwright
+Requires-Dist: beautifulsoup4
+Dynamic: license-file
+
+# Conversession
+
+Prompt management CLI application for Linux and MacOS.
+
+
+# Build and publish
+
+1. Building the package before uploading: `python -m build   # from "conversession"`.
+2. Upload the package to pypi: `python -m twine upload --repository {pypi|testpypi} dist/*`
+
+If any dependencies are required, edit the `pyproject.toml` file, "\[project\]" field, and add a `dependencies` key with a `List\[str\]` value, where each string is a `pip`-readable dependency.

conversession-2.0.0/README.md

@@ -0,0 +1,11 @@
+# Conversession
+
+Prompt management CLI application for Linux and MacOS.
+
+
+# Build and publish
+
+1. Building the package before uploading: `python -m build   # from "conversession"`.
+2. Upload the package to pypi: `python -m twine upload --repository {pypi|testpypi} dist/*`
+
+If any dependencies are required, edit the `pyproject.toml` file, "\[project\]" field, and add a `dependencies` key with a `List\[str\]` value, where each string is a `pip`-readable dependency.

conversession-2.0.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=75.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "conversession"
+version = "2.0.0"
+authors = [
+  { name="Jordi Carrera Ventura", email="jordi.carrera.ventura@gmail.com" },
+]
+description = ""
+readme = "README.md"
+requires-python = ">=3.11"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+  "build",
+  "twine",
+  "openai",
+  "python-dotenv",
+  "playwright",
+  "beautifulsoup4"
+
+]  # as pip-installable strings
+
+[project.scripts]
+conversession = "conversession.__main__:main"

conversession-2.0.0/setup.cfg

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

conversession-2.0.0/src/conversession/__init__.py

@@ -0,0 +1,257 @@
+from pathlib import Path
+import subprocess
+import os
+import sys
+import re
+from typing import Optional
+from urllib.parse import urlparse
+
+import dotenv
+from openai import OpenAI
+from bs4 import BeautifulSoup
+from playwright.sync_api import sync_playwright, TimeoutError as PlaywrightTimeoutError
+
+from .models import LLMS
+
+BUILT_IN_COMMANDS = [
+    "all",
+    "new",
+    "model",
+    "models",
+    "help",
+    "quit",
+]
+
+SKILLS_DIR = Path(__file__).resolve().parent.parent.parent / "skills"
+
+
+def _get_skills_dir() -> Path:
+    SKILLS_DIR.mkdir(parents=True, exist_ok=True)
+    return SKILLS_DIR
+
+
+def load_skills() -> list[dict]:
+    skills_dir = _get_skills_dir()
+    skills = []
+    for f in sorted(skills_dir.glob("*.md")):
+        content = f.read_text().strip()
+        if not content:
+            continue
+        name = f.stem
+        summary = content[:90].replace("\n", " ")
+        if len(content) > 90:
+            summary += "..."
+        skills.append({"name": name, "path": f, "summary": summary})
+    return skills
+
+
+def list_models(active=None) -> None:
+    for m in LLMS:
+        marker = "* " if m is active else "  "
+        print(f"{marker}{m.name} ({m.shorthand}): {m.url}")
+
+
+def list_skills() -> None:
+    skills = load_skills()
+    if not skills:
+        print("No skills found. Use new to create one.")
+        return
+    for s in skills:
+        print(f"  {s['name']}: {s['summary']}")
+
+
+def _open_in_editor(filepath: Path) -> None:
+    editor = os.environ.get("EDITOR")
+    if editor:
+        subprocess.run([editor, str(filepath)])
+    elif sys.platform == "darwin":
+        subprocess.run(["open", "-t", str(filepath)])
+    elif sys.platform.startswith("linux"):
+        subprocess.run(["xdg-open", str(filepath)])
+    else:
+        subprocess.run(["vi", str(filepath)])
+
+
+def run_skill_creation_wizard() -> None:
+    skills_dir = _get_skills_dir()
+    name = input("Skill name: ").strip()
+    if not name:
+        print("Cancelled.")
+        return
+    sanitized = "".join(c for c in name if c.isalnum() or c in "-_").strip("-_")
+    if not sanitized:
+        print("Invalid name. Use letters, numbers, hyphens, and underscores.")
+        return
+    if sanitized in BUILT_IN_COMMANDS:
+        raise ValueError(
+            f"Can't create a skill whose name {sanitized}"
+            f"matches that of a built-in command: {str(BUILT_IN_COMMANDS)}")
+    filepath = skills_dir / f"{sanitized}.md"
+    if filepath.exists():
+        overwrite = input(f"Skill '{sanitized}' already exists. Edit it? [Y/n] ").strip().lower()
+        if overwrite not in ("", "y", "yes"):
+            print("Cancelled.")
+            return
+    else:
+        filepath.write_text("")
+        print(f"Created empty skill '{sanitized}'.")
+    _open_in_editor(filepath)
+    if filepath.exists() and filepath.read_text().strip():
+        print(f"Skill '{sanitized}' saved.")
+    else:
+        print(f"Skill '{sanitized}' is empty.")
+
+
+def _resolve_skill(name: str) -> Optional[Path]:
+    skills_dir = _get_skills_dir()
+    filepath = skills_dir / f"{name}.md"
+    return filepath if filepath.exists() else None
+
+
+def edit_skill(name: str) -> None:
+    filepath = _resolve_skill(name)
+    if not filepath:
+        print(f"Skill '{name}' not found.")
+        return
+    _open_in_editor(filepath)
+
+
+def _set_clipboard(text: str) -> None:
+    try:
+        if sys.platform == "darwin":
+            subprocess.run(["pbcopy"], input=text, text=True)
+        elif sys.platform.startswith("linux"):
+            subprocess.run(["xclip", "-selection", "clipboard"], input=text, text=True)
+        else:
+            pass  # silently skip
+    except Exception:
+        pass
+
+
+def _is_url(value: str) -> bool:
+    if not value:
+        return False
+    parsed = urlparse(value)
+    return parsed.scheme in {"http", "https"} and bool(parsed.netloc)
+
+
+def _dismiss_common_popups(page) -> None:
+    try:
+        page.evaluate(
+            """
+            () => {
+                const selectors = [
+                    '[role="dialog"]',
+                    '[aria-modal="true"]',
+                    '[class*="cookie" i]',
+                    '[class*="consent" i]',
+                    '[class*="popup" i]',
+                    '[class*="modal" i]',
+                    '[class*="overlay" i]'
+                ];
+                for (const sel of selectors) {
+                    document.querySelectorAll(sel).forEach(el => el.remove());
+                }
+            }
+            """
+        )
+    except Exception:
+        return
+
+    button_texts = [
+        "Accept all",
+        "Accept",
+        "Agree",
+        "I agree",
+        "Allow all",
+        "OK",
+        "Got it",
+        "Close",
+    ]
+    for text in button_texts:
+        try:
+            locator = page.locator(f"button:has-text('{text}')").first
+            if locator.count() > 0 and locator.is_visible():
+                locator.click(timeout=1000)
+        except Exception:
+            continue
+
+
+def _extract_main_text(html: str) -> str:
+    soup = BeautifulSoup(html, "html.parser")
+    for tag in soup(["script", "style", "noscript", "svg", "canvas"]):
+        tag.decompose()
+
+    candidate = (
+        soup.find("article")
+        or soup.find("main")
+        or soup.find(attrs={"role": "main"})
+        or soup.body
+        or soup
+    )
+
+    text = " ".join(candidate.stripped_strings)
+    text = re.sub(r"\s+", " ", text).strip()
+    return text
+
+
+def fetch_webpage_text(url: str, timeout_ms: int = 20000) -> str:
+    with sync_playwright() as p:
+        browser = p.chromium.launch(headless=True)
+        context = browser.new_context(
+            user_agent=(
+                "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) "
+                "AppleWebKit/537.36 (KHTML, like Gecko) "
+                "Chrome/124.0 Safari/537.36"
+            )
+        )
+
+        def _route_filter(route, request):
+            if request.resource_type in {"image", "media", "font"}:
+                route.abort()
+            else:
+                route.continue_()
+
+        context.route("**/*", _route_filter)
+        page = context.new_page()
+        page.on("dialog", lambda dialog: dialog.dismiss())
+
+        try:
+            page.goto(url, wait_until="domcontentloaded", timeout=timeout_ms)
+            try:
+                page.wait_for_load_state("networkidle", timeout=timeout_ms)
+            except PlaywrightTimeoutError:
+                pass
+            _dismiss_common_popups(page)
+            try:
+                page.wait_for_selector("article, main, [role='main']", timeout=5000)
+            except PlaywrightTimeoutError:
+                pass
+
+            html = page.content()
+            text = _extract_main_text(html)
+            if text:
+                return text
+
+            try:
+                body_text = page.locator("body").inner_text(timeout=3000)
+            except Exception:
+                body_text = ""
+            body_text = re.sub(r"\s+", " ", body_text).strip()
+            return body_text
+        finally:
+            context.close()
+            browser.close()
+
+def compose_prompt(name: str, target: str) -> None:
+    filepath = _resolve_skill(name)
+    if not filepath:
+        print(f"Skill '{name}' not found.")
+        return
+
+    template = filepath.read_text().strip()
+
+    parts = [template, target]
+    prompt = "\n".join(parts)
+
+    return prompt

conversession-2.0.0/src/conversession/__main__.py

@@ -0,0 +1,147 @@
+import os
+import tempfile
+from pathlib import Path
+
+from . import (
+    compose_prompt,
+    edit_skill,
+    list_models,
+    list_skills,
+    load_skills,
+    run_skill_creation_wizard,
+    _open_in_editor,
+    _resolve_skill,
+    _set_clipboard,
+    _is_url,
+    fetch_webpage_text,
+)
+from .models import LLMS
+
+HELP = """
+Built-in commands:
+  new          Create a new skill
+  all          List all skills
+  model        Show active model
+  model <arg>  Switch model (by name or shorthand)
+  models       List all available models
+  help         Show this message
+  quit         Quit the application
+
+Type <skill>          to edit then open the LLM webpage.
+Type <skill> <target> to execute a skill with context.
+Type edit <skill>     to edit a skill only (no webpage).
+"""
+
+
+ACTIVE_MODEL = LLMS[0]
+
+
+def _dispatch(command: str) -> bool:
+    """Handle one user input. Returns False if the app should quit."""
+    global ACTIVE_MODEL
+    raw = command.strip()
+    if not raw:
+        return True
+
+    # ... (Keep existing command logic: quit, help, new, all, models, model) ...
+    if raw == "quit": return False
+    if raw == "help": print(HELP); return True
+    if raw == "new": run_skill_creation_wizard(); return True
+    if raw == "all": list_skills(); return True
+    if raw == "models": list_models(ACTIVE_MODEL); return True
+    
+    if raw == "model":
+        print(f"Current model: {ACTIVE_MODEL.name} ({ACTIVE_MODEL.shorthand})")
+        return True
+    if raw.startswith("model "):
+        arg = raw[6:].strip()
+        for m in LLMS:
+            if arg.lower() in (m.name.lower(), m.shorthand.lower()):
+                ACTIVE_MODEL = m
+                print(f"Switched to {ACTIVE_MODEL.name}.")
+                return True
+        print(f"Unknown model '{arg}'.")
+        return True
+
+    # Parse <edit> <skill>, <skill> <target>, or <skill>
+    rest = raw
+    first_space = rest.find(" ")
+    if first_space == -1:
+        name = rest
+        target = ""
+    else:
+        name = rest[:first_space]
+        target = rest[first_space + 1:].strip()
+
+    if name == "edit":
+        edit_skill(target)
+        return True
+
+    skills = {s["name"] for s in load_skills()}
+    if name not in skills:
+        print(f"Unknown skill '{name}'. Type `help` or `all` to see available commands.")
+        return True
+
+
+    # Determine initial prompt content
+    if target and _is_url(target):
+        print("Fetching webpage content...")
+        prompt = compose_prompt(name, target)
+        _set_clipboard(prompt)
+        os.system(f"open '{ACTIVE_MODEL.url}'")
+        return True
+    filepath = _resolve_skill(name)
+    if not filepath:
+        print(f"Skill '{name}' not found.")
+        return True
+    
+    prompt = compose_prompt(name, target)
+
+    # Create temporary scratchpad and edit
+    with tempfile.NamedTemporaryFile(mode='w+', suffix='.md', delete=False) as tf:
+        tf.write(prompt)
+        temp_path = Path(tf.name)
+    
+    if not target:
+        try:
+            _open_in_editor(temp_path)
+            
+            # --- ADDED: Manual wait to ensure file is saved ---
+            input("\nFile opened in editor. Press Enter here once you have saved and closed the editor to proceed...")
+            
+            # Read the final content
+            final_prompt = temp_path.read_text()
+            _set_clipboard(final_prompt)
+            print("Prompt copied to clipboard.") # Feedback for clarity
+            os.system(f"open '{ACTIVE_MODEL.url}'")
+        finally:
+            # Clean up
+            if temp_path.exists():
+                os.remove(temp_path)
+    else:
+        prompt = compose_prompt(name, target)
+        _set_clipboard(prompt)
+        os.system(f"open '{ACTIVE_MODEL.url}'")
+
+    return True
+
+
+
+def main() -> None:
+    try:
+        while True:
+            try:
+                command = input("\nAction: ")
+            except (EOFError, KeyboardInterrupt):
+                print()
+                break
+            if not _dispatch(command):
+                break
+    except KeyboardInterrupt:
+        print()
+    finally:
+        print("Done.")
+
+
+if __name__ == "__main__":
+    main()

conversession-2.0.0/src/conversession/models.py

@@ -0,0 +1,9 @@
+from collections import namedtuple
+
+LLM = namedtuple("LLM", "name shorthand url")
+
+LLMS = [
+    LLM("ChatGPT", "gpt", "https://chatgpt.com"),
+    LLM("DeepSeek", "deep", "https://chat.deepseek.com/a/chat"),
+    LLM("Gemini", "gem", "https://gemini.google.com/app"),
+]

conversession-2.0.0/src/conversession.egg-info/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: conversession
+Version: 2.0.0
+Author-email: Jordi Carrera Ventura <jordi.carrera.ventura@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: build
+Requires-Dist: twine
+Requires-Dist: openai
+Requires-Dist: python-dotenv
+Requires-Dist: playwright
+Requires-Dist: beautifulsoup4
+Dynamic: license-file
+
+# Conversession
+
+Prompt management CLI application for Linux and MacOS.
+
+
+# Build and publish
+
+1. Building the package before uploading: `python -m build   # from "conversession"`.
+2. Upload the package to pypi: `python -m twine upload --repository {pypi|testpypi} dist/*`
+
+If any dependencies are required, edit the `pyproject.toml` file, "\[project\]" field, and add a `dependencies` key with a `List\[str\]` value, where each string is a `pip`-readable dependency.

conversession-2.0.0/src/conversession.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/conversession/__init__.py
+src/conversession/__main__.py
+src/conversession/models.py
+src/conversession.egg-info/PKG-INFO
+src/conversession.egg-info/SOURCES.txt
+src/conversession.egg-info/dependency_links.txt
+src/conversession.egg-info/entry_points.txt
+src/conversession.egg-info/requires.txt
+src/conversession.egg-info/top_level.txt

conversession-2.0.0/src/conversession.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

conversession-2.0.0/src/conversession.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+conversession = conversession.__main__:main

conversession-2.0.0/src/conversession.egg-info/requires.txt

@@ -0,0 +1,6 @@
+build
+twine
+openai
+python-dotenv
+playwright
+beautifulsoup4

conversession-2.0.0/src/conversession.egg-info/top_level.txt

@@ -0,0 +1 @@
+conversession