mdv-live 0.1.0__tar.gz

mdv_live-0.1.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: mdv-live
+Version: 0.1.0
+Summary: Markdown Viewer - File tree + Live preview + Hot reload
+Author-email: PanHouse <hirono.okamoto@panhouse.jp>
+License: MIT
+Project-URL: Homepage, https://github.com/panhouse/mdv
+Project-URL: Repository, https://github.com/panhouse/mdv
+Keywords: markdown,viewer,live-reload,preview,hot-reload
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.104.0
+Requires-Dist: uvicorn>=0.24.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: watchdog>=3.0.0
+Requires-Dist: markdown>=3.5.0
+
+# MDV - Markdown Viewer
+
+ファイルツリー + ライブプレビュー付きマークダウンビューア
+
+## Features
+
+- 📁 左側にフォルダツリー表示
+- 📄 マークダウンをHTMLでレンダリング
+- 🔄 ファイル更新時に自動リロード（WebSocket）
+- 🎨 シンタックスハイライト（highlight.js）
+- 📊 Mermaid図のレンダリング対応
+- 🌙 ダークテーマ
+
+## Installation
+
+```bash
+# リポジトリをクローン
+git clone https://github.com/panhouse/mdv.git
+cd mdv
+
+# グローバルインストール
+pip install -e .
+```
+
+## Usage
+
+```bash
+# カレントディレクトリを表示
+mdv
+
+# 特定のディレクトリを表示
+mdv ./project/
+
+# ポート指定
+mdv -p 9000
+
+# ブラウザを自動で開かない
+mdv --no-browser
+```
+
+## Requirements
+
+- Python 3.9+
+- FastAPI
+- uvicorn
+- watchdog
+- markdown

mdv_live-0.1.0/README.md

@@ -0,0 +1,47 @@
+# MDV - Markdown Viewer
+
+ファイルツリー + ライブプレビュー付きマークダウンビューア
+
+## Features
+
+- 📁 左側にフォルダツリー表示
+- 📄 マークダウンをHTMLでレンダリング
+- 🔄 ファイル更新時に自動リロード（WebSocket）
+- 🎨 シンタックスハイライト（highlight.js）
+- 📊 Mermaid図のレンダリング対応
+- 🌙 ダークテーマ
+
+## Installation
+
+```bash
+# リポジトリをクローン
+git clone https://github.com/panhouse/mdv.git
+cd mdv
+
+# グローバルインストール
+pip install -e .
+```
+
+## Usage
+
+```bash
+# カレントディレクトリを表示
+mdv
+
+# 特定のディレクトリを表示
+mdv ./project/
+
+# ポート指定
+mdv -p 9000
+
+# ブラウザを自動で開かない
+mdv --no-browser
+```
+
+## Requirements
+
+- Python 3.9+
+- FastAPI
+- uvicorn
+- watchdog
+- markdown

mdv_live-0.1.0/mdv/__init__.py

@@ -0,0 +1,6 @@
+"""
+MDV - Markdown Viewer
+ファイルツリー + ライブプレビュー付きマークダウンビューア
+"""
+
+__version__ = "0.1.0"

mdv_live-0.1.0/mdv/__main__.py

@@ -0,0 +1,9 @@
+"""
+MDV - Markdown Viewer
+python -m mdv で実行可能にする
+"""
+
+from .cli import main
+
+if __name__ == '__main__':
+    main()

mdv_live-0.1.0/mdv/cli.py

@@ -0,0 +1,339 @@
+#!/usr/bin/env python3
+"""
+MDV - Markdown Viewer CLI
+どこからでも呼び出せるマークダウンビューア
+"""
+
+from __future__ import annotations
+
+import argparse
+import subprocess
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+from typing import List, Optional
+
+
+
+@dataclass
+class ProcessInfo:
+    """プロセス情報"""
+    pid: str
+    port: str
+    command: str
+
+
+def get_mdv_processes() -> List[ProcessInfo]:
+    """稼働中のMDVサーバープロセスを取得"""
+    try:
+        result = subprocess.run(
+            ["lsof", "-i", "-P", "-n"],
+            capture_output=True,
+            text=True,
+        )
+
+        processes = []
+        for line in result.stdout.strip().split("\n"):
+            if "python" not in line.lower() or "LISTEN" not in line:
+                continue
+
+            parts = line.split()
+            if len(parts) < 9:
+                continue
+
+            pid = parts[1]
+
+            # プロセスのコマンドラインを確認
+            try:
+                cmd_result = subprocess.run(
+                    ["ps", "-p", pid, "-o", "command="],
+                    capture_output=True,
+                    text=True,
+                )
+                cmd = cmd_result.stdout.strip()
+
+                if "mdv" not in cmd.lower():
+                    continue
+
+                # ポート番号を抽出
+                port_info = parts[8] if len(parts) > 8 else ""
+                port = ""
+                if ":" in port_info:
+                    port = port_info.split(":")[-1].split("->")[0]
+
+                # コマンドを短縮
+                display_cmd = cmd[:80] + "..." if len(cmd) > 80 else cmd
+
+                processes.append(ProcessInfo(
+                    pid=pid,
+                    port=port,
+                    command=display_cmd,
+                ))
+            except subprocess.SubprocessError:
+                pass
+
+        return processes
+
+    except Exception as e:
+        print(f"Error getting processes: {e}")
+        return []
+
+
+def list_servers() -> int:
+    """稼働中のMDVサーバーを一覧表示"""
+    processes = get_mdv_processes()
+
+    if not processes:
+        print("稼働中のMDVサーバーはありません")
+        return 0
+
+    print(f"稼働中のMDVサーバー: {len(processes)}件")
+    print("-" * 60)
+    print(f"{'PID':<8} {'Port':<8} {'Command'}")
+    print("-" * 60)
+
+    for proc in processes:
+        print(f"{proc.pid:<8} {proc.port:<8} {proc.command}")
+
+    print("-" * 60)
+    print("\n停止: mdv -k -a (全停止) / mdv -k <PID> (個別停止)")
+    return 0
+
+
+def kill_server_by_pid(pid: str) -> int:
+    """特定のPIDのサーバーを停止"""
+    try:
+        subprocess.run(["kill", pid], check=True)
+        print(f"PID {pid} を停止しました")
+        return 0
+    except ValueError:
+        print(f"無効なPID: {pid}")
+        return 1
+    except subprocess.CalledProcessError:
+        print(f"PID {pid} の停止に失敗しました")
+        return 1
+
+
+def kill_all_servers() -> int:
+    """全サーバーを停止"""
+    processes = get_mdv_processes()
+
+    if not processes:
+        print("稼働中のMDVサーバーはありません")
+        return 0
+
+    print(f"{len(processes)}件のMDVサーバーを停止します...")
+
+    killed = 0
+    for proc in processes:
+        try:
+            subprocess.run(["kill", proc.pid], check=True)
+            print(f"  PID {proc.pid} (port {proc.port}) を停止")
+            killed += 1
+        except subprocess.CalledProcessError:
+            print(f"  PID {proc.pid} の停止に失敗")
+
+    print(f"\n完了: {killed}/{len(processes)} 件を停止しました")
+    return 0 if killed == len(processes) else 1
+
+
+def kill_servers(target: Optional[str] = None, kill_all: bool = False) -> int:
+    """MDVサーバーを停止"""
+    if target:
+        return kill_server_by_pid(target)
+
+    if not kill_all:
+        print("全サーバーを停止するには -a オプションが必要です")
+        print("   mdv -k -a     全サーバーを停止")
+        print("   mdv -k <PID>  特定のサーバーを停止")
+        return 1
+
+    return kill_all_servers()
+
+
+def convert_to_pdf(input_path: Path, output_path: Optional[Path] = None) -> int:
+    """MarkdownファイルをPDFに変換（md-to-pdfを使用）"""
+    if not input_path.exists():
+        print(f"Error: File not found: {input_path}")
+        return 1
+
+    if not input_path.is_file():
+        print(f"Error: Not a file: {input_path}")
+        return 1
+
+    if input_path.suffix.lower() not in [".md", ".markdown"]:
+        print(f"Error: Not a markdown file: {input_path}")
+        return 1
+
+    # md-to-pdfコマンドを構築
+    cmd = ["npx", "md-to-pdf", str(input_path)]
+    if output_path:
+        # md-to-pdfは--out-dirオプションを使用
+        cmd.extend(["--out-dir", str(output_path.parent)])
+
+    try:
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            cwd=str(input_path.parent),
+        )
+
+        if result.returncode != 0:
+            if "npx: command not found" in result.stderr or "not found" in result.stderr:
+                print("Error: npx (Node.js) is required for PDF conversion")
+                print("Install Node.js: https://nodejs.org/")
+                return 1
+            print(f"Error: {result.stderr}")
+            return 1
+
+        # 出力ファイルパスを特定
+        default_output = input_path.with_suffix(".pdf")
+        if output_path and output_path != default_output:
+            # リネームが必要な場合
+            if default_output.exists():
+                default_output.rename(output_path)
+                print(f"✅ PDF saved: {output_path}")
+            else:
+                print(f"✅ PDF saved: {output_path}")
+        else:
+            print(f"✅ PDF saved: {default_output}")
+
+        return 0
+
+    except FileNotFoundError:
+        print("Error: npx (Node.js) is required for PDF conversion")
+        print("Install Node.js: https://nodejs.org/")
+        return 1
+    except Exception as e:
+        print(f"Error creating PDF: {e}")
+        return 1
+
+
+def start_viewer(
+    path: str = ".",
+    port: int = 8642,
+    open_browser: bool = True
+) -> None:
+    """MDVサーバーを起動"""
+    target_path = Path(path).resolve()
+
+    if not target_path.exists():
+        print(f"Error: Path does not exist: {target_path}")
+        sys.exit(1)
+
+    # ファイルが指定された場合、親ディレクトリをルートにして、そのファイルを開く
+    initial_file: Optional[str] = None
+    if target_path.is_file():
+        initial_file = target_path.name
+        target_path = target_path.parent
+
+    from .server import start_server
+    start_server(
+        root_path=str(target_path),
+        port=port,
+        open_browser=open_browser,
+        initial_file=initial_file,
+    )
+
+
+def create_parser() -> argparse.ArgumentParser:
+    """引数パーサーを作成"""
+    parser = argparse.ArgumentParser(
+        prog="mdv",
+        description="MDV - Markdown Viewer with file tree + live preview",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  mdv                    Start viewer in current directory
+  mdv /path/to/dir       Start viewer in specified directory
+  mdv README.md          Open specific file
+  mdv --pdf README.md    Convert markdown to PDF
+  mdv -p 3000            Start on port 3000
+  mdv -l                 List running servers
+  mdv -k -a              Stop all servers
+""",
+    )
+
+    # サーバー管理オプション
+    parser.add_argument(
+        "-l", "--list",
+        action="store_true",
+        help="List running MDV servers",
+    )
+    parser.add_argument(
+        "-k", "--kill",
+        nargs="?",
+        const="__no_pid__",
+        metavar="PID",
+        help="Stop server (-k -a for all, -k <PID> for specific)",
+    )
+    parser.add_argument(
+        "-a", "--all",
+        action="store_true",
+        help="Use with -k to stop all servers",
+    )
+
+    # ビューア起動オプション
+    parser.add_argument(
+        "path",
+        nargs="?",
+        default=".",
+        help="Directory or file path to view (default: current directory)",
+    )
+    parser.add_argument(
+        "-p", "--port",
+        type=int,
+        default=8642,
+        help="Server port (default: 8642)",
+    )
+    parser.add_argument(
+        "--no-browser",
+        action="store_true",
+        help="Don't open browser automatically",
+    )
+
+    # PDF変換オプション
+    parser.add_argument(
+        "--pdf",
+        action="store_true",
+        help="Convert markdown file to PDF",
+    )
+    parser.add_argument(
+        "-o", "--output",
+        type=str,
+        metavar="FILE",
+        help="Output PDF file path (default: same name as input with .pdf extension)",
+    )
+
+    return parser
+
+
+def main() -> None:
+    """メインエントリーポイント"""
+    parser = create_parser()
+    args = parser.parse_args()
+
+    # -l: サーバー一覧
+    if args.list:
+        sys.exit(list_servers())
+
+    # -k: サーバー停止
+    if args.kill is not None:
+        if args.kill != "__no_pid__":
+            sys.exit(kill_servers(target=args.kill))
+        else:
+            sys.exit(kill_servers(kill_all=args.all))
+
+    # --pdf: PDF変換
+    if args.pdf:
+        input_path = Path(args.path).resolve()
+        output_path = Path(args.output).resolve() if args.output else None
+        sys.exit(convert_to_pdf(input_path, output_path))
+
+    # デフォルト: ビューア起動
+    start_viewer(args.path, args.port, not args.no_browser)
+
+
+if __name__ == "__main__":
+    main()

mdv_live-0.1.0/mdv/file_types.py

@@ -0,0 +1,103 @@
+"""
+ファイルタイプの定義
+"""
+
+from dataclasses import dataclass
+from typing import Dict, Optional
+
+
+@dataclass(frozen=True)
+class FileTypeInfo:
+    """ファイルタイプ情報"""
+    type: str  # 'markdown', 'text', 'code', 'image'
+    icon: str
+    lang: Optional[str] = None
+
+
+# ファイル拡張子とタイプのマッピング
+FILE_TYPES: Dict[str, FileTypeInfo] = {
+    # Markdown
+    ".md": FileTypeInfo("markdown", "markdown"),
+    ".markdown": FileTypeInfo("markdown", "markdown"),
+
+    # Text
+    ".txt": FileTypeInfo("text", "text"),
+    ".text": FileTypeInfo("text", "text"),
+    ".rst": FileTypeInfo("text", "text"),
+    ".log": FileTypeInfo("text", "text"),
+
+    # Config files
+    ".json": FileTypeInfo("code", "json", "json"),
+    ".yaml": FileTypeInfo("code", "yaml", "yaml"),
+    ".yml": FileTypeInfo("code", "yaml", "yaml"),
+    ".toml": FileTypeInfo("code", "toml", "toml"),
+    ".ini": FileTypeInfo("code", "config", "ini"),
+    ".cfg": FileTypeInfo("code", "config", "ini"),
+    ".conf": FileTypeInfo("code", "config", "ini"),
+    ".env": FileTypeInfo("code", "config", "bash"),
+
+    # Code files
+    ".py": FileTypeInfo("code", "python", "python"),
+    ".js": FileTypeInfo("code", "javascript", "javascript"),
+    ".ts": FileTypeInfo("code", "typescript", "typescript"),
+    ".jsx": FileTypeInfo("code", "react", "javascript"),
+    ".tsx": FileTypeInfo("code", "react", "typescript"),
+    ".html": FileTypeInfo("code", "html", "html"),
+    ".css": FileTypeInfo("code", "css", "css"),
+    ".scss": FileTypeInfo("code", "css", "scss"),
+    ".less": FileTypeInfo("code", "css", "less"),
+    ".java": FileTypeInfo("code", "java", "java"),
+    ".c": FileTypeInfo("code", "c", "c"),
+    ".cpp": FileTypeInfo("code", "cpp", "cpp"),
+    ".h": FileTypeInfo("code", "c", "c"),
+    ".hpp": FileTypeInfo("code", "cpp", "cpp"),
+    ".go": FileTypeInfo("code", "go", "go"),
+    ".rs": FileTypeInfo("code", "rust", "rust"),
+    ".rb": FileTypeInfo("code", "ruby", "ruby"),
+    ".php": FileTypeInfo("code", "php", "php"),
+    ".swift": FileTypeInfo("code", "swift", "swift"),
+    ".kt": FileTypeInfo("code", "kotlin", "kotlin"),
+    ".sh": FileTypeInfo("code", "shell", "bash"),
+    ".bash": FileTypeInfo("code", "shell", "bash"),
+    ".zsh": FileTypeInfo("code", "shell", "bash"),
+    ".sql": FileTypeInfo("code", "database", "sql"),
+    ".xml": FileTypeInfo("code", "xml", "xml"),
+    ".graphql": FileTypeInfo("code", "graphql", "graphql"),
+    ".vue": FileTypeInfo("code", "vue", "html"),
+    ".svelte": FileTypeInfo("code", "svelte", "html"),
+
+    # Images
+    ".png": FileTypeInfo("image", "image"),
+    ".jpg": FileTypeInfo("image", "image"),
+    ".jpeg": FileTypeInfo("image", "image"),
+    ".gif": FileTypeInfo("image", "image"),
+    ".svg": FileTypeInfo("image", "image"),
+    ".webp": FileTypeInfo("image", "image"),
+    ".ico": FileTypeInfo("image", "image"),
+    ".bmp": FileTypeInfo("image", "image"),
+}
+
+# サポートする拡張子のセット
+SUPPORTED_EXTENSIONS = frozenset(FILE_TYPES.keys())
+
+# スキップするディレクトリ
+SKIP_DIRECTORIES = frozenset([
+    "node_modules",
+    "__pycache__",
+    "venv",
+    ".venv",
+    ".git",
+    "dist",
+    "build",
+    ".next",
+    ".nuxt",
+    ".cache",
+    "coverage",
+    ".pytest_cache",
+    ".mypy_cache",
+])
+
+
+def get_file_type(extension: str) -> Optional[FileTypeInfo]:
+    """拡張子からファイルタイプ情報を取得"""
+    return FILE_TYPES.get(extension.lower())

mdv_live-0.1.0/mdv/models.py

@@ -0,0 +1,11 @@
+"""
+リクエスト/レスポンスモデル
+"""
+
+from pydantic import BaseModel
+
+
+class SaveFileRequest(BaseModel):
+    """ファイル保存リクエスト"""
+    path: str
+    content: str