Skip to main content

StackSearch is a python CLI and library that provides a way to search StackExchange sites.

Project description

stacksearch 🔎

Code style: black PyPI PyPI - Python Version PyPI - License Documentation Status PythonCI

NOTE: STACKSEARCH IS NO LONGER ACTIVELY MAINTAINED. There will still be the occasional bug fixes and updates, but not as much.

StackSearch is a python module that provides a way to search StackExchange sites such as StackOverflow.

Installation

You know the drill

$ pip install stacksearch

Usage

CLI

$ stacksearch "This is the query"

or

$ python3 -m stacksearch "This is the query"

Python API

>>> from stacksearch import sync_search
>>> sync_search("This is the query")

or the asynchronous version

>>> import asyncio
>>> from stacksearch import search
>>> async def main():
...    await search("This is the query")

>>> asyncio.run(main())

Have fun!

Features

The benefits of this module as opposed to the other StackOverflow-searching modules is that this module provides the following:

  • A markdown reverser engine to return useful and beautiful answers
  • The ability to return a dictionary of ALL the search results found, not just the first result
  • The ability to return results from all StackExchange sites
  • A beautiful command-line interface for humans via argparse and Rich
  • An optional asynchronous Python API
  • The ability to crank out raw JSON data to use
  • Fully type hinted

Usage Examples

  • For creating a text editor extension built on this package

  • For searching StackOverflow and/or other StackExchange websites without leaving the Terminal (for those Vim people)

  • For getting lots of answers from all StackExchange sites you know

License

MIT

Please feel free to contribute!

Links 📎

Project details


Release history Release notifications | RSS feed

This version

2

Download files

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

Source Distribution

stacksearch-2.tar.gz (7.9 kB view hashes)

Uploaded Source

Built Distribution

stacksearch-2-py3-none-any.whl (11.0 kB view hashes)

Uploaded Python 3

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