<h1 align="center">
<br>
<img src="https://github.com/jtayped/mercapy/blob/main/images/logo.png?raw=true" alt="mercapy" width="200">
<br>
🛍️ mercapy
<br>
</h1>
<h4 align="center">A Mercadona interface for Python to track product prices, amounts, and more.</h4>
<div align="center">
<a href="https://pypi.org/project/mercapy/">
<img src="https://img.shields.io/pypi/v/mercapy?style=for-the-badge">
</a>
<a href="https://github.com/jtayped/mercapy/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/jtayped/mercapy?style=for-the-badge" alt="License">
</a>
<a href="https://github.com/jtayped/mercapy/issues">
<img src="https://img.shields.io/github/issues/jtayped/mercapy?style=for-the-badge" alt="License">
</a>
<a href="https://www.linkedin.com/in/jtayped/">
<img src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white" alt="LinkedIn">
</a>
</div>
<div align="center">
<a href="#how-to-use">How to use it</a> •
<a href="#related">Related</a>
</div>
## 🔧 How to use it
First of all, install the package using:
```bash
pip install mercapy
```
By initializing the mercadona class, you can search products, recommendations, and new arrivals:
```python
from mercapy import Mercadona
mercadona = Mercadona()
mercadona.search("galletas")
mercadona.get_new_arrivals()
mercadona.get_home_recommendations()
```
Each product has statistics such as:
```python
from mercapy import Product
# Find product by ID
prod = Product("12345")
prod.name # Beer
prod.unit_price # 1.25€
prod.previos_price # 1.95€
prod.is_discounted # True
prod.bulk_price # 7.5€
prod.is_pack # True
prod.weight # 0.5kg
prod.age_check # True
prod.alcohol_by_volume # 3.2%
prod.iva # 21%
```
You can also interact with product photos:
```python
from mercapy import Product
# Find product by ID
prod = Product("12345")
prod.images[0].save("product.png", width=1920, height=1080)
```
More docs coming soon...
<div id="related"></div>
## 🙋♂️ You may also like...
- [📷📱 pygramcore](https://github.com/jtayped/pygramcore) - A simple-to-use Instagram interface for Python using Selenium.
- [🧑💼My Portfolio](https://joeltaylor.business) - Check out my front-end and SEO skills on my Portfolio!
Raw data
{
"_id": null,
"home_page": null,
"name": "mercapy",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "mercadona, api, sdk, data science, prices, information",
"author": "Joel Taylor",
"author_email": "contact@joeltaylor.business",
"download_url": "https://files.pythonhosted.org/packages/13/47/26cacf818b8e60c53a7038719a4ed8685990d58b64ecbc008f9502339ec7/mercapy-1.0.3.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">\n <br>\n <img src=\"https://github.com/jtayped/mercapy/blob/main/images/logo.png?raw=true\" alt=\"mercapy\" width=\"200\">\n <br>\n \ud83d\udecd\ufe0f mercapy\n <br>\n</h1>\n\n<h4 align=\"center\">A Mercadona interface for Python to track product prices, amounts, and more.</h4>\n\n<div align=\"center\">\n <a href=\"https://pypi.org/project/mercapy/\">\n <img src=\"https://img.shields.io/pypi/v/mercapy?style=for-the-badge\">\n </a>\n <a href=\"https://github.com/jtayped/mercapy/blob/main/LICENSE\">\n <img src=\"https://img.shields.io/github/license/jtayped/mercapy?style=for-the-badge\" alt=\"License\">\n </a>\n <a href=\"https://github.com/jtayped/mercapy/issues\">\n <img src=\"https://img.shields.io/github/issues/jtayped/mercapy?style=for-the-badge\" alt=\"License\">\n </a>\n <a href=\"https://www.linkedin.com/in/jtayped/\">\n <img src=\"https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white\" alt=\"LinkedIn\">\n </a>\n</div>\n\n<div align=\"center\">\n <a href=\"#how-to-use\">How to use it</a> \u2022\n <a href=\"#related\">Related</a>\n</div>\n\n## \ud83d\udd27 How to use it\n\nFirst of all, install the package using:\n\n```bash\npip install mercapy\n```\n\nBy initializing the mercadona class, you can search products, recommendations, and new arrivals:\n\n```python\nfrom mercapy import Mercadona\n\nmercadona = Mercadona()\n\nmercadona.search(\"galletas\")\nmercadona.get_new_arrivals()\nmercadona.get_home_recommendations()\n```\n\nEach product has statistics such as:\n\n```python\nfrom mercapy import Product\n\n# Find product by ID\nprod = Product(\"12345\")\n\nprod.name # Beer\nprod.unit_price # 1.25\u20ac\nprod.previos_price # 1.95\u20ac\nprod.is_discounted # True\nprod.bulk_price # 7.5\u20ac\nprod.is_pack # True\nprod.weight # 0.5kg\nprod.age_check # True\nprod.alcohol_by_volume # 3.2%\nprod.iva # 21%\n```\n\nYou can also interact with product photos:\n\n```python\nfrom mercapy import Product\n\n# Find product by ID\nprod = Product(\"12345\")\nprod.images[0].save(\"product.png\", width=1920, height=1080)\n```\n\nMore docs coming soon...\n\n<div id=\"related\"></div>\n\n## \ud83d\ude4b\u200d\u2642\ufe0f You may also like...\n\n- [\ud83d\udcf7\ud83d\udcf1 pygramcore](https://github.com/jtayped/pygramcore) - A simple-to-use Instagram interface for Python using Selenium.\n- [\ud83e\uddd1\u200d\ud83d\udcbcMy Portfolio](https://joeltaylor.business) - Check out my front-end and SEO skills on my Portfolio!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Mercadona interface for Python to track product prices, amounts, and more.",
"version": "1.0.3",
"project_urls": null,
"split_keywords": [
"mercadona",
" api",
" sdk",
" data science",
" prices",
" information"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fe7f21ff7ada5ad0216b2dd0bfae2dc0d491fb2393ffd0ed1cecc400122a3288",
"md5": "a6035f7f4241d91eb7d4ca820ed799d6",
"sha256": "085bcfcd576b1eb4c5656cfdd81cd5efc2dc992e215e789f3bf38a58a56c7d11"
},
"downloads": -1,
"filename": "mercapy-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a6035f7f4241d91eb7d4ca820ed799d6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 12383,
"upload_time": "2024-05-25T14:05:29",
"upload_time_iso_8601": "2024-05-25T14:05:29.321541Z",
"url": "https://files.pythonhosted.org/packages/fe/7f/21ff7ada5ad0216b2dd0bfae2dc0d491fb2393ffd0ed1cecc400122a3288/mercapy-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "134726cacf818b8e60c53a7038719a4ed8685990d58b64ecbc008f9502339ec7",
"md5": "59a04803d9b3f77a522723013a81aad3",
"sha256": "c666920cc20537f85204b61ff1c8656ce49014e8e0c854399a199f849f92524e"
},
"downloads": -1,
"filename": "mercapy-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "59a04803d9b3f77a522723013a81aad3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 10325,
"upload_time": "2024-05-25T14:05:30",
"upload_time_iso_8601": "2024-05-25T14:05:30.901649Z",
"url": "https://files.pythonhosted.org/packages/13/47/26cacf818b8e60c53a7038719a4ed8685990d58b64ecbc008f9502339ec7/mercapy-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-25 14:05:30",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "mercapy"
}
JSON