repopy 0.2.0__tar.gz → 0.3.0__tar.gz

{repopy-0.2.0/src/repopy.egg-info → repopy-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: repopy
-Version: 0.2.0
+Version: 0.3.0
 Summary: A modular CLI workspace initializer and cloning automation tool.
 Author-email: Janitha Manatunga <janithamanatunga@gmail.com>
 License: MIT
@@ -36,17 +36,17 @@ A modular, cross-platform Python CLI workspace manager and developer tooling sui
 
 ## 🌟 Key Features
 
-- **Lifecycle Project Scaffolding (`repopy init`)**: Replaces manual setup by provisioning clean directory structures, virtual environments, automated `.gitignore` presets, and standardized metadata configurations (`pyproject.toml` or `requirements.txt`).
+- **Lifecycle Project Scaffolding (`repopy init`)**: Provisions clean directory structures, dedicated virtual environments, automated `.gitignore` templates, and PEP 621 `pyproject.toml` or `requirements.txt` configs.
 
-- **Remote Cloning (`repopy clone`)**: Clones remote Git repositories into structured local footprints and auto-provisions dedicated virtual environments and dependencies.
+- **Smart Remote Cloning (`repopy clone`)**: Clones remote Git repositories, creates isolated `.venv` environments, previews declared dependencies, and installs them interactively or via flags.
 
 - **Upstream Linking (`repopy link`)**: Instantly connects an unlinked local workspace to a remote Git upstream, staging files, executing initial commits, and pushing to the default branch in one step.
 
-- **Architectural Themes**: Supports presets (`minimal`, `web_api`, `cli_package`, `data_science`) tailored to the specific packaging needs of the application.
+- **Architectural Themes**: Built-in layout presets (`minimal`, `web_api`, `cli_package`, `data_science`) tailored to modern packaging standards.
 
-- **Transactional Cleanups**: Employs defensive rollback mechanisms (`shutil.rmtree`) to purge incomplete workspaces if initialization fails midway.
+- **Transactional Cleanups**: Employs defensive rollback mechanisms (`shutil.rmtree`) to safely purge half-baked directories if setup fails midway.
 
-- **Automated Test Suite & CI**: Fully covered by local `pytest` test suites and verified via continuous integration on GitHub Actions.
+- **Isolated & Tested**: Fully decoupled architecture backed by comprehensive unit and mock test suites.
 
 ---
 
@@ -55,11 +55,11 @@ A modular, cross-platform Python CLI workspace manager and developer tooling sui
 `repopy` is organized into single-responsibility layers:
 - **Presentation & Routing (`cli.py`, `prompts.py`, `__main__.py`)**: Evaluates native terminal arguments via `argparse`, orchestrates interactive prompt flows, and handles OS interrupts gracefully.
 
-- **Supervision (`orchestrators.py`)**: Broker layer executing lifecycle validation checks, branch sequencing, and command handoffs.
+- **Supervision (`orchestrators.py`)**: Broker layer executing lifecycle validation checks, branch sequencing, rollback triggers and command handoffs.
 
-- **Low-Level Engines (`file_system.py`, `git_engine.py`)**: Decoupled engines handling transactional directory allocations, venv isolation, and direct subprocess execution.
+- **Low-Level Engines (`file_system.py`, `git_engine.py`)**: Decoupled engines handling transactional directory allocations, venv isolation, dependency installation and direct subprocess execution.
 
-- **Validation & Translation (`validators.py`, `dependencies.py`, `os_detector.py`)**: Sanitizes paths, ensures semantic regex compliance, verifies system binaries (such as `git`), and resolves cross-platform paths.
+- **Validation & Translation (`validators.py`, `dependencies.py`, `os_detector.py`)**: Sanitizes names and paths, validates Git URLs, verifies host binaries (`python`, `git`), and resolves cross-platform paths.
 
 ---
 
@@ -100,15 +100,25 @@ repopy init my-cli -t cli_package --link <git-url>
 - `minimal`: Bare directory setup with `requirements.txt`.
 - `web_api`: Layered service layout prepared for modern frameworks.
 - `cli_package`: Modular structure configured with PEP 621 compliant `pyproject.toml`.
-- `data_science`: Notebooks, data folders, and pipeline layouts.
-<br>
+- `data_science`: Notebooks, data directories (raw, processed), and pipeline layout.
+
 <br>
 
 ### 2. Clone a Remote Project (`repopy clone`)
-Fetch a remote repository and immediately auto-provision an isolated `.venv`:
+Fetch a remote repository, provision a virtual environment, and manage dependencies:
 
 ```bash
-repopy clone <git-url> -n [custom-project-name]
+# Interactive mode (previews requirements.txt and prompts for installation)
+repopy clone <git-url>
+
+# Custom directory name
+repopy clone <git-url> -n custom-folder-name
+
+# Auto-install dependencies without prompting
+repopy clone <git-url> -i
+
+# Fetch and provision environment only (skip dependency installation)
+repopy clone <git-url> --no-install
 ```
 
 <br>
@@ -117,7 +127,11 @@ repopy clone <git-url> -n [custom-project-name]
 Run inside an existing workspace to push tracking history to an upstream origin:
 
 ```bash
-repopy link <git-url> -m ["custom-initial-commit-message"]
+# Link with default initial commit message
+repopy link <git-url>
+
+# Link with custom commit message
+repopy link <git-url> -m "feat: initial project structure"
 ```
 
 ---
@@ -130,8 +144,6 @@ Run the test suite using `pytest`:
 pytest -v
 ```
 
-All contributions and pull requests are validated through our GitHub Actions workflow matrix (`.github/workflows/tests.yml`), running integration and validation tests across supported Python versions.
-
 ---
 
 ## 🗂️ Project Structure
@@ -155,11 +167,16 @@ repopy/
 │       ├── templates.py         # Static asset definitions & manifests
 │       └── validators.py        # Input sanitation & regex filters
 ├── tests/
+│   ├── test_cli.py              # CLI argument parser & flag exclusivity tests
+│   ├── test_file_system.py      # Workspace scaffolding & requirements parsing tests
+│   ├── test_git_engine.py       # Subprocess Git mocking & exit code tests
+│   ├── test_orchestrators.py    # Pipeline logic, prompts, and rollback tests
 │   ├── test_prompts.py          # Input loop & default manifest tests
 │   └── test_validators.py       # Path and schema validation tests
 ├── pyproject.toml               # PEP 621 packaging configuration
 ├── LICENSE                      # MIT License
 └── README.md
+
 ```
 
 ---
@@ -167,10 +184,3 @@ repopy/
 ## 📄 License
 
 Distributed under the MIT License. See `LICENSE` for details.
-
----
-
-## Key Review Notes
-
-* Verify the GitHub Actions workflow file path (`.github/workflows/tests.yml`) matches your actual workflow file name so the build badge renders correctly.
-* In the `repopy init` theme section, verify that the theme descriptions match what you have mapped out in `templates.py`.

{repopy-0.2.0 → repopy-0.3.0}/README.md

@@ -11,17 +11,17 @@ A modular, cross-platform Python CLI workspace manager and developer tooling sui
 
 ## 🌟 Key Features
 
-- **Lifecycle Project Scaffolding (`repopy init`)**: Replaces manual setup by provisioning clean directory structures, virtual environments, automated `.gitignore` presets, and standardized metadata configurations (`pyproject.toml` or `requirements.txt`).
+- **Lifecycle Project Scaffolding (`repopy init`)**: Provisions clean directory structures, dedicated virtual environments, automated `.gitignore` templates, and PEP 621 `pyproject.toml` or `requirements.txt` configs.
 
-- **Remote Cloning (`repopy clone`)**: Clones remote Git repositories into structured local footprints and auto-provisions dedicated virtual environments and dependencies.
+- **Smart Remote Cloning (`repopy clone`)**: Clones remote Git repositories, creates isolated `.venv` environments, previews declared dependencies, and installs them interactively or via flags.
 
 - **Upstream Linking (`repopy link`)**: Instantly connects an unlinked local workspace to a remote Git upstream, staging files, executing initial commits, and pushing to the default branch in one step.
 
-- **Architectural Themes**: Supports presets (`minimal`, `web_api`, `cli_package`, `data_science`) tailored to the specific packaging needs of the application.
+- **Architectural Themes**: Built-in layout presets (`minimal`, `web_api`, `cli_package`, `data_science`) tailored to modern packaging standards.
 
-- **Transactional Cleanups**: Employs defensive rollback mechanisms (`shutil.rmtree`) to purge incomplete workspaces if initialization fails midway.
+- **Transactional Cleanups**: Employs defensive rollback mechanisms (`shutil.rmtree`) to safely purge half-baked directories if setup fails midway.
 
-- **Automated Test Suite & CI**: Fully covered by local `pytest` test suites and verified via continuous integration on GitHub Actions.
+- **Isolated & Tested**: Fully decoupled architecture backed by comprehensive unit and mock test suites.
 
 ---
 
@@ -30,11 +30,11 @@ A modular, cross-platform Python CLI workspace manager and developer tooling sui
 `repopy` is organized into single-responsibility layers:
 - **Presentation & Routing (`cli.py`, `prompts.py`, `__main__.py`)**: Evaluates native terminal arguments via `argparse`, orchestrates interactive prompt flows, and handles OS interrupts gracefully.
 
-- **Supervision (`orchestrators.py`)**: Broker layer executing lifecycle validation checks, branch sequencing, and command handoffs.
+- **Supervision (`orchestrators.py`)**: Broker layer executing lifecycle validation checks, branch sequencing, rollback triggers and command handoffs.
 
-- **Low-Level Engines (`file_system.py`, `git_engine.py`)**: Decoupled engines handling transactional directory allocations, venv isolation, and direct subprocess execution.
+- **Low-Level Engines (`file_system.py`, `git_engine.py`)**: Decoupled engines handling transactional directory allocations, venv isolation, dependency installation and direct subprocess execution.
 
-- **Validation & Translation (`validators.py`, `dependencies.py`, `os_detector.py`)**: Sanitizes paths, ensures semantic regex compliance, verifies system binaries (such as `git`), and resolves cross-platform paths.
+- **Validation & Translation (`validators.py`, `dependencies.py`, `os_detector.py`)**: Sanitizes names and paths, validates Git URLs, verifies host binaries (`python`, `git`), and resolves cross-platform paths.
 
 ---
 
@@ -75,15 +75,25 @@ repopy init my-cli -t cli_package --link <git-url>
 - `minimal`: Bare directory setup with `requirements.txt`.
 - `web_api`: Layered service layout prepared for modern frameworks.
 - `cli_package`: Modular structure configured with PEP 621 compliant `pyproject.toml`.
-- `data_science`: Notebooks, data folders, and pipeline layouts.
-<br>
+- `data_science`: Notebooks, data directories (raw, processed), and pipeline layout.
+
 <br>
 
 ### 2. Clone a Remote Project (`repopy clone`)
-Fetch a remote repository and immediately auto-provision an isolated `.venv`:
+Fetch a remote repository, provision a virtual environment, and manage dependencies:
 
 ```bash
-repopy clone <git-url> -n [custom-project-name]
+# Interactive mode (previews requirements.txt and prompts for installation)
+repopy clone <git-url>
+
+# Custom directory name
+repopy clone <git-url> -n custom-folder-name
+
+# Auto-install dependencies without prompting
+repopy clone <git-url> -i
+
+# Fetch and provision environment only (skip dependency installation)
+repopy clone <git-url> --no-install
 ```
 
 <br>
@@ -92,7 +102,11 @@ repopy clone <git-url> -n [custom-project-name]
 Run inside an existing workspace to push tracking history to an upstream origin:
 
 ```bash
-repopy link <git-url> -m ["custom-initial-commit-message"]
+# Link with default initial commit message
+repopy link <git-url>
+
+# Link with custom commit message
+repopy link <git-url> -m "feat: initial project structure"
 ```
 
 ---
@@ -105,8 +119,6 @@ Run the test suite using `pytest`:
 pytest -v
 ```
 
-All contributions and pull requests are validated through our GitHub Actions workflow matrix (`.github/workflows/tests.yml`), running integration and validation tests across supported Python versions.
-
 ---
 
 ## 🗂️ Project Structure
@@ -130,11 +142,16 @@ repopy/
 │       ├── templates.py         # Static asset definitions & manifests
 │       └── validators.py        # Input sanitation & regex filters
 ├── tests/
+│   ├── test_cli.py              # CLI argument parser & flag exclusivity tests
+│   ├── test_file_system.py      # Workspace scaffolding & requirements parsing tests
+│   ├── test_git_engine.py       # Subprocess Git mocking & exit code tests
+│   ├── test_orchestrators.py    # Pipeline logic, prompts, and rollback tests
 │   ├── test_prompts.py          # Input loop & default manifest tests
 │   └── test_validators.py       # Path and schema validation tests
 ├── pyproject.toml               # PEP 621 packaging configuration
 ├── LICENSE                      # MIT License
 └── README.md
+
 ```
 
 ---
@@ -142,10 +159,3 @@ repopy/
 ## 📄 License
 
 Distributed under the MIT License. See `LICENSE` for details.
-
----
-
-## Key Review Notes
-
-* Verify the GitHub Actions workflow file path (`.github/workflows/tests.yml`) matches your actual workflow file name so the build badge renders correctly.
-* In the `repopy init` theme section, verify that the theme descriptions match what you have mapped out in `templates.py`.

{repopy-0.2.0 → repopy-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "repopy"
-version = "0.2.0"
+version = "0.3.0"
 description = "A modular CLI workspace initializer and cloning automation tool."
 readme = "README.md"
 requires-python = ">=3.8"

{repopy-0.2.0 → repopy-0.3.0}/src/repopy/__main__.py

@@ -12,32 +12,34 @@ def main() -> None:
         args = parse_arguments()
 
         if args.command == 'init':
-            print('Working on it...\n')
+            print('⌛ Working on it...\n')
             manifest = capture_project_manifests(args)
             initializer = LocalInitializer(manifest)
             success = initializer.run()
 
             if success and args.link:
-                print('Initiating automated repository link shortcut...')
+                print('⌛ Initiating automated repository link shortcut...')
                 link_initializer = LinkInitializer(args.link, args.message)
                 link_initializer.run()
 
         elif args.command == 'clone':
-            print('Working on it...\n')
-            initializer = CloneInitializer(args.repo_url, args.name)
+            print('⌛ Working on it...\n')
+            initializer = CloneInitializer(
+                args.repo_url, args.name, args.install, args.no_install
+                )
             initializer.run()
 
         elif args.command == 'link':
-            print('Working on it...\n')
+            print('⌛ Working on it...\n')
             initializer = LinkInitializer(args.repo_url, args.message)
             initializer.run()
 
         else:
-            print('Usage: repopy [local | clone] --help')
-            print('Error: Please specify a subcommand')
+            print('Usage: repopy [init | clone | link] --help')
+            print('⚠️ Error: Please specify a subcommand')
 
     except KeyboardInterrupt:
-        print('\n Workspace operation cancelled by user.')
+        print('\n ✖️ Workspace operation cancelled by user.')
         sys.exit(1)
 
 

{repopy-0.2.0 → repopy-0.3.0}/src/repopy/cli.py

@@ -76,6 +76,22 @@ def parse_arguments() -> argparse.Namespace:
         help='Name of the project folder'
     )
 
+    # Mutually exclusive commands regarding installing dependencies: 
+    # install flag (-i / --install) for installing dependencies, bypassing prompt
+    # download-only flag (-d / --download-only) for only fetching dependencies without installing, bypassing prompt
+    deps_group = clone_parser.add_mutually_exclusive_group()
+    deps_group.add_argument(
+        '-i', '--install',
+        action='store_true',
+        help='Automatically install dependencies without confirmation'
+    )
+
+    deps_group.add_argument(
+        '--no-install',
+        action='store_true',
+        help='Skip dependency installation completely (fetch-only safe mode)'
+    )
+
     #---------------------------------------------------------------------------------
     # `repopy link` subcommand
     #---------------------------------------------------------------------------------

{repopy-0.2.0 → repopy-0.3.0}/src/repopy/file_system.py

@@ -10,6 +10,7 @@ import logging
 import subprocess
 from pathlib import Path
 
+from repopy.os_detector import is_windows
 from repopy.templates import GITIGNORE_TEMPLATE, generate_pyproject_toml
 
 logger = logging.getLogger(__name__)
@@ -105,6 +106,63 @@ class FileSystemEngine:
             return False
 
 
+    def read_requirements(self) -> list[str]:
+        '''Read repository dependencies if requirements.txt exists and displays them'''
+        req_path = self.project_path / 'requirements.txt'
+        if not req_path.is_file():
+            return []
+        
+        with open(req_path, 'r') as f:
+            lines = [
+                cleaned_line
+                for line in f
+                if (cleaned_line := line.strip()) and not cleaned_line.startswith('#')
+            ]
+
+        return lines
+    
+
+    def install_dependencies(self) -> bool:
+        '''Install repository dependencies if requirements.txt is present'''
+        req_file = self.project_path / 'requirements.txt'
+
+        if not req_file.exists():
+            return True
+
+        if is_windows():
+            pip_path = self.project_path / '.venv' / 'Scripts' / 'pip.exe'
+        else:
+            pip_path = self.project_path / '.venv' / 'bin' / 'pip'
+
+        try:
+            result = subprocess.run([str(pip_path), 'install', '-r', str(req_file)], capture_output=True, text=True)
+            return result.returncode == 0
+        
+        except OSError as e:
+            logger.error(f'Failed to install dependencies at {self.project_path}: {e}')
+            return False
+
+
+    def get_activation_guide(self) -> str:
+        if is_windows():
+            venv_activation = '''
+    .\\.venv\\Scripts\\Activate.ps1 (if on Powershell)
+    .\\.venv\\Scripts\\activate.bat (if on cmd)\n
+'''
+        else:
+            venv_activation = '''
+    source .venv/bin/activate\n
+'''
+        
+        return f'''
+To activate the virtual environment and get started, enter the following:
+
+    cd {self.project_path}
+
+{venv_activation}
+'''
+
+
     def cleanup(self) -> None:
         '''Removes any partially created project directories if a failure occurs'''
         if self.project_path.exists():

{repopy-0.2.0 → repopy-0.3.0}/src/repopy/git_engine.py

@@ -4,13 +4,10 @@ holds the methods required to cone a GitHub repository and install
 dependencies.
 '''
 
-import shutil
 import logging
 import subprocess
 from pathlib import Path
 
-from repopy.os_detector import is_windows
-
 logger = logging.getLogger(__name__)
 
 class GitEngine:
@@ -27,42 +24,13 @@ class GitEngine:
     def clone_repository(self) -> bool:
         '''Clone GitHub repository using the given url to the given directory name'''
         try:
-            result = subprocess.run(['git', 'clone', self.repo_url, str(self.project_path)], capture_output=True, text=True)
+            result = subprocess.run(['git', 'clone', self.repo_url, str(self.project_path)], text=True)
             return result.returncode == 0
         except OSError as e:
             logger.error(f'Failed to clone repository at {self.project_path}: {e}')
             return False
 
 
-    def install_dependencies(self) -> bool:
-        '''Install repository dependencies if requirements.txt is present'''
-        req_file = self.project_path / 'requirements.txt'
-
-        if not req_file.exists():
-            return True
-
-        if is_windows():
-            pip_path = self.project_path / '.venv' / 'Scripts' / 'pip.exe'
-        else:
-            pip_path = self.project_path / '.venv' / 'bin' / 'pip'
-
-        try:
-            result = subprocess.run([str(pip_path), 'install', '-r', str(req_file)], capture_output=True, text=True)
-            return result.returncode == 0
-        except OSError as e:
-            logger.error(f'Failed to install dependencies at {self.project_path}: {e}')
-            return False
-
-    def cleanup(self) -> None:
-        '''Removes any partially created project directories if a failure occurs'''
-        if self.project_path.exists():
-            try:
-                shutil.rmtree(self.project_path)
-                logger.info(f'Successfully cleaned up half-baked workspace at {self.project_path}')
-            except OSError as e:
-                logger.error(f'Failed to clean up directory at {self.project_path}: {e}')
-
-
 class GitLinkEngine:
 
     def __init__(self, repo_url: str, message: str):
@@ -97,6 +65,6 @@ class GitLinkEngine:
             return True
 
         except OSError as e:
-            logger.error(f'Failed to execute Git linking operationsL {e}')
+            logger.error(f'Failed to execute Git linking operations: {e}')
             return False
         

repopy-0.3.0/src/repopy/orchestrators.py

@@ -0,0 +1,149 @@
+'''
+Orchestration Layer. Core supervisor that amalgamates all inspectors and building
+tools and manages the entire user request loop from start to finish.
+'''
+
+import logging
+from pathlib import Path
+
+from repopy.file_system import FileSystemEngine
+from repopy.git_engine import GitEngine, GitLinkEngine
+from repopy.dependencies import has_python, has_git
+from repopy.prompts import confirm_dependency_installation, confirm_cleanup
+from repopy.validators import is_valid_project_name, is_valid_git_url
+
+logger = logging.getLogger(__name__)
+
+class LocalInitializer:
+
+    def __init__(self, manifest: dict):
+        self.manifest = manifest
+        self.project_name = manifest['project_name']
+        self.project_path = Path(self.project_name).resolve()
+        self.theme = manifest['theme']
+
+
+    def run(self) -> bool:
+        '''Runs when `repopy local` is called'''
+        if not has_python():
+            print('⚠️ Python is not installed in the local machine.')
+            return False
+
+        if not is_valid_project_name(self.project_name):    
+            print(f'⚠️ "{self.project_name}" is not a valid directory name.')
+            return False
+
+        fs_engine = FileSystemEngine(self.project_path)
+        if fs_engine.build_workspace(self.theme, self.manifest):
+            print(f'✅ Success! Workspace provisioned inside: {self.project_path}')
+            print(f'✅ Layout theme configured: [{self.theme.upper()}]')
+            print(fs_engine.get_activation_guide())
+            return True
+
+        else:
+            print(f'❌ Construction failed. Triggering cleanup on half-baked directories...')
+            fs_engine.cleanup()
+            return False
+
+
+class CloneInitializer:
+
+    def __init__(self, repo_url: str, dir_name: str | None, install: bool, no_install: bool):
+        self.repo_url = repo_url
+        self.dir_name = dir_name if dir_name else None
+        self.auto_install = bool(install)
+        self.no_install = bool(no_install)
+
+    def run(self) -> bool:
+        '''Runs when `repopy clone` is called'''
+        if not has_python() or not has_git():        
+            print(f'❌ Failed to initiate repopy due to absence of Python or Git on local machine.')
+            return False   
+
+        if not is_valid_git_url(self.repo_url):
+            print('⚠️ Invalid Git URL format')
+            return False
+            
+        if self.dir_name:
+            predicted_name = self.dir_name
+        else:
+            cleaned_url = self.repo_url.removesuffix('.git')
+            predicted_name = Path(cleaned_url).name
+
+        if not is_valid_project_name(str(predicted_name)):
+            print(f'⚠️ "{predicted_name}" is not a valid directory name.')
+            return False
+
+        git_engine = GitEngine(self.repo_url, self.dir_name)
+        fs_engine = FileSystemEngine(git_engine.project_path)
+
+        if not git_engine.clone_repository():
+            return False
+
+        if not fs_engine.create_virtual_environment():
+            print(f'❌ Failed to create virtual environment at {git_engine.project_path}. Cleaning up half-baked files...')
+            fs_engine.cleanup()
+            return False
+
+        print('☑️ Cloning complete and .venv has been created.')
+        deps = fs_engine.read_requirements()
+
+        if not deps:
+            print('No dependencies to install in repository (or requirements.txt is absent).')
+            should_install = False
+
+        elif self.no_install:
+            print('Skipping installation of dependencies.')
+            should_install = False
+
+        elif self.auto_install:
+            print('Installing dependencies...')
+            should_install = True
+
+        else:
+            should_install = confirm_dependency_installation(deps)
+
+        if should_install:
+            if not fs_engine.install_dependencies():
+                print(f'✅ GitHub repository is ready at {git_engine.project_path}.')
+                print(f'⚠️ Failed to install dependencies from requirements.txt at {git_engine.project_path}')
+                print(fs_engine.get_activation_guide())
+                print('To install dependencies, run the following on your terminal:\n')
+                print('    pip install -r requirements.txt\n')
+                print('Or install them individually by `pip install <module>`\n')
+
+                if confirm_cleanup():
+                    fs_engine.cleanup()
+                    print('Half-baked directory has been cleaned up.')
+                    return False
+
+        print(f'✅ Success! GitHub repository is ready at {git_engine.project_path}.')
+        print(fs_engine.get_activation_guide())
+        return True                 
+
+
+class LinkInitializer:
+
+    def __init__(self, repo_url: str, message: str | None):
+        self.repo_url = repo_url
+        self.message = message if message else 'Initial commit: Workspace structured by repopy'
+
+
+    def run(self) -> bool:
+        '''Runs when `repopy link` is called'''
+        if not has_git():           
+            print('⚠️ Git is not installed on this machine.')
+            return False
+
+        if not Path('.git').exists():
+            print('❌ No local Git repository detected. Please initialize this project first.')
+            return False
+
+        git_link_engine = GitLinkEngine(self.repo_url, self.message)
+        if git_link_engine.link_and_push():
+            print(f'✅ Success! Your local repository has been linked to {self.repo_url}.')
+            print(f'Commit message baseline: "{self.message}"')
+            return True
+        else:
+            print(f'❌ Failed to establish communication or push to remote repository at {self.repo_url}.')
+            return False

{repopy-0.2.0 → repopy-0.3.0}/src/repopy/prompts.py

@@ -5,7 +5,7 @@ loops, and fallback default configurations.
 
 import re
 from pathlib import Path
-from repopy.orchestrators import is_valid_project_name
+from repopy.validators import is_valid_project_name
 
 THEME_OPTIONS = {
     '1': 'minimal',
@@ -106,4 +106,26 @@ def capture_project_manifests(cli_args) -> dict:
     }
 
 
+def confirm_dependency_installation(dependencies: list[str]) -> bool:
+    print('\nThis repository contains the following dependencies:')
+    for dep in dependencies:
+        print(f'    • {dep}')
+    
+    print()
 
+    try:
+        choice = input('Do you want to install these dependencies? [y/N]: ').strip().lower()
+        return choice in ('y', 'yes')
+
+    except (KeyboardInterrupt, EOFError):
+        print('\nSkipping installation.')
+        return False
+
+
+def confirm_cleanup() -> bool:
+    try:
+        answer = input('If not, would you like to cleanup the new directory? [y/N]: ').strip().lower()
+        return answer in ('y', 'yes')
+
+    except (KeyboardInterrupt, EOFError):
+        return False