,hEUddlmZmZmZmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZmZe Zeed< deededddddddddddddeeeeededdd dd d eeed fd eeegefdfedfdeeeedfdeeedfedfdeeedfedfdeeedfedfdeeeedfdeeeedfdeeeedfdeeeedfdeeeed fd!eeeed"fd#eeeed$fd%eeeed&fd'eeeed(fd)eeeed(ed*fd+eeedfed,fd-eeedfed.fd/eeedfed0fd1eeedfed2fd3eeedfed4fd5eeedfed6fd7eeeeed8fd9eeeed:fd;eeeee fed<fd=eeeeedfed>fd?eeed@fdAeeeeefdfedBfdCeeedDedEfdFeffd?eeed@fdAeeeeefdfedBfdCeeedDedEfdFeffd?eeed@fdAeeeeefdfedBfdCeeedDedEfdFef>dMZe fededddddddddddddeeeeededdd dd d eeedHfd eeegefdfedfdeeeedfdeeedfedfdeeedfedfdeeedfedfdeeeedfdeeeedfdeeeedfdeeeedfdeeeed fd!eeeed"fd#eeeed$fd%eeeed&fd'eeeed(fd)eeeed(ed*fd+eeedfed,fd-eeedfed.fd/eeedfed0fd1eeedfed2fd3eeedfed4fd5eeedfed6fd7eeeeed8fd9eeeed:fd;eeeee fed<fd=eeeeedfed>fd?eeed@fdAeeeeefdfedBfdCeeedDedEfdFeffd?eeed@fdAeeeeefdfedBfdCeeedDedEfdFef@dUZe fedVdedddddddddddddeeeeededdd ddWd eeedHfd eeegefdfedfdSeeedTfdeeeedfdeeedfedfdeeedfedfdeeedfedfdeeeedfdeeeedfdeeeedfdeeeedfdeeeed fd!eeeed"fd#eeeed$fd%eeeed&fd'eeeed(fd)eeeed(ed*fd+eeedfed,fd-eeedfed.fd/eeedfed0fd1eeedfed2fd3eeedfed4fd5eeedfed6fd7eeeeed8fd9eeeed:fd;eeeee fed<fd=eeeeedfed>fd?eeed@fdAeeeeefdfedBfdCeeedDedEfdFef>dXZe fedYdedddddddddddddeeeeededdd ddWd eeedHfd eeegefdfedfdSeeedTfdeeeedfdeeedfedfdeeedfedfdeeedfedfdeeeedfdeeeedfdeeeedfdeeeedfdeeeed fd!eeeed"fd#eeeed$fd%eeeed&fd'eeeed(fd)eeeed(ed*fd+eeedfed,fd-eeedfed.fd/eeedfed0fd1eeedfed2fd3eeedfed4fd5eeedfed6fd7eeeeed8fd9eeeed:fd;eeeee fed<fd=eeeeedfed>fd?eeed@fdAeeeeefdfedBfdCeeedDedEfdFef>dZZ dfd d[d\eeedefed]fd^eeed_fdFefd`Z dfdd dad\eeedefed]fdbeeeeedcfd^eeed_fdFefddZ y)g)AnyCallableDictListOptionalSequenceUnion)params) Undefined)Example) AnnotatedDoc deprecated_Unset.NT)default_factoryaliasalias_priorityvalidation_aliasserialization_aliastitle descriptiongtgeltle min_length max_lengthpatternregex discriminatorstrict multiple_of allow_inf_nan max_digitsdecimal_placesexamplesexampleopenapi_examplesrinclude_in_schemajson_schema_extradefaultz Default value if the parameter field is not set. This doesn't affect `Path` parameters as the value is always required. The parameter is available only for compatibility. rz A callable to generate the default value. This doesn't affect `Path` parameters as the value is always required. The parameter is available only for compatibility. ra# An alternative name for the parameter field. This will be used to extract the data and for the generated OpenAPI. It is particularly useful when you can't use the name you want because it is a Python reserved keyword or similar. rza Priority of the alias. This affects whether an alias generator is used. rz 'Whitelist' validation step. The parameter field will be the single one allowed by the alias or set of aliases defined. rz 'Blacklist' validation step. The vanilla parameter field will be the single one of the alias' or set of aliases' fields and all the other fields will be ignored at serialization time. rz/ Human-readable title. rz5 Human-readable description. rzx Greater than. If set, value must be greater than this. Only applicable to numbers. rz Greater than or equal. If set, value must be greater than or equal to this. Only applicable to numbers. rzf Less than. If set, value must be less than this. Only applicable to numbers. rz Less than or equal. If set, value must be less than or equal to this. Only applicable to numbers. rz5 Minimum length for strings. rz5 Maximum length for strings. rz4 RegEx pattern for strings. rzEDeprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead.r z] Parameter field name for discriminating the type in a tagged union. r!zO If `True`, strict validation is applied to the field. r"zW Value must be a multiple of this. Only applicable to numbers. r#zQ Allow `inf`, `-inf`, `nan`. Only applicable to numbers. r$zE Maximum number of allow digits for strings. r%zO Maximum number of decimal places allowed for numbers. r&z8 Example values for this field. r'znDeprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, although still supported. Use examples instead.r(a OpenAPI-specific examples. It will be added to the generated OpenAPI (e.g. visible at `/docs`). Swagger UI (that provides the `/docs` interface) has better support for the OpenAPI-specific examples than the JSON Schema `examples`, that's the main use case for this. Read more about it in the [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter). rz Mark this parameter field as deprecated. It will affect the generated OpenAPI (e.g. visible at `/docs`). r)z To include (or not) this parameter field in the generated OpenAPI. You probably don't need it, but it's available. This affects the generated OpenAPI (e.g. visible at `/docs`). r*z: Any additional JSON schema data. extrazG Include extra fields used by the JSON Schema. z\ The `extra` kwargs is deprecated. Use `json_schema_extra` instead. returnc tjdid|d|d|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|d|d|d|d|d|d|d|d|d||S)a Declare a path parameter for a *path operation*. Read more about it in the [FastAPI docs for Path Parameters and Numeric Validations](https://fastapi.tiangolo.com/tutorial/path-params-numeric-validations/). ```python from typing import Annotated from fastapi import FastAPI, Path app = FastAPI() @app.get("/items/{item_id}") async def read_items( item_id: Annotated[int, Path(title="The ID of the item to get")], ): return {"item_id": item_id} ``` r+rrrrrrrrrrrrrrrr r!r"r#r$r%r'r&r(rr)r*)r Pathr+rrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(rr)r*r,s Y/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/fastapi/param_functions.pyr0r0 s-N ;;  '  &   *   0                 ! "$# $% & ' ($) *+ ,&- ./ 01 2*3 45 6,7 8, ; zJ Default value if the parameter field is not set. c tjdid|d|d|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|d|d|d|d|d|d|d|d|d||SNr+rrrrrrrrrrrrrrrr r!r"r#r$r%r'r&r(rr)r*r/)r Queryr1s r2r6r6Ss-^ <<  '  &   *   0                 ! "$# $% & ' ($) *+ ,&- ./ 01 2*3 45 6,7 8, ; r3)rrrrrconvert_underscoresrrrrrrrrrrr r!r"r#r$r%r&r'r(rr)r*r7a Automatically convert underscores to hyphens in the parameter field name. Read more about it in the [FastAPI docs for Header Parameters](https://fastapi.tiangolo.com/tutorial/header-params/#automatic-conversion) c tjdid|d|d|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|d|d|d|d|d|d|d|d|d|d||S)Nr+rrrrrr7rrrrrrrrrrr r!r"r#r$r%r'r&r(rr)r*r/)r Header)r+rrrrrr7rrrrrrrrrrr r!r"r#r$r%r&r'r(rr)r*r,s r2r9r9s7t ==  '  &   *   0  0               ! "# $$% &' ( ) *$+ ,- .&/ 01 23 4*5 67 8,9 :, = r3c tjdid|d|d|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|d|d|d|d|d|d|d|d|d||Sr5)r Cookier1s r2r;r;s-^ ==  '  &   *   0                 ! "$# $% & ' ($) *+ ,&- ./ 01 2*3 45 6,7 8, ; r3zapplication/json)rembed media_typerrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(rr)r*r<a When `embed` is `True`, the parameter will be expected in a JSON body as a key instead of being the JSON body itself. This happens automatically when more than one `Body` parameter is declared. Read more about it in the [FastAPI docs for Body - Multiple Parameters](https://fastapi.tiangolo.com/tutorial/body-multiple-params/#embed-a-single-body-parameter). r=z The media type of this parameter field. Changing it would affect the generated OpenAPI, but currently it doesn't affect the parsing of the data. c tjdid|d|d|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d||S) Nr+rr<r=rrrrrrrrrrrrrrr r!r"r#r$r%r'r&r(rr)r*r/)r Body)r+rr<r=rrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(rr)r*r,s r2r?r?sAL ;;  '      & * 0              ! "# $% &$' () * + ,$- ./ 0&1 23 45 6*7 89 :,; <, ?  r3z!application/x-www-form-urlencoded)rr=rrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(rr)r*c tjdid|d|d|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|d|d|d|d|d|d|d|d|d|d||SNr+rr=rrrrrrrrrrrrrrr r!r"r#r$r%r'r&r(rr)r*r/)r Formr+rr=rrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(rr)r*r,s r2rBrB87p ;;  '     &   *  0               ! "# $$% &' ( ) *$+ ,- .&/ 01 23 4*5 67 8,9 :, = r3zmultipart/form-datac tjdid|d|d|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|d|d|d|d|d|d|d|d|d|d||SrA)r FilerCs r2rFrFrrDr3) use_cache dependencyz A "dependable" callable (like a function). Don't call it directly, FastAPI will call it for you, just pass the object directly. rGa By default, after a dependency is called the first time in a request, if the dependency is declared again for the rest of the request (for example if the dependency is needed by several dependencies), the value will be re-used for the rest of the request. Set `use_cache` to `False` to disable this behavior and ensure the dependency is called again (if declared more than once) in the same request. c0tj||S)a Declare a FastAPI dependency. It takes a single "dependable" callable (like a function). Don't call it directly, FastAPI will call it for you. Read more about it in the [FastAPI docs for Dependencies](https://fastapi.tiangolo.com/tutorial/dependencies/). **Example** ```python from typing import Annotated from fastapi import Depends, FastAPI app = FastAPI() async def common_parameters(q: str | None = None, skip: int = 0, limit: int = 100): return {"q": q, "skip": skip, "limit": limit} @app.get("/items/") async def read_items(commons: Annotated[dict, Depends(common_parameters)]): return commons ``` rHrG)r DependsrJs r2rKrKsr >>Z9 EEr3)scopesrGrLa OAuth2 scopes required for the *path operation* that uses this Security dependency. The term "scope" comes from the OAuth2 specification, it seems to be intentionally vague and interpretable. It normally refers to permissions, in cases to roles. These scopes are integrated with OpenAPI (and the API docs at `/docs`). So they are visible in the OpenAPI specification. ) c2tj|||S)a Declare a FastAPI Security dependency. The only difference with a regular dependency is that it can declare OAuth2 scopes that will be integrated with OpenAPI and the automatic UI docs (by default at `/docs`). It takes a single "dependable" callable (like a function). Don't call it directly, FastAPI will call it for you. Read more about it in the [FastAPI docs for Security](https://fastapi.tiangolo.com/tutorial/security/) and in the [FastAPI docs for OAuth2 scopes](https://fastapi.tiangolo.com/advanced/security/oauth2-scopes/). **Example** ```python from typing import Annotated from fastapi import Security, FastAPI from .db import User from .security import get_current_active_user app = FastAPI() @app.get("/users/me/items/") async def read_own_items( current_user: Annotated[User, Security(get_current_active_user, scopes=["items"])] ): return [{"item_id": "Foo", "owner": current_user.username}] ``` rHrLrG)r SecurityrNs r2rOrOs` ??j9 UUr3).)N)!typingrrrrrrr fastapir fastapi._compatr fastapi.openapi.modelsr typing_extensionsr rrr__annotations__strintfloatboolr0r6r9r;r?rBrFrKrOr/r3r2rZs+GGG%*88 E.                       "    GE       E hr3w%&     E0       1EH c4i    IE\  c4i    ]En# c4i     oEB       CER     SEb      cEt      uEF      GEV      WEh     iEx     yEH     IEX      S   YEn c4i    oE~  dDj     EN eTk    OE^ dDj    _En c4i    oE~ c4i    ENc    OE^  >  _El c7l#$    mEN j#tT)*     OEb!      cEx! d38nd"#    yEH       IEb cE` m(                       "    Am      m hr3w%&     m*       +mB c4i    CmV  c4i    Wmh# c4i     im|       }mL     Mm\      ]mn      om@      AmP      Qmb     cmr     smB     CmR      S   Smh c4i    imx  dDj     ymH eTk    ImX dDj    Ymh c4i    imx c4i    ymHc    ImX  >  Ymf c7l#$    gmH j#tT)*     Im\!      ]mr! d38nd"#    smB       Cm\ ]mp y(                        "    Wy      y hr3w%&     y*       +yB c4i    CyV  c4i    Wyh# c4i     iy|#      }yR       Syb     cyr      syD      EyV      Wyf      gyx     yyH     IyX     Yyh      S   iy~ c4i    yN  dDj     Oy^ eTk    _yn dDj    oy~ c4i    yN c4i    Oy^c    _yn  >  oy| c7l#$    }y^ j#tT)*     _yr!      syH! d38nd"#    IyX       Yyr syH m(                       "    Am      m hr3w%&     m*       +mB c4i    CmV  c4i    Wmh# c4i     im|       }mL     Mm\      ]mn      om@      AmP      Qmb     cmr     smB     CmR      S   Smh c4i    imx  dDj     ymH eTk    ImX dDj    Ymh c4i    imx c4i    ymHc    ImX  >  Ymf c7l#$    gmH j#tT)*     Im\!      ]mr! d38nd"#    smB       Cm\ ]mp F(                         "    oF      F hr3w%&     F*  dDj     +FF     GFX       YFp c4i    qFD  c4i    EFV# c4i     WFj       kFz     {FJ      KF\      ]Fn      oF~      FP     QF`     aFp     qF@      S   AFV c4i    WFf  dDj     gFv eTk    wFF dDj    GFV c4i    WFf c4i    gFvc    wFF  >  GFT c7l#$    UFv j#tT)*     wFJ!      KF`! d38nd"#    aFp       qFJ  K Fb w(  ,                      "    Sw      w hr3w%&     w*     +w<       =wT c4i    Uwh  c4i    iwz# c4i     {wN       Ow^     _wn      ow@      AwR      Swb      cwt     uwD     EwT     Uwd      S   ewz c4i    {wJ  dDj     KwZ eTk    [wj dDj    kwz c4i    {wJ c4i    KwZc    [wj  >  kwx c7l#$    ywZ j#tT)*     [wn!      owD! d38nd"#    EwT       Uwn owD w(                        "    Sw      w hr3w%&     w*     +w<       =wT c4i    Uwh  c4i    iwz# c4i     {wN       Ow^     _wn      ow@      AwR      Swb      cwt     uwD     EwT     Uwd      S   ewz c4i    {wJ  dDj     KwZ eTk    [wj dDj    kwz c4i    {wJ c4i    KwZc    [wj  >  kwx c7l#$    ywZ j#tT)*     [wn!      owD! d38nd"#    EwT       Uwn owJ 9F4 59F#s(#$     9F      9F6 79FN PV:  WPV#s(#$     PV #     PV<      =PVX YPVr3