automatic import of python-gsearch

3 files changed, 377 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..923116e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/gsearch-1.6.0.tar.gz
diff --git a/python-gsearch.spec b/python-gsearch.spec
new file mode 100644
index 0000000..9c99100
--- /dev/null
+++ b/python-gsearch.spec
@@ -0,0 +1,375 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-gsearch
+Version:	1.6.0
+Release:	1
+Summary:	Google Search unofficial API for Python with no external dependencies
+License:	MIT License
+URL:		https://github.com/aviaryan/python-gsearch
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/78/e3/4f0e12e1815990ef03a816dd28b360ba15a49cc9dfbe7f4e752af3fa2c67/gsearch-1.6.0.tar.gz
+BuildArch:	noarch
+
+
+%description
+# Python Google Search API
+
+[![Version](https://img.shields.io/pypi/v/gsearch.svg)](https://pypi.python.org/pypi/gsearch)
+[![Build Status](https://travis-ci.org/aviaryan/python-gsearch.svg?branch=master)](https://travis-ci.org/aviaryan/python-gsearch)
+
+Unofficial Google Search API for Python.
+
+It uses web scraping in the background and is compatible with both **Python 2 and 3**.
+
+
+### Why this project?
+
+No such library exists which works out of the box i.e. without requiring any external dependencies.
+I did this so that I can use it on my [Alfred workflow](https://github.com/aviaryan/alfred-google-search).
+But this turned out to be pretty generic, feel free to use it for your own work.
+
+
+### Features
+
+* Free unrestricted API, requires no key or credit card
+* Unicode support
+* Works for all Python versions (2 & 3)
+
+
+### Installation
+
+```sh
+pip install gsearch
+```
+
+**NOTE:** By using this library, you agree to its [Terms and Conditions](T_AND_C.md).
+
+
+### Using
+
+```sh
+> from gsearch.googlesearch import search
+
+> results = search('Full Stack Developer')  # returns 10 or less results
+[ ('Name', 'Link'),
+	('Name', 'Link'),
+	... ]
+
+> results = search('Avi Aryan', num_results=20)  # returns 20 or less results
+```
+
+You can also use it as a CLI tool.
+
+```sh
+$ gsearch "君の名"
+
+1. 映画『君の名は。』公式サイト
+	http://www.kiminona.com/
+2. 君の名は。 - Wikipedia
+	https://ja.wikipedia.org/wiki/%25E5%2590%259B%25E3%2581%25AE%25E5%2590%258D%25E3%2581%25AF%25E3%2580%2582
+3. 君の名は。 : 作品情報 - 映画.com
+	http://eiga.com/movie/83796/
+4. 君の名は。 - 作品 - Yahoo!映画
+	https://movies.yahoo.co.jp/movie/%25E5%2590%259B%25E3%2581%25AE%25E5%2590%258D%25E3%2581%25AF%25E3%2580%2582/355058/
+5. 『君の名は。』米メディア“矛盾”を指摘しつつも「一流」と絶賛 | dmenu映画
+	https://movie.smt.docomo.ne.jp/article/1053874/
+6. 「君の名は。」予告 - YouTube
+	https://www.youtube.com/watch%3Fv%3Dk4xGqY5IDBE
+7. 君の名はのネタバレ - 【君の名は。】あらすじやネタバレから舞台の聖地 ...
+	https://tabichannel.com/article/102/kiminona
+8. 『君の名は。』の深すぎる「15」の盲点 | シネマズ by 松竹
+	https://cinema.ne.jp/recommend/kiminonaha2016092717/
+9. Amazon.co.jp: 君の名は: DVD - アマゾン
+	https://www.amazon.co.jp/b%3Fnode%3D5276458051
+```
+
+
+### Examples
+
+```sh
+>>> from gsearch.googlesearch import search
+>>> search('Python')
+[('Welcome to Python.org', 'https://www.python.org/'), ('Python (programming language) - Wikipedia', 'https://en.wikipedia.org/wiki/Python_(programming_language)'), ('Python tutorial - TutorialsPoint', 'https://www.tutorialspoint.com/python/'), ('Learn Python (Programming Tutorial for Beginners) - Programiz', 'https://www.programiz.com/python-programming'), ('Learn Python | Codecademy', 'https://www.codecademy.com/learn/learn-python'), ('Learn Python | Codecademy', 'https://www.codecademy.com/en/courses/learn-python/lessons/python-syntax/exercises/welcome'), ('Introduction · A Byte of Python', 'https://python.swaroopch.com/'), ('Solve Introduction Questions | Python | HackerRank', 'https://www.hackerrank.com/domains/python')]
+>>>
+>>> search('Google Search API', num_results=15)
+[('Custom Search JSON/Atom API | Custom Search | Google Developers', 'https://developers.google.com/custom-search/json-api/v1/overview'), ('Custom Search | Google Developers', 'https://developers.google.com/custom-search/'), ('Using REST to Invoke the API | Custom Search | Google Developers', 'https://developers.google.com/custom-search/json-api/v1/using_rest'), ('Custom Search Engine - Google', 'https://www.google.com/cse/'), ('What are the alternatives now that the Google web search API has ...', 'https://stackoverflow.com/questions/4082966/what-are-the-alternatives-now-that-the-google-web-search-api-has-been-deprecated'), ('Is there an API for Google search results? - Quora', 'https://www.quora.com/Is-there-an-API-for-Google-search-results'), ('Fetch Google Search Results with the Site Search API - CtrlQ.org', 'https://ctrlq.org/code/20076-google-search-api'), ('Google Custom Search API | ProgrammableWeb', 'https://www.programmableweb.com/api/google-custom-search'), ('Google Search API Alternative | Webhose.io', 'https://webhose.io/google-search-api-alternative'), ('FAROO - Free Search API', 'http://www.faroo.com/hp/api/api.html'), ("Google's Ajax Search API | Search Engine Watch", 'https://searchenginewatch.com/sew/news/2056817/googles-ajax-search-api'), ('Search | GitHub Developer Guide', 'https://developer.github.com/v3/search/'), ('Using the Google SOAP Search API - SEO Chat', 'http://www.seochat.com/c/a/google-optimization-help/using-the-google-soap-search-api/')]
+```
+
+
+### Warning
+
+Overusing this library might lead to your IP being blocked by Google Search servers.
+Searches through Chrome or another browser might still work but this library will stop working.
+I recommend keeping a 15 seconds gap after each usage of this library.
+In most cases, much lower gaps or even continuous use of the library will still work but still this is something to be kept in mind.
+If you see a 'rate limit' or a 503 error, it's best to stop using the library and try back after some time (~1 minute).
+
+
+### Inspiration
+
+[google by Mario Vilas](https://breakingcode.wordpress.com/2010/06/29/google-search-python/) -
+A library which does almost the same thing except that it uses external dependencies.
+This library also has some additional optimizations to reduce the chances of hitting `rate limit`.
+
+
+
+
+
+%package -n python3-gsearch
+Summary:	Google Search unofficial API for Python with no external dependencies
+Provides:	python-gsearch
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-gsearch
+# Python Google Search API
+
+[![Version](https://img.shields.io/pypi/v/gsearch.svg)](https://pypi.python.org/pypi/gsearch)
+[![Build Status](https://travis-ci.org/aviaryan/python-gsearch.svg?branch=master)](https://travis-ci.org/aviaryan/python-gsearch)
+
+Unofficial Google Search API for Python.
+
+It uses web scraping in the background and is compatible with both **Python 2 and 3**.
+
+
+### Why this project?
+
+No such library exists which works out of the box i.e. without requiring any external dependencies.
+I did this so that I can use it on my [Alfred workflow](https://github.com/aviaryan/alfred-google-search).
+But this turned out to be pretty generic, feel free to use it for your own work.
+
+
+### Features
+
+* Free unrestricted API, requires no key or credit card
+* Unicode support
+* Works for all Python versions (2 & 3)
+
+
+### Installation
+
+```sh
+pip install gsearch
+```
+
+**NOTE:** By using this library, you agree to its [Terms and Conditions](T_AND_C.md).
+
+
+### Using
+
+```sh
+> from gsearch.googlesearch import search
+
+> results = search('Full Stack Developer')  # returns 10 or less results
+[ ('Name', 'Link'),
+	('Name', 'Link'),
+	... ]
+
+> results = search('Avi Aryan', num_results=20)  # returns 20 or less results
+```
+
+You can also use it as a CLI tool.
+
+```sh
+$ gsearch "君の名"
+
+1. 映画『君の名は。』公式サイト
+	http://www.kiminona.com/
+2. 君の名は。 - Wikipedia
+	https://ja.wikipedia.org/wiki/%25E5%2590%259B%25E3%2581%25AE%25E5%2590%258D%25E3%2581%25AF%25E3%2580%2582
+3. 君の名は。 : 作品情報 - 映画.com
+	http://eiga.com/movie/83796/
+4. 君の名は。 - 作品 - Yahoo!映画
+	https://movies.yahoo.co.jp/movie/%25E5%2590%259B%25E3%2581%25AE%25E5%2590%258D%25E3%2581%25AF%25E3%2580%2582/355058/
+5. 『君の名は。』米メディア“矛盾”を指摘しつつも「一流」と絶賛 | dmenu映画
+	https://movie.smt.docomo.ne.jp/article/1053874/
+6. 「君の名は。」予告 - YouTube
+	https://www.youtube.com/watch%3Fv%3Dk4xGqY5IDBE
+7. 君の名はのネタバレ - 【君の名は。】あらすじやネタバレから舞台の聖地 ...
+	https://tabichannel.com/article/102/kiminona
+8. 『君の名は。』の深すぎる「15」の盲点 | シネマズ by 松竹
+	https://cinema.ne.jp/recommend/kiminonaha2016092717/
+9. Amazon.co.jp: 君の名は: DVD - アマゾン
+	https://www.amazon.co.jp/b%3Fnode%3D5276458051
+```
+
+
+### Examples
+
+```sh
+>>> from gsearch.googlesearch import search
+>>> search('Python')
+[('Welcome to Python.org', 'https://www.python.org/'), ('Python (programming language) - Wikipedia', 'https://en.wikipedia.org/wiki/Python_(programming_language)'), ('Python tutorial - TutorialsPoint', 'https://www.tutorialspoint.com/python/'), ('Learn Python (Programming Tutorial for Beginners) - Programiz', 'https://www.programiz.com/python-programming'), ('Learn Python | Codecademy', 'https://www.codecademy.com/learn/learn-python'), ('Learn Python | Codecademy', 'https://www.codecademy.com/en/courses/learn-python/lessons/python-syntax/exercises/welcome'), ('Introduction · A Byte of Python', 'https://python.swaroopch.com/'), ('Solve Introduction Questions | Python | HackerRank', 'https://www.hackerrank.com/domains/python')]
+>>>
+>>> search('Google Search API', num_results=15)
+[('Custom Search JSON/Atom API | Custom Search | Google Developers', 'https://developers.google.com/custom-search/json-api/v1/overview'), ('Custom Search | Google Developers', 'https://developers.google.com/custom-search/'), ('Using REST to Invoke the API | Custom Search | Google Developers', 'https://developers.google.com/custom-search/json-api/v1/using_rest'), ('Custom Search Engine - Google', 'https://www.google.com/cse/'), ('What are the alternatives now that the Google web search API has ...', 'https://stackoverflow.com/questions/4082966/what-are-the-alternatives-now-that-the-google-web-search-api-has-been-deprecated'), ('Is there an API for Google search results? - Quora', 'https://www.quora.com/Is-there-an-API-for-Google-search-results'), ('Fetch Google Search Results with the Site Search API - CtrlQ.org', 'https://ctrlq.org/code/20076-google-search-api'), ('Google Custom Search API | ProgrammableWeb', 'https://www.programmableweb.com/api/google-custom-search'), ('Google Search API Alternative | Webhose.io', 'https://webhose.io/google-search-api-alternative'), ('FAROO - Free Search API', 'http://www.faroo.com/hp/api/api.html'), ("Google's Ajax Search API | Search Engine Watch", 'https://searchenginewatch.com/sew/news/2056817/googles-ajax-search-api'), ('Search | GitHub Developer Guide', 'https://developer.github.com/v3/search/'), ('Using the Google SOAP Search API - SEO Chat', 'http://www.seochat.com/c/a/google-optimization-help/using-the-google-soap-search-api/')]
+```
+
+
+### Warning
+
+Overusing this library might lead to your IP being blocked by Google Search servers.
+Searches through Chrome or another browser might still work but this library will stop working.
+I recommend keeping a 15 seconds gap after each usage of this library.
+In most cases, much lower gaps or even continuous use of the library will still work but still this is something to be kept in mind.
+If you see a 'rate limit' or a 503 error, it's best to stop using the library and try back after some time (~1 minute).
+
+
+### Inspiration
+
+[google by Mario Vilas](https://breakingcode.wordpress.com/2010/06/29/google-search-python/) -
+A library which does almost the same thing except that it uses external dependencies.
+This library also has some additional optimizations to reduce the chances of hitting `rate limit`.
+
+
+
+
+
+%package help
+Summary:	Development documents and examples for gsearch
+Provides:	python3-gsearch-doc
+%description help
+# Python Google Search API
+
+[![Version](https://img.shields.io/pypi/v/gsearch.svg)](https://pypi.python.org/pypi/gsearch)
+[![Build Status](https://travis-ci.org/aviaryan/python-gsearch.svg?branch=master)](https://travis-ci.org/aviaryan/python-gsearch)
+
+Unofficial Google Search API for Python.
+
+It uses web scraping in the background and is compatible with both **Python 2 and 3**.
+
+
+### Why this project?
+
+No such library exists which works out of the box i.e. without requiring any external dependencies.
+I did this so that I can use it on my [Alfred workflow](https://github.com/aviaryan/alfred-google-search).
+But this turned out to be pretty generic, feel free to use it for your own work.
+
+
+### Features
+
+* Free unrestricted API, requires no key or credit card
+* Unicode support
+* Works for all Python versions (2 & 3)
+
+
+### Installation
+
+```sh
+pip install gsearch
+```
+
+**NOTE:** By using this library, you agree to its [Terms and Conditions](T_AND_C.md).
+
+
+### Using
+
+```sh
+> from gsearch.googlesearch import search
+
+> results = search('Full Stack Developer')  # returns 10 or less results
+[ ('Name', 'Link'),
+	('Name', 'Link'),
+	... ]
+
+> results = search('Avi Aryan', num_results=20)  # returns 20 or less results
+```
+
+You can also use it as a CLI tool.
+
+```sh
+$ gsearch "君の名"
+
+1. 映画『君の名は。』公式サイト
+	http://www.kiminona.com/
+2. 君の名は。 - Wikipedia
+	https://ja.wikipedia.org/wiki/%25E5%2590%259B%25E3%2581%25AE%25E5%2590%258D%25E3%2581%25AF%25E3%2580%2582
+3. 君の名は。 : 作品情報 - 映画.com
+	http://eiga.com/movie/83796/
+4. 君の名は。 - 作品 - Yahoo!映画
+	https://movies.yahoo.co.jp/movie/%25E5%2590%259B%25E3%2581%25AE%25E5%2590%258D%25E3%2581%25AF%25E3%2580%2582/355058/
+5. 『君の名は。』米メディア“矛盾”を指摘しつつも「一流」と絶賛 | dmenu映画
+	https://movie.smt.docomo.ne.jp/article/1053874/
+6. 「君の名は。」予告 - YouTube
+	https://www.youtube.com/watch%3Fv%3Dk4xGqY5IDBE
+7. 君の名はのネタバレ - 【君の名は。】あらすじやネタバレから舞台の聖地 ...
+	https://tabichannel.com/article/102/kiminona
+8. 『君の名は。』の深すぎる「15」の盲点 | シネマズ by 松竹
+	https://cinema.ne.jp/recommend/kiminonaha2016092717/
+9. Amazon.co.jp: 君の名は: DVD - アマゾン
+	https://www.amazon.co.jp/b%3Fnode%3D5276458051
+```
+
+
+### Examples
+
+```sh
+>>> from gsearch.googlesearch import search
+>>> search('Python')
+[('Welcome to Python.org', 'https://www.python.org/'), ('Python (programming language) - Wikipedia', 'https://en.wikipedia.org/wiki/Python_(programming_language)'), ('Python tutorial - TutorialsPoint', 'https://www.tutorialspoint.com/python/'), ('Learn Python (Programming Tutorial for Beginners) - Programiz', 'https://www.programiz.com/python-programming'), ('Learn Python | Codecademy', 'https://www.codecademy.com/learn/learn-python'), ('Learn Python | Codecademy', 'https://www.codecademy.com/en/courses/learn-python/lessons/python-syntax/exercises/welcome'), ('Introduction · A Byte of Python', 'https://python.swaroopch.com/'), ('Solve Introduction Questions | Python | HackerRank', 'https://www.hackerrank.com/domains/python')]
+>>>
+>>> search('Google Search API', num_results=15)
+[('Custom Search JSON/Atom API | Custom Search | Google Developers', 'https://developers.google.com/custom-search/json-api/v1/overview'), ('Custom Search | Google Developers', 'https://developers.google.com/custom-search/'), ('Using REST to Invoke the API | Custom Search | Google Developers', 'https://developers.google.com/custom-search/json-api/v1/using_rest'), ('Custom Search Engine - Google', 'https://www.google.com/cse/'), ('What are the alternatives now that the Google web search API has ...', 'https://stackoverflow.com/questions/4082966/what-are-the-alternatives-now-that-the-google-web-search-api-has-been-deprecated'), ('Is there an API for Google search results? - Quora', 'https://www.quora.com/Is-there-an-API-for-Google-search-results'), ('Fetch Google Search Results with the Site Search API - CtrlQ.org', 'https://ctrlq.org/code/20076-google-search-api'), ('Google Custom Search API | ProgrammableWeb', 'https://www.programmableweb.com/api/google-custom-search'), ('Google Search API Alternative | Webhose.io', 'https://webhose.io/google-search-api-alternative'), ('FAROO - Free Search API', 'http://www.faroo.com/hp/api/api.html'), ("Google's Ajax Search API | Search Engine Watch", 'https://searchenginewatch.com/sew/news/2056817/googles-ajax-search-api'), ('Search | GitHub Developer Guide', 'https://developer.github.com/v3/search/'), ('Using the Google SOAP Search API - SEO Chat', 'http://www.seochat.com/c/a/google-optimization-help/using-the-google-soap-search-api/')]
+```
+
+
+### Warning
+
+Overusing this library might lead to your IP being blocked by Google Search servers.
+Searches through Chrome or another browser might still work but this library will stop working.
+I recommend keeping a 15 seconds gap after each usage of this library.
+In most cases, much lower gaps or even continuous use of the library will still work but still this is something to be kept in mind.
+If you see a 'rate limit' or a 503 error, it's best to stop using the library and try back after some time (~1 minute).
+
+
+### Inspiration
+
+[google by Mario Vilas](https://breakingcode.wordpress.com/2010/06/29/google-search-python/) -
+A library which does almost the same thing except that it uses external dependencies.
+This library also has some additional optimizations to reduce the chances of hitting `rate limit`.
+
+
+
+
+
+%prep
+%autosetup -n gsearch-1.6.0
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-gsearch -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Wed Apr 12 2023 Python_Bot <Python_Bot@openeuler.org> - 1.6.0-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..e6549df
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+49d6b386954fe96751f5e149e5a73442  gsearch-1.6.0.tar.gz