simple-vcs 1.2.0__py3-none-any.whl → 1.3.0__py3-none-any.whl

simple_vcs/cli.py

@@ -1,17 +1,93 @@
 import click
 from .core import SimpleVCS
 from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+from rich import box
+from rich.columns import Columns
 
 console = Console()
 
-@click.group()
-@click.version_option(version="1.2.0", prog_name="SimpleVCS")
+class RichGroup(click.Group):
+    """Custom Click Group that adds Rich formatting to help output"""
+
+    def format_help(self, ctx, formatter):
+        """Override help formatting with Rich output"""
+        console = Console()
+
+        # Beautiful header
+        console.print()
+        title = Text("SimpleVCS", style="bold cyan", justify="center")
+        subtitle = Text("A Beautiful Version Control System", style="dim", justify="center")
+        console.print(title)
+        console.print(subtitle)
+        console.print()
+
+        # Description panel
+        description = Panel(
+            "[white]A lightweight, elegant version control system with a modern terminal interface.\n"
+            "Track your files, manage versions, and keep your project history organized.[/white]",
+            title="[bold cyan]About[/bold cyan]",
+            border_style="cyan",
+            box=box.ROUNDED,
+            padding=(0, 2)
+        )
+        console.print(description)
+        console.print()
+
+        # Commands section
+        console.print("[bold white]Available Commands:[/bold white]")
+        console.print()
+
+        commands_info = [
+            ("init", "Initialize a new repository", "cyan"),
+            ("add", "Add files to staging area", "green"),
+            ("commit", "Create a new commit", "green"),
+            ("status", "Show repository status", "yellow"),
+            ("log", "View commit history", "blue"),
+            ("diff", "Compare commits", "magenta"),
+            ("revert", "Revert to previous commit", "red"),
+            ("snapshot", "Create backup snapshot", "cyan"),
+            ("restore", "Restore from snapshot", "cyan"),
+            ("compress", "Optimize storage", "yellow"),
+        ]
+
+        for cmd_name, cmd_desc, color in commands_info:
+            console.print(f"  [{color}]{cmd_name:12}[/{color}] [dim]{cmd_desc}[/dim]")
+
+        console.print()
+
+        # Usage examples
+        examples = Panel(
+            "[bold]Quick Start:[/bold]\n"
+            "[cyan]$[/cyan] svcs init                    [dim]# Create repository[/dim]\n"
+            "[cyan]$[/cyan] svcs add file.txt            [dim]# Stage files[/dim]\n"
+            "[cyan]$[/cyan] svcs commit -m \"message\"     [dim]# Save changes[/dim]\n"
+            "[cyan]$[/cyan] svcs log                     [dim]# View history[/dim]\n\n"
+            "[bold]Get Help:[/bold]\n"
+            "[cyan]$[/cyan] svcs [yellow]<command>[/yellow] --help       [dim]# Help for specific command[/dim]",
+            title="[bold green]Examples[/bold green]",
+            border_style="green",
+            box=box.ROUNDED,
+            padding=(0, 2)
+        )
+        console.print(examples)
+        console.print()
+
+        # Footer
+        console.print(
+            "[dim]Version 1.2.0  |  "
+            "More info: [/dim][cyan]https://github.com/muhammadsufiyanbaig/simple_vcs[/cyan]"
+        )
+        console.print()
+
+        # Prevent Click from outputting its own help
+        ctx.resilient_parsing = True
+
+@click.group(cls=RichGroup)
+@click.version_option(version="1.3.0", prog_name="SimpleVCS")
 def main():
-    """
-    SimpleVCS - A beautiful and simple version control system
-
-    A lightweight VCS with an intuitive interface for managing your project versions.
-    """
+    """SimpleVCS - A beautiful and simple version control system"""
     pass
 
 @main.command()

simple_vcs/core.py

@@ -15,6 +15,9 @@ from rich.progress import Progress, SpinnerColumn, TextColumn, BarColumn
 from rich.syntax import Syntax
 from rich import box
 from rich.text import Text
+from rich.columns import Columns
+from rich.tree import Tree
+from rich.align import Align
 
 class SimpleVCS:
     """Simple Version Control System core functionality"""
@@ -36,6 +39,13 @@ class SimpleVCS:
             self.console.print(f"[yellow]WARNING: Repository already exists at[/yellow] [cyan]{self.repo_path}[/cyan]")
             return False
 
+        # Print beautiful header
+        self.console.print()
+        header = Text("SimpleVCS", style="bold cyan", justify="center")
+        self.console.print(header)
+        self.console.print(Align.center("[dim]A Beautiful Version Control System[/dim]"))
+        self.console.print()
+
         self.console.print("[cyan]Initializing repository...[/cyan]")
 
         # Create directory structure
@@ -47,18 +57,50 @@ class SimpleVCS:
         self._write_json(self.staging_file, {})
         self.head_file.write_text("0")  # Start with commit 0
 
+        # Create tree structure visualization
+        tree = Tree(
+            "[bold cyan].svcs/[/bold cyan] [dim](Repository Root)[/dim]",
+            guide_style="cyan"
+        )
+        tree.add("[green]objects/[/green] [dim]- Stores file content by hash[/dim]")
+        tree.add("[green]commits.json[/green] [dim]- Tracks all commits and history[/dim]")
+        tree.add("[green]staging.json[/green] [dim]- Lists files ready to commit[/dim]")
+        tree.add("[green]HEAD[/green] [dim]- Points to current commit[/dim]")
+
+        # Create success panel with tree
+        panel_content = (
+            f"[bold green]SUCCESS![/bold green] Repository initialized\n\n"
+            f"[bold]Location:[/bold]\n"
+            f"[cyan]{self.repo_path}[/cyan]\n\n"
+            f"[bold]Directory Structure:[/bold]"
+        )
+
         panel = Panel(
-            f"[green]SUCCESS[/green] Repository initialized at [cyan]{self.repo_path}[/cyan]\n\n"
-            "[dim]Structure created:[/dim]\n"
-            "  - .svcs/objects/ - File storage\n"
-            "  - .svcs/commits.json - Commit history\n"
-            "  - .svcs/staging.json - Staged files\n"
-            "  - .svcs/HEAD - Current commit",
-            title="[bold green]SimpleVCS Repository[/bold green]",
+            panel_content,
+            title="[bold white on green] Repository Created [/bold white on green]",
             border_style="green",
-            box=box.ROUNDED
+            box=box.DOUBLE,
+            padding=(1, 2)
         )
         self.console.print(panel)
+        self.console.print(tree)
+
+        # Quick start guide
+        guide_panel = Panel(
+            "[bold]Quick Start:[/bold]\n\n"
+            "[cyan]1.[/cyan] Add files:      [yellow]svcs add <file>[/yellow]\n"
+            "[cyan]2.[/cyan] Commit changes: [yellow]svcs commit -m \"message\"[/yellow]\n"
+            "[cyan]3.[/cyan] View history:   [yellow]svcs log[/yellow]\n"
+            "[cyan]4.[/cyan] Check status:   [yellow]svcs status[/yellow]",
+            title="[bold cyan]Next Steps[/bold cyan]",
+            border_style="cyan",
+            box=box.ROUNDED,
+            padding=(0, 2)
+        )
+        self.console.print()
+        self.console.print(guide_panel)
+        self.console.print()
+
         return True
     
     def add_file(self, file_path: str) -> bool:
@@ -235,56 +277,102 @@ class SimpleVCS:
 
         commits = self._read_json(self.commits_file)
         if not commits:
-            self.console.print("[yellow]WARNING: No commits found[/yellow]")
-            self.console.print("[dim]Tip: Use 'svcs commit -m \"message\"' to create your first commit[/dim]")
+            # Create empty state panel
+            empty_panel = Panel(
+                "[yellow]No commits yet[/yellow]\n\n"
+                "[dim]Your repository is ready, but you haven't made any commits.[/dim]\n\n"
+                "[bold]Get started:[/bold]\n"
+                "[cyan]1.[/cyan] Add files:  [yellow]svcs add <file>[/yellow]\n"
+                "[cyan]2.[/cyan] Commit:     [yellow]svcs commit -m \"First commit\"[/yellow]",
+                title="[bold yellow]Empty Repository[/bold yellow]",
+                border_style="yellow",
+                box=box.ROUNDED,
+                padding=(1, 2)
+            )
+            self.console.print()
+            self.console.print(empty_panel)
+            self.console.print()
             return False
 
         commits_to_show = commits[-limit:] if limit else commits
         commits_to_show.reverse()  # Show newest first
 
-        # Create commits table
+        # Print beautiful header
+        self.console.print()
+        header_text = Text()
+        header_text.append("Commit History", style="bold cyan")
+        self.console.print(Align.center(header_text))
+        self.console.print(Align.center(f"[dim]Repository: {self.repo_path.name}[/dim]"))
+        self.console.print()
+
+        # Create commits table with enhanced styling
         table = Table(
-            title="[bold cyan]Commit History[/bold cyan]",
-            box=box.ROUNDED,
+            box=box.DOUBLE_EDGE,
             show_header=True,
-            header_style="bold magenta"
+            header_style="bold white on blue",
+            border_style="cyan",
+            padding=(0, 1)
         )
-        table.add_column("ID", justify="center", style="cyan", width=6)
-        table.add_column("Date", style="green", width=19)
-        table.add_column("Message", style="white")
-        table.add_column("Files", justify="center", style="yellow", width=7)
-        table.add_column("Parent", justify="center", style="dim", width=7)
+        table.add_column("ID", justify="center", style="bold cyan", width=8)
+        table.add_column("Date & Time", style="green", width=19)
+        table.add_column("Commit Message", style="white", no_wrap=False)
+        table.add_column("Files", justify="center", style="bold yellow", width=7)
+        table.add_column("Parent", justify="center", style="dim", width=8)
 
         current_commit_id = self._get_current_commit_id()
 
         for commit in commits_to_show:
             commit_id = str(commit['id'])
-            if commit['id'] == current_commit_id:
-                commit_id = f"* {commit_id}"  # Mark current commit
+            is_current = commit['id'] == current_commit_id
+
+            if is_current:
+                commit_id = f"-> {commit_id}"  # Mark current commit with arrow
 
             date_str = datetime.fromtimestamp(commit['timestamp']).strftime('%Y-%m-%d %H:%M:%S')
             message = commit['message']
-            if len(message) > 50:
-                message = message[:47] + "..."
+            if len(message) > 60:
+                message = message[:57] + "..."
             files_count = str(len(commit['files']))
-            parent = str(commit.get('parent', '-'))
+            parent = str(commit.get('parent', 'None'))
 
-            # Style current commit differently
-            if commit['id'] == current_commit_id:
+            # Style current commit differently with background
+            if is_current:
                 table.add_row(
-                    f"[bold cyan]{commit_id}[/bold cyan]",
-                    date_str,
-                    f"[bold]{message}[/bold]",
-                    files_count,
-                    parent
+                    f"[bold white on blue]{commit_id}[/bold white on blue]",
+                    f"[bold]{date_str}[/bold]",
+                    f"[bold white]{message}[/bold white]",
+                    f"[bold]{files_count}[/bold]",
+                    parent,
+                    style="on blue"
                 )
             else:
                 table.add_row(commit_id, date_str, message, files_count, parent)
 
         self.console.print(table)
 
+        # Statistics footer
+        stats_text = (
+            f"[dim]Total commits: [/dim][cyan]{len(commits)}[/cyan]"
+        )
         if limit and len(commits) > limit:
-            self.console.print(f"\n[dim]Showing last {limit} of {len(commits)} commits[/dim]")
+            stats_text += f"[dim]  |  Showing: [/dim][yellow]Last {limit}[/yellow]"
+        if current_commit_id:
+            stats_text += f"[dim]  |  Current: [/dim][green]#{current_commit_id}[/green]"
+
+        self.console.print()
+        self.console.print(Align.center(stats_text))
+        self.console.print()
+
+        # Legend
+        legend = Panel(
+            "[bold white on blue]-> ID[/bold white on blue] = Current commit  |  "
+            "[dim]Parent[/dim] = Previous commit ID",
+            border_style="dim",
+            box=box.ROUNDED,
+            padding=(0, 2)
+        )
+        self.console.print(legend)
+        self.console.print()
 
         return True
     

{simple_vcs-1.2.0.dist-info → simple_vcs-1.3.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: simple-vcs
-Version: 1.2.0
-Summary: A beautiful and simple version control system with a modern terminal interface
+Version: 1.3.0
+Summary: A beautiful and simple version control system with a stunning terminal interface
 Home-page: https://github.com/muhammadsufiyanbaig/simple_vcs
 Author: Muhammad Sufiyan Baig
 Author-email: Muhammad Sufiyan Baig <send.sufiyan@gmail.com>
@@ -44,13 +44,14 @@ Dynamic: requires-python
 
 A simple version control system written in Python that provides basic VCS functionality similar to Git - now with a **beautiful modern terminal interface**!
 
-## ✨ New in Version 1.2.0
+## ✨ New in Version 1.3.0
 
-**Stunning Visual Interface** - SimpleVCS now features a gorgeous terminal interface powered by Rich:
-- 🎨 **Colored Output** - Color-coded messages for success, warnings, and errors
-- 📊 **Beautiful Tables** - Commit history and status displayed in elegant tables
-- 📦 **Styled Panels** - Information presented in clean, bordered boxes
-- 🌟 **Professional Look** - Modern, easy-to-read formatting throughout
+**Enhanced Visual Experience** - SimpleVCS now features an even more stunning terminal interface:
+- 🎨 **Enhanced Init** - Beautiful header, tree structure, and quick start guide
+- 📜 **Gorgeous Log** - Double-bordered tables with highlighted current commit and legend
+- 💡 **Rich Help** - Custom help interface with examples and organized commands
+- 🌈 **Professional Design** - Centered headers, better spacing, and visual hierarchy
+- ⭐ **Better UX** - Empty state messages, statistics, and helpful tips throughout
 
 ## Features
 
@@ -327,6 +328,16 @@ Project Link: [https://github.com/muhammadsufiyanbaig/simple_vcs](https://github
 
 ## Changelog
 
+### Version 1.3.0
+- **Enhanced Init Command**: Beautiful header, tree visualization, and quick start guide
+- **Gorgeous Log Display**: Double-bordered tables with current commit highlighting
+- **Custom Help Interface**: Rich-formatted help with organized commands and examples
+- **Better Visual Hierarchy**: Centered headers, improved spacing, and alignment
+- **Enhanced Empty States**: Helpful messages when no commits exist
+- **Statistics Display**: Show total commits, current commit, and filters in log
+- **Legend Support**: Clear explanations of symbols and formatting
+- **Professional Polish**: Refined colors, borders, and overall presentation
+
 ### Version 1.2.0
 - **Beautiful Terminal Interface**: Complete visual overhaul with Rich library
 - **Colored Output**: Green for success, yellow for warnings, red for errors

simple_vcs-1.3.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+simple_vcs/__init__.py,sha256=RcYfgE1z2am5TUREGRVniDWErxGOW8dHH3hmt13bebE,166
+simple_vcs/cli.py,sha256=LSKU6nRwhl261s4MZnOzhpyyZV6pEWoH1v0AOJQXqNI,6950
+simple_vcs/core.py,sha256=ZpdBo-fNQzyBWGA0si2F8VR6_ZKpnbhQICN352mbwjE,26105
+simple_vcs/utils.py,sha256=CTd4gDdHqP-dawjtEeKU3csnT-Fe7_SN9a5ENQlo7wk,1202
+simple_vcs-1.3.0.dist-info/licenses/LICENSE,sha256=6o_m1QgCywYf-QZnE6cuLTwu5kVVQn3vJ7JJUd0V_iY,1085
+simple_vcs-1.3.0.dist-info/METADATA,sha256=dMl9Yf-X96YbuZSVnXLptJJ1Kd2-O0CxL6bVk29C5pI,10213
+simple_vcs-1.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+simple_vcs-1.3.0.dist-info/entry_points.txt,sha256=19JeWUvRFzwKF5p_iLQiSwCV3XTgxB7mkTLmFGrc_aY,45
+simple_vcs-1.3.0.dist-info/top_level.txt,sha256=YcaiuqQjjXFL-H62tfC-hTcg-7sWFmLh65zghskauL4,11
+simple_vcs-1.3.0.dist-info/RECORD,,

simple_vcs-1.2.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-simple_vcs/__init__.py,sha256=RcYfgE1z2am5TUREGRVniDWErxGOW8dHH3hmt13bebE,166
-simple_vcs/cli.py,sha256=GUwtLDFMM9musEPJCIn8DM94Sb4vnCXJ3QuWWWV1QaU,3916
-simple_vcs/core.py,sha256=SggyUSmLeOCENRihS3JTjoDhKjxSVgTsMckcRIFMNF0,22684
-simple_vcs/utils.py,sha256=CTd4gDdHqP-dawjtEeKU3csnT-Fe7_SN9a5ENQlo7wk,1202
-simple_vcs-1.2.0.dist-info/licenses/LICENSE,sha256=6o_m1QgCywYf-QZnE6cuLTwu5kVVQn3vJ7JJUd0V_iY,1085
-simple_vcs-1.2.0.dist-info/METADATA,sha256=ClxCpAV9I69xYpKnuHPa63fWIPT8pUDUVHUk8I5WApE,9438
-simple_vcs-1.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-simple_vcs-1.2.0.dist-info/entry_points.txt,sha256=19JeWUvRFzwKF5p_iLQiSwCV3XTgxB7mkTLmFGrc_aY,45
-simple_vcs-1.2.0.dist-info/top_level.txt,sha256=YcaiuqQjjXFL-H62tfC-hTcg-7sWFmLh65zghskauL4,11
-simple_vcs-1.2.0.dist-info/RECORD,,