git-ripper/src/parser.js

CLI tool that lets you download specific folders from GitHub repositories without cloning the entire repo.

export function parseGitHubUrl(url) {
    // Validate the URL format
    if (!url || typeof url !== 'string') {
        throw new Error('Invalid URL: URL must be a non-empty string');
    }

    // Validate if it's a GitHub URL
    const githubUrlPattern = /^https?:\/\/(?:www\.)?github\.com\/([^\/]+)\/([^\/]+)(?:\/tree\/([^\/]+)(?:\/(.+))?)?$/;
    const match = url.match(githubUrlPattern);

    if (!match) {
        throw new Error('Invalid GitHub URL format. Expected: https://github.com/owner/repo/tree/branch/folder');
    }

    // Extract components from the matched pattern
    const owner = match[1];
    const repo = match[2];
    const branch = match[3] || 'main'; // Default to 'main' if branch is not specified
    const folderPath = match[4] || ''; // Empty string if no folder path

    // Additional validation
    if (!owner || !repo) {
        throw new Error('Invalid GitHub URL: Missing repository owner or name');
    }

    return { owner, repo, branch, folderPath };
}