Fastly Python Client
fastly-py is available through pip as the fastly package
There are three simple scripts provided in /bin that can be used for various stand-alone purge operations.
A Note About Authentication
Authenticating with an API Token is shown in the example below. For more information on API Tokens, please see Fastly’s API Token documentation. For more information about authenticating to our API, please see our Authentication section.
Usage
import fastly
api = fastly.API()
api.authenticate_by_key('MYKEY')
api.purge_url('www.example.com', '/some/path')
TODO:
Doc files
Docstrings
Config file
create requirements.txt file
Running Tests
$ python -m test.api_test
Set up environment configuration
We use Python’s os and a .env file to manage environment variables in development and test environments. See the list of required environment variables in the .env.example file in the root directory.
To optionally set values for testing, make a copy of .env.example and name it .env.
cp .env.example .env
# Note:
# If using direnv, you can just use it as a `.envrc` file and not have to `source` it manually.
# Using your favorite editor, update the values of the environment variables in `.env` and then
source .env
Distributing a package
Create a .pypirc file:
$ cat > .pypirc
[distutils]
index-servers =
pypi
[pypi]
repository: https://upload.python.org/legacy/
Install twine:
$ python3 -m pip install --user --upgrade twine
Create a build:
$ python3 setup.py sdist bdist_wheel
Use twine to publish to Pypi:
$ twine upload dist/*
Uploading distributions to https://upload.pypi.org/legacy/
Enter your username: [YOUR_USERNAME]
Enter your password:
Uploading fastly-0.2.3-py3-none-any.whl
100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 13.2k/13.2k [00:02<00:00, 6.40kB/s]
Uploading fastly-0.1.3-py2.7.egg
100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 17.8k/17.8k [00:01<00:00, 12.8kB/s]
Uploading fastly-0.1.3-py3.6.egg
100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 18.3k/18.3k [00:01<00:00, 14.2kB/s]
Uploading fastly-0.2.3.tar.gz
100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 9.25k/9.25k [00:01<00:00, 9.09kB/s]
Builds and uploads to PyPi. More info on this at the python site. You will need to be granted access to the fastly package in order to push.