goish 0.2.0

Write Rust using Go idioms — a Go-flavored standard library for Rust
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

// goish: write Rust using Go idioms.
//
//   use goish::prelude::*;
//
//   fn divide(a: int64, b: int64) -> (int64, error) {
//       if b == 0 {
//           return (0, errors::New("divide by zero"));
//       }
//       (a / b, nil)
//   }
//
//   fn main() {
//       Println!("hello", "world");
//
//       let (q, err) = divide(10, 0);
//       if err != nil {
//           Println!("error:", err);
//       } else {
//           Printf!("q = %d\n", q);
//       }
//   }
//
// Cheat-sheet:
//
//   Go                                goish
//   ───────────────────────────────   ──────────────────────────────────
//   int64 / float64 / byte / rune     int64 / float64 / byte / rune
//   error                             error           (a newtype, not Option)
//   nil                               nil             (zero-value error)
//   if err != nil { ... }             if err != nil { ... }
//   fmt.Println(a, b)                 fmt::Println!(a, b)
//   fmt.Printf("%d", n)               fmt::Printf!("%d", n)
//   fmt.Sprintf("%s", s)              fmt::Sprintf!("%s", s)
//   fmt.Fprintf(w, "%d", n)           fmt::Fprintf!(w, "%d", n)
//   fmt.Errorf("bad: %s", e)          fmt::Errorf!("bad: %s", e)
//   errors.New("msg")                 errors::New("msg")
//   errors.Wrap(err, "msg")           errors::Wrap(err, "msg")
//   errors.Is(err, ErrX)              errors::Is(&err, &ErrX)
//   errors.Unwrap(err)                errors::Unwrap(err)

#![allow(non_snake_case)]
#![allow(non_camel_case_types)]
#![allow(non_upper_case_globals)]
// Our doc comments use Go-syntax cheat-sheets with `[brackets]` and `<T>`
// that rustdoc would otherwise interpret as intra-doc-links / HTML tags.
#![allow(rustdoc::broken_intra_doc_links)]
#![allow(rustdoc::invalid_html_tags)]

pub mod base64;
pub mod bufio;
pub mod bytes;
pub mod chan;
pub mod consts;
pub mod context;
pub mod defer;
pub mod errors;
pub mod filepath;
pub mod flag;
pub mod fmt;
pub mod goroutine;
pub mod hex;
pub mod io;
pub mod log;
pub mod math;
pub mod os;
pub mod rand;
pub mod range;
pub mod sort;
pub mod strconv;
pub mod strings;
pub mod sync;
pub mod time;
pub mod types;
pub mod unicode;
pub mod utf8;

// Make Go primitive type names visible at the crate root so macros that
// say `$crate::int` resolve correctly.
pub use crate::types::*;

pub mod prelude {
    pub use crate::base64;
    pub use crate::bufio;
    pub use crate::bytes;
    pub use crate::chan::Chan;
    pub use crate::context;
    pub use crate::errors::{self, error, nil};
    pub use crate::filepath;
    pub use crate::flag;
    pub use crate::fmt;
    pub use crate::hex;
    pub use crate::io;
    pub use crate::log;
    pub use crate::math;
    pub use crate::os;
    pub use crate::rand;
    pub use crate::sort;
    pub use crate::strconv;
    pub use crate::strings;
    pub use crate::sync;
    pub use crate::time;
    pub use crate::unicode;
    pub use crate::utf8;
    pub use crate::types::*;
    pub use crate::goroutine::Goroutine;
    pub use crate::{
        Errorf, Fprintf, Printf, Println, Sprintf,
        append, chan, const_block, defer, delete, go, len, make, map, range, slice, stringer,
    };
}