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
127
128
129
130
131
132
133
134
135
136
137
138
|
# Scrawl
Rust library that opens a user's text editor and returns the results as a string. Can be used to open and edit exisiting files, or just as a scratch space for input. Useful for having a user edit text inline with a CLI program a la `git commit -m`
Built for my new (under development) daily journaling program in Rust: [Echo](https://git.xvrqt.com/xvrqt/echo)
## Quick Start
```rust
use scrawl;
fn main() {
// Open an empty buffer with the user's preferred text editor
let output = scrawl::new()?;
println!("User Input: {}", output);
// Open a buffer with contents in the text editor
let output = scrawl::with("Favorite color: ")?;
println!("{}", output);
// Open a buffer with text from a file in the text editor
let output = scrawl::open("survey.txt")?;
println!("{}", output);
// Open a file for direct editing in the text editor
let output = scrawl::edit("README.md")?;
println!("{}", output);
}
```
## Editor Struct
The Editor struct allows you to set certain options before opening the editor. It also allows you resuse these settings instead of having to build them each time you want to use an editor. Run `edit()` on the struct to open the buffer.
```rust
use scrawl::{editor, error};
fn main() -> Result<(), error::ScrawlError> {
let editor = editor::new()
.editor("vim")
.contents("My favorite color is: ")
.open()?;
println!("About Me:\n{}", fave_color);
}
```
If you want to open a one off editor without using settings, see the **Functions** section below.
### Settings
#### Editor
You can set a preferred text editor for the user. Otherwise, $VISUAL, $EDITOR or "textpad.exe"/"vi" is used as a fallback if none is set.
```rust
let output = editor::new().editor("vim").open()?;
```
#### File
You can set a file from which the text buffer will be seeded.
```rust
let output = editor::new().file("my_survey.txt").open()?;
```
#### Contents
You can use a string to seed the text buffer.
```rust
let output = editor::new().contents("Favorite Number: ").open()?;
```
#### Extension
Set the extension of the temporary file created as a buffer. Useful for hinting to text editors which syntax highlighting to use.
```rust
let output = editor::new().extension(".rs").open()?;
```
#### Edit Directly
Opens a file for directory editing in the text editor. Does **not** return a String with the contents of the file.
```rust
editor::new().file("lib.rs").edit(true).open()?;
```
## Functions
These functions are provided for convenience. Useful for prototyping, or if you don't want to build and maintain a struct just to open an editor.
### New
Open an empty text buffer in the user's preferred editor. Returns a Result<String> with the contents of the buffer.
```rust
use scrawl;
fn main() {
let output = scrawl::new(path).unwrap();
println!("{}", output);
}
```
### With
Open an text buffer with the contents of the String slice in the user's preferred editor. Returns a Result<String> with the contents of the buffer.
```rust
use scrawl;
fn main() {
let output = scrawl::with("Hello World!").unwrap();
println!("{}", output);
}
```
### Open
Open opens a text buffer in an editor with the contents of the file specified. This does _**not**_ edit the contents of the file. Returns a Result<String> with the contents of the buffer.
```rust
use scrawl;
fn main() {
let output = scrawl::open("hello.txt").unwrap();
println!("{}", output);
}
```
### Edit
Edit opens a text buffer in an editor with the contents of the file specified. This _**does**_ edit the contents of the file.
```rust
use scrawl;
fn main() {
scrawl::edit("README.md").unwrap();
}
```
|
