# EAN-DB Python client
This is a Python client for EAN-DB API.
[EAN-DB](https://ean-db.com) is an online API for product info lookups by EAN / UPC / ISBN.
Product info includes titles in various languages, categories, manufacturer, images and additional metadata.
For more information, please see [API docs](https://ean-db.com/docs) and [Database stats](https://ean-db.com/stats).
## Installation
```commandline
pip install eandb
```
## Usage
### Asynchronous client
```pycon
>>> from eandb.clients.v2 import EandbV2AsyncClient
>>> eandb_client = EandbV2AsyncClient(jwt='YOUR_JWT_GOES_HERE')
>>> response = await eandb_client.get_product('0016065024615')
```
### Synchronous client
```pycon
>>> from eandb.clients.v2 import EandbV2SyncClient
>>> eandb_client = EandbV2SyncClient(jwt='YOUR_JWT_GOES_HERE')
>>> response = eandb_client.get_product('0016065024615')
>>> response
ProductResponse(
balance=100, error=None,
product=Product(
barcode='0016065024615',
titles={'en': 'Pretty Tied Up'},
categories=[
Category(id='855', titles={'en': 'Music & Sound Recordings', ...})
],
manufacturer=Manufacturer(id=None, titles={'de': 'Geffen'}, wikidataId=None),
relatedBrands=[],
images=[Image(url='...')],
metadata=Metadata(
externalIds=None,
generic=Generic(
weight=None,
manufacturerCode=None,
color=None,
ingredients=None,
contributors=[Contributor(names={'en': "Guns N' Roses"}, type='artist')]
),
food=None,
printBook=None,
musicCD=None
)
)
)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ean-db/python-client",
"name": "eandb",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.1",
"maintainer_email": "",
"keywords": "barcode,ean,upc,isbn",
"author": "EAN-DB",
"author_email": "support@ean-db.com",
"download_url": "https://files.pythonhosted.org/packages/8b/bd/cc7e08a401f5e9f247b8e3f449dc2cf4bf42755d136e92bfb7ba3e9dd11a/eandb-0.3.0.tar.gz",
"platform": null,
"description": "# EAN-DB Python client\n\nThis is a Python client for EAN-DB API.\n\n[EAN-DB](https://ean-db.com) is an online API for product info lookups by EAN / UPC / ISBN.\nProduct info includes titles in various languages, categories, manufacturer, images and additional metadata.\n\nFor more information, please see [API docs](https://ean-db.com/docs) and [Database stats](https://ean-db.com/stats).\n\n## Installation\n\n```commandline\npip install eandb\n```\n\n## Usage\n\n### Asynchronous client\n\n```pycon\n>>> from eandb.clients.v2 import EandbV2AsyncClient\n\n>>> eandb_client = EandbV2AsyncClient(jwt='YOUR_JWT_GOES_HERE')\n>>> response = await eandb_client.get_product('0016065024615')\n```\n\n### Synchronous client\n\n```pycon\n>>> from eandb.clients.v2 import EandbV2SyncClient\n\n>>> eandb_client = EandbV2SyncClient(jwt='YOUR_JWT_GOES_HERE')\n>>> response = eandb_client.get_product('0016065024615')\n>>> response\n\nProductResponse(\n balance=100, error=None, \n product=Product(\n barcode='0016065024615', \n titles={'en': 'Pretty Tied Up'}, \n categories=[\n Category(id='855', titles={'en': 'Music & Sound Recordings', ...})\n ],\n manufacturer=Manufacturer(id=None, titles={'de': 'Geffen'}, wikidataId=None),\n relatedBrands=[],\n images=[Image(url='...')], \n metadata=Metadata(\n externalIds=None,\n generic=Generic(\n weight=None,\n manufacturerCode=None,\n color=None,\n ingredients=None,\n contributors=[Contributor(names={'en': \"Guns N' Roses\"}, type='artist')]\n ),\n food=None,\n printBook=None,\n musicCD=None\n )\n )\n)\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python client for EAN-DB API",
"version": "0.3.0",
"project_urls": {
"Homepage": "https://github.com/ean-db/python-client",
"Repository": "https://github.com/ean-db/python-client"
},
"split_keywords": [
"barcode",
"ean",
"upc",
"isbn"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "44d5f6137a087d0f4637c4ed963f9413606f337020dc6b22491f351d12ceaaba",
"md5": "2a5ec90c26308b65f68d0810718e3b93",
"sha256": "1e9f3be8108ba0bc6b082cc6ba128d8b242becbc1426d75a90f3596523b94ddf"
},
"downloads": -1,
"filename": "eandb-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2a5ec90c26308b65f68d0810718e3b93",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1",
"size": 4667,
"upload_time": "2023-11-18T14:30:06",
"upload_time_iso_8601": "2023-11-18T14:30:06.320525Z",
"url": "https://files.pythonhosted.org/packages/44/d5/f6137a087d0f4637c4ed963f9413606f337020dc6b22491f351d12ceaaba/eandb-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8bbdcc7e08a401f5e9f247b8e3f449dc2cf4bf42755d136e92bfb7ba3e9dd11a",
"md5": "39243d77fab779d4e3a7aee99df55da8",
"sha256": "406ab7f987de1362c68a358105d8a8dae6add61fd2e5d90da882a3c7578897f6"
},
"downloads": -1,
"filename": "eandb-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "39243d77fab779d4e3a7aee99df55da8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1",
"size": 3824,
"upload_time": "2023-11-18T14:30:07",
"upload_time_iso_8601": "2023-11-18T14:30:07.939525Z",
"url": "https://files.pythonhosted.org/packages/8b/bd/cc7e08a401f5e9f247b8e3f449dc2cf4bf42755d136e92bfb7ba3e9dd11a/eandb-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-18 14:30:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ean-db",
"github_project": "python-client",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "eandb"
}
JSON
