Registry / http-networking / filestack-python

filestack-python

library4.0.0pypypi✓ verified 86d ago

A Python SDK for the Filestack API, providing file upload, transformation, and delivery services. Version 4.0.0 is the latest major release with async support and reorganized client architecture. Releases are semi-regular with breaking changes between major versions.

http-networking serialization aws

pip install filestack-python

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · FILESTACK-PYTHON

filestack-python

http-networkingpythonv4.0.0

Install

2.2s avg

Import

753ms

Disk

20MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v4.0.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.816s · 21.6MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.2s · import 0.690s · 22MB

20MB installed

● package 20MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FilestackClient

✓ from filestack import Client as FilestackClient

✗ from filestack import FilestackClient

In v4, 'Client' is the primary class, imported from 'filestack' directly, not 'FilestackClient'.

Client

✓ from filestack import Client

Initialize the client with your API key and upload a file.

import os from filestack import Client api_key = os.environ.get('FILESTACK_API_KEY', '') client = Client(api_key) # upload a file filelink = client.upload(filepath='path/to/file.pdf') print(filelink.url)

Debug

Known issues

breakingv4 introduces a breaking change: the module structure changed. 'filestack' now exports 'Client' directly, replacing the old 'FilestackClient' from 'filestack-python' in v3.

fix

Update import: from filestack import Client (instead of from filestack import FilestackClient).

affects: >=4.0.0,<5.0.0

gotchaThe upload method in v4 returns a Filelink object, not a dict. Accessing the URL requires .url attribute.

fix

Use filelink.url instead of filelink['url'].

affects: >=4.0.0

gotchaAPI key is required even for public uploads unless using a security policy. The Client constructor expects the API key as the first positional argument.

fix

Always pass your API key: Client('your-api-key').

affects: all

deprecatedv4 removed the 'Filestack' class and the 'filestack-python' top-level package. Use 'filestack' only.

fix

pip install filestack-python and import from filestack.

affects: >=4.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'filestack'

The package is installed as 'filestack-python' but imported as 'filestack'.

fix

pip install filestack-python and use import filestack. Do not try to import 'filestack-python' directly.

ImportError: cannot import name 'FilestackClient' from 'filestack'

Using old v3 import pattern with v4 installed.

fix

Use: from filestack import Client

TypeError: upload() missing 1 required positional argument: 'filepath'

The upload method requires a filepath or file-like object as first argument.

fix

Provide the filepath argument: client.upload(filepath='path/to/file.pdf')

Upgrade

Version history

4.0.0latest on PyPI · released Sep 17, 2024

Audit

Dependencies

No dependency data recorded yet.

Agent activity

21 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/filestack/filestack-python ↗

packagehttps://pypi.org/project/filestack-python/ ↗

homepagehttps://www.filestack.com ↗