]jD/`SrSSKJr SSKJrJrJr SSKrSSKJ r SSK J r SSK J r SSKJr SS KJr SS KJr SS KJrJrJrJr SS KJrJrJrJr SS KJ r SSK!J"s J#r$ SSK%J&r& \(aSSK'J(r(J)r) SSKJ*r* SSK+J,r, Sr-SSjr.Sr/SSjr0SSjr1SSSjjr2SSjr3g)zH Table Schema builders https://specs.frictionlessdata.io/table-schema/ ) annotations) TYPE_CHECKINGAnycastN)option_context)lib) ujson_loads) timezones)find_stack_level) _registry) is_bool_dtypeis_integer_dtypeis_numeric_dtypeis_string_dtype)CategoricalDtypeDatetimeTZDtypeExtensionDtype PeriodDtype) DataFrame) to_offset)DtypeObjJSONSerializable)Series) MultiIndexz1.4.0c6[U5(ag[U5(ag[U5(ag[R"US5(d[ U[ [45(ag[R"US5(ag[U5(agg ) a< Convert a NumPy / pandas type to its corresponding json_table. Parameters ---------- x : np.dtype or ExtensionDtype Returns ------- str the Table Schema data types Notes ----- This table shows the relationship between NumPy / pandas dtypes, and Table Schema dtypes. ============== ================= Pandas type Table Schema type ============== ================= int64 integer float64 number bool boolean datetime64[ns] datetime timedelta64[ns] duration object str categorical any =============== ================= integerbooleannumberMdatetimemdurationstringany) rr rr is_np_dtype isinstancerrr)xs Y/home/mande/repo/quber/.venv/lib/python3.13/site-packages/pandas/io/json/_table_schema.pyas_json_table_typer)7sx< q   !   C Jq?K2P$Q$Q C    c[R"URR6(aURRn[ U5S:Xa9URR S:Xa[ R"S[5S9 U$[ U5S:a4[SU55(a[ R"S[5S9 U$URSS9nURRS:a;[R"URR5URlU$URR =(d SURlU$) z?Sets index names to 'index' for regular, or 'level_x' for Multiindexz-Index name of 'index' is not round-trippable.) stacklevelc3B# UHoRS5v M g7f)level_N) startswith).0r's r( $set_default_names..ns!F#Q,,x"8"8#sz * *!JJj Lr*cJUSnUS:XaURSS5$US:XaURSS5$US:XaURSS5$US :XaURSS 5$US :Xag US :Xa_URS5(a SUSS3$URS5(a)[US5n[U5RnSUS3$gUS:Xa?SU;aSU;a[ USSUSS9$SU;a[ R "US5$g[SU35e)a Converts a JSON field descriptor into its corresponding NumPy / pandas type Parameters ---------- field A JSON field descriptor Returns ------- dtype Raises ------ ValueError If the type of the provided field is unknown or currently unsupported Examples -------- >>> convert_json_field_to_pandas_type({"name": "an_int", "type": "integer"}) 'int64' >>> convert_json_field_to_pandas_type( ... { ... "name": "a_categorical", ... "type": "any", ... "constraints": {"enum": ["a", "b", "c"]}, ... "ordered": True, ... } ... ) CategoricalDtype(categories=['a', 'b', 'c'], ordered=True, categories_dtype=str) >>> convert_json_field_to_pandas_type({"name": "a_datetime", "type": "datetime"}) 'datetime64[ns]' >>> convert_json_field_to_pandas_type( ... {"name": "a_datetime_with_tz", "type": "datetime", "tz": "US/Central"} ... ) 'datetime64[ns, US/Central]' rEr#rLNrint64rfloat64rboolr" timedelta64r rKzdatetime64[ns, ]rIzperiod[zdatetime64[ns]r$rGrHrF)rNrHobjectz#Unsupported or invalid field type: )getrr_freqstrrregistryfind ValueError)rUtypoffsetrIs r(!convert_json_field_to_pandas_typergsMR -C hyyT** yyW-- yyY// yyV,,   99T??$U4[M3 3 YYv  uV}-Fv&//DTF!$ $#  E !i5&8# /7yAQ 5 ==z!23 3 :3%@ AAr*cUSLa [U5n0n/nU(aURRS:ax[SUR5Ul[ URR URR SS9H%upg[U5nXxS'URU5 M' O$UR[UR55 URS:a4UR5HupUR[U 55 M! OUR[U55 XTS'U(amURR(aRUcOURRS:XaURR/US'O!URR US'OUbX$S'U(a [US'U$) a  Create a Table schema from ``data``. This method is a utility to generate a JSON-serializable schema representation of a pandas Series or DataFrame, compatible with the Table Schema specification. It enables structured data to be shared and validated in various applications, ensuring consistency and interoperability. Parameters ---------- data : Series or DataFrame The input data for which the table schema is to be created. index : bool, default True Whether to include ``data.index`` in the schema. primary_key : bool or None, default True Column names to designate as the primary key. The default `None` will set `'primaryKey'` to the index level or levels if the index is unique. version : bool, default True Whether to include a field `pandas_version` with the version of pandas that last revised the table schema. This version can be different from the installed pandas version. Returns ------- dict A dictionary representing the Table schema. See Also -------- DataFrame.to_json : Convert the object to a JSON string. read_json : Convert a JSON string to pandas object. Notes ----- See `Table Schema `__ for conversion types. Timedeltas as converted to ISO8601 duration format with 9 decimal places after the seconds field for nanosecond precision. Categoricals are converted to the `any` dtype, and use the `enum` field constraint to list the allowed values. The `ordered` attribute is included in an `ordered` field. Examples -------- >>> from pandas.io.json._table_schema import build_table_schema >>> df = pd.DataFrame( ... {'A': [1, 2, 3], ... 'B': ['a', 'b', 'c'], ... 'C': pd.date_range('2016-01-01', freq='D', periods=3), ... }, index=pd.Index(range(3), name='idx')) >>> build_table_schema(df) {'fields': [{'name': 'idx', 'type': 'integer'}, {'name': 'A', 'type': 'integer'}, {'name': 'B', 'type': 'string', 'extDtype': 'str'}, {'name': 'C', 'type': 'datetime'}], 'primaryKey': ['idx'], 'pandas_version': '1.4.0'} Tr,r)strictr:fields primaryKeypandas_version)rBr-r>rziplevelsr8rXappendndimitems is_uniquer:TABLE_SCHEMA_VERSION) r@r- primary_keyversionschemarjlevelr: new_fieldcolumnss r(build_table_schemar{sbJ } &F F ::   !lDJJ7DJ"4::#4#4djj6F6FtT =eD $(&! i( U MM;DJJG H yy1}IF MM;A> ?&  7=>8 %%+*= ::   "$(JJOO#4F< #'::#3#3F<  *|#7 Mr*c[XS9nUSSVs/sHo3SPM nn[USUS9UnUSSVs0sHnUS[U5_M nnSUR5;a [ S5e[ S S 5 UR U5nS S S 5 S US;aURUSS 5n[URR5S :Xa-URRS:XaS URl U$URRVs/sHowRS5(aS OUPM snURl U$s snfs snf!,(df  N=fs snf)a Builds a DataFrame from a given schema Parameters ---------- json : A JSON table schema precise_float : bool Flag controlling precision when decoding string to double values, as dictated by ``read_json`` Returns ------- df : DataFrame Raises ------ NotImplementedError If the JSON table schema contains either timezone or timedelta data Notes ----- Because :func:`DataFrame.to_json` uses the string 'index' to denote a name-less :class:`Index`, this function sets the name of the returned :class:`DataFrame` to ``None`` when said string is encountered with a normal :class:`Index`. For a :class:`MultiIndex`, the same limitation applies to any strings beginning with 'level_'. Therefore, an :class:`Index` name of 'index' and :class:`MultiIndex` names starting with 'level_' are not supported. See Also -------- build_table_schema : Inverse function. pandas.read_json ) precise_floatrvrjr:r@)columnsr]zrs # )))49  0 4+\0@IB\# f f ff f ! fR@r*