| Name | google-image-source-search JSON |
| Version |
1.2.2
JSON |
| download |
| home_page | None |
| Summary | A package to search image sources using google services |
| upload_time | 2024-08-17 22:11:52 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.7 |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Google Reverse Image Search
[](https://badge.fury.io/py/google-image-source-search)
An unofficial simple solution to search web pages using the specified image. Written on pure requests
## Installation
```sh
> pip install google-image-source-search
```
## Usage
```py
from google_img_source_search import ReverseImageSearcher
if __name__ == '__main__':
image_url = 'https://i.pinimg.com/originals/c4/50/35/c450352ac6ea8645ead206721673e8fb.png'
rev_img_searcher = ReverseImageSearcher()
res = rev_img_searcher.search(image_url)
for search_item in res:
print(f'Title: {search_item.page_title}')
print(f'Site: {search_item.page_url}')
print(f'Img: {search_item.image_url}\n')
```
#### Searching by file
```py
rev_img_searcher.search_by_file('test.png')
```
#### Switching safe mode
```py
from google_img_source_search import SafeMode
rev_img_searcher.switch_safe_mode(SafeMode.DISABLED)
```
#### Passing custom session
```py
import requests
session = requests.Session()
rev_img_searcher = ReverseImageSearcher(session)
```
### Results
#### Output:
```
Title: WAIFU OR LAIFU? - YouTube
Site: https://www.youtube.com/watch?v=F8l5OgLpuyM
Img: https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKg0oMfWeMyBo0-KRerecMaRXNLI2zTLqmyXc0TgDS7nWJx3aB
Title: Печальный факт о Эмилии из аниме "Re:Zero. Жизнь с нуля в альтернативном мире" | AniGAM | Дзен
Site: https://dzen.ru/a/ZBs3vFvEYSvIxPhv
Img: https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTA-RDMY-xUrV5Qqn5fYjJ9qFsZC2Posk16qHkWh4sdnVP5Leh7
Title: Stream chocho music | Listen to songs, albums, playlists for free on SoundCloud
Site: https://soundcloud.com/chocho-329200480
Img: https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQycLi6Ug9JtqKp5t6irb-3Pbj26DtTT48P-R38lOqVI5pXCwYz
```
#### Google lens:
Raw data
{
"_id": null,
"home_page": null,
"name": "google-image-source-search",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Vorrik <author@example.com>",
"download_url": "https://files.pythonhosted.org/packages/92/ad/4b645cd468b5b4e79ed8de8e8e46b7bd6d72793c6068f5245a25536edf65/google_image_source_search-1.2.2.tar.gz",
"platform": null,
"description": "# Google Reverse Image Search\r\n[](https://badge.fury.io/py/google-image-source-search)\r\n\r\nAn unofficial simple solution to search web pages using the specified image. Written on pure requests\r\n\r\n\r\n\r\n## Installation\r\n```sh\r\n> pip install google-image-source-search\r\n```\r\n\r\n## Usage\r\n```py\r\nfrom google_img_source_search import ReverseImageSearcher\r\n\r\n\r\nif __name__ == '__main__':\r\n image_url = 'https://i.pinimg.com/originals/c4/50/35/c450352ac6ea8645ead206721673e8fb.png'\r\n\r\n rev_img_searcher = ReverseImageSearcher()\r\n res = rev_img_searcher.search(image_url)\r\n\r\n for search_item in res:\r\n print(f'Title: {search_item.page_title}')\r\n print(f'Site: {search_item.page_url}')\r\n print(f'Img: {search_item.image_url}\\n')\r\n```\r\n#### Searching by file\r\n```py\r\nrev_img_searcher.search_by_file('test.png')\r\n```\r\n#### Switching safe mode\r\n```py\r\nfrom google_img_source_search import SafeMode\r\nrev_img_searcher.switch_safe_mode(SafeMode.DISABLED)\r\n```\r\n#### Passing custom session\r\n```py\r\nimport requests\r\nsession = requests.Session()\r\nrev_img_searcher = ReverseImageSearcher(session)\r\n```\r\n\r\n### Results\r\n#### Output:\r\n```\r\nTitle: WAIFU OR LAIFU? - YouTube\r\nSite: https://www.youtube.com/watch?v=F8l5OgLpuyM\r\nImg: https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKg0oMfWeMyBo0-KRerecMaRXNLI2zTLqmyXc0TgDS7nWJx3aB\r\n\r\nTitle: \u041f\u0435\u0447\u0430\u043b\u044c\u043d\u044b\u0439 \u0444\u0430\u043a\u0442 \u043e \u042d\u043c\u0438\u043b\u0438\u0438 \u0438\u0437 \u0430\u043d\u0438\u043c\u0435 \"Re:Zero. \u0416\u0438\u0437\u043d\u044c \u0441 \u043d\u0443\u043b\u044f \u0432 \u0430\u043b\u044c\u0442\u0435\u0440\u043d\u0430\u0442\u0438\u0432\u043d\u043e\u043c \u043c\u0438\u0440\u0435\" | AniGAM | \u0414\u0437\u0435\u043d\r\nSite: https://dzen.ru/a/ZBs3vFvEYSvIxPhv\r\nImg: https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTA-RDMY-xUrV5Qqn5fYjJ9qFsZC2Posk16qHkWh4sdnVP5Leh7\r\n\r\nTitle: Stream chocho music | Listen to songs, albums, playlists for free on SoundCloud\r\nSite: https://soundcloud.com/chocho-329200480\r\nImg: https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQycLi6Ug9JtqKp5t6irb-3Pbj26DtTT48P-R38lOqVI5pXCwYz\r\n```\r\n#### Google lens:\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A package to search image sources using google services",
"version": "1.2.2",
"project_urls": {
"Bug Tracker": "https://github.com/Vorrik/Google-Image-Source-Search/issues",
"Homepage": "https://github.com/Vorrik/Google-Image-Source-Search"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d011ac1c74b3e536e6f10dfa005b1b48b045e57af0c3eae3caf089059dd664c1",
"md5": "940d22d50d055d7b5892a010285d905d",
"sha256": "c224cfd2355b2fa3d1c5277222cc38a67033b4713fd3d3f839b0b6a6804207b5"
},
"downloads": -1,
"filename": "google_image_source_search-1.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "940d22d50d055d7b5892a010285d905d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 12121,
"upload_time": "2024-08-17T22:11:50",
"upload_time_iso_8601": "2024-08-17T22:11:50.654446Z",
"url": "https://files.pythonhosted.org/packages/d0/11/ac1c74b3e536e6f10dfa005b1b48b045e57af0c3eae3caf089059dd664c1/google_image_source_search-1.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "92ad4b645cd468b5b4e79ed8de8e8e46b7bd6d72793c6068f5245a25536edf65",
"md5": "eec6b9e3b83fef5dca2ff78122fb521c",
"sha256": "cd1650e6ac86f21eb3ac59524fc00277a81bfa764b8c237d895f76246c17b604"
},
"downloads": -1,
"filename": "google_image_source_search-1.2.2.tar.gz",
"has_sig": false,
"md5_digest": "eec6b9e3b83fef5dca2ff78122fb521c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 9089,
"upload_time": "2024-08-17T22:11:52",
"upload_time_iso_8601": "2024-08-17T22:11:52.124412Z",
"url": "https://files.pythonhosted.org/packages/92/ad/4b645cd468b5b4e79ed8de8e8e46b7bd6d72793c6068f5245a25536edf65/google_image_source_search-1.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-17 22:11:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Vorrik",
"github_project": "Google-Image-Source-Search",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "google-image-source-search"
}
