nu-plugin-test-support 0.112.2

Testing support for Nushell plugins
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

//! Test support for [Nushell](https://nushell.sh) plugins.
//!
//! # Example
//!
//! ```rust
//! use std::sync::Arc;
//!
//! use nu_plugin::*;
//! use nu_plugin_test_support::PluginTest;
//! use nu_protocol::{
//!     Example, IntoInterruptiblePipelineData, LabeledError, PipelineData, ShellError, Signals,
//!     Signature, Span, Type, Value,
//! };
//!
//! struct LowercasePlugin;
//! struct Lowercase;
//!
//! impl PluginCommand for Lowercase {
//!     type Plugin = LowercasePlugin;
//!
//!     fn name(&self) -> &str {
//!         "lowercase"
//!     }
//!
//!     fn description(&self) -> &str {
//!         "Convert each string in a stream to lowercase"
//!     }
//!
//!     fn signature(&self) -> Signature {
//!         Signature::build(self.name()).input_output_type(
//!             Type::List(Type::String.into()),
//!             Type::List(Type::String.into()),
//!         )
//!     }
//!
//!     fn examples(&self) -> Vec<Example<'_>> {
//!         vec![Example {
//!             example: r#"[Hello wORLD] | lowercase"#,
//!             description: "Lowercase a list of strings",
//!             result: Some(Value::test_list(vec![
//!                 Value::test_string("hello"),
//!                 Value::test_string("world"),
//!             ])),
//!         }]
//!     }
//!
//!     fn run(
//!         &self,
//!         _plugin: &LowercasePlugin,
//!         _engine: &EngineInterface,
//!         call: &EvaluatedCall,
//!         input: PipelineData,
//!     ) -> Result<PipelineData, LabeledError> {
//!         let span = call.head;
//!         Ok(input.map(
//!             move |value| {
//!                 value
//!                     .as_str()
//!                     .map(|string| Value::string(string.to_lowercase(), span))
//!                     // Errors in a stream should be returned as values.
//!                     .unwrap_or_else(|err| Value::error(err, span))
//!             },
//!             &Signals::empty(),
//!         )?)
//!     }
//! }
//!
//! impl Plugin for LowercasePlugin {
//!     fn version(&self) -> String {
//!         env!("CARGO_PKG_VERSION").into()
//!     }
//!
//!     fn commands(&self) -> Vec<Box<dyn PluginCommand<Plugin=Self>>> {
//!         vec![Box::new(Lowercase)]
//!     }
//! }
//!
//! // #[test]
//! fn test_examples() -> Result<(), ShellError> {
//!     PluginTest::new("lowercase", LowercasePlugin.into())?
//!         .test_command_examples(&Lowercase)
//! }
//!
//! // #[test]
//! fn test_lowercase() -> Result<(), ShellError> {
//!     let input = vec![Value::test_string("FooBar")].into_pipeline_data(Span::test_data(), Signals::empty());
//!     let output = PluginTest::new("lowercase", LowercasePlugin.into())?
//!         .eval_with("lowercase", input)?
//!         .into_value(Span::test_data())?;
//!
//!     assert_eq!(
//!         Value::test_list(vec![
//!             Value::test_string("foobar")
//!         ]),
//!         output
//!     );
//!     Ok(())
//! }
//! #
//! # test_examples().unwrap();
//! # test_lowercase().unwrap();
//! ```

mod diff;
mod fake_persistent_plugin;
mod fake_register;
mod plugin_test;
mod spawn_fake_plugin;

pub use plugin_test::PluginTest;