⚡️ Quick and easy search engine queries.
Project description
Searchor
Installation
Python 3.7+ is required
# MacOS / Linux (via Terminal)
python3 -m pip install -U searchor
# Windows (via CMD Prompt)
py -3 -m pip install -U searchor
Quick Start
>>> from searchor import Engine
>>> Engine.Google.search("Hello, World!"))
'https://www.google.com/search?q=Hello%2C%20World%21'
Custom Engine
>>> from searchor import Engine
>>> Engine.new("Colgate", "https://www.colgate.com/en-us/search/all?term=")
>>> Engine.Colgate.search("Hi world!", copy_url=True)
'https://www.colgate.com/en-us/search/all?term=Hi%20world!"
Searchor CLI Quick Start
$ searchor Google "Hello World!" --copy
Take a look at more examples in the examples folder!
Note: Engine names follow the UpperCamelCase convention.(eg: ChromeWebStore).
Docker
Building the docker image
$ docker build -t searchor .
Running searchor on the docker container
$ docker run --rm -it searchor sh
/usr/src/searchor/examples # python searchamazon.py
https://www.amazon.com/s?k=Hello%2C%20World%21
v2.5.2 Changes
v2.5.0
- [ADDED] Added a new Enum class
Information
. - [ADDED] Added
getinfo
function in theInformation
Enum to gather information about a given topic, using Wikipedia. - [ADDED] Add
web_scraper
function in theInformation
Enum, to web scrape a URL that is given. - [ADDED] Added bs4 and requests as dependencies.
- [MODIFIED] The Searchor Package is now officially becoming a library, and is therefore no longer considered a package.
v2.5.2
- [FIXED] Fixed issue with web scraping, with attribute errors, and CLI issues
Migration
Instead 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:
# Searchor 2.0.0
from searchor import search, Engine
search("Hello, World!", Engine.Google)
# Searchor v2.2.0
from searchor import Engine
Engine.Google.search("Hello, World!")
Want to contribute?
Take a look at the contributing guidelines!
© Arjun Sharda 2022-present
All Rights Reserved
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
searchor-2.5.2.tar.gz
(10.3 kB
view hashes)