Merge pull request #69 from gaurav123-4/master

Purpose-Based App Suggestions #18

Author: AdmGenSameer

README.md

@@ -34,6 +34,8 @@ archpkg-helper is designed to work across Linux distributions. While originally
 
 ## Features
 
+- **Purpose-based App Suggestions**: Get app recommendations based on what you want to do (e.g., "video editing", "office work", "programming")
+- **Intelligent Query Matching**: Natural language processing to understand user intent (e.g., "apps to edit videos" → video editing)
 - Search for packages and generate install commands for:
   - pacman (Arch), AUR, apt (Debian/Ubuntu), dnf (Fedora), flatpak, snap
 - Cross-distro support (not limited to Arch)
@@ -134,7 +136,30 @@ After installation, the CLI is available as `archpkg`.
 
 Here are some common commands for using the archpkg tool:
 
-#### 1. Search for a Package
+#### 1. Purpose-based App Suggestions (NEW!)
+
+Get app recommendations based on what you want to do:
+
+```sh
+# Get video editing apps
+archpkg suggest "video editing"
+
+# Get office applications
+archpkg suggest "office"
+
+# Get programming tools
+archpkg suggest "coding"
+
+# Natural language queries work too!
+archpkg suggest "apps to edit videos"
+archpkg suggest "programming tools"
+archpkg suggest "photo editing"
+
+# List all available purposes
+archpkg suggest --list
+```
+
+#### 2. Search for a Package
 
 Search for a package across all supported package managers:
 
@@ -145,7 +170,7 @@ archpkg search firefox
 
 This command will search for the `firefox` package across multiple package managers (e.g., pacman, AUR, apt).
 
-#### 2. Install a Package
+#### 3. Install a Package
 
 Once you have identified a package, use the install command to generate the correct installation command for your system:
 
@@ -156,7 +181,7 @@ archpkg install firefox
 
 This will generate an appropriate installation command (e.g., `pacman -S firefox` for Arch-based systems).
 
-#### 3. Install a Package from AUR (Arch User Repository)
+#### 4. Install a Package from AUR (Arch User Repository)
 
 To install from the AUR specifically:
 
@@ -167,7 +192,7 @@ archpkg install vscode --source aur
 
 This installs `vscode` from the AUR.
 
-#### 4. Install a Package from Pacman
+#### 5. Install a Package from Pacman
 
 To install a package directly using pacman (e.g., on Arch Linux):
 
@@ -176,7 +201,7 @@ archpkg install firefox --source pacman
 ```
 
 
-#### 5. Remove a Package
+#### 6. Remove a Package
 
 To generate commands to remove a package:
 
@@ -294,6 +319,11 @@ Top-level layout of this repository:
 archpkg-helper/
 ├── .github/                  # issue templates and pull request template
 ├── archpkg/                  # Core Python package code (CLI and logic)
+│   ├── suggest.py            # Purpose-based app suggestions module
+│   ├── cli.py                # Main CLI interface
+│   └── ...                   # Other modules
+├── data/                     # Data files for suggestions
+│   └── purpose_mapping.yaml  # Purpose-to-apps mapping (community-driven)
 ├── install.sh                # One-command installer script (uses pipx)
 ├── pyproject.toml            # Build/metadata configuration
 ├── setup.py                  # Packaging configuration (entry points, deps)
@@ -322,6 +352,31 @@ Contributions are welcome! Please:
 5. Open a Pull Request
 
 Report bugs or request features via the [issue tracker](https://github.com/AdmGenSameer/archpkg-helper/issues).
+
+### Contributing to Purpose Mappings
+
+The purpose-based suggestions are powered by a community-driven mapping file at `data/purpose_mapping.yaml`. You can help improve the suggestions by:
+
+1. **Adding new purposes**: Add new categories of applications (e.g., "security", "education", "gaming")
+2. **Adding more apps**: Suggest additional applications for existing purposes
+3. **Improving descriptions**: Add better descriptions for applications
+4. **Adding synonyms**: Help improve the natural language processing by adding more phrase mappings
+
+To contribute:
+1. Edit `data/purpose_mapping.yaml` to add your suggestions
+2. Test your changes with `python -m archpkg.cli suggest "your-purpose"`
+3. Submit a Pull Request with your improvements
+
+Example contribution:
+```yaml
+# Add to data/purpose_mapping.yaml
+security:
+  - firejail
+  - tor
+  - keepassxc
+  - veracrypt
+  - wireshark
+```
 ---
 
 ## 🛣️ Roadmap

archpkg/__pycache__/cli.cpython-312.pyc

@@ -23,6 +23,7 @@
 from archpkg.search_dnf import search_dnf
 from archpkg.command_gen import generate_command
 from archpkg.logging_config import get_logger, PackageHelperLogger
+from archpkg.suggest import suggest_apps, list_purposes
 
 console = Console()
 logger = get_logger(__name__)
@@ -316,10 +317,22 @@ def main() -> None:
     logger.info("Starting archpkg-helper CLI")
 
     parser = argparse.ArgumentParser(description="Universal Package Helper CLI")
-    parser.add_argument('query', type=str, nargs='*', help='Name of the software to search for')
+    subparsers = parser.add_subparsers(dest='command', help='Available commands')
+    
+    # Search command (default behavior)
+    search_parser = subparsers.add_parser('search', help='Search for packages by name')
+    search_parser.add_argument('query', type=str, nargs='*', help='Name of the software to search for')
+    search_parser.add_argument('--aur', action='store_true', help='Prefer AUR packages over Pacman when both are available')
+    
+    # Suggest command
+    suggest_parser = subparsers.add_parser('suggest', help='Get app suggestions based on purpose')
+    suggest_parser.add_argument('purpose', type=str, nargs='*', help='Purpose or use case (e.g., "video editing", "office")')
+    suggest_parser.add_argument('--list', action='store_true', help='List all available purposes')
+    
+    # Global arguments
     parser.add_argument('--debug', action='store_true', help='Enable debug logging to console')
     parser.add_argument('--log-info', action='store_true', help='Show logging configuration and exit')
-    parser.add_argument('--aur', action='store_true', help='Prefer AUR packages over Pacman when both are available')
+    
     args = parser.parse_args()
 
     # Enable debug mode if requested
@@ -342,15 +355,78 @@ def main() -> None:
         ))
         return
 
+    # Handle different commands
+    if args.command == 'suggest':
+        handle_suggest_command(args)
+        return
+    elif args.command == 'search' or args.command is None:
+        # Default to search behavior for backward compatibility
+        handle_search_command(args)
+        return
+    else:
+        console.print(Panel(
+            "[red]Unknown command.[/red]\n\n"
+            "[bold cyan]Available commands:[/bold cyan]\n"
+            "- [cyan]archpkg search firefox[/cyan] - Search for packages by name\n"
+            "- [cyan]archpkg suggest video editing[/cyan] - Get app suggestions by purpose\n"
+            "- [cyan]archpkg suggest --list[/cyan] - List all available purposes\n"
+            "- [cyan]archpkg --help[/cyan] - Show help information",
+            title="Invalid Command",
+            border_style="red"
+        ))
+        return
+
+
+def handle_suggest_command(args) -> None:
+    """Handle the suggest command."""
+    if args.list:
+        logger.info("Listing all available purposes")
+        list_purposes()
+        return
+    
+    if not args.purpose:
+        console.print(Panel(
+            "[red]No purpose specified.[/red]\n\n"
+            "[bold cyan]Usage:[/bold cyan]\n"
+            "- [cyan]archpkg suggest video editing[/cyan] - Get video editing apps\n"
+            "- [cyan]archpkg suggest office[/cyan] - Get office applications\n"
+            "- [cyan]archpkg suggest --list[/cyan] - List all available purposes\n"
+            "- [cyan]archpkg suggest --help[/cyan] - Show help information",
+            title="No Purpose Specified",
+            border_style="red"
+        ))
+        return
+    
+    purpose = ' '.join(args.purpose)
+    logger.info(f"Purpose suggestion query: '{purpose}'")
+    
+    if not purpose.strip():
+        logger.warning("Empty purpose query provided by user")
+        console.print(Panel(
+            "[red]Empty purpose query provided.[/red]\n\n"
+            "[bold cyan]Usage:[/bold cyan]\n"
+            "- [cyan]archpkg suggest video editing[/cyan] - Get video editing apps\n"
+            "- [cyan]archpkg suggest office[/cyan] - Get office applications\n"
+            "- [cyan]archpkg suggest --list[/cyan] - List all available purposes",
+            title="Invalid Input",
+            border_style="red"
+        ))
+        return
+    
+    # Display suggestions
+    suggest_apps(purpose)
+
+
+def handle_search_command(args) -> None:
+    """Handle the search command (original functionality)."""
     if not args.query:
         console.print(Panel(
             "[red]No search query provided.[/red]\n\n"
             "[bold cyan]Usage:[/bold cyan]\n"
-            "- [cyan]archpkg firefox[/cyan] - Search for Firefox\n"
-            "- [cyan]archpkg visual studio code[/cyan] - Search for VS Code\n"
-            "- [cyan]archpkg --aur firefox[/cyan] - Prefer AUR packages over Pacman\n"
-            "- [cyan]archpkg --debug firefox[/cyan] - Search with debug output\n"
-            "- [cyan]archpkg --log-info[/cyan] - Show logging configuration\n"
+            "- [cyan]archpkg search firefox[/cyan] - Search for Firefox\n"
+            "- [cyan]archpkg search visual studio code[/cyan] - Search for VS Code\n"
+            "- [cyan]archpkg search --aur firefox[/cyan] - Prefer AUR packages over Pacman\n"
+            "- [cyan]archpkg suggest video editing[/cyan] - Get app suggestions by purpose\n"
             "- [cyan]archpkg --help[/cyan] - Show help information",
             title="Invalid Input",
             border_style="red"
@@ -365,10 +441,10 @@ def main() -> None:
         console.print(Panel(
             "[red]Empty search query provided.[/red]\n\n"
             "[bold cyan]Usage:[/bold cyan]\n"
-            "- [cyan]archpkg firefox[/cyan] - Search for Firefox\n"
-            "- [cyan]archpkg visual studio code[/cyan] - Search for VS Code\n"
-            "- [cyan]archpkg --aur firefox[/cyan] - Prefer AUR packages over Pacman\n"
-            "- [cyan]archpkg --help[/cyan] - Show help information",
+            "- [cyan]archpkg search firefox[/cyan] - Search for Firefox\n"
+            "- [cyan]archpkg search visual studio code[/cyan] - Search for VS Code\n"
+            "- [cyan]archpkg search --aur firefox[/cyan] - Prefer AUR packages over Pacman\n"
+            "- [cyan]archpkg suggest video editing[/cyan] - Get app suggestions by purpose",
             title="Invalid Input",
             border_style="red"
         ))