初次发行
datakick的Python项目详细描述
datakick是Datakick的python包装器。 打开产品数据库API。
用法
安装:
python setup.py install
或
pip install datakick
示例代码:
首先导入模块:
>>>importdatakick
按条形码搜索产品:
>>>gtin14="037000062219">>>product=datakick.find_product(gtin14)>>>print("{} - {}".format(product.brand_name,product.name))'Crest Pro-Health Clean Mint Toothpaste'
搜索带密钥的产品:
>>>products=datakick.search("Toothpaste")>>>forproductinproducts:...print("{} - {}".format(product.brand_name,product.name))'Crest Pro-Health Clean Mint Toothpaste''Sensodyne Fresh Impact Toothpaste'# etc.
在数据库中添加/修改产品:
>>>gtin14="011110491503">>>product=datakick.add_product(...gtin14,brand_name="Big K",name="Diet Cola",size="355mL"...)>>>print("{} - {} - {}".format(...product.brand_name,product.name,product.size)...)'Big K Diet Cola 355mL'
将图像添加到数据库中的产品:
>>>gtin14="011110491503">>>img_path="path/to/your/image/cola.jpg"# only .jpg or .jpeg allowed!>>>img_url=datakick.add_image(gtin14,img_path)>>>print(img_url)'https://d2b9vdin3yve6y.cloudfront.net/1a888191-e530-4d55-a871-00a0994d75c0.jpg'
列出产品(在一页上):
>>>products=datakick.list_products(5)# each page returns 100 products>>>forproductinproducts:...print(product.gtin14)'016000437692''016000439894'# etc.
添加/修改产品的可选参数:
Optional Parameters | Type | Units | Example |
---|---|---|---|
name | string | n/a | “Toothpaste” |
brand_name | string | n/a | “Colgate” |
size | string | n/a | “20oz” |
ingredients | string | n/a | “Milk, Chocolate, Sugar” |
serving_size | string | n/a | “2 tbsp.” |
servings_per_container | string | n/a | “2 cookies” |
calories | int | n/a | 200 |
fat_calories | int | n/a | 100 |
fat | int/float | grams | 10 |
saturated_fat | int/float | grams | 10 |
trans_fat | int/float | grams | 0 |
polyunsaturated_fat | int/float | grams | 5 |
monounsaturated_fat | int/float | grams | 5 |
cholesterol | int | milligrams | 20 |
sodium | int | milligrams | 40 |
potassium | int | milligrams | 60 |
carbohydrate | int | grams | 20 |
fiber | int | grams | 10 |
sugars | int | grams | 6 |
protein | int | grams | 4 |
author | string | n/a | “First M. Last” |
publisher | string | n/a | “MyPublisher” |
pages | int | n/a | 400 |
alcohol_by_volume | int/float | percent | 20 |
例外情况:
- datakick.exceptions.image too large-如果提供给datakick.add_的图像太大(>;1MB)
- datakick.exceptions.invalidimageformat-如果提供给datakick.add_图像的图像的文件格式错误(仅允许.jpg或.jpeg),则将引发此错误。
- requests.exceptions.httperror-如果提供的gtin14无效或在产品数据库中找不到,则将引发该错误。