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

simple_vcs/cli.py

@@ -1,79 +1,220 @@
 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
 
-@click.group()
-@click.version_option()
+console = Console()
+
+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 simple version control system"""
+    """SimpleVCS - A beautiful and simple version control system"""
     pass
 
 @main.command()
-@click.option('--path', default='.', help='Repository path')
+@click.option('--path', default='.', help='Path where repository will be created')
 def init(path):
-    """Initialize a new repository"""
+    """Initialize a new SimpleVCS repository
+
+    Creates a new .svcs directory with all necessary files for version control.
+
+    Example: svcs init --path ./my-project
+    """
     vcs = SimpleVCS(path)
     vcs.init_repo()
 
 @main.command()
 @click.argument('files', nargs=-1, required=True)
 def add(files):
-    """Add files to staging area"""
+    """Add files to the staging area
+
+    Stage files to be included in the next commit. You can add multiple files at once.
+
+    Example: svcs add file1.txt file2.py
+    """
     vcs = SimpleVCS()
     for file in files:
         vcs.add_file(file)
 
 @main.command()
-@click.option('-m', '--message', help='Commit message')
+@click.option('-m', '--message', help='Commit message describing the changes')
 def commit(message):
-    """Commit staged changes"""
+    """Commit staged changes to the repository
+
+    Creates a new commit with all staged files. If no message is provided,
+    an automatic timestamp-based message will be generated.
+
+    Example: svcs commit -m "Add new feature"
+    """
     vcs = SimpleVCS()
     vcs.commit(message)
 
 @main.command()
-@click.option('--c1', type=int, help='First commit ID')
-@click.option('--c2', type=int, help='Second commit ID')
+@click.option('--c1', type=int, help='First commit ID (defaults to second-last commit)')
+@click.option('--c2', type=int, help='Second commit ID (defaults to last commit)')
 def diff(c1, c2):
-    """Show differences between commits"""
+    """Show differences between commits
+
+    Compare files between two commits to see what changed. Without arguments,
+    compares the last two commits.
+
+    Example: svcs diff --c1 1 --c2 3
+    """
     vcs = SimpleVCS()
     vcs.show_diff(c1, c2)
 
 @main.command()
-@click.option('--limit', type=int, help='Limit number of commits to show')
+@click.option('--limit', type=int, help='Maximum number of commits to display')
 def log(limit):
-    """Show commit history"""
+    """Show commit history
+
+    Display a beautiful table of all commits with their messages, dates, and files.
+    Use --limit to show only recent commits.
+
+    Example: svcs log --limit 10
+    """
     vcs = SimpleVCS()
     vcs.show_log(limit)
 
 @main.command()
 def status():
-    """Show repository status"""
+    """Show current repository status
+
+    Display information about the repository including current commit,
+    total commits, and staged files ready for commit.
+
+    Example: svcs status
+    """
     vcs = SimpleVCS()
     vcs.status()
 
 @main.command()
 @click.argument('commit_id', type=int)
 def revert(commit_id):
-    """Quickly revert to a specific commit"""
+    """Revert to a specific commit
+
+    Quickly restore your repository to a previous commit state.
+    All files will be restored to their state at that commit.
+
+    Example: svcs revert 3
+    """
     vcs = SimpleVCS()
     vcs.quick_revert(commit_id)
 
 @main.command()
-@click.option('--name', help='Name for the snapshot')
+@click.option('--name', help='Custom name for the snapshot (optional)')
 def snapshot(name):
-    """Create a compressed snapshot of the current repository state"""
+    """Create a compressed snapshot
+
+    Creates a ZIP archive of your entire repository (excluding .svcs directory).
+    Perfect for backups or sharing your project.
+
+    Example: svcs snapshot --name my-backup
+    """
     vcs = SimpleVCS()
     vcs.create_snapshot(name)
 
 @main.command()
 @click.argument('snapshot_path', type=click.Path(exists=True))
 def restore(snapshot_path):
-    """Restore repository from a snapshot"""
+    """Restore from a snapshot
+
+    Restore your repository from a previously created snapshot ZIP file.
+    Current files will be replaced with snapshot contents.
+
+    Example: svcs restore snapshot_12345.zip
+    """
     vcs = SimpleVCS()
     vcs.restore_from_snapshot(snapshot_path)
 
 @main.command()
 def compress():
-    """Compress stored objects to save space"""
+    """Compress stored objects
+
+    Optimize repository storage by compressing object files.
+    Helps save disk space without losing any data.
+
+    Example: svcs compress
+    """
     vcs = SimpleVCS()
     vcs.compress_objects()
 

simple_vcs/core.py

@@ -3,14 +3,25 @@ import json
 import hashlib
 import shutil
 import time
+import sys
 from datetime import datetime
 from pathlib import Path
 from typing import Dict, List, Optional, Tuple
 import zipfile
+from rich.console import Console
+from rich.table import Table
+from rich.panel import Panel
+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"""
-    
+
     def __init__(self, repo_path: str = "."):
         self.repo_path = Path(repo_path).resolve()
         self.svcs_dir = self.repo_path / ".svcs"
@@ -18,52 +29,105 @@ class SimpleVCS:
         self.commits_file = self.svcs_dir / "commits.json"
         self.staging_file = self.svcs_dir / "staging.json"
         self.head_file = self.svcs_dir / "HEAD"
+        # Force UTF-8 output and disable emoji on Windows
+        self.is_windows = sys.platform == "win32"
+        self.console = Console(force_terminal=True, legacy_windows=False)
         
     def init_repo(self) -> bool:
         """Initialize a new repository"""
         if self.svcs_dir.exists():
-            print(f"Repository already exists at {self.repo_path}")
+            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
         self.svcs_dir.mkdir()
         self.objects_dir.mkdir()
-        
+
         # Initialize files
         self._write_json(self.commits_file, [])
         self._write_json(self.staging_file, {})
         self.head_file.write_text("0")  # Start with commit 0
-        
-        print(f"Initialized empty SimpleVCS repository at {self.repo_path}")
+
+        # 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(
+            panel_content,
+            title="[bold white on green] Repository Created [/bold white on green]",
+            border_style="green",
+            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:
         """Add a file to staging area"""
         if not self._check_repo():
             return False
-            
+
         file_path = Path(file_path).resolve()  # Convert to absolute path
         if not file_path.exists():
-            print(f"File {file_path} does not exist")
+            self.console.print(f"[red]ERROR: File not found:[/red] [yellow]{file_path}[/yellow]")
             return False
-            
+
         if not file_path.is_file():
-            print(f"{file_path} is not a file")
+            self.console.print(f"[red]ERROR: Not a file:[/red] [yellow]{file_path}[/yellow]")
             return False
-            
+
         # Check if file is within repository
         try:
             relative_path = file_path.relative_to(self.repo_path)
         except ValueError:
-            print(f"File {file_path} is not within the repository")
+            self.console.print(f"[red]ERROR: File not in repository:[/red] [yellow]{file_path}[/yellow]")
             return False
-            
-        # Calculate file hash
+
+        # Calculate file hash and store
         file_hash = self._calculate_file_hash(file_path)
-        
-        # Store file content in objects
         self._store_object(file_hash, file_path.read_bytes())
-        
+
         # Add to staging
         staging = self._read_json(self.staging_file)
         staging[str(relative_path)] = {
@@ -72,20 +136,25 @@ class SimpleVCS:
             "modified": file_path.stat().st_mtime
         }
         self._write_json(self.staging_file, staging)
-        
-        print(f"Added {file_path.name} to staging area")
+
+        # Format file size
+        size_kb = file_path.stat().st_size / 1024
+        size_str = f"{size_kb:.1f}KB" if size_kb < 1024 else f"{size_kb/1024:.1f}MB"
+
+        self.console.print(f"[green]Added:[/green] [cyan]{relative_path}[/cyan] [dim]({size_str})[/dim]")
         return True
     
     def commit(self, message: Optional[str] = None) -> bool:
         """Commit staged changes"""
         if not self._check_repo():
             return False
-            
+
         staging = self._read_json(self.staging_file)
         if not staging:
-            print("No changes to commit")
+            self.console.print("[yellow]WARNING: No changes staged for commit[/yellow]")
+            self.console.print("[dim]Tip: Use 'svcs add <file>' to stage files[/dim]")
             return False
-            
+
         # Create commit object
         commit = {
             "id": len(self._read_json(self.commits_file)) + 1,
@@ -94,136 +163,276 @@ class SimpleVCS:
             "files": staging.copy(),
             "parent": self._get_current_commit_id()
         }
-        
+
         # Save commit
         commits = self._read_json(self.commits_file)
         commits.append(commit)
         self._write_json(self.commits_file, commits)
-        
+
         # Update HEAD
         self.head_file.write_text(str(commit["id"]))
-        
+
         # Clear staging
         self._write_json(self.staging_file, {})
-        
-        print(f"Committed changes with ID: {commit['id']}")
-        print(f"Message: {commit['message']}")
+
+        # Create summary panel
+        files_list = "\n".join([f"  - [cyan]{f}[/cyan]" for f in list(staging.keys())[:5]])
+        if len(staging) > 5:
+            files_list += f"\n  [dim]... and {len(staging) - 5} more file(s)[/dim]"
+
+        panel = Panel(
+            f"[bold green]Commit #{commit['id']}[/bold green]\n\n"
+            f"[bold]Message:[/bold] {commit['message']}\n"
+            f"[bold]Files:[/bold] {len(staging)} file(s)\n\n"
+            f"{files_list}",
+            title="[bold green]Commit Successful[/bold green]",
+            border_style="green",
+            box=box.ROUNDED
+        )
+        self.console.print(panel)
         return True
     
     def show_diff(self, commit_id1: Optional[int] = None, commit_id2: Optional[int] = None) -> bool:
         """Show differences between commits"""
         if not self._check_repo():
             return False
-            
+
         commits = self._read_json(self.commits_file)
         if not commits:
-            print("No commits found")
+            self.console.print("[yellow]WARNING: No commits found[/yellow]")
             return False
-            
+
         # Default to comparing last two commits
         if commit_id1 is None and commit_id2 is None:
             if len(commits) < 2:
-                print("Need at least 2 commits to show diff")
+                self.console.print("[yellow]WARNING: Need at least 2 commits to show diff[/yellow]")
                 return False
             commit1 = commits[-2]
             commit2 = commits[-1]
         else:
             commit1 = self._get_commit_by_id(commit_id1 or (len(commits) - 1))
             commit2 = self._get_commit_by_id(commit_id2 or len(commits))
-            
+
         if not commit1 or not commit2:
-            print("Invalid commit IDs")
+            self.console.print("[red]ERROR: Invalid commit IDs[/red]")
             return False
-            
-        print(f"\nDifferences between commit {commit1['id']} and {commit2['id']}:")
-        print("-" * 50)
-        
+
+        # Create comparison table
+        table = Table(
+            title=f"[bold]Differences: Commit #{commit1['id']} to Commit #{commit2['id']}[/bold]",
+            box=box.ROUNDED,
+            show_header=True,
+            header_style="bold cyan"
+        )
+        table.add_column("Status", style="bold", width=10)
+        table.add_column("File", style="cyan")
+        table.add_column("Details", style="dim")
+
         files1 = set(commit1["files"].keys())
         files2 = set(commit2["files"].keys())
-        
+
+        has_changes = False
+
         # New files
-        new_files = files2 - files1
-        if new_files:
-            print("New files:")
-            for file in new_files:
-                print(f"  + {file}")
-        
+        new_files = sorted(files2 - files1)
+        for file in new_files:
+            size = commit2["files"][file]["size"]
+            size_str = f"{size/1024:.1f}KB" if size < 1024*1024 else f"{size/(1024*1024):.1f}MB"
+            table.add_row("[green]+ Added[/green]", file, f"Size: {size_str}")
+            has_changes = True
+
         # Deleted files
-        deleted_files = files1 - files2
-        if deleted_files:
-            print("Deleted files:")
-            for file in deleted_files:
-                print(f"  - {file}")
-        
+        deleted_files = sorted(files1 - files2)
+        for file in deleted_files:
+            table.add_row("[red]- Deleted[/red]", file, "")
+            has_changes = True
+
         # Modified files
         common_files = files1 & files2
         modified_files = []
-        for file in common_files:
+        for file in sorted(common_files):
             if commit1["files"][file]["hash"] != commit2["files"][file]["hash"]:
+                size1 = commit1["files"][file]["size"]
+                size2 = commit2["files"][file]["size"]
+                diff = size2 - size1
+                diff_str = f"+{diff/1024:.1f}KB" if diff > 0 else f"{diff/1024:.1f}KB"
+                table.add_row("[yellow]M Modified[/yellow]", file, f"Size change: {diff_str}")
                 modified_files.append(file)
-        
-        if modified_files:
-            print("Modified files:")
-            for file in modified_files:
-                print(f"  M {file}")
-        
-        if not new_files and not deleted_files and not modified_files:
-            print("No differences found")
-            
+                has_changes = True
+
+        if not has_changes:
+            self.console.print("[dim]No differences found between commits[/dim]")
+        else:
+            self.console.print(table)
+            self.console.print(f"\n[dim]Summary: [green]{len(new_files)} added[/green], "
+                             f"[yellow]{len(modified_files)} modified[/yellow], "
+                             f"[red]{len(deleted_files)} deleted[/red][/dim]")
+
         return True
     
     def show_log(self, limit: Optional[int] = None) -> bool:
         """Show commit history"""
         if not self._check_repo():
             return False
-            
+
         commits = self._read_json(self.commits_file)
         if not commits:
-            print("No commits found")
+            # 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
-        
-        print("\nCommit History:")
-        print("=" * 50)
-        
+
+        # 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(
+            box=box.DOUBLE_EDGE,
+            show_header=True,
+            header_style="bold white on blue",
+            border_style="cyan",
+            padding=(0, 1)
+        )
+        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:
-            print(f"Commit ID: {commit['id']}")
-            print(f"Date: {datetime.fromtimestamp(commit['timestamp']).strftime('%Y-%m-%d %H:%M:%S')}")
-            print(f"Message: {commit['message']}")
-            print(f"Files: {len(commit['files'])} file(s)")
-            if commit.get('parent'):
-                print(f"Parent: {commit['parent']}")
-            print("-" * 30)
-            
+            commit_id = str(commit['id'])
+            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) > 60:
+                message = message[:57] + "..."
+            files_count = str(len(commit['files']))
+            parent = str(commit.get('parent', 'None'))
+
+            # Style current commit differently with background
+            if is_current:
+                table.add_row(
+                    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:
+            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
     
     def status(self) -> bool:
         """Show repository status"""
         if not self._check_repo():
             return False
-            
+
         staging = self._read_json(self.staging_file)
         current_commit = self._get_current_commit()
-        
-        print(f"\nRepository: {self.repo_path}")
-        print(f"Current commit: {current_commit['id'] if current_commit else 'None'}")
-        
+        total_commits = len(self._read_json(self.commits_file))
+
+        # Create status panel
+        status_text = f"[bold]Repository:[/bold] [cyan]{self.repo_path.name}[/cyan]\n"
+        status_text += f"[bold]Location:[/bold] [dim]{self.repo_path}[/dim]\n"
+        status_text += f"[bold]Current Commit:[/bold] [green]#{current_commit['id']}[/green] " if current_commit else "[bold]Current Commit:[/bold] [yellow]None (no commits yet)[/yellow]\n"
+        if current_commit:
+            status_text += f"[dim]({current_commit['message']})[/dim]\n"
+        status_text += f"[bold]Total Commits:[/bold] {total_commits}"
+
+        panel = Panel(
+            status_text,
+            title="[bold cyan]Repository Status[/bold cyan]",
+            border_style="cyan",
+            box=box.ROUNDED
+        )
+        self.console.print(panel)
+
+        # Show staged files
         if staging:
-            print("\nStaged files:")
+            table = Table(
+                title="[bold yellow]Staged Files[/bold yellow]",
+                box=box.ROUNDED,
+                show_header=True,
+                header_style="bold yellow"
+            )
+            table.add_column("File", style="cyan")
+            table.add_column("Size", justify="right", style="green")
+            table.add_column("Hash", style="dim", width=16)
+
             for file, info in staging.items():
-                print(f"  {file}")
+                size = info['size']
+                size_str = f"{size/1024:.1f}KB" if size < 1024*1024 else f"{size/(1024*1024):.1f}MB"
+                hash_short = info['hash'][:14] + "..."
+                table.add_row(file, size_str, hash_short)
+
+            self.console.print("\n", table)
+            self.console.print(f"[dim]Ready to commit {len(staging)} file(s)[/dim]")
         else:
-            print("\nNo files staged")
-            
+            self.console.print("\n[yellow]No files staged[/yellow]")
+            self.console.print("[dim]Use 'svcs add <file>' to stage files for commit[/dim]")
+
         return True
     
     # Helper methods
     def _check_repo(self) -> bool:
         """Check if repository is initialized"""
         if not self.svcs_dir.exists():
-            print("Not a SimpleVCS repository. Run 'svcs init' first.")
+            self.console.print("[red]ERROR: Not a SimpleVCS repository[/red]")
+            self.console.print("[dim]Tip: Run 'svcs init' to initialize a repository[/dim]")
             return False
         return True
     
@@ -283,9 +492,11 @@ class SimpleVCS:
 
         commit = self._get_commit_by_id(commit_id)
         if not commit:
-            print(f"Commit {commit_id} not found")
+            self.console.print(f"[red]ERROR: Commit #{commit_id} not found[/red]")
             return False
 
+        self.console.print(f"[cyan]Reverting to commit #{commit_id}...[/cyan]")
+
         # Restore files from the specified commit
         for file_path, file_info in commit["files"].items():
             target_path = self.repo_path / file_path
@@ -301,7 +512,16 @@ class SimpleVCS:
         # Update HEAD to point to the reverted commit
         self.head_file.write_text(str(commit_id))
 
-        print(f"Reverted to commit {commit_id}: {commit['message']}")
+        panel = Panel(
+            f"[bold green]Successfully reverted to commit #{commit_id}[/bold green]\n\n"
+            f"[bold]Message:[/bold] {commit['message']}\n"
+            f"[bold]Files restored:[/bold] {len(commit['files'])}\n"
+            f"[bold]Date:[/bold] {datetime.fromtimestamp(commit['timestamp']).strftime('%Y-%m-%d %H:%M:%S')}",
+            title="[bold green]Revert Complete[/bold green]",
+            border_style="green",
+            box=box.ROUNDED
+        )
+        self.console.print(panel)
         return True
 
     def create_snapshot(self, name: str = None) -> bool:
@@ -312,6 +532,14 @@ class SimpleVCS:
         snapshot_name = name or f"snapshot_{int(time.time())}"
         snapshot_path = self.repo_path / f"{snapshot_name}.zip"
 
+        self.console.print("[cyan]Creating snapshot...[/cyan]")
+
+        # Count files first
+        file_count = 0
+        for root, dirs, files in os.walk(self.repo_path):
+            dirs[:] = [d for d in dirs if d != '.svcs']
+            file_count += len(files)
+
         # Create a zip archive of all tracked files
         with zipfile.ZipFile(snapshot_path, 'w', zipfile.ZIP_DEFLATED) as zipf:
             for root, dirs, files in os.walk(self.repo_path):
@@ -324,18 +552,35 @@ class SimpleVCS:
                         arc_path = file_path.relative_to(self.repo_path)
                         zipf.write(file_path, arc_path)
 
-        print(f"Created snapshot: {snapshot_path}")
+        snapshot_size = snapshot_path.stat().st_size
+        size_str = f"{snapshot_size/1024:.1f}KB" if snapshot_size < 1024*1024 else f"{snapshot_size/(1024*1024):.1f}MB"
+
+        panel = Panel(
+            f"[bold green]Snapshot created successfully[/bold green]\n\n"
+            f"[bold]Name:[/bold] [cyan]{snapshot_name}.zip[/cyan]\n"
+            f"[bold]Location:[/bold] [dim]{snapshot_path}[/dim]\n"
+            f"[bold]Size:[/bold] {size_str}\n"
+            f"[bold]Files:[/bold] {file_count}",
+            title="[bold green]Snapshot Created[/bold green]",
+            border_style="green",
+            box=box.ROUNDED
+        )
+        self.console.print(panel)
         return True
 
     def restore_from_snapshot(self, snapshot_path: str) -> bool:
         """Restore repository from a snapshot"""
         snapshot_path = Path(snapshot_path)
         if not snapshot_path.exists():
-            print(f"Snapshot {snapshot_path} does not exist")
+            self.console.print(f"[red]ERROR: Snapshot not found:[/red] [yellow]{snapshot_path}[/yellow]")
             return False
 
+        self.console.print("[cyan]Restoring from snapshot...[/cyan]")
+
         # Extract the zip archive
         with zipfile.ZipFile(snapshot_path, 'r') as zipf:
+            file_list = zipf.namelist()
+
             # Clear current files (but preserve .svcs directory)
             for item in self.repo_path.iterdir():
                 if item.name != '.svcs':
@@ -347,7 +592,15 @@ class SimpleVCS:
             # Extract all files
             zipf.extractall(self.repo_path)
 
-        print(f"Restored from snapshot: {snapshot_path}")
+        panel = Panel(
+            f"[bold green]Repository restored successfully[/bold green]\n\n"
+            f"[bold]Snapshot:[/bold] [cyan]{snapshot_path.name}[/cyan]\n"
+            f"[bold]Files restored:[/bold] {len(file_list)}",
+            title="[bold green]Restore Complete[/bold green]",
+            border_style="green",
+            box=box.ROUNDED
+        )
+        self.console.print(panel)
         return True
 
     def compress_objects(self) -> bool:
@@ -356,27 +609,49 @@ class SimpleVCS:
             return False
 
         original_size = sum(f.stat().st_size for f in self.objects_dir.glob('*') if f.is_file())
+        obj_files = [f for f in self.objects_dir.glob('*') if f.is_file() and f.stat().st_size > 1024]
+
+        if not obj_files:
+            self.console.print("[yellow]WARNING: No objects to compress (files are too small)[/yellow]")
+            return True
+
+        self.console.print("[cyan]Compressing objects...[/cyan]")
 
         # For each object file, compress it if it's large enough to benefit
-        for obj_file in self.objects_dir.glob('*'):
-            if obj_file.is_file() and obj_file.stat().st_size > 1024:  # Only compress files > 1KB
-                # Create a compressed version with .gz extension
-                compressed_path = obj_file.with_suffix(obj_file.suffix + '.gz')
-                with open(obj_file, 'rb') as f_in:
-                    import gzip
-                    with gzip.open(compressed_path, 'wb') as f_out:
-                        f_out.writelines(f_in)
-
-                # Replace original with compressed version
-                obj_file.unlink()
-                # Decompress back to original name for compatibility
-                with gzip.open(compressed_path, 'rb') as f_in:
-                    with open(obj_file, 'wb') as f_out:
-                        f_out.write(f_in.read())
-                compressed_path.unlink()
+        for obj_file in obj_files:
+            # Create a compressed version with .gz extension
+            compressed_path = obj_file.with_suffix(obj_file.suffix + '.gz')
+            with open(obj_file, 'rb') as f_in:
+                import gzip
+                with gzip.open(compressed_path, 'wb') as f_out:
+                    f_out.writelines(f_in)
+
+            # Replace original with compressed version
+            obj_file.unlink()
+            # Decompress back to original name for compatibility
+            with gzip.open(compressed_path, 'rb') as f_in:
+                with open(obj_file, 'wb') as f_out:
+                    f_out.write(f_in.read())
+            compressed_path.unlink()
 
         new_size = sum(f.stat().st_size for f in self.objects_dir.glob('*') if f.is_file())
         saved_space = original_size - new_size
+        saved_percent = (saved_space / original_size * 100) if original_size > 0 else 0
+
+        # Format sizes
+        orig_str = f"{original_size/1024:.1f}KB" if original_size < 1024*1024 else f"{original_size/(1024*1024):.1f}MB"
+        new_str = f"{new_size/1024:.1f}KB" if new_size < 1024*1024 else f"{new_size/(1024*1024):.1f}MB"
+        saved_str = f"{saved_space/1024:.1f}KB" if saved_space < 1024*1024 else f"{saved_space/(1024*1024):.1f}MB"
 
-        print(f"Compression completed. Saved approximately {saved_space} bytes.")
+        panel = Panel(
+            f"[bold green]Compression completed successfully[/bold green]\n\n"
+            f"[bold]Original size:[/bold] {orig_str}\n"
+            f"[bold]New size:[/bold] {new_str}\n"
+            f"[bold]Space saved:[/bold] [green]{saved_str}[/green] [dim]({saved_percent:.1f}%)[/dim]\n"
+            f"[bold]Objects compressed:[/bold] {len(obj_files)}",
+            title="[bold green]Compression Complete[/bold green]",
+            border_style="green",
+            box=box.ROUNDED
+        )
+        self.console.print(panel)
         return True

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: simple-vcs
-Version: 1.1.0
-Summary: A simple version control system with unique features for easy version management
+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>
@@ -34,6 +34,7 @@ Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click>=7.0
+Requires-Dist: rich>=10.0.0
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -41,7 +42,16 @@ Dynamic: requires-python
 
 # SimpleVCS
 
-A simple version control system written in Python that provides basic VCS functionality similar to Git.
+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.3.0
+
+**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
 
@@ -240,6 +250,7 @@ When initialized, SimpleVCS creates a `.svcs` directory containing:
 
 - Python 3.7 or higher
 - click>=7.0 (for CLI functionality)
+- rich>=10.0.0 (for beautiful terminal interface)
 
 ## Development
 
@@ -317,6 +328,26 @@ 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
+- **Elegant Tables**: Commit history, status, and diffs in formatted tables
+- **Styled Panels**: Information displayed in bordered panels with rounded corners
+- **Enhanced Commands**: All commands now have beautiful, professional output
+- **Better UX**: Clear visual hierarchy and consistent formatting
+- **Windows Compatible**: No problematic Unicode characters
+- **Enhanced Help**: Detailed descriptions and examples for all commands
+
 ### Version 1.1.0
 - Added quick revert functionality to go back to any commit instantly
 - Added snapshot creation and restoration features

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.1.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-simple_vcs/__init__.py,sha256=RcYfgE1z2am5TUREGRVniDWErxGOW8dHH3hmt13bebE,166
-simple_vcs/cli.py,sha256=ealBu5Q5XpeguLRnXY7OTqKuJXKFQKI5dn0dHynLGA4,2004
-simple_vcs/core.py,sha256=I83hj6IxJE4q5nyXcq6kAxM8Y8MzpB_maJGEBoXOuVk,13779
-simple_vcs/utils.py,sha256=CTd4gDdHqP-dawjtEeKU3csnT-Fe7_SN9a5ENQlo7wk,1202
-simple_vcs-1.1.0.dist-info/licenses/LICENSE,sha256=6o_m1QgCywYf-QZnE6cuLTwu5kVVQn3vJ7JJUd0V_iY,1085
-simple_vcs-1.1.0.dist-info/METADATA,sha256=QRbAb_AyBiC7LRfP3S1N1rej9_EB5dm-UJwnO6LgzAM,8231
-simple_vcs-1.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-simple_vcs-1.1.0.dist-info/entry_points.txt,sha256=19JeWUvRFzwKF5p_iLQiSwCV3XTgxB7mkTLmFGrc_aY,45
-simple_vcs-1.1.0.dist-info/top_level.txt,sha256=YcaiuqQjjXFL-H62tfC-hTcg-7sWFmLh65zghskauL4,11
-simple_vcs-1.1.0.dist-info/RECORD,,