vtexpy


Namevtexpy JSON
Version 0.0.0b36 PyPI version JSON
download
home_pagehttps://github.com/lvieirajr/vtex-python
SummaryUnofficial VTEX API's Python SDK
upload_time2024-11-30 04:01:02
maintainerLuis Vieira
docs_urlNone
authorLuis Vieira
requires_python<3.14,>=3.9
licenseApache
keywords vtex sdk client api
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # VTEXPY
[![PyPI Version](https://img.shields.io/pypi/v/vtexpy.svg)](https://pypi.python.org/pypi/vtexpy)

## Unofficial VTEX API's Python SDK

VTEXPY is an unofficial Python SDK designed to facilitate integration with the VTEX API.

Even though it is still tagged as beta, vtexpy has been in use by a _SaaS_ company in a
production environment for over a year, making millions of requests a day to the VTEX
API. The only reason why it is tagged as beta is that it is still under heavy
development and breaking changes are expected on the external API.

### Features

- Easy to use Python interface for calling VTEX API endpoints
- Response format standardization
- Custom exception handling
- Automatic request retrying
- Request logging

### Getting Started

#### Requirements

- Python >= 3.9, < 3.14

#### Installation

```bash
pip install vtexpy
```

#### Usage

If the API you want to call is not yet implemented, feel free to create an issue on the
VTEXPY Github repository and request it to be added.

```python
from vtex import VTEX, VTEXConfig

# Instantiate your VTEX API configuration:
vtex_config = VTEXConfig(
    account_name="<ACCOUNT_NAME>",
    app_key="<APP_KEY>",
    app_token="<APP_TOKEN>",
    # Other arguments such as: retrying, logging, etc...
)

# Instantiate the VTEX client with your configuration:
vtex_client = VTEX(config=vtex_config)

# Call one of the available APIs, e.g.:
account_response = vtex_client.license_manager.get_account()
list_sku_ids_response = vtex_client.catalog.list_sku_ids(page=1, page_size=1000)
list_orders_response = vtex_client.orders.list_orders(page=1, page_size=100)

# If the API you want to call is not yet implemented you can use the `custom` API.
response = vtex_client.custom.request(
    method="GET",
    environment="vtexcommercestable",
    endpoint="/api/catalog_system/pvt/commercialcondition/list",
    # Other arguments such as: query params, headers, json data, response class, etc...
)
```


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/lvieirajr/vtex-python",
    "name": "vtexpy",
    "maintainer": "Luis Vieira",
    "docs_url": null,
    "requires_python": "<3.14,>=3.9",
    "maintainer_email": "lvieira@lvieira.com",
    "keywords": "vtex, sdk, client, api",
    "author": "Luis Vieira",
    "author_email": "lvieira@lvieira.com",
    "download_url": "https://files.pythonhosted.org/packages/31/b3/e3f818d8ffe3af4ce2572148df517c1fca4d7b8aef2471986caa33ab22b8/vtexpy-0.0.0b36.tar.gz",
    "platform": null,
    "description": "# VTEXPY\n[![PyPI Version](https://img.shields.io/pypi/v/vtexpy.svg)](https://pypi.python.org/pypi/vtexpy)\n\n## Unofficial VTEX API's Python SDK\n\nVTEXPY is an unofficial Python SDK designed to facilitate integration with the VTEX API.\n\nEven though it is still tagged as beta, vtexpy has been in use by a _SaaS_ company in a\nproduction environment for over a year, making millions of requests a day to the VTEX\nAPI. The only reason why it is tagged as beta is that it is still under heavy\ndevelopment and breaking changes are expected on the external API.\n\n### Features\n\n- Easy to use Python interface for calling VTEX API endpoints\n- Response format standardization\n- Custom exception handling\n- Automatic request retrying\n- Request logging\n\n### Getting Started\n\n#### Requirements\n\n- Python >= 3.9, < 3.14\n\n#### Installation\n\n```bash\npip install vtexpy\n```\n\n#### Usage\n\nIf the API you want to call is not yet implemented, feel free to create an issue on the\nVTEXPY Github repository and request it to be added.\n\n```python\nfrom vtex import VTEX, VTEXConfig\n\n# Instantiate your VTEX API configuration:\nvtex_config = VTEXConfig(\n    account_name=\"<ACCOUNT_NAME>\",\n    app_key=\"<APP_KEY>\",\n    app_token=\"<APP_TOKEN>\",\n    # Other arguments such as: retrying, logging, etc...\n)\n\n# Instantiate the VTEX client with your configuration:\nvtex_client = VTEX(config=vtex_config)\n\n# Call one of the available APIs, e.g.:\naccount_response = vtex_client.license_manager.get_account()\nlist_sku_ids_response = vtex_client.catalog.list_sku_ids(page=1, page_size=1000)\nlist_orders_response = vtex_client.orders.list_orders(page=1, page_size=100)\n\n# If the API you want to call is not yet implemented you can use the `custom` API.\nresponse = vtex_client.custom.request(\n    method=\"GET\",\n    environment=\"vtexcommercestable\",\n    endpoint=\"/api/catalog_system/pvt/commercialcondition/list\",\n    # Other arguments such as: query params, headers, json data, response class, etc...\n)\n```\n\n",
    "bugtrack_url": null,
    "license": "Apache",
    "summary": "Unofficial VTEX API's Python SDK",
    "version": "0.0.0b36",
    "project_urls": {
        "Documentation": "https://github.com/lvieirajr/vtex-python",
        "Homepage": "https://github.com/lvieirajr/vtex-python",
        "Repository": "https://github.com/lvieirajr/vtex-python"
    },
    "split_keywords": [
        "vtex",
        " sdk",
        " client",
        " api"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "47317acb5802770b6831d65235ea29fc41e0a6fa7a4133c200c4ec1185a1118f",
                "md5": "25de1f0ee7c4078021e486c8c77bef02",
                "sha256": "91203b1398d3b737cbcfceb95b26d72a693c27d9fb3b47c35518e4e0da56ae02"
            },
            "downloads": -1,
            "filename": "vtexpy-0.0.0b36-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "25de1f0ee7c4078021e486c8c77bef02",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.14,>=3.9",
            "size": 29224,
            "upload_time": "2024-11-30T04:01:00",
            "upload_time_iso_8601": "2024-11-30T04:01:00.034955Z",
            "url": "https://files.pythonhosted.org/packages/47/31/7acb5802770b6831d65235ea29fc41e0a6fa7a4133c200c4ec1185a1118f/vtexpy-0.0.0b36-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "31b3e3f818d8ffe3af4ce2572148df517c1fca4d7b8aef2471986caa33ab22b8",
                "md5": "5ffcceca85442aed538f50b5cd18efe3",
                "sha256": "345a276cdc61041a02604d57747b00f1e60f79ebd5fb233805afa58f58f83a79"
            },
            "downloads": -1,
            "filename": "vtexpy-0.0.0b36.tar.gz",
            "has_sig": false,
            "md5_digest": "5ffcceca85442aed538f50b5cd18efe3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.14,>=3.9",
            "size": 21517,
            "upload_time": "2024-11-30T04:01:02",
            "upload_time_iso_8601": "2024-11-30T04:01:02.912091Z",
            "url": "https://files.pythonhosted.org/packages/31/b3/e3f818d8ffe3af4ce2572148df517c1fca4d7b8aef2471986caa33ab22b8/vtexpy-0.0.0b36.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-30 04:01:02",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "lvieirajr",
    "github_project": "vtex-python",
    "github_not_found": true,
    "lcname": "vtexpy"
}
        
Elapsed time: 0.39495s