documentation for name validation grammar

Signed-off-by: Stephen J Day <stephen.day@docker.com>
This commit is contained in:
Stephen J Day 2015-02-26 16:06:36 -08:00
parent 00ce453315
commit ac7af800fb

View file

@ -82,6 +82,16 @@ var (
// registry. This function accepts a superset of what might be accepted by // registry. This function accepts a superset of what might be accepted by
// docker core or docker hub. If the name does not pass validation, an error, // docker core or docker hub. If the name does not pass validation, an error,
// describing the conditions, is returned. // describing the conditions, is returned.
//
// Effectively, the name should comply with the following grammar:
//
// alpha-numeric := /[a-z0-9]+/
// separator := /[._-]/
// component := alpha-numeric [separator alpha-numeric]*
// namespace := component ['/' component]*
//
// The result of the production, known as the "namespace", should be limited
// to 255 characters.
func ValidateRespositoryName(name string) error { func ValidateRespositoryName(name string) error {
if len(name) > RepositoryNameTotalLengthMax { if len(name) > RepositoryNameTotalLengthMax {
return ErrRepositoryNameLong return ErrRepositoryNameLong