python-frameio-client
Frame.io
Frame.io is a cloud-based collaboration hub that allows video professionals to share files, comment on clips real-time, and compare different versions and edits of a clip.
Overview
Installation
via Pip
$ pip install frameioclient
via Source
$ git clone https://github.com/frameio/python-frameio-client
$ pip install .
Developing
Install the package into your development environment and link to it by running the following:
pipenv install -e . -pre
Documentation
Use CLI
When you install this package, a cli tool called fioctl will also be installed to your environment.
To upload a file or folder
fioctl \
--token fio-u-YOUR_TOKEN_HERE \
--destination "YOUR TARGET FRAME.IO PROJECT OR FOLDER" \
--target "YOUR LOCAL SYSTEM DIRECTORY" \
--threads 8
To download a file, project, or folder
fioctl \
--token fio-u-YOUR_TOKEN_HERE \
--destination "YOUR LOCAL SYSTEM DIRECTORY" \
--target "YOUR TARGET FRAME.IO PROJECT OR FOLDER" \
--threads 2
Links
Sphinx Documentation
- https://pythonhosted.org/sphinxcontrib-restbuilder/
- https://www.npmjs.com/package/rst-selector-parser
- https://sphinx-themes.org/sample-sites/furo/_sources/index.rst.txt
- https://developer.mantidproject.org/Standards/DocumentationGuideForDevs.html
- https://sublime-and-sphinx-guide.readthedocs.io/en/latest/code_blocks.html
- https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html
- https://stackoverflow.com/questions/64451966/python-sphinx-how-to-embed-code-into-a-docstring
- https://pythonhosted.org/an_example_pypi_project/sphinx.html
Decorators
- https://docs.python.org/3.7/library/functools.html
- https://realpython.com/primer-on-python-decorators/
- https://www.sphinx-doc.org/en/master/usage/quickstart.html
- https://www.geeksforgeeks.org/decorators-with-parameters-in-python/
- https://stackoverflow.com/questions/43544954/why-does-sphinx-autodoc-output-a-decorators-docstring-when-there-are-two-decora
Usage
Note: A valid token is required to make requests to Frame.io. Go to our Developer Portal to get a token!
In addition to the snippets below, examples are included in /examples.
Get User Info
Get basic info on the authenticated user.
from frameioclient import FrameioClient
client = FrameioClient("TOKEN")
me = client.users.get_me()
print(me['id'])
Create and Upload Asset
Create a new asset and upload a file. For parent_asset_id you must have the root asset ID for the project, or an ID for a folder in the project. For more information on how assets work, check out our docs.
import os
from frameioclient import FrameioClient
client = FrameioClient("TOKEN")
# Create a new asset manually
asset = client.assets.create(
parent_asset_id="1234abcd",
name="MyVideo.mp4",
type="file",
filetype="video/mp4",
filesize=os.path.getsize("sample.mp4")
)
# Create a new folder
client.assets.create(
parent_asset_id="",
name="Folder name",
type="folder" # this kwarg is what makes it a folder
)
# Upload a file
client.assets.upload(destination_id, "video.mp4")
4 Dec 07, 2022
2 Jan 04, 2023
3 Apr 08, 2022
2 Jan 05, 2022
12 Sep 09, 2022
5 Apr 05, 2022
1 Jun 01, 2022
19 Feb 14, 2022
13 May 24, 2021
6 Jun 20, 2022
10 Dec 29, 2022
1 May 20, 2022
22 Nov 12, 2022
29 Apr 23, 2022
4 Aug 02, 2022
1.5k Dec 22, 2022
1 Oct 10, 2021
32 Feb 09, 2022
2 Jan 27, 2022
160 Dec 31, 2022