# google_image_fetcher
Google Image Fetcher is a Python library that allows you to fetch images from Google Search using the Custom Search JSON API.
## Motive Of The Project
Frontend Developers faces a problem , when they develop any website , that is IMAGE . All the time , they have to go to Google , to search and download the images , they want to use this in their website , when there is no Graphic Designer available in their team . As a Frontend Developer , I also faces the same problem . To solve this problem here you have this Python Library .
I want to develop this library for non-python programmers also . Here You can use this library , without any knowledge of Python Programming .
Here after following all the steps , you will be able to use the images , which will be downloaded according to your prompt / query . Also you can see the `URL` of those images in the terminal below .
## Structure Of The Project
```bash
google_image_fetcher/
│
├── google_image_fetcher/
│ ├── __init__.py
│ └── google_image_fetcher.py
│
├── CONTRIUTING.md
├── LEARN.md
├── LICENSE
├── README.md
└── setup.py
```
## setup.py
```bash
from setuptools import setup, find_packages
import codecs
import os
here = os.path.abspath(os.path.dirname(__file__))
with codecs.open(os.path.join(here, "README.md"), encoding="utf-8") as fh:
long_description = "\n" + fh.read()
VERSION = '1.1.0'
DESCRIPTION = 'Fetch & Download Images From Google'
LONG_DESCRIPTION = 'Google Image Fetcher is a Python library that allows you to fetch images from Google Search using the Custom Search JSON API.'
# Setting up
setup(
name="google_image_fetcher",
version=VERSION,
author="PB2204 (Pabitra Banerjee)",
author_email="<rockstarpabitra2204@gmail.com>",
description=DESCRIPTION,
long_description_content_type="text/markdown",
long_description=long_description,
packages=find_packages(),
install_requires=['requests'],
keywords=['python', 'image', 'fetch', 'web scrapping', 'image scrapping'],
classifiers=[
"Development Status :: 1 - Planning",
"Intended Audience :: Developers",
"Programming Language :: Python :: 3",
"Operating System :: Unix",
"Operating System :: MacOS :: MacOS X",
"Operating System :: Microsoft :: Windows",
]
)
```
## Installation
You can install this library using pip:
```bash
pip install google_image_fetcher
```
or
```bash
pip install google-image-fetcher
```
Then You've to create new python `(.py)` file in the same folder , you're working in the Frontend / Full-Stack project .
Then You've to copy the following lines of code to your `.py` file .
```bash
from google_image_fetcher.google_image_fetcher import GoogleImageFetcher
# Create a GoogleImageFetcher instance
fetcher = GoogleImageFetcher()
# Define the search query
query = "YOUR_QUERY"
# Fetch and save images
fetcher.fetch_images(query, save_folder="YOUR_FOLDER NAME")
```
You just need to substitute `YOUR_QUERY` to your required `Image Name` and the `YOUR_FOLDER NAME` to , where you want to download the images , which will be created inside the same folder, where you're currently working . This is so simple to use .
Now you're ready to use the images .
## Contribution
If you want to contribute something please follow the [CONTRIUTING.md](https://github.com/PB2204/google_image_fetcher/blob/main/CONTRIBUTING.md).
# Happy Coding 🚀
Raw data
{
"_id": null,
"home_page": "",
"name": "google-image-fetcher",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python,image,fetch,web scrapping,image scrapping",
"author": "PB2204 (Pabitra Banerjee)",
"author_email": "<rockstarpabitra2204@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/2e/08/dbd22cf5b60f452377276933e0bee9823593077dfbddc590998a476d2e37/google_image_fetcher-2.0.0.tar.gz",
"platform": null,
"description": "\r\n# google_image_fetcher\r\n\r\n\r\n\r\nGoogle Image Fetcher is a Python library that allows you to fetch images from Google Search using the Custom Search JSON API.\r\n\r\n\r\n\r\n## Motive Of The Project\r\n\r\n\r\n\r\nFrontend Developers faces a problem , when they develop any website , that is IMAGE . All the time , they have to go to Google , to search and download the images , they want to use this in their website , when there is no Graphic Designer available in their team . As a Frontend Developer , I also faces the same problem . To solve this problem here you have this Python Library .\r\n\r\n\r\n\r\nI want to develop this library for non-python programmers also . Here You can use this library , without any knowledge of Python Programming .\r\n\r\n\r\n\r\nHere after following all the steps , you will be able to use the images , which will be downloaded according to your prompt / query . Also you can see the `URL` of those images in the terminal below .\r\n\r\n## Structure Of The Project\r\n\r\n\r\n\r\n```bash\r\n\r\ngoogle_image_fetcher/\r\n\r\n\u2502\r\n\r\n\u251c\u2500\u2500 google_image_fetcher/\r\n\r\n\u2502 \u251c\u2500\u2500 __init__.py\r\n\r\n\u2502 \u2514\u2500\u2500 google_image_fetcher.py\r\n\r\n\u2502\r\n\r\n\u251c\u2500\u2500 CONTRIUTING.md\r\n\r\n\u251c\u2500\u2500 LEARN.md\r\n\r\n\u251c\u2500\u2500 LICENSE\r\n\r\n\u251c\u2500\u2500 README.md\r\n\r\n\u2514\u2500\u2500 setup.py\r\n\r\n```\r\n\r\n\r\n\r\n## setup.py\r\n\r\n\r\n\r\n```bash\r\n\r\nfrom setuptools import setup, find_packages\r\n\r\nimport codecs\r\n\r\nimport os\r\n\r\n\r\n\r\nhere = os.path.abspath(os.path.dirname(__file__))\r\n\r\n\r\n\r\nwith codecs.open(os.path.join(here, \"README.md\"), encoding=\"utf-8\") as fh:\r\n\r\n long_description = \"\\n\" + fh.read()\r\n\r\n\r\n\r\nVERSION = '1.1.0'\r\n\r\nDESCRIPTION = 'Fetch & Download Images From Google'\r\n\r\nLONG_DESCRIPTION = 'Google Image Fetcher is a Python library that allows you to fetch images from Google Search using the Custom Search JSON API.'\r\n\r\n\r\n\r\n# Setting up\r\n\r\nsetup(\r\n\r\n name=\"google_image_fetcher\",\r\n\r\n version=VERSION,\r\n\r\n author=\"PB2204 (Pabitra Banerjee)\",\r\n\r\n author_email=\"<rockstarpabitra2204@gmail.com>\",\r\n\r\n description=DESCRIPTION,\r\n\r\n long_description_content_type=\"text/markdown\",\r\n\r\n long_description=long_description,\r\n\r\n packages=find_packages(),\r\n\r\n install_requires=['requests'],\r\n\r\n keywords=['python', 'image', 'fetch', 'web scrapping', 'image scrapping'],\r\n\r\n classifiers=[\r\n\r\n \"Development Status :: 1 - Planning\",\r\n\r\n \"Intended Audience :: Developers\",\r\n\r\n \"Programming Language :: Python :: 3\",\r\n\r\n \"Operating System :: Unix\",\r\n\r\n \"Operating System :: MacOS :: MacOS X\",\r\n\r\n \"Operating System :: Microsoft :: Windows\",\r\n\r\n ]\r\n\r\n)\r\n\r\n```\r\n\r\n\r\n\r\n## Installation\r\n\r\n\r\n\r\nYou can install this library using pip:\r\n\r\n\r\n\r\n```bash\r\n\r\npip install google_image_fetcher\r\n\r\n```\r\n\r\nor\r\n\r\n```bash\r\n\r\npip install google-image-fetcher\r\n\r\n```\r\n\r\n\r\n\r\nThen You've to create new python `(.py)` file in the same folder , you're working in the Frontend / Full-Stack project .\r\n\r\n\r\n\r\nThen You've to copy the following lines of code to your `.py` file .\r\n\r\n\r\n\r\n```bash\r\n\r\nfrom google_image_fetcher.google_image_fetcher import GoogleImageFetcher\r\n\r\n\r\n\r\n# Create a GoogleImageFetcher instance\r\n\r\nfetcher = GoogleImageFetcher()\r\n\r\n\r\n\r\n# Define the search query\r\n\r\nquery = \"YOUR_QUERY\"\r\n\r\n\r\n\r\n# Fetch and save images\r\n\r\nfetcher.fetch_images(query, save_folder=\"YOUR_FOLDER NAME\")\r\n\r\n```\r\n\r\n\r\n\r\nYou just need to substitute `YOUR_QUERY` to your required `Image Name` and the `YOUR_FOLDER NAME` to , where you want to download the images , which will be created inside the same folder, where you're currently working . This is so simple to use .\r\n\r\n\r\n\r\nNow you're ready to use the images .\r\n\r\n\r\n\r\n## Contribution\r\n\r\n\r\n\r\nIf you want to contribute something please follow the [CONTRIUTING.md](https://github.com/PB2204/google_image_fetcher/blob/main/CONTRIBUTING.md).\r\n\r\n\r\n\r\n# Happy Coding \ud83d\ude80\r\n\r\n",
"bugtrack_url": null,
"license": "",
"summary": "Fetch & Download Images From Google",
"version": "2.0.0",
"project_urls": null,
"split_keywords": [
"python",
"image",
"fetch",
"web scrapping",
"image scrapping"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "90b3b5e0df77f5626628609be452c0ddf55a0c6e04ad7ab297a768627fbba457",
"md5": "036405e993dcb2339266bb6531ee6820",
"sha256": "6b36df09b2d645fa25d0c0acbeafdb4aba6975b66327d3b637b52836562d600e"
},
"downloads": -1,
"filename": "google_image_fetcher-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "036405e993dcb2339266bb6531ee6820",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4781,
"upload_time": "2023-09-22T06:44:37",
"upload_time_iso_8601": "2023-09-22T06:44:37.096782Z",
"url": "https://files.pythonhosted.org/packages/90/b3/b5e0df77f5626628609be452c0ddf55a0c6e04ad7ab297a768627fbba457/google_image_fetcher-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2e08dbd22cf5b60f452377276933e0bee9823593077dfbddc590998a476d2e37",
"md5": "cba4cdb460a6f4ba6a2c43b1ec2426a5",
"sha256": "29f4b674c81b27d95aa4a1795ccd430d94dd4c06e166254f632d200d0d7195ca"
},
"downloads": -1,
"filename": "google_image_fetcher-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "cba4cdb460a6f4ba6a2c43b1ec2426a5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4197,
"upload_time": "2023-09-22T06:44:39",
"upload_time_iso_8601": "2023-09-22T06:44:39.581641Z",
"url": "https://files.pythonhosted.org/packages/2e/08/dbd22cf5b60f452377276933e0bee9823593077dfbddc590998a476d2e37/google_image_fetcher-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-22 06:44:39",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "google-image-fetcher"
}
JSON