Name | netlify-python JSON |
Version |
0.3.2
JSON |
| download |
home_page | None |
Summary | Bare-bones python library for the official Netlify API |
upload_time | 2025-02-14 21:46:29 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.10 |
license | MIT |
keywords |
http
netlify
client-library
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# Netlify Python Client SDK

[](https://github.com/cbrews/netlify-python/actions/workflows/ci.yml)


This is a work in progress package designed to wrap the [Netlify APIs](https://docs.netlify.com/api/get-started/) for python client users.
Note that this library is in pre-release and the APIs may be changed in later versions.
## User Guide
This section is intended for developers who want to use the library to make requests to Netlify.
### Installation
⚠ `netlify-python` currently supports python 3.10+.
Recommended installation through [PIP](https://pypi.org/project/netlify-python/) via pypi.
```shell
$ pip install netlify-python
```
### Usage
This client currently only supports [Personal Access Tokens](https://app.netlify.com/user/applications#personal-access-tokens). Navigate to User Settings > Applications > Personal Access Tokens and create a new access token. This is the token you'll use in your initialization of the client.
This created a client that can send http requests.
```python
from netlify import NetlifyClient
client = NetlifyClient(access_token="my-access-token")
client.get_current_user() # Get current user information
client.create_site_deploy('site-id', 'path/to/zip/file.zip')
```
### API
⚠ This client is currently expanding its API support, more documentation coming soon here.
## For Developers
This section is for developers who want to improve this library. The default development version is on 3.10.4 but we are currently supporting all python versions >= 3.10
### Development Dependencies
Make sure that you have [`pyenv`](https://github.com/pyenv/pyenv). You can test this by checking your python version after opening this directory.
```bash
$ python --version
Python 3.10.4
```
Make sure your active python version has `virtualenv` setup via:
```bash
$ python -m pip install virtualenv
```
Create and activate your venv
```bash
$ python -m venv venv
$ . venv/bin/activate
```
### Starting development
Everything here out should be in the venv.
Install your dependencies:
```bash
$ pip install .[dev]
```
Setup pre-commits:
```bash
$ pre-commit install
```
You should be good to go now.
### Building the package
Get your build dependencies in place:
```bash
$ pip install .[build]
```
Then build the package:
```bash
$ python -m build
```
Raw data
{
"_id": null,
"home_page": null,
"name": "netlify-python",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "http, netlify, client-library",
"author": null,
"author_email": "Chris Brousseau <cbrews@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/13/63/8af77b9dcc0ccc03481944f76da1f6c8c11f99b053883a57b9135d657be5/netlify_python-0.3.2.tar.gz",
"platform": null,
"description": "# Netlify Python Client SDK\n\n\n[](https://github.com/cbrews/netlify-python/actions/workflows/ci.yml)\n\n\n\nThis is a work in progress package designed to wrap the [Netlify APIs](https://docs.netlify.com/api/get-started/) for python client users.\n\nNote that this library is in pre-release and the APIs may be changed in later versions.\n\n## User Guide\n\nThis section is intended for developers who want to use the library to make requests to Netlify.\n\n### Installation\n\n\u26a0 `netlify-python` currently supports python 3.10+.\n\nRecommended installation through [PIP](https://pypi.org/project/netlify-python/) via pypi.\n\n```shell\n$ pip install netlify-python\n```\n\n### Usage\n\nThis client currently only supports [Personal Access Tokens](https://app.netlify.com/user/applications#personal-access-tokens). Navigate to User Settings > Applications > Personal Access Tokens and create a new access token. This is the token you'll use in your initialization of the client.\n\nThis created a client that can send http requests.\n\n```python\nfrom netlify import NetlifyClient\n\nclient = NetlifyClient(access_token=\"my-access-token\")\n\nclient.get_current_user() # Get current user information\nclient.create_site_deploy('site-id', 'path/to/zip/file.zip')\n```\n\n### API\n\n\u26a0 This client is currently expanding its API support, more documentation coming soon here.\n\n## For Developers\n\nThis section is for developers who want to improve this library. The default development version is on 3.10.4 but we are currently supporting all python versions >= 3.10\n\n### Development Dependencies\n\nMake sure that you have [`pyenv`](https://github.com/pyenv/pyenv). You can test this by checking your python version after opening this directory.\n\n```bash\n$ python --version\nPython 3.10.4\n```\n\nMake sure your active python version has `virtualenv` setup via:\n\n```bash\n$ python -m pip install virtualenv\n```\n\nCreate and activate your venv\n```bash\n$ python -m venv venv\n$ . venv/bin/activate\n```\n\n### Starting development\n\nEverything here out should be in the venv.\n\nInstall your dependencies:\n```bash\n$ pip install .[dev]\n```\n\nSetup pre-commits:\n```bash\n$ pre-commit install\n```\n\nYou should be good to go now.\n\n### Building the package\nGet your build dependencies in place:\n\n```bash\n$ pip install .[build]\n```\n\nThen build the package:\n```bash\n$ python -m build\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Bare-bones python library for the official Netlify API",
"version": "0.3.2",
"project_urls": null,
"split_keywords": [
"http",
" netlify",
" client-library"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "20221910bbf3662be66cf07be094077f355ef89e2f44abd99dd2909c6c320736",
"md5": "5ff3b93f53bd1f0aad740b5f92647d9f",
"sha256": "f2655ed28cb1332fa3334b8d22530300a46a5998f75994662212ae521210f3f3"
},
"downloads": -1,
"filename": "netlify_python-0.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5ff3b93f53bd1f0aad740b5f92647d9f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 9263,
"upload_time": "2025-02-14T21:46:27",
"upload_time_iso_8601": "2025-02-14T21:46:27.329558Z",
"url": "https://files.pythonhosted.org/packages/20/22/1910bbf3662be66cf07be094077f355ef89e2f44abd99dd2909c6c320736/netlify_python-0.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "13638af77b9dcc0ccc03481944f76da1f6c8c11f99b053883a57b9135d657be5",
"md5": "bee737f5823e87820c0858772dc45fc2",
"sha256": "5fc54513c743dcafd471ec9a4e716940fe4cd92e671e074f04acbd738cab2ba8"
},
"downloads": -1,
"filename": "netlify_python-0.3.2.tar.gz",
"has_sig": false,
"md5_digest": "bee737f5823e87820c0858772dc45fc2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 10981,
"upload_time": "2025-02-14T21:46:29",
"upload_time_iso_8601": "2025-02-14T21:46:29.269574Z",
"url": "https://files.pythonhosted.org/packages/13/63/8af77b9dcc0ccc03481944f76da1f6c8c11f99b053883a57b9135d657be5/netlify_python-0.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-14 21:46:29",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "netlify-python"
}