VuzitCL_1_1

<h1>VuzitCL – Vuzit Command Line</h1> VuzitCL is a command line program for the <a href="http://vuzit.com/developer/documents_api">Web Services Library</a> . It was created for developers and non-developers to be able to automate the upload, viewing and deletion of documents from their <a href="http://vuzit.com/">Vuzit</a> web account. <h2>INSTALL</h2> Installation is as easy as copying a file to your computer. Just <a href="http://github.com/vuzit/vuzitruby/downloads">download</a> the VuzitCL application for your operating system. Here are the instructions: <h3>Windows</h3> <ol> <li>Download the VuzitCL-x.×.x_win32.zip zip archive</li> <li>Extract the vuzitcl.exe file to somewhere on your <a href="http://www.computerhope.com/issues/ch000549.htm">Windows System PATH</a></li> </ol> <h3>Linux</h3> <ol> <li>Download the VuzitCL-x.×.x_linux32.zip zip archive.</li> <li>Extract the vuzitcl executable and drop it into your system PATH use as /usr/bin or /usr/local/bin (you can run ‘echo $PATH’ to figure that out)</li> </ol> <h2>OPTIONS</h2> When you run VuzitCL without any options it will give you the list of options seen below. Several examples of how to use these commands is listed in the later sections. <pre> <code> VuzitCL - Vuzit Command Line Usage: vuzitcl -k PUBLIC_KEY,PRIVATE_KEY [OPTIONS] Options: -k, --keys=PUB_KEY,PRIV_KEY Developer API keys - REQUIRED -u, --upload=PATH File to upload -p, --public Make uploaded file public -l, --load=ID Loads the document data -d, --delete=ID Deletes a document -s, --service-url=URL Sets the service URL (e.g. http://domain.com) -v, --verbose Prints more messages -h, --help Show this message </code> </pre> <h2>UPLOAD EXAMPLES</h2> Below is an example of how to upload a file to Vuzit. Replace PUBLIC_KEY and PRIVATE_KEY with your personal Vuzit developer public and private keys respectively. Notice the comma (“,”) between the two keys. You can sign up to get your keys from <a href="https://ssl.vuzit.com/signup">here</a>. <pre> <code> vuzitcl -k PUBLIC_KEY,PRIVATE_KEY -u "c:/temp/test.pdf" </code> </pre> The output of that command if successful is below. <pre> <code> UPLOADED: abc123 </code> </pre> The “abc123” is an example of the document ID. The ID is the unique identifier for the document in the Vuzit document system. You can use this ID to load or delete the document later. Below is the same example of how to upload a file to Vuzit but to make the file public (using the -p flag). <pre> <code> vuzitcl -k PUBLIC_KEY,PRIVATE_KEY -u "c:/temp/test.pdf" -p </code> </pre> <h2>LOAD EXAMPLE</h2> Below is an example of how to load the data from a document. In this example we’ll use that made up “abc123” document ID. <pre> <code> vuzitcl -k PUBLIC_KEY,PRIVATE_KEY -l abc123 </code> </pre> This is some sample output that you’ll see: <pre> <code> LOADED: abc123 title: Some sample title subject: Sample subject pages: 13 width: 595 height: 842 size: 29730 </code> </pre> <h2>DELETE EXAMPLE</h2> Below is an example of how to delete a document. In this example we’ll use the “abc123” document ID we created earlier. <pre> <code> vuzitcl -k PUBLIC_KEY,PRIVATE_KEY -d abc123 </code> </pre> This is some sample output that you’ll see if successful: <pre> <code> DELETED: abc123 </code> </pre> <h2>USING WITH YOUR PROGRAMMING LANGUAGE</h2> Vuzit already has support for programming languages like <a href="http://wiki.github.com/vuzit/vuzitphp">PHP</a> and <a href="http://wiki.github.com/vuzit/vuzitruby">Ruby</a> so it’s recommended that you use these. However if your language is not currently supported then you can use VuzitCL to handle it. Below are a few libraries that allow programmers to run external applications. <ul> <li>.NET: <a href="http://msdn.microsoft.com/en-us/library/system.diagnostics.process.start(VS.71).aspx">Process Start() method</a></li> <li>Java: <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Runtime.html#exec(java.lang.String)">java.lang.Runtime exec() method</a></li> <li>Python: <a href="http://docs.python.org/library/subprocess.html">subprocess</a></li> <li>Perl: <a href="http://perl.about.com/od/programmingperl/qt/perlexecsystem.htm">exec() or system() functions</a></li> </ul> <h2>SPECIAL THANKS</h2> Thanks to Erik Veenstra for his <a href="http://www.erikveen.dds.nl/rubyscript2exe/">RubyScript2Exe</a> which made it possible to write this application natively for Windows and Linux without the need for a Ruby interpreter. <h2>LICENSE</h2> Copyright © 2009 Brent Matzelle, Vuzit LLC Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 2009-11-24T03:30:51-08:00 386692 vuzitcl_1_1_0

164824

VuzitCL_1_1_0

2009-11-05T13:50:39-08:00

62149