duckduckgo 0.1.2

🦆 A CLI and library for colorful DuckDuckGo searches.
Documentation 
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use clap::builder::styling::{AnsiColor, Effects, Styles};
use clap::Parser;

fn styles() -> Styles {
    Styles::styled()
        .header(AnsiColor::Red.on_default() | Effects::BOLD)
        .usage(AnsiColor::Red.on_default() | Effects::BOLD)
        .literal(AnsiColor::Blue.on_default() | Effects::BOLD)
        .error(AnsiColor::Red.on_default() | Effects::BOLD)
        .placeholder(AnsiColor::Green.on_default())
}

#[derive(Parser, Debug)]
#[command(
    author = "Mahmoud Harmouch",
    version,
    name = "duckduckgo",
    propagate_version = true,
    styles = styles(),
    help_template = r#"{before-help}{name} {version}
{about-with-newline}

{usage-heading} {usage}

{all-args}{after-help}

AUTHORS:
    {author}
"#,
    about=r#"
▓█████▄  █    ██  ▄████▄   ██ ▄█▀▓█████▄  █    ██  ▄████▄   ██ ▄█▀  ▄████  ▒█████  
▒██▀ ██▌ ██  ▓██▒▒██▀ ▀█   ██▄█▒ ▒██▀ ██▌ ██  ▓██▒▒██▀ ▀█   ██▄█▒  ██▒ ▀█▒▒██▒  ██▒
░██   █▌▓██  ▒██░▒▓█    ▄ ▓███▄░ ░██   █▌▓██  ▒██░▒▓█    ▄ ▓███▄░ ▒██░▄▄▄░▒██░  ██▒
░▓█▄   ▌▓▓█  ░██░▒▓▓▄ ▄██▒▓██ █▄ ░▓█▄   ▌▓▓█  ░██░▒▓▓▄ ▄██▒▓██ █▄ ░▓█  ██▓▒██   ██░
░▒████▓ ▒▒█████▓ ▒ ▓███▀ ░▒██▒ █▄░▒████▓ ▒▒█████▓ ▒ ▓███▀ ░▒██▒ █▄░▒▓███▀▒░ ████▓▒░
 â–’â–’â–“  â–’ â–‘â–’â–“â–’ â–’ â–’ â–‘ â–‘â–’ â–’  â–‘â–’ â–’â–’ â–“â–’ â–’â–’â–“  â–’ â–‘â–’â–“â–’ â–’ â–’ â–‘ â–‘â–’ â–’  â–‘â–’ â–’â–’ â–“â–’ â–‘â–’   â–’ â–‘ â–’â–‘â–’â–‘â–’â–‘ 
 â–‘ â–’  â–’ â–‘â–‘â–’â–‘ â–‘ â–‘   â–‘  â–’   â–‘ â–‘â–’ â–’â–‘ â–‘ â–’  â–’ â–‘â–‘â–’â–‘ â–‘ â–‘   â–‘  â–’   â–‘ â–‘â–’ â–’â–‘  â–‘   â–‘   â–‘ â–’ â–’â–‘ 
 â–‘ â–‘  â–‘  â–‘â–‘â–‘ â–‘ â–‘ â–‘        â–‘ â–‘â–‘ â–‘  â–‘ â–‘  â–‘  â–‘â–‘â–‘ â–‘ â–‘ â–‘        â–‘ â–‘â–‘ â–‘ â–‘ â–‘   â–‘ â–‘ â–‘ â–‘ â–’  
   â–‘       â–‘     â–‘ â–‘      â–‘  â–‘      â–‘       â–‘     â–‘ â–‘      â–‘  â–‘         â–‘     â–‘ â–‘  
 â–‘               â–‘                â–‘               â–‘
  Search and advanced search in DuckDuckGo 
  ========================================

  Perform searches and advanced searches on DuckDuckGo from the command line.

  FEATURES:
    - Search query: Set the search query with the --query or -q option.
    - Search operators: Use the --operators or -o option to set search operators.
    - Safe search: Enable safe search with the --safe option.
    - Output format: Set the output format (list or detailed) with the --format option.
    - Result limit: Limit the number of results with the --limit option.
    - User agent: Set the user agent for the HTTP client with the --user-agent option.
    - Cookie: Set the cookie for the HTTP client with the --cookie option.
    - Proxy: Set the proxy for the HTTP client with the --proxy option.
    - Verbose mode: Show debug messages with the --verbose or -v option.

  USAGE:
    duckduckgo [OPTIONS]

  EXAMPLES:
    - Perform a basic search:
      duckduckgo --query "rust lang"

    - Use search operators:
      duckduckgo --query "rust lang" --operators "+tutorial +beginner"

    - Enable safe search:
      duckduckgo --query "rust lang" --safe

    - Set the output format to detailed:
      duckduckgo --query "rust lang" --format

    - Limit the number of results to 10:
      duckduckgo --query "rust lang" --limit 10

    - Set user agent:
      duckduckgo --query "rust lang" --user-agent "MyCustomAgent"

    - Set cookie for subsequent requests:
      duckduckgo --query "rust lang" --cookie

    - Set proxy:
      duckduckgo --query "rust lang" --proxy "socks5://192.168.1.1:9000"

    - Enable verbose mode:
      duckduckgo --query "rust lang" --verbose

  For more information, visit: https://github.com/wiseaidev/duckduckgo
"#
)]
pub struct Cli {
    #[arg(global = true, short, long)]
    pub verbose: bool,

    /// Sets the search query.
    #[arg(short = 'q', long = "query")]
    pub query: String,

    /// Sets the search operators.
    #[arg(short = 'o', long = "operators", default_value_t = String::from(""))]
    pub operators: String,

    /// Enable safe search.
    #[arg(short = 's', long = "safe", default_value_t = false)]
    pub safe: bool,

    /// Sets the output format (`false` for list or `true` for detailed).
    #[arg(short = 'f', long = "format", default_value_t = false)]
    pub format: bool,

    /// Limits the number of results (default is 10).
    #[arg(short = 'l', long = "limit", default_value_t = 10)]
    pub limit: usize,

    /// Sets the user agent for the HTTP client.
    #[arg(short = 'u', long = "user-agent", default_value_t = String::from("firefox"))]
    pub user_agent: String,

    /// Sets the cookie for subsequent HTTP requests.
    #[arg(short = 'c', long = "cookie", default_value_t = true)]
    pub cookie: bool,

    /// Sets the proxy for the HTTP client (e.g. "socks5://192.168.1.1:9000").
    #[arg(short = 'p', long = "proxy", default_value_t = String::from(""))]
    pub proxy: String,
}