{ "info": { "author": "Makoto Fujimoto", "author_email": "makoto@makoto.io", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Internet :: WWW/HTTP :: Indexing/Search", "Topic :: Software Development :: Libraries", "Topic :: Utilities" ], "description": "Poogle\n======\n\n|Build Status| |Coverage Status| |Code Health|\n\nPoogle is a Google scraping library and command line utility for Python.\n\nCurrently, it only offers the ability to scrape Google search results.\nFuture functionality will enable retrieving of image links, similar\nsearch queries, and even the ability to retrieve direct answers to\nquestions you can ask Google.\n\nInstallation\n------------\n\nTo install Poogle, simply:\n\n::\n\n $ pip install poogle\n\nUsage\n-----\n\nPoogle provides both a librry for use in your own Python applications,\nas well as a CLI utility for executing search queries in the command\nline.\n\nLibrary\n~~~~~~~\n\ngoogle\\_search()\n^^^^^^^^^^^^^^^^\n\nUsing the Poogle search library is pretty straightforward. If you all\nyou want is a set number of Google search results returned in list\nformat, use the ``google_search`` function,\n\n.. code:: python\n\n from poogle import google_search\n\n results = google_search('Python', results=2)\n for result in results:\n print(result.title)\n print(result.url.as_string() + '\\n')\n\nThe above code will result in output like the following:\n\n::\n\n Welcome to Python.org\n https://www.python.org/\n\n Python (programming language) - Wikipedia, the free encyclopedia\n https://en.wikipedia.org/wiki/Python_(programming_language)\n\nURL's are returned as `Yurl `__\nobjects out of the box.\n\nPoogle\n^^^^^^\n\nFor more advanced usage, you will want to work with the Poogle class\nobject directly.\n\n.. code:: python\n\n from poogle import Poogle\n\n search = Poogle('Python', per_page=10, start_page=1, lazy=True)\n\n print(search.total_results) # Estimated number of total search results reported by Google\n print(search.results)\n\n print(search.next_page()) # Returns an object containing the search results for the next page only\n print(search.results)\n\nThe above code will result in output like the following:\n\n::\n\n 159000000\n\n [, , , , , ]\n\n \n\n [, , , , , , ,\n , , , , , , , ]\n\nThe only major difference between using the google\\_search() function\nand the Poogle class object at the moment is the ability to fetch more\nsearch result pages after a query has already been executed.\n\nCLI\n~~~\n\nFor documentation on how to use the Poogle command line utility, run\n``poogle --help``.\n\nThe only command available at the moment is ``search``,\n\n::\n\n Usage: poogle search [OPTIONS] QUERY\n\n Execute a Google search query and display the results\n\n Options:\n -r, --results INTEGER The number of search results to retrieve\n --plain Disables bolding and keyword highlighting\n --help Show this message and exit.\n\nUsing it is pretty straightfoward. Just be sure to quote your search\nquery if it contains more than one word.\n\n::\n\n $ poogle search -r 2 \"Python\"\n Executing search query for Python\n\n Welcome to Python.org\n ==============================\n https://www.python.org/\n\n Python (programming language) - Wikipedia, the free encyclopedia\n ==============================\n https://en.wikipedia.org/wiki/Python_(programming_language)\n\n.. |Build Status| image:: https://travis-ci.org/FujiMakoto/Poogle.svg?branch=master\n :target: https://travis-ci.org/FujiMakoto/Poogle\n.. |Coverage Status| image:: https://coveralls.io/repos/FujiMakoto/Poogle/badge.svg?branch=master&service=github\n :target: https://coveralls.io/github/FujiMakoto/Poogle?branch=master\n.. |Code Health| image:: https://landscape.io/github/FujiMakoto/Poogle/master/landscape.svg?style=flat\n :target: https://landscape.io/github/FujiMakoto/Poogle/master", "description_content_type": null, "docs_url": null, "download_url": null, "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/FujiMakoto/Poogle", "keywords": "google,web search,search engine", "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "Poogle", "package_url": "https://pypi.org/project/Poogle/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/Poogle/", "project_urls": { "Homepage": "https://github.com/FujiMakoto/Poogle" }, "release_url": "https://pypi.org/project/Poogle/0.1.0/", "requires_dist": null, "requires_python": null, "summary": "Poogle is a Google scraping library and command line utility for Python.", "version": "0.1.0" }, "last_serial": 1840593, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "1631667486ef65cd695e9930895fd6a1", "sha256": "2596d62d78df0019ab847f1856b924086b465d869c6f5df514b83197a5d0dd0f" }, "downloads": -1, "filename": "Poogle-0.1.0.tar.gz", "has_sig": false, "md5_digest": "1631667486ef65cd695e9930895fd6a1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7744, "upload_time": "2015-11-30T22:51:04", "url": "https://files.pythonhosted.org/packages/85/1b/2854b5b0a832bb1041c57b986f2d84ee929fe893dd1166f89ebb90a3a994/Poogle-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1631667486ef65cd695e9930895fd6a1", "sha256": "2596d62d78df0019ab847f1856b924086b465d869c6f5df514b83197a5d0dd0f" }, "downloads": -1, "filename": "Poogle-0.1.0.tar.gz", "has_sig": false, "md5_digest": "1631667486ef65cd695e9930895fd6a1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7744, "upload_time": "2015-11-30T22:51:04", "url": "https://files.pythonhosted.org/packages/85/1b/2854b5b0a832bb1041c57b986f2d84ee929fe893dd1166f89ebb90a3a994/Poogle-0.1.0.tar.gz" } ] }