18. Външни зависимости: пакети, данни

13 декември 2017

Административни неща

Петък (15.12) сме в зала 200

Преговор

Нишки, канали

По-рядко срещани синхронизационни примитиви: Barrier, Condvar, RwLock
MPSC (Multiple Producer, Single Consumer) канали
Networking (UdpSocket, TcpStream, TcpListener)
Пример: простичък чат

Домашно 3

грешки

str::len брои байтове, не char-ове — .chars().count() ви трябваше
Ред на грешките: първо GameOver, после BadGuess
Разнообразни дребни логически грешки. Твърде много unwrap()-ове?

Домашно 3

Demo

Пълния код: rust-hangman

fn main() {
    // ???
}

Домашно 3

Demo

Парсене на команди

Pattern-matching по първа буква или if-клаузи, it's all good
Помощна функция, която връща Option вместо Result, и позволява оператори-въпросчета?
Макроси за по-малко писане?

Домашно 3

Demo

Как избираме дума?

Външни пакети

[dependencies]
rand = "*"

Данни за играта?

От предефиниран път на системата — $HOME/.hangman_words.txt
От аргументите на командния ред — $ hangman wordlist.txt
Вградени в binary-то чрез include_str!

Локално инсталиране на пакет

cargo install, а ако вече е било викнато, cargo install --force
Инсталира нещата в ~/.cargo/bin/
hangman wordlist.txt

Debug-ване

ENV vars

pub fn clear_screen() {
    if env::var("DEBUG").is_ok() {
        return;
    }

    print!("{}[2J", 27 as char);
    print!("{}[1;1H", 27 as char);
}

DEBUG=1 cargo run some-file.txt
DEBUG=1 hangman some-file.txt

По-сложна обработка на аргументи чрез structopt

[dependencies]
rand = "*"
structopt = "*"
structopt-derive = "*"

По-сложна обработка на аргументи чрез structopt

$ hangman --wordlist=words.txt --attempts=10 --debug
$ hangman -w words.txt -a 10 -d
$ hangman --help
$ hangman --version

По-сложна обработка на аргументи чрез structopt

extern crate structopt;
#[macro_use]
extern crate structopt_derive;
use structopt::StructOpt;

#[derive(StructOpt, Debug)]
#[structopt(name="hangman", about="A game of Hangman")]
pub struct Options {
    #[structopt(short="w", long="wordlist", help="The path to a word list")]
    wordlist_path: Option<String>,

    #[structopt(short="a", long="attempts", help="The number of attempts to guess the word", default_value="10")]
    attempts: u32,

    #[structopt(short="d", long="debug", help="Show debug info")]
    debug: bool,
}

Ограничения на structopt

Трудно дебъгване на грешки (доста магия)
Липса на гъвкавост?
В краен случай, може би решението е (използвания отдолу пакет) clap

Още полезни пакети

clap — по-сложен command-line parsing, мощен, доста за четене
lazy_static — дефиниране на константи с код
failure — помага за дефиниране на грешки и конвертиране между тях
serde — за писане и четене на структурирани данни

Въпроси

http://fmi.rust-lang.bg/