import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.annotations.Nonnull;

/**
 * An SPI interface to extend Maven with new enum values for extensible enumerations.
 * <p>
 * Maven uses extensible enumerations to allow plugins and extensions to add new values
 * to various categories like languages, scopes, and packaging types. This interface is the
 * base for all providers that register such extensions.

<img src="/img/tutorial/path-params/image03.png">

### Working with Python *enumerations* { #working-with-python-enumerations }

The value of the *path parameter* will be an *enumeration member*.

#### Compare *enumeration members* { #compare-enumeration-members }

You can compare it with the *enumeration member* in your created enum `ModelName`:

{* ../../docs_src/path_params/tutorial005_py39.py hl[17] *}

import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;

import org.junit.jupiter.api.Test;

/**
 * Unit tests for witness protocol enumerations.
 */
public class WitnessEnumTest {

    @Test
    void testWitnessServiceTypes() {
        assertEquals(4, WitnessServiceType.values().length);

        // Verify all expected types are present

     *
     * @param <T> the element type
     * @param enumeration the enumeration (must not be {@literal null})
     * @return an {@link Iterable} wrapping the enumeration
     */
    public static <T> Iterable<T> iterable(final Enumeration<T> enumeration) {
        assertArgumentNotNull("enumeration", enumeration);

        return () -> new EnumerationIterator<>(enumeration);
    }

    }

    /**
     * Opens the enumeration and returns the first entry.
     *
     * @return the first file entry, or null if empty
     * @throws CIFSException if an error occurs during opening
     */
    protected abstract FileEntry open() throws CIFSException;

    /**
     * Checks if the enumeration is complete.
     *
     * @return true if enumeration is done, false otherwise
     */

        }

        return type.cast(object);
    }

    /**
     * Gets the next element from an enumeration and casts it to the specified type
     * @param <T> the target type
     * @param type the target class type
     * @param enumeration the enumeration to read from
     * @return next element from enumeration cast to type
     * @throws PACDecodingException if types are incompatible
     */

    /**
     * Test method for
     * {@link org.codelibs.core.collection.EnumerationIterator#EnumerationIterator(Enumeration)}
     * .
     */
    @Test
    public void testCopyDestNull() {
        exception.expect(NullArgumentException.class);
        exception.expectMessage(is("[ECL0008]argument[enumeration] is null."));
        new EnumerationIterator<Object>(null);
    }

import static org.codelibs.core.misc.AssertionUtil.assertArgumentNotNull;

import java.util.Enumeration;
import java.util.Iterator;

/**
 * Adapter to convert an {@link Iterator} to an {@link Enumeration}.
 *
 * @author higa
 * @param <T> the element type
 */
public class IteratorEnumeration<T> implements Enumeration<T> {

    /** 反復子 */
    protected final Iterator<T> iterator;

    /**

    }

    /**
     * Sets the query flags for the directory enumeration
     *
     * @param queryFlags
     *            the queryFlags to set
     */
    public void setQueryFlags(final byte queryFlags) {
        this.queryFlags = queryFlags;
    }

    /**
     * Sets the file index from which to start the directory enumeration
     *
     * @param fileIndex
     *            the fileIndex to set

     *            The class loader. Must not be {@literal null}.
     * @param name
     *            The resource name. Must not be {@literal null} or an empty string.
     * @return An enumeration of URL objects for the resources. If no resources are found, the enumeration will be empty.
     *         Resources that the class loader does not have access to will not be included.
     * @see java.lang.ClassLoader#getResources(String)
     */