org.testcontainers.utility.Versioning Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of testcontainers Show documentation

Isolated container management for Java code testing

There is a newer version: 1.20.4

package org.testcontainers.utility;

import lombok.AccessLevel;
import lombok.EqualsAndHashCode;
import lombok.NoArgsConstructor;

/**
 * Represents mechanisms for versioning docker images.
 */
interface Versioning {
    AnyVersion ANY = new AnyVersion();

    boolean isValid();

    String getSeparator();

    @NoArgsConstructor(access = AccessLevel.PRIVATE)
    class AnyVersion implements Versioning {

        @Override
        public boolean isValid() {
            return true;
        }

        @Override
        public String getSeparator() {
            return ":";
        }

        @Override
        public String toString() {
            return "latest";
        }

        @Override
        public boolean equals(final Object obj) {
            return obj instanceof Versioning;
        }

        @Override
        public int hashCode() {
            return super.hashCode();
        }
    }

    @EqualsAndHashCode
    class TagVersioning implements Versioning {

        public static final String TAG_REGEX = "[\\w][\\w.\\-]{0,127}";

        static final TagVersioning LATEST = new TagVersioning("latest");

        private final String tag;

        TagVersioning(String tag) {
            this.tag = tag;
        }

        @Override
        public boolean isValid() {
            return tag.matches(TAG_REGEX);
        }

        @Override
        public String getSeparator() {
            return ":";
        }

        @Override
        public String toString() {
            return tag;
        }
    }

    @EqualsAndHashCode
    class Sha256Versioning implements Versioning {

        public static final String HASH_REGEX = "[0-9a-fA-F]{32,}";

        private final String hash;

        Sha256Versioning(String hash) {
            this.hash = hash;
        }

        @Override
        public boolean isValid() {
            return hash.matches(HASH_REGEX);
        }

        @Override
        public String getSeparator() {
            return "@";
        }

        @Override
        public String toString() {
            return "sha256:" + hash;
        }
    }
}