Method create_documentation_branch

codewiki/cli/git_manager.py:73–121

Create a new documentation branch with timestamp. Args: force: Force creation even if dirty working directory Returns: Branch name Raises: RepositoryError: If working directory is dirty (unless fo

(self, force: bool = False)

    def create_documentation_branch(self, force: bool = False) -> str:
        """
        Create a new documentation branch with timestamp.

        Args:
            force: Force creation even if dirty working directory

        Returns:
            Branch name

        Raises:
            RepositoryError: If working directory is dirty (unless force=True)
        """
        # Check working directory
        if not force:
            is_clean, status_msg = self.check_clean_working_directory()
            if not is_clean:
                raise RepositoryError(
                    "Working directory has uncommitted changes.\n\n"
                    f"{status_msg}\n\n"
                    "Cannot create documentation branch with uncommitted changes.\n"
                    "Please commit or stash your changes first:\n"
                    "  git status\n"
                    '  git add -A && git commit -m "Your message"\n'
                    "  # or\n"
                    "  git stash\n\n"
                    "Then re-run: codewiki generate --create-branch"
                )

        # Generate branch name with timestamp
        timestamp = datetime.now().strftime("%Y%m%d-%H%M%S")
        branch_name = f"docs/codewiki-{timestamp}"

        # Check if branch already exists (shouldn't happen with timestamp)
        existing_branches = [b.name for b in self.repo.branches]
        if branch_name in existing_branches:
            # Append counter
            counter = 1
            while f"{branch_name}-{counter}" in existing_branches:
                counter += 1
            branch_name = f"{branch_name}-{counter}"

        try:
            # Create and checkout new branch
            new_branch = self.repo.create_head(branch_name)
            new_branch.checkout()
            return branch_name
        except GitCommandError as e:
            raise RepositoryError(f"Failed to create branch: {e}")

    def commit_documentation(self, docs_path: Path, message: Optional[str] = None) -> str:
        """
        Commit generated documentation.