github.com/demonoid81/containerd@v1.3.4/identifiers/validate.go (about)

     1  /*
     2     Copyright The containerd Authors.
     3  
     4     Licensed under the Apache License, Version 2.0 (the "License");
     5     you may not use this file except in compliance with the License.
     6     You may obtain a copy of the License at
     7  
     8         http://www.apache.org/licenses/LICENSE-2.0
     9  
    10     Unless required by applicable law or agreed to in writing, software
    11     distributed under the License is distributed on an "AS IS" BASIS,
    12     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13     See the License for the specific language governing permissions and
    14     limitations under the License.
    15  */
    16  
    17  // Package identifiers provides common validation for identifiers and keys
    18  // across containerd.
    19  //
    20  // Identifiers in containerd must be a alphanumeric, allowing limited
    21  // underscores, dashes and dots.
    22  //
    23  // While the character set may be expanded in the future, identifiers
    24  // are guaranteed to be safely used as filesystem path components.
    25  package identifiers
    26  
    27  import (
    28  	"regexp"
    29  
    30  	"github.com/containerd/containerd/errdefs"
    31  	"github.com/pkg/errors"
    32  )
    33  
    34  const (
    35  	maxLength  = 76
    36  	alphanum   = `[A-Za-z0-9]+`
    37  	separators = `[._-]`
    38  )
    39  
    40  var (
    41  	// identifierRe defines the pattern for valid identifiers.
    42  	identifierRe = regexp.MustCompile(reAnchor(alphanum + reGroup(separators+reGroup(alphanum)) + "*"))
    43  )
    44  
    45  // Validate return nil if the string s is a valid identifier.
    46  //
    47  // identifiers must be valid domain names according to RFC 1035, section 2.3.1.  To
    48  // enforce case insensitivity, all characters must be lower case.
    49  //
    50  // In general, identifiers that pass this validation, should be safe for use as
    51  // a domain names or filesystem path component.
    52  func Validate(s string) error {
    53  	if len(s) == 0 {
    54  		return errors.Wrapf(errdefs.ErrInvalidArgument, "identifier must not be empty")
    55  	}
    56  
    57  	if len(s) > maxLength {
    58  		return errors.Wrapf(errdefs.ErrInvalidArgument, "identifier %q greater than maximum length (%d characters)", s, maxLength)
    59  	}
    60  
    61  	if !identifierRe.MatchString(s) {
    62  		return errors.Wrapf(errdefs.ErrInvalidArgument, "identifier %q must match %v", s, identifierRe)
    63  	}
    64  	return nil
    65  }
    66  
    67  func reGroup(s string) string {
    68  	return `(?:` + s + `)`
    69  }
    70  
    71  func reAnchor(s string) string {
    72  	return `^` + s + `$`
    73  }