* `url` (**obrigatório**): uma `str` com a URL da documentação externa.

### Criar Metadados para tags

Vamos tentar isso em um exemplo com tags para `users` e `items`.

Crie metadados para suas tags e passe-os para o parâmetro `openapi_tags`:

{* ../../docs_src/metadata/tutorial004.py hl[3:16,18] *}

import java.util.SortedSet;
import java.util.TreeSet;
import org.jspecify.annotations.Nullable;

/**
 * A wrapper around {@code TreeSet} that aggressively checks to see if elements are mutually
 * comparable. This implementation passes the navigable set test suites.
 *
 * @author Louis Wasserman
 */
@GwtIncompatible
public final class SafeTreeSet<E> implements Serializable, NavigableSet<E> {
  @SuppressWarnings("unchecked")

    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new QueryParseException with the specified ParseException as the cause.
     *
     * @param cause the ParseException that caused this exception
     */
    public QueryParseException(final ParseException cause) {
        super(cause);
    }

    }

    @Test
    public void testParseSource() {
        // Test parseSource method
        Map<String, Object> source = new HashMap<>();
        source.put(FieldNames.TEXT, "parsed text");
        source.put(FieldNames.QUERY_FREQ, 75L);
        source.put(FieldNames.DOC_FREQ, 35L);
        source.put(FieldNames.USER_BOOST, 2.0f);

    }

    /**
     * Parses a date string using the default date format.
     *
     * @param value the date string to parse
     * @return parsed Date object, or null if parsing fails
     */
    public static Date parseDate(final String value) {
        return parseDate(value, Constants.DATE_OPTIONAL_TIME);
    }

    /**
     * Parses a date string using the specified format.
     *

        EXCEPTION,
        /** Indicates that processing of a URL has finished. */
        FINISHED,
        /** Indicates that content was successfully parsed. */
        PARSED,
        /** Indicates that a URL was prepared for crawling. */
        PREPARED,
        /** Indicates that a URL redirect was encountered. */
        REDIRECTED,

		if actualErrCode == ErrNone {
			// validating the extracted/parsed credential fields.
			validateCredentialfields(t, i+1, testCase.expectedAuthField.Credential, parsedAuthField.Credential)

			// validating the extraction/parsing of signature field.
			if !compareSignatureV4(testCase.expectedAuthField.Signature, parsedAuthField.Signature) {

        });
    }

    @Test
    public void testPathWithTraversal() throws Exception {
        assertThrows(SmbException.class, () -> {
            validator.validatePath("\\share\\..\\..\\etc\\passwd");
        });
    }

    @Test
    public void testPathWithDotSlash() throws Exception {
        assertThrows(SmbException.class, () -> {
            validator.validatePath("\\share\\./system");

@SuppressWarnings("JUnit4ClassUsedInJUnit3")
public class AbstractSetTester<E> extends AbstractCollectionTester<E> {
  /*
   * Previously we had a field named set that was initialized to the value of
   * collection in setUp(), but that caused problems when a tester changed the
   * value of set or collection but not both.
   */
  protected final Set<E> getSet() {
    return (Set<E>) collection;
  }

 * text is performed automatically by the relevant parser.
 *
 * <p>For example, an XML escaper would convert the literal string {@code "Foo<Bar>"} into {@code
 * "Foo&lt;Bar&gt;"} to prevent {@code "<Bar>"} from being confused with an XML tag. When the
 * resulting XML document is parsed, the parser API will return this text as the original literal
 * string {@code "Foo<Bar>"}.
 *