4 releases (2 breaking)

0.4.1 May 16, 2023
0.4.0 Mar 26, 2023
0.3.0 Jan 11, 2023
0.2.0 Jan 10, 2023
0.1.0 Jan 6, 2023

#2446 in Command line utilities

MIT license

77KB
238 lines

Crag

crag is a command-line rust based application and library for acessing (google) search results.

crag example

Quickstart: CLI

If you already have rust and cargo installed, you can install crag directly from crates.io:

cargo install --features=cli crag

Usage

To search with crag, just run crag [SEARCH], and wait for the results -- it's really that simple.

crag mountain-climbing

Of course, crag also supports several flags that modify the results returned by your search. The tool ships with built-in help text that describes the various options:

crag --help
...

Quickstart: Lib

Add crag to your project in your Cargo.toml:

crag = "0.4.0"

Usage

From a high level, crag uses search engine implementations to execute search queries and return a vector of results. Queries, engine settings, and search results are all static types; the actual search engine used should be interchangeable for any given query.

So if you want to point crag at your custom searx server, it's as simple as implementing the Soap trait for that engine.

crag also provides search implementations out-of-the-box, so you can get to searching:

Check out the API docs for usage examples and detailed information: https://docs.rs/crag

Overview

Features

  • Searches things (from the command line!)
  • Clean search result display
  • Cross-platform
  • Integrates with your project as a library
  • Optional interactive search result navigation
  • Supports multiple search engines
  • ...

Alternatives

  • googler: The de facto standard (and probably best) command line google application, but it is currently archived.

Dependencies

~2–13MB
~177K SLoC