70 lines
2.2 KiB
Python
70 lines
2.2 KiB
Python
"""Module for determining project state and initialization status."""
|
|
|
|
from pathlib import Path
|
|
from typing import Set
|
|
|
|
|
|
class ProjectStateError(Exception):
|
|
"""Base exception for project state related errors."""
|
|
|
|
pass
|
|
|
|
|
|
class DirectoryNotFoundError(ProjectStateError):
|
|
"""Raised when the specified directory does not exist."""
|
|
|
|
pass
|
|
|
|
|
|
class DirectoryAccessError(ProjectStateError):
|
|
"""Raised when the directory cannot be accessed due to permissions."""
|
|
|
|
pass
|
|
|
|
|
|
def is_new_project(directory: str) -> bool:
|
|
"""
|
|
Determine if a directory represents a new/empty project.
|
|
|
|
A project is considered new if it either:
|
|
- Is an empty directory
|
|
- Contains only .git directory, .gitignore file, .venv directory, and/or .ra-aid directory
|
|
|
|
Args:
|
|
directory: String path to the directory to check
|
|
|
|
Returns:
|
|
bool: True if the directory is empty or contains only git files,
|
|
False otherwise
|
|
|
|
Raises:
|
|
DirectoryNotFoundError: If the specified directory does not exist
|
|
DirectoryAccessError: If the directory cannot be accessed
|
|
ProjectStateError: For other unexpected errors
|
|
"""
|
|
try:
|
|
path = Path(directory).resolve()
|
|
if not path.exists():
|
|
raise DirectoryNotFoundError(f"Directory does not exist: {directory}")
|
|
if not path.is_dir():
|
|
raise DirectoryNotFoundError(f"Path is not a directory: {directory}")
|
|
|
|
# Get all files/dirs in the directory, excluding allowed items
|
|
_allowed_items: Set[str] = {".git", ".gitignore", ".ra-aid", ".venv"}
|
|
try:
|
|
contents = set()
|
|
for item in path.iterdir():
|
|
# Only consider top-level items
|
|
if item.name != ".git":
|
|
contents.add(item.name)
|
|
except PermissionError as e:
|
|
raise DirectoryAccessError(f"Cannot access directory {directory}: {e}")
|
|
|
|
# Directory is new if empty or only contains allowed items
|
|
return len(contents) == 0 or contents.issubset(_allowed_items)
|
|
|
|
except Exception as e:
|
|
if isinstance(e, ProjectStateError):
|
|
raise
|
|
raise ProjectStateError(f"Error checking project state: {e}")
|