Examples & Tutorials
Files
You can store common files and datasets on Datapane to use in your scripts.
It is often necessary to make use of non-code assets such as datasets, models, or files when generating reports. In many situations, deploying these alongside your script is not ideal.
- 1.If they are deployed on a different cadence to your script; for instance, you want to make use of a model which is trained on a daily cadence, even though the code of your script remains static.
- 2.If they are deployed from a different environment than your script; for instance, you may train a model on Sagemaker and want to use it in your script.
- 3.If they are large, and re-uploading them each time you deploy your script is cumbersome.
For these use-cases, Datapane provides a File API which allows you to upload files from any Python or CLI environment, and access them inside your scripts or through the CLI. See the Python API Docs for more information on using Files.
This feature is only available on Datapane Teams plans at present
CLI
upload
uploadUpload a file and return an id and a url which you can use to retrieve the file.
1
datapane file upload <name> <filename> [--project project-name]
Copied!
download
downloadDownload a file and save it on your local machine.
1
datapane file download <name> <filename> [--project project-name]
Copied!
Python
upload_df, upload_file, upload_obj
upload_df, upload_file, upload_objParameters
All upload methods take the object to upload as the first parameter. Depending on the method, this can be a file path, DataFrame, or a Python object.
All methods have the additional parameters:
Parameter
Description
Required
nameThe value of your variable
True
1
import datapane as dp
2
3
# Upload a DataFrame
4
f = dp.File.upload_df(df, name='my_df')
5
6
# Upload a file
7
f = dp.File.upload_file("~/my_dataset.csv", name='my_ds')
8
9
# Upload an object
10
f = dp.File.upload_obj([1,2,3], name='my_list')
Copied!
download_df, download_file, download_obj
download_df, download_file, download_objDownload a DataFrame, file, or object. All download operations have the following parameters:
Parameter
Description
Required
nameThe name of your file
True
projectThe project to upload the file to.
False
If you want other people inside your organization to run your apps which access a file which you created, you must specify yourself as the
owner in this method. When someone runs your app, it runs under their name, and if you do not set an explicitly specify the owner , it will try and look for the file under their name and fail.1
dp.File.get(name='foo', owner='john')
Copied!
1
import datapane as dp
2
3
# Download a DataFrame
4
file = dp.File.get(name="file_id")
5
6
# Download a DataFrame
7
f = file.download_df()
8
9
# Download a file
10
f = file.download_file("~/my_dataset.csv")
11
12
# Download an object
13
f = file.download_obj()
Copied!
If your teammates within your private workspace want to access your file, they need to specifying the name of the file and project name(provided they are a member of that project) in
project1
file = dp.File.get(name='myfile', owner='john')
2
3
# Retrieve file
4
f = file.download_df() # Or download_file(), download_obj()
Copied!
Now others can use your file for their code!
Last modified 5mo ago