Future: Support searching crates by GitHub URL

[nikomatsakis]

Overview

Allow users to search for examples directly from GitHub repositories, bypassing crates.io entirely.

Use Cases

• Explore unreleased versions or development branches
• Search private repositories (with authentication)
• Analyze forks or experimental versions
• Research crates that aren't published to crates.io

Proposed API

// Search a GitHub repository directly
let result = Eg::github_repo("tokio-rs/tokio")
    .branch("main")  // optional, defaults to default branch
    .pattern(r"spawn")?
    .search().await?;

// Or with full URL
let result = Eg::github_url("https://github.com/tokio-rs/tokio")
    .pattern(r"async")?
    .search().await?;

Implementation Notes

• Clone/download repository to local cache
• Use same search infrastructure as crate extraction
• Handle authentication via GITHUB_TOKEN
• Support branch/tag/commit specification
• Consider rate limiting and caching strategies

Priority

Low - the current crates.io approach covers 95% of use cases. This is a nice-to-have enhancement for power users.

Related

This was originally part of the GitHub fallback feature that was removed in favor of the simpler full-extraction approach.