Skip to main content

Search plugin for Sopel IRC bots

Project description

sopel-search

Search plugin for Sopel IRC bots

Installing

Releases are hosted on PyPI, so after installing Sopel, all you need is pip:

$ pip install sopel-search

Google query suggestions

If you want users to be able to fetch query suggestions from Google using the .gsuggest command, you will need the gsuggest extra:

$ pip install sopel-search[gsuggest]

Configuring

The easiest way to configure sopel-search is via Sopel's configuration wizard—simply run sopel-plugins configure search and enter the values for which it prompts you. Available settings are:

  • region: Set this to the primary geographical region of your bot's users, using one of the values from https://duckduckgo.com/params

    Setting this correctly may improve the relevance of both search results and query suggestions using .suggest.

  • safesearch: Controls SafeSearch filtering of .search results; one of 'on', 'moderate', and 'off'.

Changelog

1.1.0

  • Handle common errors with some amount of grace (#4)
  • Refresh the DDGS client periodically to reduce errors (#5)

1.0.1

Bump DuckDuckGo library minimum version; older releases stopped working.

1.0.0

First release of sopel-search.

This new search plugin apes a lot of behaviors from Sopel's built-in search, with the following notable changes:

  • .bing is no longer available
  • .search is an alias to .ddg, as .g was already
  • Search region and safesearch level are now configurable
  • .suggest uses DuckDuckGo; Google suggestions are still available via the new .gsuggest command (if optional extra dependencies are installed)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sopel_search-1.1.0.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

sopel_search-1.1.0-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file sopel_search-1.1.0.tar.gz.

File metadata

  • Download URL: sopel_search-1.1.0.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.7

File hashes

Hashes for sopel_search-1.1.0.tar.gz
Algorithm Hash digest
SHA256 91fb330e6872528177e8ae97fe6dcb5dcc1bbb4310daab93af679cf6eeb29c0d
MD5 1beb963721ddbdc28fdde88fcb5c73d3
BLAKE2b-256 8eae8ea6756bde092b723f8ffe7cd73867e73feaceb9acd6d2b33aae2de98c8c

See more details on using hashes here.

File details

Details for the file sopel_search-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for sopel_search-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a04a3e28f810635369a399c707098950725eee6735855e322c8d6c332020f9b8
MD5 163b242bc438355cbe26cce37ac8e7f1
BLAKE2b-256 773247ec779c947b8c02ea36c56a7bd4a6dc63bb369321befc73ba6872e526b6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page