{"id":16655144,"url":"https://github.com/arjunsharda/searchor","last_synced_at":"2025-04-04T01:06:35.930Z","repository":{"id":59605399,"uuid":"529644625","full_name":"ArjunSharda/Searchor","owner":"ArjunSharda","description":"⚡️ Quick and easy searching tasks in one library.","archived":false,"fork":false,"pushed_at":"2024-10-04T19:56:00.000Z","size":747,"stargazers_count":80,"open_issues_count":0,"forks_count":34,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-10-13T09:52:15.813Z","etag":null,"topics":["collaborate","communityexchange","github","imgbot","learn","pypi-package","python","search","search-engine","searchor"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/Searchor/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ArjunSharda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-27T16:55:00.000Z","updated_at":"2024-10-04T21:22:19.000Z","dependencies_parsed_at":"2023-12-13T20:09:26.860Z","dependency_job_id":"66c011b7-41da-4525-9e3d-477d18d40f8c","html_url":"https://github.com/ArjunSharda/Searchor","commit_stats":{"total_commits":363,"total_committers":46,"mean_commits":7.891304347826087,"dds":0.3608815426997245,"last_synced_commit":"e9b9fa8f4d3f7b0e62057735a192060a1abd79cc"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArjunSharda%2FSearchor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArjunSharda%2FSearchor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArjunSharda%2FSearchor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArjunSharda%2FSearchor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArjunSharda","download_url":"https://codeload.github.com/ArjunSharda/Searchor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247103306,"owners_count":20884023,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["collaborate","communityexchange","github","imgbot","learn","pypi-package","python","search","search-engine","searchor"],"created_at":"2024-10-12T09:52:02.561Z","updated_at":"2025-04-04T01:06:35.909Z","avatar_url":"https://github.com/ArjunSharda.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Searchor\n========\n\n\n\u003cimg align=\"left\" src=\"http://estruyf-github.azurewebsites.net/api/VisitorHit?user=ArjunSharda\u0026repo=Searchor\u0026countColorcountColor\u0026countColor=%237B1E7B\"/\u003e\n\u003cimg align=\"right\" src=\"https://img.shields.io/github/repo-size/ArjunSharda/Searchor?style=for-the-badge\u0026logo=appveyor\" alt=\"GitHub repo size\"/\u003e\n\n\u003cimg align=\"right\" alt=\"Json-Generator\" src=\"https://socialify.git.ci/ArjunSharda/Searchor/image?description=1\u0026font=Rokkitt\u0026forks=1\u0026issues=1\u0026language=1\u0026logo=https%3A%2F%2Fgithub.com%2FArjunSharda%2FSearchor%2Fblob%2Fmain%2Fext%2Fsearchor.png%3Fraw%3Dtrue\u0026name=1\u0026owner=1\u0026pattern=Floating%20Cogs\u0026pulls=1\u0026stargazers=1\u0026theme=Light\" /\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://forthebadge.com/images/badges/built-with-love.svg\" alt=\" forks\"/\u003e\n\u003c/p\u003e\n\n![PyPI](https://img.shields.io/pypi/v/searchor?color=green\u0026logo=python\u0026logoColor=green)\n[![Discord](https://img.shields.io/discord/1026470859868741662)](https://discord.gg/fPXNMW7swn)\n\u003cdiv style=\"text-align: center; display: grid; justify-content: center;\"\u003e\u003cimg style=\"margin: auto; margin-bottom: 1rem; border-radius: 30%;\" height=\"150\" width=\"150\" src=\"https://raw.githubusercontent.com/ArjunSharda/Searchor/main/ext/searchor.png\"/\u003e\u003c/div\u003e\n\n# Description\n\n Searchor is an all-in-one PyPi Python Library that simplifies web scraping, obtaining information on an topic, and generating search query URLs. Searchor is an a efficient tool for Python developers, with many web development needs in one, with support of over 100+ Engines and custom engines allowed, making it easy for developers to use for their web programming needs in Python without relying on many third-party dependencies. Furthermore, Searchor has a wide range of support, including command line interface and pip.\n\nInstallation\n------------\n**[Python 3.7+](https://www.python.org/downloads/) is required**\n```bash\n# MacOS / Linux (via Terminal)\npython3 -m pip install -U searchor\n\n# Windows (via CMD Prompt)\npy -3 -m pip install -U searchor\n```\n\nQuick Start\n-----------\n```python\n\u003e\u003e\u003e from searchor import Engine\n\u003e\u003e\u003e Engine.Google.search(\"Hello, World!\"))\n'https://www.google.com/search?q=Hello%2C%20World%21'\n```\nCustom Engine\n-------------\n```python\n\u003e\u003e\u003e from searchor import Engine\n\u003e\u003e\u003e Engine.new(\"Colgate\", \"https://www.colgate.com/en-us/search/all?term=\")\n\u003e\u003e\u003e Engine.Colgate.search(\"Hi world!\")\n'https://www.colgate.com/en-us/search/all?term=Hi%20world!\"\n```\nSearchor CLI Quick Start\n```bash\n$ searchor Google \"Hello World!\" --copy\n```\n\u003cbr\u003e\n\u003c/br\u003e\n\nWeb Scrape\n----------\n```python\n\u003e\u003e\u003e from searchor import Information\n\u003e\u003e\u003e Information.scrape(\"https://google.com\")\n\u003e\u003e\u003e '{'title': 'Google', 'paragraphs': [\u003cp style=\"font-size:8pt;color:#70757a\"\u003e© 2023 - \u003ca href=\"/intl/en/policies/privacy/\"\u003ePrivacy\u003c/a\u003e - \u003ca href=\"/intl/en/policies/terms/\"\u003eTerms\u003c/a\u003e\u003c/p\u003e]}'\n```\n\n\nGet Information\n---------------\n```python\n\u003e\u003e\u003e from searchor import Information\n\u003e\u003e\u003e Information.getinfo(\"GitHub\")\n\u003e\u003e\u003e 'GitHub, Inc. is an Internet hosting service for software development and version control using Git. It provides the distributed version control of Git plus access control, bug tracking, software feature requests, task management, continuous integration, and wikis for every project. Headquartered in California, it has been a subsidiary of Microsoft since 2018.'\n```\nTake a look at more examples in the [examples](https://github.com/ArjunSharda/Searchor/tree/main/examples) folder!\n\n*Note*:\u0026nbsp; Engine names follow the **UpperCamelCase** convention.(eg: ChromeWebStore).\n\nDocker\n------\n\nBuilding the docker image\n```sh\n$ docker build -t searchor .\n```\n\nRunning searchor on the docker container\n```sh\n$ docker run --rm -it searchor sh\n/usr/src/searchor/examples # python searchamazon.py\nhttps://www.amazon.com/s?k=Hello%2C%20World%21\n```\n\nv2.5.2 Changes\n--------------\nv2.5.0\n- **[ADDED]** Added a new Enum class `Information`.\n- **[ADDED]** Added `getinfo` function in the `Information` Enum to gather information about a given topic, using Wikipedia.\n- **[ADDED]** Add `web_scraper` function in the `Information` Enum, to web scrape a URL that is given.\n- **[ADDED]** Added bs4 and requests as dependencies.\n- **[MODIFIED]** The Searchor Package is now officially becoming a library, and is therefore no longer considered a package.\n\nv2.5.2\n- **[FIXED]** Fixed issue with web scraping, with attribute errors, and CLI issues\n\nMigration\n---------\nInstead of different functions for each engine, Searchor `v2.2.0` uses a single function with an `Engine` enum. This makes it easier to use and maintain. If you're migrating from `v2.0.0`, compare the differences between the following snippets:\n```python\n# Searchor 2.0.0\nfrom searchor import search, Engine\nsearch(\"Hello, World!\", Engine.Google)\n```\n```python\n# Searchor v2.2.0\nfrom searchor import Engine\nEngine.Google.search(\"Hello, World!\")\n```\n\n## Want to contribute?\nTake a look at the [contributing guidelines](CONTRIBUTING.md)!\n\n\u003chr\u003e\n\u003ch6 align=\"center\"\u003e© Arjun Sharda 2022-present\n\u003cbr\u003e\nAll Rights Reserved\u003c/h6\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farjunsharda%2Fsearchor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farjunsharda%2Fsearchor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farjunsharda%2Fsearchor/lists"}