Metadata-Version: 1.1
Name: yandex-search
Version: 0.3.2
Summary: Yandex search library
Home-page: https://github.com/codinguncut/yandex-search
Author: Johannes Ahlmann
Author-email: johannes@fluquid.com
License: MIT
Description: =============
        Yandex Search
        =============
        
        .. image:: https://img.shields.io/pypi/v/yandex-search.svg
                :target: https://pypi.python.org/pypi/yandex-search
        
        .. image:: https://img.shields.io/travis/fluquid/yandex-search.svg
                :target: https://travis-ci.org/fluquid/yandex-search
        
        .. image:: https://codecov.io/github/fluquid/yandex-search/coverage.svg?branch=master
            :alt: Coverage Status
            :target: https://codecov.io/github/fluquid/yandex-search
        
        .. image:: https://requires.io/github/fluquid/yandex-search/requirements.svg?branch=master
            :alt: Requirements Status
            :target: https://requires.io/github/fluquid/yandex-search/requirements/?branch=master
        
        
        Search library for yandex.ru search engine.
        
        Yandex allows **10,000 searches per day** when registered with a validated (international) mobile number.
        
        Example
        -------
        ::
        
            >>> yandex = yandex_search.Yandex(api_user='asdf', api_key='asdf')
            >>> yandex.search('"Interactive Saudi"').items
            [{
                  "snippet": "Your Software Development Partner In  Saudi   Arabia . Since our early days in 2003, our main goal in  Interactive   Saudi   Arabia  has been: \"To earn customer respect and maintain long-term loyalty\".",
                  "url": "http://www.interactive.sa/en",
                  "title": "Interactive   Saudi   Arabia  Limited",
                  "domain": "www.interactive.sa"
            }]
        
        Getting Started
        ---------------
        * register account: https://passport.yandex.ru/registration
        
          * use google translate addon (right-click "translate page")
        
        * configure yandex: https://xml.yandex.ru/settings.xml
        
          * Navigate to "Settings"
        
              * switch language to english in bottom left (En/Ru)
              * enter email for "Email notifications"
              * set "Search type" to "Worldwide"
              * set "Main IP-address" to your querying machine
              * "I accept the terms of License Agreement"
              * Save
        
          * Navigate to "Test"
        
            * "? user = " is your credentials username
            * "& key = " is your crednetials key
        
        
        Notes
        -----
        * Yandex highlights matching terms, leading to extra whitespace from `' '.join`
        
        Alternatives
        ------------
        * pyyaxml is py2-only and was giving me grief ;)
        
        Documentation
        -------------
        search operators:
        
        * https://yandex.com/support/search/how-to-search/search-operators.html
        
        settings:
        
        * https://xml.yandex.ru/settings.xml
        
        docs:
        
        * https://tech.yandex.ru/xml/doc/dg/concepts/restrictions-docpage/
        * https://yandex.com/support/search/robots/search-api.html
        
        =======
        History
        =======
        
        
        0.3.2 (2017-06-12)
        ------------------
        
        * updated readme to include "accept terms of license agreement"
        
        0.3.0 (2017-06-11)
        ------------------
        
        * better log output for issues with error message code parsing
        
        0.2.0 (unreleased)
        ----------------------
        
        * made it better ;)
        
        0.1.0-dev (unreleased)
        ----------------------
        
        * First release on PyPI.
Keywords: yandex-search
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
