From 91e39e825b17629b4f68e1668082f846e5304b55 Mon Sep 17 00:00:00 2001 From: Dmitry Pimenov Date: Tue, 2 Jan 2024 17:19:35 -0800 Subject: [PATCH 1/2] minor tweaks to the readme descriptions (#10) --- README.md | 29 ++++++++++++++++------------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 34a0c6c..5bd81ef 100644 --- a/README.md +++ b/README.md @@ -3,13 +3,15 @@ [![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-SDK%20generated%20by%20Fern-brightgreen)](https://github.com/fern-api/fern) [![pypi](https://img.shields.io/pypi/v/webflow.svg)](https://pypi.python.org/pypi/webflow) -The Webflow Python Library provides convenient access to the Webflow API from -applications written in Python. The library includes type definitions for all +The Webflow Python Library provides convenient access to the [Webflow Data API](https://developers.webflow.com/reference/rest-introduction) from +applications written in Python. + +The library includes type definitions for all request and response fields, and offers both synchronous and asynchronous clients powered by httpx. ## Documentation -API reference documentation is available [here](https://developers.webflow.com/reference/designer-api-reference). +Explore the API reference documentation [here](https://developers.webflow.com/reference/rest-introduction). ## Installation @@ -53,12 +55,12 @@ asyncio.run(main()) ## OAuth -To implement OAuth, you'll need a registred Webflow App. +To implement OAuth, you'll need to [register a Webflow App in your Workspace](https://developers.webflow.com/reference/authorization) ### Step 1: Authorize URL -The first step in OAuth is to generate an authorization url. Use this URL -to fetch your authorization code. See the [docs](https://docs.developers.webflow.com/v1.0.0/docs/oauth#user-authorization) +The first step in OAuth is to generate an Authorization URL. Use this URL +to fetch your Authorization Code. See the [docs](https://docs.developers.webflow.com/v1.0.0/docs/oauth#user-authorization) for more details. ```python @@ -90,7 +92,7 @@ access_token = get_access_token( ``` ### Step 3: Instantiate the client -Instantiate the client using your access_token. +Instantiate the client using your `access_token`. ```python from webflow.client import Webflow @@ -101,13 +103,13 @@ client = Webflow( ``` ## Webflow Module -All of the models are nested within the Webflow module. Let Intellisense +All of the models are nested within the Webflow module. Let IntelliSense guide you! ![Alt text](assets/module.png) ## Exception Handling -All errors thrown by the SDK will be sublcasses of [`ApiError`](./src/webflow/core/api_error.py). +All errors thrown by the SDK will be subclasses of [`ApiError`](./src/webflow/core/api_error.py). ```python import webflow @@ -138,7 +140,7 @@ client = Webflow( ``` ### Custom HTTP client -You can override the httpx client to customize it for your use case. Some common use-cases +You can override the httpx client to customize it for your use-case. Some common use-cases include support for proxies and transports. ```python @@ -156,9 +158,10 @@ client = Webflow( ## Beta Status -This SDK is in beta, and there may be breaking changes between versions without a major -version update. Therefore, we recommend pinning the package version to a specific version. -This way, you can install the same version each time without breaking changes. +This SDK is in **Preview**, and there may be breaking changes between versions without a major +version update. + +To ensure a reproducible environment (and minimize risk of breaking changes), we recommend pinning a specific package version. ## Contributing From 29c737699f9af252851a88cdfa17aad57ffb4eb3 Mon Sep 17 00:00:00 2001 From: fern <126544928+fern-bot@users.noreply.github.com> Date: Thu, 22 Feb 2024 10:15:51 -0800 Subject: [PATCH 2/2] (release): Release 1.0.0 of Python SDK (#11) --- pyproject.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index 9750e6b..f2f2fcc 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "webflow" -version = "0.1.0b2" +version = "1.0.0" description = "" readme = "README.md" authors = []