A Python SDK for ScreenshotOne.com API to take screenshots of URLs, render HTML as images and PDF
Project description
pythonsdk
An official Python SDK for ScreenshotOne.com API to take screenshots of URLs, render HTML as images and PDF.
It takes minutes to start taking screenshots. Just sign up to get access and secret keys, import the client, and you are ready to go.
The SDK client is synchronized with the latest screenshot API options.
Installation
pip install screenshotone
Usage
Generate a screenshot URL without executing the request. Or download the screenshot. It is up to you:
import shutil
from screenshotone import Client, TakeOptions
# create API client
client = Client('<your access key>', '<your secret key>')
# set up options
options = (TakeOptions.url('https://screenshotone.com')
.format("png")
.viewport_width(1024)
.viewport_height(768)
.block_cookie_banners(True)
.block_chats(True))
# generate the screenshot URL and share it with a user
url = client.generate_take_url(options)
# expected output: https://api.screenshotone.com/take?url=https%3A%2F%2Fscreenshotone.com&viewport_width=1024&viewport_height=768&block_cookie_banners=True&block_chats=True&access_key=<your access key>&signature=6afc9417a523788580fa01a9f668ea82c78a9d2b41441d2a696010bf2743170f
# or render a screenshot and download the image as stream
image = client.take(options)
# store the screenshot the example.png file
with open('example.png', 'wb') as result_file:
shutil.copyfileobj(image, result_file)
Release
Github Actions is used to automate the release process and publishing to PyPI. Update the library version in pyproject.toml
and create a new release to launch the publish
workflow.
License
screenshotone/pythonsdk
is released under the MIT license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for screenshotone-0.0.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3a5bec8f69bf24ec33e055926d112a00cc4c9fbf08247692e9cd16ae3bd62b9e |
|
MD5 | 139e7ece5c9a03ec8441b3b62874b3a7 |
|
BLAKE2b-256 | d5d8944c1dd17e779a3a237691b9b5da6a92f443c2f8dc74e0f216038baf8503 |