diff options
Diffstat (limited to 'python-gsearch.spec')
| -rw-r--r-- | python-gsearch.spec | 375 |
1 files changed, 375 insertions, 0 deletions
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 + +[](https://pypi.python.org/pypi/gsearch) +[](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 + +[](https://pypi.python.org/pypi/gsearch) +[](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 + +[](https://pypi.python.org/pypi/gsearch) +[](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 |