Function generate_command

codewiki/cli/commands/generate.py:310–621

Generate comprehensive documentation for a code repository. Analyzes the current repository and generates documentation using LLM-powered analysis. Documentation is output to ./docs/ by default. Examples: \b # Basic generation $ codewiki generate

(
    ctx,
    output: str,
    create_branch: bool,
    github_pages: bool,
    no_cache: bool,
    include: Optional[str],
    exclude: Optional[str],
    focus: Optional[str],
    doc_type: Optional[str],
    instructions: Optional[str],
    verbose: bool,
    max_tokens: Optional[int],
    max_token_per_module: Optional[int],
    max_token_per_leaf_module: Optional[int],
    max_depth: Optional[int],
    update: bool = False,
    compare_to: Optional[str] = None
)

         "normal calls if the provider rejects them (default: enabled)",
)
@click.option(
    "--update",
    is_flag=True,
    help="Incremental update: only regenerate modules affected by changes since last generation",
)
@click.option(
    "--compare-to",
    type=str,
    default=None,
    help="Commit hash to compare against for incremental updates (overrides stored commit in metadata.json)",
)
@click.pass_context
def generate_command(
    ctx,
    output: str,
    create_branch: bool,
    github_pages: bool,
    no_cache: bool,
    include: Optional[str],
    exclude: Optional[str],
    focus: Optional[str],
    doc_type: Optional[str],
    instructions: Optional[str],
    use_gitignore: Optional[bool],
    verbose: bool,
    max_tokens: Optional[int],
    max_token_per_module: Optional[int],
    max_token_per_leaf_module: Optional[int],
    max_depth: Optional[int],
    prompt_caching: Optional[bool],
    update: bool = False,
    compare_to: Optional[str] = None
):
    """
    Generate comprehensive documentation for a code repository.
    
    Analyzes the current repository and generates documentation using LLM-powered
    analysis. Documentation is output to ./docs/ by default.
    
    Examples:
    
    \b
    # Basic generation
    $ codewiki generate
    
    \b
    # With git branch creation and GitHub Pages
    $ codewiki generate --create-branch --github-pages
    
    \b
    # Force full regeneration
    $ codewiki generate --no-cache

    \b
    # Analyze ignored files as well
    $ codewiki generate --no-gitignore
    
    \b