util/url.go

// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.

package util

import (
	"net/url"
	"strings"

	"github.com/docker/docker/builder/remotecontext/urlutil"
)

const (
	azureDevOpsHost = "dev.azure.com"
	vstsHost        = ".visualstudio.com"
	httpsScheme     = "https"
)

// IsAzureDevOpsGitURL determines whether or not the specified string is an Azure DevOps Git URL.
func IsAzureDevOpsGitURL(s string) bool {
	lowercaseURL, err := url.Parse(strings.ToLower(s))
	if err != nil {
		return false
	}
	return lowercaseURL.Scheme == httpsScheme &&
		lowercaseURL.Host == azureDevOpsHost &&
		strings.Contains(lowercaseURL.Path, "/_git/") &&
		len(lowercaseURL.Query()) == 0
}

// IsVstsGitURL determines whether or not the specified string is a VSTS Git URL.
func IsVstsGitURL(s string) bool {
	lowercaseURL, err := url.Parse(strings.ToLower(s))
	if err != nil {
		return false
	}

	return lowercaseURL.Scheme == httpsScheme &&
		strings.HasSuffix(lowercaseURL.Host, vstsHost) &&
		strings.Contains(lowercaseURL.Path, "/_git/") &&
		len(lowercaseURL.Query()) == 0
}

// IsSourceControlURL determines whether or not the specified string is a source control URL.
func IsSourceControlURL(s string) bool {
	return IsGitURL(s) || IsAzureDevOpsGitURL(s) || IsVstsGitURL(s)
}

// IsGitURL determines whether or not the specified string is a Git URL.
func IsGitURL(s string) bool {
	return urlutil.IsGitURL(s)
}

// IsRegistryArtifact determines whether or not the specified string is a registry artifact
func IsRegistryArtifact(s string) bool {
	return strings.HasPrefix(strings.ToLower(s), "oci://")
}

// IsURL determines whether or not the specified string is a URL.
func IsURL(s string) bool {
	return urlutil.IsURL(s)
}

// IsLocalContext determines whether or not the specified string is local.
func IsLocalContext(s string) bool {
	if IsURL(s) || IsSourceControlURL(s) || IsRegistryArtifact(s) {
		return false
	}
	return true
}