so 0.4.10

A terminal interface for StackOverflow
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

mod cli;
mod config;
mod error;
mod stackexchange;
mod term;
mod tui;
mod utils;

use std::{fmt::Write, sync::Arc};

use crossterm::event::{KeyCode, KeyEvent};
use tokio::runtime::Runtime;
use tokio::task;

use config::Config;
use error::{Error, Result};
use stackexchange::{LocalStorage, Search};
use term::Term;

fn main() -> Result<()> {
    env_logger::init();
    // Tokio runtime
    Runtime::new()?
        .block_on(run())
        .map(|app| {
            // Run TUI
            app.map(tui::App::run);
        })
        .or_else(|e: Error| {
            // Handle errors
            term::print_error(&e.to_string())
        })
}

/// Runs the CLI and, if the user wishes to enter the TUI, returns
/// question/answer data
async fn run() -> Result<Option<tui::App>> {
    // Get CLI opts
    let opts = cli::get_opts()?;
    let config = opts.config;
    let sites = &config.sites;
    let lucky = config.lucky;

    // Term tools and markdown styles (outside of TUI)
    let mut term = Term::new();

    let ls = LocalStorage::new(opts.update_sites).await?;

    if let Some(key) = opts.set_api_key {
        Config::set_api_key(key)?;
    }

    if opts.print_config_path {
        println!("{}", Config::config_file_path()?.display());
    }

    if opts.list_sites {
        let mut md = String::new();
        md.push_str("|:-:|:-:|\n");
        md.push_str("|Site Code|Site URL|\n");
        md.push_str("|-:|:-|\n");
        for s in ls.sites.iter() {
            writeln!(&mut md, "|{}|{}", s.api_site_parameter, s.site_url).ok();
        }
        md.push_str("|-\n");
        term.print(&md);
        return Ok(None);
    }

    if let Some(site) = ls.find_invalid_site(sites).await {
        term.print_error(&format!("{site} is not a valid StackExchange site.\n\n"))?;
        term.print_notice(
            "If you think this is incorrect, try running \
                `so --update-sites` to update the cached site listing. \
                You can also run `so --list-sites` to list all available sites.",
        )?;
        return Ok(None);
    }

    if let Some(q) = opts.query {
        let site_map = Arc::new(ls.get_site_map(&config.sites));
        let mut search = Search::new(config.clone(), Arc::clone(&site_map), q);
        if lucky {
            // Show top answer
            let lucky_answer = Term::wrap_spinner(search.search_lucky()).await??;
            term.print(&lucky_answer.answer.body);
            term.print("\nPress **[SPACE]** to see more results, **[o]** to open in the browser, or any other key to exit");

            // Kick off the rest of the search in the background
            let app = task::spawn(async move { tui::App::from_search(search).await });

            match Term::wait_for_key().await? {
                KeyEvent {
                    code: KeyCode::Char(' '),
                    ..
                } => (),
                KeyEvent {
                    code: KeyCode::Char('o'),
                    ..
                } => {
                    let url = site_map.answer_url(&lucky_answer.question, lucky_answer.answer.id);
                    webbrowser::open(&url)?;
                    return Ok(None);
                }
                _ => return Ok(None),
            }

            // Get the rest of the questions
            return Ok(Some(Term::wrap_spinner(app).await?.unwrap()?));
        } else {
            return Ok(Some(
                Term::wrap_spinner(tui::App::from_search(search)).await??,
            ));
        }
    }
    Ok(None)
}