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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file stacksearch-2.tar.gz.

File metadata

  • Download URL: stacksearch-2.tar.gz
  • Upload date:
  • Size: 7.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.6.13 Darwin/20.3.0

File hashes

Hashes for stacksearch-2.tar.gz
Algorithm Hash digest
SHA256 0b27c64485effeccd65b7f17e55c372ff1460eee1c8cd772421f93c83a79082b
MD5 2a36bcf7b731aabdb55e977794370b59
BLAKE2b-256 7217d1dedc15d772556ebd02dce7ff7598820c714b6bf333aa1359029ba9bd1f

See more details on using hashes here.

File details

Details for the file stacksearch-2-py3-none-any.whl.

File metadata

  • Download URL: stacksearch-2-py3-none-any.whl
  • Upload date:
  • Size: 11.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.6.13 Darwin/20.3.0

File hashes

Hashes for stacksearch-2-py3-none-any.whl
Algorithm Hash digest
SHA256 426c12648a322f3500dd5ed75386227f684065dff11560483c7e52c11d7b4773
MD5 535c6eebc35a6846c33519fb6225aaa2
BLAKE2b-256 8d28957cb6817bc5bb5d5c706033e004a62bf5603c9b04391763a78811f4d3c3

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