Function parseRawGitHubContentURL

pkg/parser/github_urls.go:242–285

parseRawGitHubContentURL parses raw.githubusercontent.com URLs Supports URLs like: - https://raw.githubusercontent.com/owner/repo/refs/heads/branch/path/to/file.md - https://raw.githubusercontent.com/owner/repo/COMMIT_SHA/path/to/file.md - https://raw.githubusercontent.com/owner/repo/refs/tags/tag/p

(parsedURL *url.URL)

//   - https://raw.githubusercontent.com/owner/repo/COMMIT_SHA/path/to/file.md
//   - https://raw.githubusercontent.com/owner/repo/refs/tags/tag/path/to/file.md
func parseRawGitHubContentURL(parsedURL *url.URL) (*GitHubURLComponents, error) {
	pathParts := strings.Split(strings.Trim(parsedURL.Path, "/"), "/")

	// Need at least: owner, repo, ref-or-sha, and filename
	if len(pathParts) < 4 {
		return nil, errors.New("invalid raw.githubusercontent.com URL format: path too short")
	}

	owner := pathParts[0]
	repo := pathParts[1]

	// Determine the reference and file path based on the third part
	var ref string
	var filePath string

	if pathParts[2] == "refs" {
		// Format: /owner/repo/refs/heads/branch/path/to/file
		// or /owner/repo/refs/tags/tag/path/to/file
		if len(pathParts) < 5 {
			return nil, errors.New("invalid raw.githubusercontent.com URL format: refs path too short")
		}
		// pathParts[3] is "heads" or "tags"
		ref = pathParts[4] // branch or tag name
		filePath = strings.Join(pathParts[5:], "/")
	} else {
		// Format: /owner/repo/COMMIT_SHA/path/to/file or /owner/repo/branch/path/to/file
		ref = pathParts[2]
		filePath = strings.Join(pathParts[3:], "/")
	}

	// Validate owner and repo
	if owner == "" || repo == "" {
		return nil, errors.New("invalid raw.githubusercontent.com URL: owner and repo cannot be empty")
	}

	return &GitHubURLComponents{
		Host:  "raw.githubusercontent.com",
		Owner: owner,
		Repo:  repo,
		Type:  URLTypeRawContent,
		Path:  filePath,
		Ref:   ref,
	}, nil
}

// ParseRunURLExtended is similar to ParseRunURL but returns additional information
// including job ID and step details from deep URLs.