from typing import Annotated, Literal

from fastapi import FastAPI, Query
from pydantic import BaseModel, Field

app = FastAPI()


class FilterParams(BaseModel):
    model_config = {"extra": "forbid"}

    limit: int = Field(100, gt=0, le=100)
    offset: int = Field(0, ge=0)
    order_by: Literal["created_at", "updated_at"] = "created_at"
    tags: list[str] = []


@app.get("/items/")

     * @param propertyName
     *            The property name. Must not be {@literal null} or empty string
     * @return Whether the {@link PropertyDesc} exists
     */
    boolean hasPropertyDesc(String propertyName);

    /**
     * Returns the {@link PropertyDesc}.
     *
     * @param propertyName
     *            The property name. Must not be {@literal null} or empty string
     * @return {@link PropertyDesc}
     */

import org.hamcrest.Matcher;

/**
 * @author koichik
 */
public abstract class TestUtil {

    /**
     * 実際の値が期待する{@literal clazz}と等しいかを検証する{@link Matcher}を返します。
     *
     * <pre>assertThat(clazz, is(Xxx.class));</pre>
     * <p>
     * と書くと{@link CoreMatchers#is(Class)}が適用されて{@literal clazz}が {@literal Xxx}
     * のインスタンスかを検証されてしまうのでこれが必要。
     *
     * @param clazz
     *            期待するクラス

     *
     * @param targetClass
     *            The target class. Must not be {@literal null}.
     * @param name
     *            The resource name. Must not be {@literal null} or an empty string.
     * @return An iterator of URL objects for the resources. If no resources are found, the iterator will be empty.

    @SuppressWarnings("rawtypes") // class literals
    private final List<Class<? extends AbstractTester>> testers;

    @SuppressWarnings("rawtypes") // class literals
    OneSizeTestSuiteBuilder(List<Class<? extends AbstractTester>> testers) {
      this.testers = testers;
    }

    @SuppressWarnings("rawtypes") // class literals
    @Override

     * @return The converted {@literal String}
     */
    public static String toString(final Object value) {
        return toString(value, null);
    }

    /**
     * Converts the given object to a string.
     *
     * @param value
     *            The object to convert
     * @param pattern
     *            The pattern string
     * @return The converted {@literal String}
     */

            // <tr>
            //   <td><literal><link linkend="$id">$name</link>$signature</literal></td>
            //   <td>$description</td>
            // </tr>
            tr = document.createElement("tr");
            parent.appendChild(tr);

            td = document.createElement("td");
            tr.appendChild(td);
            Element literal = document.createElement("literal");
            td.appendChild(literal);

     *
     * @param jarFile
     *            the Jar file (must not be {@literal null})
     * @param prefix
     *            the prefix that resource names must start with (must not be {@literal null}).
     *            If not empty, must end with a slash ('/').
     * @param handler
     *            the handler to process resources (must not be {@literal null})
     */

     */
    protected StatementUtil() {
    }

    /**
     * Executes the SQL.
     *
     * @param statement
     *            {@link Statement}. Must not be {@literal null}.
     * @param sql
     *            SQL string. Must not be {@literal null} or empty.
     * @return The result of the execution.
     * @see Statement#execute(String)
     */
    public static boolean execute(final Statement statement, final String sql) {

     *
     * @param context
     *            The context in which to parse the spec. Must not be {@literal null}.
     * @param spec
     *            A string to be parsed as a <code>URL</code>. Must not be {@literal null} or empty.
     * @return A <code>URL</code>.
     */
    public static URL create(final URL context, final String spec) {