Function ParseRunURLExtended

pkg/parser/github_urls.go:289–309

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

(input string)

// ParseRunURLExtended is similar to ParseRunURL but returns additional information
// including job ID and step details from deep URLs.
func ParseRunURLExtended(input string) (*GitHubURLComponents, error) {
	// First try to parse as a direct numeric ID
	if runID, err := strconv.ParseInt(input, 10, 64); err == nil {
		return &GitHubURLComponents{
			Type:   URLTypeRun,
			Number: runID,
		}, nil
	}

	// Try to parse as a GitHub URL
	components, err := ParseGitHubURL(input)
	if err != nil {
		return nil, fmt.Errorf("invalid run ID or URL '%s': must be a numeric run ID or a GitHub URL containing '/actions/runs/{run-id}' or '/runs/{run-id}'", input)
	}

	if components.Type != URLTypeRun {
		return nil, errors.New("URL is not a GitHub Actions run URL")
	}

	return components, nil
}

// ParsePRURL is a convenience function that parses a GitHub PR URL and extracts PR information.
// Expected format: https://github.com/owner/repo/pull/123 or https://github.enterprise.com/owner/repo/pull/123