il-supermarket-scraper


Nameil-supermarket-scraper JSON
Version 0.3.8 PyPI version JSON
download
home_pagehttps://github.com/jladan/package_demo
Summarypython package that implement a scraping for israeli supermarket data
upload_time2024-04-18 10:08:16
maintainerNone
docs_urlNone
authorSefi Erlich
requires_pythonNone
licenseMIT
keywords israel israeli scraper supermarket
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
Israel Supermarket Scraper: Clients to download the data published by the supermarkets.
=======================================
This is a scraper for ALL the supermarket chains listed in the GOV.IL site.

שקיפות מחירים (השוואת מחירים) - https://www.gov.il/he/departments/legalInfo/cpfta_prices_regulations




[![Unit & Integration Tests](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/test-suite.yml/badge.svg?event=push)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/test-suite.yml)
[![CodeQL](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/codeql.yml/badge.svg)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/codeql.yml)
[![Pylint](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/pylint.yml/badge.svg)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/pylint.yml)
[![Publish Docker image](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/docker-publish.yml/badge.svg)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/docker-publish.yml)
[![Upload Python Package](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/python-publish.yml/badge.svg)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/python-publish.yml)


----
Scheduled Automatic Testing:
The test-suite is scheduled to run every three days, so you can see if the supermarket chains has chanced something in their interface and the package will not work probably. however, the tests running here are also integration tests with the APIs which may fail.

Status: [![Scheduled Tests](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/test-suite.yml/badge.svg?event=schedule)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/test-suite.yml)

Notice:
- Berekt and Quik are flaky! They will not fail the testing framework, but you can still use them.
- some of the scrapers site are blocked to be accessed from outside of israel. 

--------

 

Got a question?
---------------

You can email me at erlichsefi@gmail.com

If you think you've found a bug:

- Create issue in [issue tracker](https://github.com/erlichsefi/israeli-supermarket-scarpers/issues) to see if
  it's already been reported
- Please consider solving the issue by yourself and creating a pull request.

What is il_supermarket_scarper?
-------------

There are alot of projects in github trying to scrape the supermarket data, most of them are not stable or wasn't updated for a while, it's about time there will be one codebase that does the work completely. 

You only need to run the following code to get all the data currently shared by the supermarkets.

```python
from il_supermarket_scarper import MainScrapperRunner

scraper = MainScrapperRunner()
scraper.run()
```


Please notice!
since new files are constantly uploaded by the supermarket to their site, you will only get the current snapshot. In order to keep geting data, you will need to run this code more the one time to get the newly uploaded files. 

Quick start
-----------

il_supermarket_scarper can be installed using pip:

    python3 -m pip install -U il-supermarket-scraper

If you want to run the latest version of the code, you can install from the
repo directly:

    python3 -m pip install -U git+https://github.com/erlichsefi/israeli-supermarket-scarpers.git
    # or if you don't have 'git' installed
    python3 -m pip install -U https://github.com/erlichsefi/israeli-supermarket-scarpers/master
    


Running Docker
-----------
The docker is designed to run the scaper every 6 hours, (you change the cron expression if you would like, checkout the file 'crontab'), in every itreation the scraper will collect the files avaliabe to download and check if the file alreay exists before fetching it, either by scaning the dump folder, or checking the mongo.


    docker-compose up -d

or if you want to use the existing image from docker hub:

    docker pull erlichsefi/israeli-supermarket-scarpers:latest

Contributing
------------

Help in testing, development, documentation and other tasks is
highly appreciated and useful to the project. There are tasks for
contributors of all experience levels.

If you need help getting started, don't hesitate to contact me.


Development status
------------------

IL SuperMarket Scraper is beta software, as far as i see devlopment stoped until new issues will be found.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/jladan/package_demo",
    "name": "il-supermarket-scraper",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "israel, israeli, scraper, supermarket",
    "author": "Sefi Erlich",
    "author_email": "erlichsefi@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/f6/45/1fe79624b37d74f2924d2e48492fb4b04a439423318b21a874466d2cf382/il_supermarket_scraper-0.3.8.tar.gz",
    "platform": null,
    "description": "\nIsrael Supermarket Scraper: Clients to download the data published by the supermarkets.\n=======================================\nThis is a scraper for ALL the supermarket chains listed in the GOV.IL site.\n\n\u05e9\u05e7\u05d9\u05e4\u05d5\u05ea \u05de\u05d7\u05d9\u05e8\u05d9\u05dd (\u05d4\u05e9\u05d5\u05d5\u05d0\u05ea \u05de\u05d7\u05d9\u05e8\u05d9\u05dd) - https://www.gov.il/he/departments/legalInfo/cpfta_prices_regulations\n\n\n\n\n[![Unit & Integration Tests](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/test-suite.yml/badge.svg?event=push)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/test-suite.yml)\n[![CodeQL](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/codeql.yml/badge.svg)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/codeql.yml)\n[![Pylint](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/pylint.yml/badge.svg)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/pylint.yml)\n[![Publish Docker image](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/docker-publish.yml/badge.svg)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/docker-publish.yml)\n[![Upload Python Package](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/python-publish.yml/badge.svg)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/python-publish.yml)\n\n\n----\nScheduled Automatic Testing:\nThe test-suite is scheduled to run every three days, so you can see if the supermarket chains has chanced something in their interface and the package will not work probably. however, the tests running here are also integration tests with the APIs which may fail.\n\nStatus: [![Scheduled Tests](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/test-suite.yml/badge.svg?event=schedule)](https://github.com/erlichsefi/israeli-supermarket-scarpers/actions/workflows/test-suite.yml)\n\nNotice:\n- Berekt and Quik are flaky! They will not fail the testing framework, but you can still use them.\n- some of the scrapers site are blocked to be accessed from outside of israel. \n\n--------\n\n \n\nGot a question?\n---------------\n\nYou can email me at erlichsefi@gmail.com\n\nIf you think you've found a bug:\n\n- Create issue in [issue tracker](https://github.com/erlichsefi/israeli-supermarket-scarpers/issues) to see if\n  it's already been reported\n- Please consider solving the issue by yourself and creating a pull request.\n\nWhat is il_supermarket_scarper?\n-------------\n\nThere are alot of projects in github trying to scrape the supermarket data, most of them are not stable or wasn't updated for a while, it's about time there will be one codebase that does the work completely. \n\nYou only need to run the following code to get all the data currently shared by the supermarkets.\n\n```python\nfrom il_supermarket_scarper import MainScrapperRunner\n\nscraper = MainScrapperRunner()\nscraper.run()\n```\n\n\nPlease notice!\nsince new files are constantly uploaded by the supermarket to their site, you will only get the current snapshot. In order to keep geting data, you will need to run this code more the one time to get the newly uploaded files. \n\nQuick start\n-----------\n\nil_supermarket_scarper can be installed using pip:\n\n    python3 -m pip install -U il-supermarket-scraper\n\nIf you want to run the latest version of the code, you can install from the\nrepo directly:\n\n    python3 -m pip install -U git+https://github.com/erlichsefi/israeli-supermarket-scarpers.git\n    # or if you don't have 'git' installed\n    python3 -m pip install -U https://github.com/erlichsefi/israeli-supermarket-scarpers/master\n    \n\n\nRunning Docker\n-----------\nThe docker is designed to run the scaper every 6 hours, (you change the cron expression if you would like, checkout the file 'crontab'), in every itreation the scraper will collect the files avaliabe to download and check if the file alreay exists before fetching it, either by scaning the dump folder, or checking the mongo.\n\n\n    docker-compose up -d\n\nor if you want to use the existing image from docker hub:\n\n    docker pull erlichsefi/israeli-supermarket-scarpers:latest\n\nContributing\n------------\n\nHelp in testing, development, documentation and other tasks is\nhighly appreciated and useful to the project. There are tasks for\ncontributors of all experience levels.\n\nIf you need help getting started, don't hesitate to contact me.\n\n\nDevelopment status\n------------------\n\nIL SuperMarket Scraper is beta software, as far as i see devlopment stoped until new issues will be found.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "python package that implement a scraping for israeli supermarket data",
    "version": "0.3.8",
    "project_urls": {
        "Homepage": "https://github.com/jladan/package_demo"
    },
    "split_keywords": [
        "israel",
        " israeli",
        " scraper",
        " supermarket"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3c8ffa208a02870d5b9afcf92f12169388036ea4372430112ce95597972690b3",
                "md5": "b18e230371398769a6c77d48a949c420",
                "sha256": "b0202b27c4a866b5e6bb55be00bc31d90989cb38194623824cb1dde6aeadd049"
            },
            "downloads": -1,
            "filename": "il_supermarket_scraper-0.3.8-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b18e230371398769a6c77d48a949c420",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 47414,
            "upload_time": "2024-04-18T10:08:14",
            "upload_time_iso_8601": "2024-04-18T10:08:14.845395Z",
            "url": "https://files.pythonhosted.org/packages/3c/8f/fa208a02870d5b9afcf92f12169388036ea4372430112ce95597972690b3/il_supermarket_scraper-0.3.8-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f6451fe79624b37d74f2924d2e48492fb4b04a439423318b21a874466d2cf382",
                "md5": "824d751ed7ae818e73851fd9ca6db165",
                "sha256": "7fb9298846ce620d4f0a4d385d25f9437fd0be9eba77b18a39a9b54a6ffb4c57"
            },
            "downloads": -1,
            "filename": "il_supermarket_scraper-0.3.8.tar.gz",
            "has_sig": false,
            "md5_digest": "824d751ed7ae818e73851fd9ca6db165",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 31527,
            "upload_time": "2024-04-18T10:08:16",
            "upload_time_iso_8601": "2024-04-18T10:08:16.951464Z",
            "url": "https://files.pythonhosted.org/packages/f6/45/1fe79624b37d74f2924d2e48492fb4b04a439423318b21a874466d2cf382/il_supermarket_scraper-0.3.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-18 10:08:16",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jladan",
    "github_project": "package_demo",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "il-supermarket-scraper"
}
        
Elapsed time: 0.23469s