from fastapi import FastAPI
from fastapi.responses import FileResponse
from pydantic import BaseModel


class Item(BaseModel):
    id: str
    value: str


app = FastAPI()


@app.get(
    "/items/{item_id}",
    response_model=Item,
    responses={
        200: {
            "content": {"image/png": {}},
            "description": "Return the JSON item or an image.",
        }
    },
)

 * Helper type to implement rounding {@code X} to a representable {@code double} value according to
 * a {@link RoundingMode}.
 */
@GwtIncompatible
abstract class ToDoubleRounder<X extends Number & Comparable<X>> {
  /**
   * Returns x rounded to either the greatest double less than or equal to the precise value of x,
   * or the least double greater than or equal to the precise value of x.
   */
  abstract double roundToDoubleArbitrarily(X x);

     */
    String type() default "java.lang.String";

    /**
     * Specifies the default value of the configuration property.
     *
     * @return the default value as a string, defaults to empty string
     */
    String defaultValue() default "";

    /**
     * Specifies whether the configuration property is read-only.
     *

    public interface ContentTransformer {
        /**
         * Interpolate the value read from the xpp3 document
         *
         * @param source    the source value
         * @param fieldName a description of the field being interpolated. The implementation may use this to
         *                  log stuff
         * @return the interpolated value
         */
        String transform(String source, String fieldName);
    }

 */
package jcifs.ntlmssp.av;

import jcifs.internal.util.SMBUtil;

/**
 * NTLMSSP AV (Attribute-Value) pair representing flags information.
 * Contains flag values used in NTLM authentication attribute-value pairs.
 *
 * @author mbechler
 */
public class AvFlags extends AvPair {

    /**
     * Constructs an AV flags pair from raw bytes

constraints.AssertTrue.message = {item} 必须为 true。
constraints.DecimalMax.message = {item} 必须小于 {value}。
constraints.DecimalMin.message = {item} 必须大于 {value}。
constraints.Digits.message = {item} 必须是数字。(预期: <数字>.<数字>)
constraints.Future.message = {item} 必须是未来的值。
constraints.Max.message = {item} 必须小于或等于 {value}。
constraints.Min.message = {item} 必须大于或等于 {value}。
constraints.NotNull.message = {item} 不能为空。
constraints.Null.message = {item} 必须为 null。

  @SuppressWarnings("InlineMeInliner")
  public void testHashCode() {
    for (char value : VALUES) {
      assertThat(Chars.hashCode(value)).isEqualTo(Character.hashCode(value));
    }
  }

  public void testCheckedCast() {
    for (char value : VALUES) {
      assertThat(Chars.checkedCast((long) value)).isEqualTo(value);
    }
    assertCastFails(GREATEST + 1L);
    assertCastFails(LEAST - 1L);

     * Ensures that the static field holds the expected string value.
     */
    @Test
    void testNoNullRefConstant() {
        assertNotNull(NdrException.NO_NULL_REF, "NO_NULL_REF constant should not be null.");
        assertEquals("ref pointer cannot be null", NdrException.NO_NULL_REF, "NO_NULL_REF constant should have the expected value.");
    }

    /**
     * Test the INVALID_CONFORMANCE static field.

    @see <a href="/guides/mini/guide-using-toolchains.html">Guide to Using Toolchains</a>
    ]]></description>

  <defaults>
    <default>
      <key>package</key>
      <value>org.apache.maven.toolchain.model</value>
    </default>
  </defaults>

  <classes>
    <class java.clone="deep">
      <name>TrackableBase</name>
      <version>1.1.0+</version>
      <description>

/// note

FastAPI will know that the value of `q` is not required because of the default value `= None`.

The `str | None` is not used by FastAPI to determine that the value is not required, it will know it's not required because it has a default value of `= None`.

But adding the type annotations will allow your editor to give you better support and detect errors.