Package: countdowner
Copyright (c) 2017 Alex RaichevPermission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included inall copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS INTHE SOFTWARE.Description-Content-Type: UNKNOWNDescription: Countdowner************.. image:: https://travis-ci.org/araichev/countdowner.svg?branch=master:target: https://travis-ci.org/araichev/countdownerA Python 3.4+ package to check for sales at Countdown grocery stores throughout New Zealand.Pretty rough, but gets the job done.Installation=============``pip install -U git+https://github.com/araichev/countdowner``Usage======Here is a common workflow.#. Get the stock codes of the products you want to watch by searching `the Countdown site <https://shop.countdown.co.nz/>`_.  The stock code of a product is listed in the URL of its details page. For example, the stock code for the product at ``https://shop.countdown.co.nz/Shop/ProductDetails?stockcode=214684&name=colgate-360-toothbrush-medium-whole-mouth-clean`` is ``214684``.#. Put your stock codes into a YAML watchlist along with your email address and a name for the watchlist.  The watchlist ---call it ``watchlist.yaml``--- should have the form::name: my_favoritesemail_addresses:- brainbummer@mailinator.com- rhymedude@mailinator.comproducts: |description,stock_codeorganic cheese,281739GB chocolate,260803Lupi olive oil,701829Earthcare double toilet paper,381895Dijon mustard,700630#. Use the ``countdowner`` library functions as in the IPython notebook at ``ipynb/examples.ipynb`` or run ``countdownit --help`` from the command line for information on the command line tool.  To use the emailing functionality of ``countdowner``, you'll need a (free) `Mailgun account <https://mailgun.com>`_.Authors========- Alex Raichev (2017-05)Notes======- Development status is Alpha- This project uses semantic versioning- I might extend this to New World stores once they roll out `more online shopping <http://www.newworld.co.nz/online-shopping/>`_- Will replace ``grequests`` with a faster asynchronous HTTP requester as soon as someone makes one for ``trio``History========0.3.1, 2017-11-10-------------------- Adapted ``parse_product`` function to Countdown's new HTML page format0.3.0, 2017-10-06-------------------- Changed ``run_pipeline`` API0.2.0, 2017-06-18-------------------- Allowed for multiple email addresses in watchlist- In tests, replaced actual HTTP requests with mock ones0.1.0, 2017-06-04-------------------- Replaced ``curio`` and ``curio-http`` with ``grequests`` for asynchronous requests. The latter is slower but easier to use.- Handled invalid stock codes- Added some automated tests0.0.1, 2017-05-30------------------- First draftPlatform: UNKNOWN