zabby 0.0.4 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. data/.gitignore +2 -1
  2. data/.yardopts +1 -0
  3. data/ChangeLog.rdoc +11 -0
  4. data/README.rdoc +35 -0
  5. data/Rakefile +2 -1
  6. data/bin/zabbysh +49 -19
  7. data/lib/zabby/connection.rb +5 -1
  8. data/lib/zabby/runner.rb +3 -2
  9. data/lib/zabby/version.rb +1 -1
  10. data/zabby.gemspec +3 -1
  11. metadata +13 -37
  12. data/doc/Zabby.html +0 -208
  13. data/doc/Zabby/AuthenticationError.html +0 -116
  14. data/doc/Zabby/Config.html +0 -414
  15. data/doc/Zabby/ConfigurationError.html +0 -116
  16. data/doc/Zabby/Connection.html +0 -1617
  17. data/doc/Zabby/ResponseCodeError.html +0 -116
  18. data/doc/Zabby/Runner.html +0 -1057
  19. data/doc/Zabby/ZObject.html +0 -480
  20. data/doc/_index.html +0 -188
  21. data/doc/class_list.html +0 -47
  22. data/doc/css/common.css +0 -1
  23. data/doc/css/full_list.css +0 -55
  24. data/doc/css/style.css +0 -322
  25. data/doc/file.ChangeLog.html +0 -91
  26. data/doc/file.LICENSE.html +0 -132
  27. data/doc/file.README.html +0 -271
  28. data/doc/file.TODO.html +0 -99
  29. data/doc/file_list.html +0 -58
  30. data/doc/frames.html +0 -13
  31. data/doc/index.html +0 -271
  32. data/doc/js/app.js +0 -205
  33. data/doc/js/full_list.js +0 -167
  34. data/doc/js/jquery.js +0 -16
  35. data/doc/method_list.html +0 -382
  36. data/doc/top-level-namespace.html +0 -103
data/doc/file.ChangeLog.html DELETED
@@ -1,91 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
- <head>
5
- <meta http-equiv="Content-Type" content="text/html; charset=fr_fr" />
6
- <title>
7
- File: ChangeLog
8
-
9
- &mdash; Documentation by YARD 0.7.4
10
-
11
- </title>
12
-
13
- <link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
14
-
15
- <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
16
-
17
- <script type="text/javascript" charset="utf-8">
18
- relpath = '';
19
- if (relpath != '') relpath += '/';
20
- </script>
21
-
22
- <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
23
-
24
- <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
25
-
26
-
27
- </head>
28
- <body>
29
- <script type="text/javascript" charset="utf-8">
30
- if (window.top.frames.main) document.body.className = 'frames';
31
- </script>
32
-
33
- <div id="header">
34
- <div id="menu">
35
-
36
- <a href="_index.html" title="Index">Index</a> &raquo;
37
- <span class="title">File: ChangeLog</span>
38
-
39
-
40
- <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
41
- </div>
42
-
43
- <div id="search">
44
-
45
- <a id="class_list_link" href="#">Class List</a>
46
-
47
- <a id="method_list_link" href="#">Method List</a>
48
-
49
- <a id="file_list_link" href="#">File List</a>
50
-
51
- </div>
52
- <div class="clear"></div>
53
- </div>
54
-
55
- <iframe id="search_frame"></iframe>
56
-
57
- <div id="content"><div id='filecontents'><h1>ChangeLog for Zabby</h1>
58
- <h2>v0.0.4 (2011/12/21)</h2>
59
- <ul>
60
- <li>Same as v0.0.3 that I could not publish on rubygems.org
61
-
62
- </li>
63
- </ul>
64
- <h2>v0.0.3 (2011/12/21)</h2>
65
- <ul>
66
- <li>Improve documentation and add all Zabbix API verbs
67
-
68
- </li>
69
- </ul>
70
- <h2>v0.0.2 (2011/12/20)</h2>
71
- <ul>
72
- <li>First public release.
73
-
74
- </li>
75
- </ul>
76
- <h2>v0.0.1 (2011/12/18)</h2>
77
- <ul>
78
- <li>Unpublished.
79
-
80
- </li>
81
- </ul>
82
- </div></div>
83
-
84
- <div id="footer">
85
- Generated on Wed Dec 21 12:25:11 2011 by
86
- <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
87
- 0.7.4 (ruby-1.8.7).
88
- </div>
89
-
90
- </body>
91
- </html>
data/doc/file.LICENSE.html DELETED
@@ -1,132 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
- <head>
5
- <meta http-equiv="Content-Type" content="text/html; charset=fr_fr" />
6
- <title>
7
- File: LICENSE
8
-
9
- &mdash; Documentation by YARD 0.7.4
10
-
11
- </title>
12
-
13
- <link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
14
-
15
- <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
16
-
17
- <script type="text/javascript" charset="utf-8">
18
- relpath = '';
19
- if (relpath != '') relpath += '/';
20
- </script>
21
-
22
- <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
23
-
24
- <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
25
-
26
-
27
- </head>
28
- <body>
29
- <script type="text/javascript" charset="utf-8">
30
- if (window.top.frames.main) document.body.className = 'frames';
31
- </script>
32
-
33
- <div id="header">
34
- <div id="menu">
35
-
36
- <a href="_index.html" title="Index">Index</a> &raquo;
37
- <span class="title">File: LICENSE</span>
38
-
39
-
40
- <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
41
- </div>
42
-
43
- <div id="search">
44
-
45
- <a id="class_list_link" href="#">Class List</a>
46
-
47
- <a id="method_list_link" href="#">Method List</a>
48
-
49
- <a id="file_list_link" href="#">File List</a>
50
-
51
- </div>
52
- <div class="clear"></div>
53
- </div>
54
-
55
- <iframe id="search_frame"></iframe>
56
-
57
- <div id="content"><div id='filecontents'><p>
58
- Copyright 2011 Farzad FARID / Pragmatic Source. All rights reserved.
59
- </p>
60
- <p>
61
- Redistribution and use in source and binary forms, with or without
62
- modification, are permitted provided that the following conditions are met:
63
- </p>
64
- <pre class="code">
65
- <span class='float val'>1</span><span class='dot token'>.</span> <span class='rubyid_Redistributions constant id'>Redistributions</span> <span class='rubyid_of identifier id'>of</span> <span class='rubyid_source identifier id'>source</span> <span class='rubyid_code identifier id'>code</span> <span class='rubyid_must identifier id'>must</span> <span class='rubyid_retain identifier id'>retain</span> <span class='rubyid_the identifier id'>the</span> <span class='rubyid_above identifier id'>above</span> <span class='rubyid_copyright identifier id'>copyright</span> <span class='rubyid_notice identifier id'>notice</span><span class='comma token'>,</span> <span class='rubyid_this identifier id'>this</span> <span class='rubyid_list identifier id'>list</span> <span class='rubyid_of identifier id'>of</span>
66
- <span class='rubyid_conditions identifier id'>conditions</span> <span class='rubyid_and and kw'>and</span> <span class='rubyid_the identifier id'>the</span> <span class='rubyid_following identifier id'>following</span> <span class='rubyid_disclaimer identifier id'>disclaimer</span><span class='dot token'>.</span>
67
-
68
- <span class='float val'>2</span><span class='dot token'>.</span> <span class='rubyid_Redistributions constant id'>Redistributions</span> <span class='rubyid_in in kw'>in</span> <span class='rubyid_binary identifier id'>binary</span> <span class='rubyid_form identifier id'>form</span> <span class='rubyid_must identifier id'>must</span> <span class='rubyid_reproduce identifier id'>reproduce</span> <span class='rubyid_the identifier id'>the</span> <span class='rubyid_above identifier id'>above</span> <span class='rubyid_copyright identifier id'>copyright</span> <span class='rubyid_notice identifier id'>notice</span><span class='comma token'>,</span> <span class='rubyid_this identifier id'>this</span> <span class='rubyid_list identifier id'>list</span>
69
- <span class='rubyid_of identifier id'>of</span> <span class='rubyid_conditions identifier id'>conditions</span> <span class='rubyid_and and kw'>and</span> <span class='rubyid_the identifier id'>the</span> <span class='rubyid_following identifier id'>following</span> <span class='rubyid_disclaimer identifier id'>disclaimer</span> <span class='rubyid_in in kw'>in</span> <span class='rubyid_the identifier id'>the</span> <span class='rubyid_documentation identifier id'>documentation</span> <span class='rubyid_and and kw'>and</span><span class='regexp val'>/or other materials
70
- provided with the distribution.
71
- </span></pre>
72
- <p>
73
- THIS SOFTWARE IS PROVIDED BY PRAGMATIC SOURCE &#8217;&#8217;AS
74
- IS&#8217;&#8217; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
75
- LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
76
- PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL PRAGMATIC SOURCE OR
77
- CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
78
- EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
79
- PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
80
- OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
81
- WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
82
- OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
83
- ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
84
- </p>
85
- <p>
86
- The views and conclusions contained in the software and documentation are
87
- those of the authors and should not be interpreted as representing official
88
- policies, either expressed or implied, of Pragmatic Source.
89
- </p>
90
- <p>
91
- OTHER LICENSES COVERING PORTIONS OF CODE
92
- </p>
93
- <h6>==================================</h6>
94
- <p>
95
- Portions of code in &quot;Zabbix::Running&quot; were inspired by Rush
96
- (https://github.com/adamwiggins/rush):
97
- </p>
98
- <p>
99
- Copyright &#169; 2010 Adam Wiggins
100
- </p>
101
- <p>
102
- Permission is hereby granted, free of charge, to any person obtaining a
103
- copy of this software and associated documentation files (the
104
- &quot;Software&quot;), to deal in the Software without restriction,
105
- including without limitation the rights to use, copy, modify, merge,
106
- publish, distribute, sublicense, and/or sell copies of the Software, and to
107
- permit persons to whom the Software is furnished to do so, subject to the
108
- following conditions:
109
- </p>
110
- <p>
111
- The above copyright notice and this permission notice shall be included in
112
- all copies or substantial portions of the Software.
113
- </p>
114
- <p>
115
- THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND,
116
- EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
117
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
118
- NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
119
- DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
120
- OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
121
- USE OR OTHER DEALINGS IN THE SOFTWARE.
122
- </p>
123
- </div></div>
124
-
125
- <div id="footer">
126
- Generated on Wed Dec 21 12:25:11 2011 by
127
- <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
128
- 0.7.4 (ruby-1.8.7).
129
- </div>
130
-
131
- </body>
132
- </html>
data/doc/file.README.html DELETED
@@ -1,271 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
- <head>
5
- <meta http-equiv="Content-Type" content="text/html; charset=fr_fr" />
6
- <title>
7
- File: README
8
-
9
- &mdash; Documentation by YARD 0.7.4
10
-
11
- </title>
12
-
13
- <link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
14
-
15
- <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
16
-
17
- <script type="text/javascript" charset="utf-8">
18
- relpath = '';
19
- if (relpath != '') relpath += '/';
20
- </script>
21
-
22
- <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
23
-
24
- <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
25
-
26
-
27
- </head>
28
- <body>
29
- <script type="text/javascript" charset="utf-8">
30
- if (window.top.frames.main) document.body.className = 'frames';
31
- </script>
32
-
33
- <div id="header">
34
- <div id="menu">
35
-
36
- <a href="_index.html" title="Index">Index</a> &raquo;
37
- <span class="title">File: README</span>
38
-
39
-
40
- <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
41
- </div>
42
-
43
- <div id="search">
44
-
45
- <a id="class_list_link" href="#">Class List</a>
46
-
47
- <a id="method_list_link" href="#">Method List</a>
48
-
49
- <a id="file_list_link" href="#">File List</a>
50
-
51
- </div>
52
- <div class="clear"></div>
53
- </div>
54
-
55
- <iframe id="search_frame"></iframe>
56
-
57
- <div id="content"><div id='filecontents'><h1>Zabby</h1>
58
- <p>
59
- Zabby[http://zabby.org] is a Ruby library and client for
60
- Zabbix[http://www.zabbix.com/]. It provides a simple and clean interface to
61
- the Web Services[http://www.zabbix.com/documentation/1.8/api].
62
- </p>
63
- <h2>Goals</h2>
64
- <p>
65
- There already are Ruby Zabbix libraries but some of them are unfinished
66
- (and apparently abandonned) and some other&#8217;s code is too complicated
67
- or poorly designed. This is why I decided to write another tool for which
68
- my primary goal is to keep the code design, the user interaction and
69
- application interface clean and simple.
70
- </p>
71
- <p>
72
- Zabby has the following caracteristics:
73
- </p>
74
- <ul>
75
- <li>Works both as a Ruby API and a command line tool.
76
-
77
- </li>
78
- <li>Uses an internal Ruby DSL (Domain Specific Langage) that give access to the
79
- full power of Ruby scripting in your configurarion files. No need for a
80
- specific configuration language.
81
-
82
- </li>
83
- <li>Simple design: avoids spaghetti code, WTF and facepalm, unlike some other
84
- Ruby Zabbix libraries.
85
-
86
- </li>
87
- </ul>
88
- <h2>Features</h2>
89
- <ul>
90
- <li>Low level Ruby API that maps every Zabbix API (JSON RPC) to Ruby hashes.
91
-
92
- </li>
93
- <li>Higher level Ruby DSL, both available in pure Ruby and for writing
94
- configuration files.
95
-
96
- </li>
97
- <li>Supports SSL and authenticated HTTP proxies.
98
-
99
- </li>
100
- <li>Full featured IRB like shell included with Readline support. You can mix
101
- Zabbix instructions with Ruby calls transparently.
102
-
103
- </li>
104
- </ul>
105
- <h2>Examples</h2>
106
- <h3>API use</h3>
107
- <p>
108
- The barebone API can be used in Ruby like this:
109
- </p>
110
- <pre class="code">
111
- <span class='rubyid_require identifier id'>require</span> <span class='string val'>&quot;rubygems&quot;</span>
112
- <span class='rubyid_require identifier id'>require</span> <span class='string val'>&quot;zabby&quot;</span>
113
- <span class='rubyid_require identifier id'>require</span> <span class='string val'>&quot;pp&quot;</span>
114
-
115
- <span class='rubyid_z identifier id'>z</span> <span class='assign token'>=</span> <span class='rubyid_Zabby constant id'>Zabby</span><span class='dot token'>.</span><span class='rubyid_init identifier id'>init</span> <span class='rubyid_do do kw'>do</span>
116
- <span class='rubyid_server identifier id'>server</span> <span class='string val'>&quot;https://monitoring.example.com&quot;</span>
117
- <span class='rubyid_user identifier id'>user</span> <span class='string val'>&quot;api_user&quot;</span>
118
- <span class='rubyid_password identifier id'>password</span> <span class='string val'>&quot;s3cr3t&quot;</span>
119
- <span class='rubyid_proxy_host identifier id'>proxy_host</span> <span class='string val'>&quot;http://10.10.10.10&quot;</span>
120
- <span class='rubyid_proxy_user identifier id'>proxy_user</span> <span class='string val'>&quot;john&quot;</span>
121
- <span class='rubyid_proxy_password identifier id'>proxy_password</span> <span class='string val'>&quot;D0e&quot;</span>
122
- <span class='rubyid_end end kw'>end</span>
123
- <span class='rubyid_z identifier id'>z</span><span class='dot token'>.</span><span class='rubyid_login identifier id'>login</span>
124
-
125
- <span class='rubyid_pp identifier id'>pp</span> <span class='rubyid_z identifier id'>z</span><span class='dot token'>.</span><span class='rubyid_connection identifier id'>connection</span><span class='dot token'>.</span><span class='rubyid_perform_request identifier id'>perform_request</span><span class='lparen token'>(</span><span class='string val'>&quot;host&quot;</span><span class='comma token'>,</span> <span class='string val'>&quot;get&quot;</span><span class='comma token'>,</span> <span class='lbrace token'>{</span> <span class='string val'>&quot;filter&quot;</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='lbrace token'>{</span> <span class='string val'>&quot;host&quot;</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='string val'>&quot;master.example.com&quot;</span> <span class='rbrace token'>}</span> <span class='rbrace token'>}</span><span class='rparen token'>)</span>
126
- <span class='rubyid_pp identifier id'>pp</span> <span class='rubyid_z identifier id'>z</span><span class='dot token'>.</span><span class='rubyid_connection identifier id'>connection</span><span class='dot token'>.</span><span class='rubyid_perform_request identifier id'>perform_request</span><span class='lparen token'>(</span><span class='string val'>&quot;item&quot;</span><span class='comma token'>,</span> <span class='string val'>&quot;get&quot;</span><span class='comma token'>,</span> <span class='lbrace token'>{</span> <span class='string val'>&quot;host&quot;</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='string val'>&quot;master.example.com&quot;</span><span class='comma token'>,</span> <span class='string val'>&quot;output&quot;</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='string val'>&quot;shorten&quot;</span> <span class='rbrace token'>}</span><span class='rparen token'>)</span>
127
- </pre>
128
- <ul>
129
- <li>The <em>server</em>, <em>user</em> and <em>passord</em> are necessary.
130
-
131
- </li>
132
- <li>If you don&#8217;t provide the path to the JSON-RPC script
133
- &quot;/api_jsonrpc.php&quot; is appended to the URI automatically.
134
-
135
- </li>
136
- <li>The <em>proxy_*</em> settings are optionnal.
137
-
138
- </li>
139
- </ul>
140
- <h3>Shell</h3>
141
- <p>
142
- <b>zabbysh</b> is an simple Zabbix Shell. It runs either interactively or
143
- can be used to execute a command file with the &quot;-f CMD_FILE&quot;
144
- option.
145
- </p>
146
- <p>
147
- If the command file does not end with &quot;exit&quot; then the program
148
- drops into the shell after executing the file.
149
- </p>
150
- <p>
151
- <b>zabbysh</b> provides Readline support but does no support advanced IRB
152
- features likes multi-lines instructions.
153
- </p>
154
- <p>
155
- <b>zabbyrb</b> is another Zabbix Shell based on <b>IRB</b>. It provides the
156
- whole power of IRB but may be less stable than zabbysh because the IRB API
157
- is poorly documented and hard to use.
158
- </p>
159
- <h4>Interactive shell</h4>
160
- <pre class="code">
161
- <span class='comment val'># zabbysh</span>
162
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_set identifier id'>set</span> <span class='rubyid_server identifier id'>server</span> <span class='string val'>&quot;https://monitoring.example.com&quot;</span>
163
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_set identifier id'>set</span> <span class='rubyid_user identifier id'>user</span> <span class='string val'>&quot;api_user&quot;</span>
164
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_set identifier id'>set</span> <span class='rubyid_password identifier id'>password</span> <span class='string val'>&quot;s3cr3t&quot;</span>
165
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_set identifier id'>set</span> <span class='rubyid_proxy_host identifier id'>proxy_host</span> <span class='string val'>&quot;http://10.10.10.10&quot;</span>
166
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_set identifier id'>set</span> <span class='rubyid_proxy_user identifier id'>proxy_user</span> <span class='string val'>&quot;john&quot;</span>
167
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_set identifier id'>set</span> <span class='rubyid_proxy_password identifier id'>proxy_password</span> <span class='string val'>&quot;D0e&quot;</span>
168
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_login identifier id'>login</span>
169
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_puts identifier id'>puts</span> <span class='rubyid_logged_in? fid id'>logged_in?</span>
170
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_host identifier id'>host</span><span class='dot token'>.</span><span class='rubyid_get identifier id'>get</span> <span class='string val'>&quot;filter&quot;</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='lbrace token'>{</span> <span class='string val'>&quot;host&quot;</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='string val'>&quot;monitor.example.com&quot;</span> <span class='rbrace token'>}</span><span class='comma token'>,</span> <span class='string val'>&quot;output&quot;</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='string val'>&quot;extend&quot;</span>
171
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_item identifier id'>item</span><span class='dot token'>.</span><span class='rubyid_get identifier id'>get</span> <span class='string val'>&quot;host&quot;</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='string val'>&quot;monitor.example.com&quot;</span><span class='comma token'>,</span> <span class='string val'>&quot;output&quot;</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='string val'>&quot;refer&quot;</span>
172
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='lbrack token'>[</span><span class='dot3 op'>...</span><span class='rbrack token'>]</span>
173
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_logout identifier id'>logout</span>
174
- <span class='rubyid_zabby identifier id'>zabby</span><span class='gt op'>&gt;</span> <span class='rubyid_exit identifier id'>exit</span>
175
- </pre>
176
- <h4>Execute a command script</h4>
177
- <p>
178
- Create a file and put the same instructions as above in it, then execute
179
- <b>zabbysh</b>:
180
- </p>
181
- <pre class="code">
182
- <span class='comment val'># zabbysh --file my_zabbix_commands.txt</span>
183
- </pre>
184
- <h2>Requirements</h2>
185
- <ul>
186
- <li>Ruby 1.8.5. IT BASICALLY RUNS ANYWHERE!
187
-
188
- </li>
189
- <li>JSON library: &#8216;json&#8217; or &#8216;json_pure&#8217;
190
-
191
- </li>
192
- <li>OptionParser
193
-
194
- </li>
195
- <li>Readline (optionnal, used by the interactive shell)
196
-
197
- </li>
198
- </ul>
199
- <h2>References</h2>
200
- <ul>
201
- <li>Main web site: http://zabby.org
202
-
203
- </li>
204
- <li>GitHub projet: https://github.com/Pragmatic-Source/zabby
205
-
206
- </li>
207
- <li>RubyGems.org homepage: https://rubygems.org/gems/zabby
208
-
209
- </li>
210
- <li>Author&#8217;s company: http://www.pragmatic-source.com
211
-
212
- </li>
213
- </ul>
214
- <h2>Contributing</h2>
215
- <p>
216
- All contributions are welcome. You can either open a ticket on Github, send
217
- a pull request with a patch or send an email to the author.
218
- </p>
219
- <h2>Author</h2>
220
- <p>
221
- Farzad FARID mailto:ffarid@pragmatic-source.com
222
- </p>
223
- <h3>Thanks to</h3>
224
- <ul>
225
- <li>Jean-Hadrien Chabran (jhchabran): Advices on code design.
226
-
227
- </li>
228
- <li>Nicolas Blanco (slainer68): Advices on code design and Triple Facepalming
229
- after reading other Ruby/Zabbix code.
230
-
231
- </li>
232
- <li>Renaud Chaput (renchap): For suggesting the &quot;zabby&quot; name.
233
-
234
- </li>
235
- </ul>
236
- <h3>Sources of inspiration</h3>
237
- <ul>
238
- <li>Adam Wiggins&#8217;s Rush[https://github.com/adamwiggins/rush] for the
239
- interactive shell.
240
-
241
- </li>
242
- <li>Other Zabbix Ruby libraries (only the good parts ;) ):
243
-
244
- </li>
245
- </ul>
246
- <table>
247
- <tr><td valign="top">zabcon[http://trac.red-tux.net/]:</td><td>Zabcon is a command line interface for Zabbix written in Ruby
248
-
249
- </td></tr>
250
- <tr><td valign="top">rzabbix[http://github.com/neerfri/rzabbix]:</td><td>Zabbix API client for Ruby
251
-
252
- </td></tr>
253
- <tr><td valign="top">rubix[https://github.com/dhruvbansal/rubix]:</td><td>Rubix is a Ruby client for Zabbix
254
-
255
- </td></tr>
256
- </table>
257
- <h2>License</h2>
258
- <p>
259
- This software is release under the <b>Simplified BSD license</b>. See the
260
- LICENSE file.
261
- </p>
262
- </div></div>
263
-
264
- <div id="footer">
265
- Generated on Wed Dec 21 12:25:11 2011 by
266
- <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
267
- 0.7.4 (ruby-1.8.7).
268
- </div>
269
-
270
- </body>
271
- </html>