search-cli 0.2.0

Cli program to search for arguments words in the browser.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

# search-cli

This is a binary crate to search the web from CLI

# Usage

```
search [PROVIDER] WORD
```

`search` command with provider and word. The provider is optional. if not
specified, the first provider in the configuration file is used.

```bash
Usage:
    search searchword 
    search google searchword # provider is google
    search g searchword # provider is alias
```

# Configuration

The following command will output the configuration file path.

```
search config -p
```

Edit the output yaml path file with your favorite editor.

The following are the default settings.

```yaml
version: "v1.0"
providers:
  - name: google
    aliases:
      - g
    url: "https://google.com/search?q={{ word | urlencode }}"
  - name: bing
    url: "https://www.bing.com/search?q={{ word | urlencode }}"
  - name: duckduckgo
    aliases:
      - d
    url: "https://duckduckgo.com/?q={{ word | urlencode }}"
```

Each of these settings is described below.

## version

Currently fixed at `"v1.0"`.

## providers

An array of [`provider`](#provider)

## provider

| key                                                            | description                                                                   |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| name                                                           | Provider Name. This is the name of the command execution.                     |
| aliases                                                        | An array of strings. A list of aliases for the command to execute.            |
| url                                                            | Search URL. `{{ word }}` inserts the contents of the `word` argument.         |
| browser                                                        | specify a browser name. See details for [provider.browser](#provider.browser) |
| URLs are parsed using [`tera`](https://github.com/Keats/tera). |                                                                               |

### provider.browser

| key            | description                                          |
| -------------- | ---------------------------------------------------- |
| default        | Use the OS default browser.                          |
| default_config | Use the default configuration browser.               |
| other          | Any browser name. e.g) `chrome`, `msedge`, `firefox` |

## default

example:

```yaml
version: "v1.0"
providers:
  ...
default:
  browser: chrome
```

`default` key is optional key.

| key     | description                                                      |
| ------- | ---------------------------------------------------------------- |
| browser | scecify a default browser. if not specified, OS default browser. |

# License

Mit or Apache 2.0