civis.io.dataframe_to_file

civis.io.dataframe_to_file(df, name='data.csv', expires_at='DEFAULT', description=None, client=None, **to_csv_kws)

Store a DataFrame as a CSV in Civis Platform

Parameters:

dfDataFrame

The table to upload.

namestr, optional

The name of the Civis File

expires_atstr, optional

The date and time the file will expire. If not specified, the file will expire in 30 days. To specify a date and time, format it by the ISO 8601 standard (e.g., "2020-12-31", "2020-12-31T23:03:40Z"), or equivalently, the returned value of the isoformat() method from a datetime.date or datetime.datetime object. To keep a file indefinitely, specify None.

descriptionstr, optional

Description (max length: 512 characters) of the file object.

clientcivis.APIClient, optional

If not provided, an civis.APIClient object will be created from the CIVIS_API_KEY.

**to_csv_kws

Additional keyword parameters will be passed directly to to_csv().

Returns:

file_idint

The integer ID of the new Civis File object

Raises:

ValueError

If description is provided and it’s longer than 512 characters.

See also

file_to_civis()

to_csv()