o ŀgJ-@sDdZddlmZddlmZmZmZddlZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZmZmZmZdd lmZmZmZmZdd lm Z ddl!m"m#Z$ddl%m&Z&er}ddl'm(Z(m)Z)ddlm*Z*ddl+m,Z,dZ-d/ddZ.ddZ/d0ddZ0d1dd Z1 !  !d2d3d)d*Z2d4d-d.Z3dS)5zH Table Schema builders https://specs.frictionlessdata.io/table-schema/ ) annotations) TYPE_CHECKINGAnycastN)lib) ujson_loads) timezones)freq_to_period_freqstr)find_stack_level) _registry) is_bool_dtypeis_integer_dtypeis_numeric_dtypeis_string_dtype)CategoricalDtypeDatetimeTZDtypeExtensionDtype PeriodDtype) DataFrame) to_offset)DtypeObjJSONSerializable)Series) MultiIndexz1.4.0xrreturnstrcCspt|rdSt|r dSt|rdSt|dst|ttfr!dSt|dr)dSt|tr0dSt |r6d SdS) 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 =============== ================= integerbooleannumberMdatetimemdurationanystring) r r rr is_np_dtype isinstancerrrr)rr(P/var/www/html/myenv/lib/python3.10/site-packages/pandas/io/json/_table_schema.pyas_json_table_type5s  r*cCstj|jjr:|jj}t|dkr!|jjdkr!tjdtd|St|dkr8t dd|Dr8tjdtd|S| }|jj dkrOt |jj|j_|S|jjpTd|j_|S)z?Sets index names to 'index' for regular, or 'level_x' for Multiindexz-Index name of 'index' is not round-trippable.) stacklevelcss|]}|dVqdSlevel_N startswith.0rr(r(r) nsz$set_default_names..z>> 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=object) >>> 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]' rDr%objectrrKint64rfloat64rboolr# timedelta64r!rJzdatetime64[ns, ]rHzperiod[zdatetime64[ns]r$rFrGrE)rMrGz#Unsupported or invalid field type: ) getrnr9r rregistryfind ValueError)rStypoffsetfreq_n freq_namerHr(r(r)!convert_json_field_to_pandas_types:)        rfTr?DataFrame | Seriesr,rZ primary_key bool | Noneversionc Cs|durt|}i}g}|r?|jjdkr7td|j|_t|jj|jjD]\}}t|}||d<||q$n|t|j|j dkrU| D] \} } |t| qHn|t|||d<|r|jj r|dur|jjdkrx|jj g|d<n|jj|d<n|dur||d<|rt |d<|S) a Create a Table schema from ``data``. Parameters ---------- data : Series, DataFrame 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 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'}, {'name': 'C', 'type': 'datetime'}], 'primaryKey': ['idx'], 'pandas_version': '1.4.0'} Tr+rr9fieldsN primaryKeypandas_version)rAr,r=rziplevelsr7rUappendndimitems is_uniquer9TABLE_SCHEMA_VERSION) r?r,rhrjschemarklevelr9 new_fieldcolumnsr(r(r)build_table_schemas88    rz precise_floatrcCst||d}dd|ddD}t|d|d|}dd |ddD}d |vr0td ||}d |dvrc||dd }t|jjd krX|jj dkrVd|j_ |Sdd|jjD|j_|S)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 )r{cSsg|]}|dqSr9r(r3rSr(r(r) ksz&parse_table_schema..rurkr?)columnscSsi|] }|dt|qSr|)rfr}r(r(r) ns z&parse_table_schema..r[zs:            0  O \