vfs-momolog 0.0.1

data/.gitignore

@@ -0,0 +1,8 @@
+tmp/*
+spec/config.yml
+
+*~
+.DS_Store
+.idea
+.idea/**/*
+Thumbs.db

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in vfs.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Alexander Presber
+
+MIT License
+
+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.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/docs/basics.rb

@@ -0,0 +1,116 @@
+# Virtual File System provides **clean, simple and unified API over different storages** (Local File System, AWS S3, SFTP, ...).
+#
+# - very simple and intuitive API.
+# - same API for different storages.
+# - work simultaneously with multiple storages.
+# - small codebase, easy to learn and extend.
+# - driver implementation is very simple, it is easy to create new drivers.
+#
+# Such unified API is possible because although the API of storages are different the core concept are almost the same.
+#
+# Install Vfs with Rubygems:
+#
+#     gem install vfs
+#
+# Once installed, You can proceed with the example below. It uses local file system as storage, there's also [S3 version][s3_basics] and [SFTP version][ssh_basics] (also [S3 backup][s3_backup] and [SSH/SFTP deployment][ssh_deployment] examples availiable).
+#
+# The project is [hosted on GitHub][project]. You can report bugs and discuss features on the [issues page][issues].
+
+# ### Example
+
+# Preparing sandbox for our sample and cleaning it before starting
+# (ignore the `$sandbox` variable, it's needed to reuse this code in S3 and SSH samples).
+require 'vfs'
+sandbox = $sandbox || '/tmp/vfs_sandbox'.to_dir.destroy
+
+# Creating simple Hello World project.
+project = sandbox['hello_world']
+
+# Writing readme file (note that parent dirs where created automatically).
+project['readme.txt'].write 'My App'
+
+# We can assign files and dirs to variables, now the `readme` variable refers to our readme.txt file.
+readme = project['readme.txt']
+
+# Let's ensure that it's all ok with our readme file and check its attributes.
+p readme.name                               # => readme.txt
+p [readme.basename, readme.extension]       # => ['readme', 'txt']
+p readme.path                               # => /.../readme.txt
+p readme.exist?                             # => true
+p readme.file?                              # => true
+p readme.dir?                               # => false
+p readme.size                               # => 6
+p readme.created_at                         # => 2011-09-09 13:20:43 +0400
+p readme.updated_at                         # => 2011-09-09 13:20:43 +0400
+
+# Reading - You can read all at once or do it sequentially (input stream
+# will be automatically splitted into chunks of reasonable size).
+p readme.read                               # => "My shiny App"
+readme.read{|chunk| p chunk}                # => "My shiny App"
+
+# The same for writing - write all at once or do it sequentially
+# (if there's no file it will be created, if it exists it will be rewriten).
+readme.write "My App v2"
+readme.write{|stream| stream.write "My App v3"}
+p readme.read                               # => "My shiny App v3"
+
+# Appending content to existing file.
+readme.append "How to install ..."
+p readme.size                               # => 27
+
+# Copying and Moving. It also works exactly the same
+# way if You copy or move files and dirs to other storages.
+readme.copy_to project['docs/readme.txt']
+p project['docs/readme.txt'].exist?         # => true
+p readme.exist?                             # => true
+
+readme.move_to project['docs/readme.txt']
+p project['docs/readme.txt'].exist?         # => true
+p readme.exist?                             # => false
+
+# Let's add empty Rakefile to our project.
+project['Rakefile'].write
+
+# Operations with directories - checking our project exists and not empty.
+p project.exist?                            # => true
+p project.empty?                            # => false
+
+# Listing dir content. There are two versions of methods -
+# without block the result will be Array of Entries, with block
+# it will iterate over directory sequentially.
+p project.entries                           # => [/.../docs, /.../Rakefile]
+p project.files                             # => [/.../Rakefile]
+p project.dirs                              # => [/.../docs]
+project.entries do |entry|                  # => ["docs", false]
+  p [entry.name, entry.file?]               # => ["Rakefile", true]
+end
+p project.include?('Rakefile')              # => true
+
+# You can also use glob (if storage support it).
+if project.driver.local?
+  p project.entries('**/Rake*')             # => [/.../Rakefile]
+  p project['**/Rake*']                     # => [/.../Rakefile]
+
+  # The result of dir listing is just an array of Entries, so
+  # You can use it to do interesting things. For example this code will
+  # calculates the size of sources in our project.
+  project['**/*.rb'].collect(&:size).reduce(0, :+)
+end
+
+# Copying and moving - let's create another project by cloning our hello_world.
+project.copy_to sandbox['another_project']
+p sandbox['another_project'].entries        # => [/.../docs, .../Rakefile]
+
+# Cleaning sandbox.
+sandbox.destroy
+
+# In this example we covering basics of **Virtual File System**, if You are interesting You can also take
+# a look at [S3 backup][s3_backup] and [SSH/SFTP deployment][ssh_deployment] examples.
+#
+# [s3_basics]:      s3_basics.html
+# [s3_backup]:      s3_backup.html
+# [ssh_basics]:     ssh_basics.html
+# [ssh_deployment]: ssh_deployment.html
+#
+# [project]:        https://github.com/alexeypetrushin/vfs
+# [issues]:         https://github.com/alexeypetrushin/vfs/issues

data/docs/s3_backup.rb

@@ -0,0 +1,29 @@
+# Example of creating AWS S3 Backup with [Virtual File System][vfs].
+#
+# In this example we uploading sample files to S3 and then
+# copying it back to local folder.
+
+# Connecting to S3 and preparing sandbox. You may take a look at
+# the [docs/s3_sandbox.rb][s3_sandbox] to see the actual code.
+$LOAD_PATH << File.expand_path("#{__FILE__}/../..")
+require 'docs/s3_sandbox'
+s3 = $sandbox
+
+# Preparing sample files located in our local folder in
+# current directory.
+current_dir = __FILE__.to_entry.parent
+sample_files = current_dir['s3_backup/app']
+
+# Uploading sample files to S3.
+sample_files.copy_to s3['app']
+p s3['app/files/bos.png'].exist?             # => true
+
+# Preparing local storage for S3 backup.
+local_backup = '/tmp/vfs_sandbox/backup'.to_dir.destroy
+
+# Copying files from S3 to local backup directory.
+s3['app'].copy_to local_backup['app']
+p local_backup['app/files/bos.png'].exist?   # => true
+
+# [vfs]:        index.html
+# [s3_sandbox]: s3_sandbox.html

data/docs/s3_basics.rb

@@ -0,0 +1,19 @@
+# Example of [Virtual File System][vfs] working with AWS S3.
+#
+# This is exactly the same [basic example][basics] but this time
+# we using S3 as storage instead of local file system.
+
+# Adding examples folder to load paths.
+$LOAD_PATH << File.expand_path("#{__FILE__}/../..")
+
+# Connecting to S3 and preparing sandbox. You may take a look at
+# the [docs/s3_sandbox.rb][s3_sandbox] to see the actual code.
+require 'docs/s3_sandbox'
+
+# Now we just executig [basic example][basics]
+# but with the `$storage` set to AWS S3.
+require 'docs/basics'
+
+# [vfs]:        index.html
+# [basics]:     basics.html
+# [s3_sandbox]: s3_sandbox.html

data/docs/s3_sandbox.rb

@@ -0,0 +1,24 @@
+# Example of using AWS S3 as a storage for [Virtual File System][vfs]
+
+# To use S3 we need the S3 driver, You need 'vos' and 'aws-sdk' gems installed.
+#
+#     gem install vos aws-sdk
+#
+require 'vfs'
+require 'vos'
+require 'vos/drivers/s3'
+
+# Initializing S3 driver, You need to provide Your AWS credentials.
+driver = Vos::Drivers::S3.new \
+  access_key_id:     'xxx',
+  secret_access_key: 'xxx',
+  bucket:            'xxx'
+
+# After creating driver we can create storage.
+box = Vos::Box.new driver
+
+# Preparing temporary dir (actually, S3 has no dirs, but it can mimic it)
+# for sandbox and cleaning it before starting.
+$sandbox = box['/tmp/vfs_sandbox'].to_dir.destroy
+
+# [vfs]: index.html

data/docs/site/404.html

@@ -0,0 +1,8 @@
+<html>
+  <head>
+    <meta http-equiv="Refresh" content="0; url=basics.html" />
+  </head>
+  <body>
+    <p>Page not exists, redirecting to <a href="basics.html">home</a>.</p>
+  </body>
+</html>

data/docs/site/basics.html

@@ -0,0 +1,305 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="content-type" content="text/html;charset=utf-8">
+  <title>basics.rb</title>
+  <link rel="stylesheet" href="http://jashkenas.github.com/docco/resources/docco.css">
+</head>
+<body>
+<div id='container'>
+  <div id="background"></div>
+  <div id="jump_to">
+    Jump To &hellip;
+    <div id="jump_wrapper">
+      <div id="jump_page">
+          <a class="source" href="basics.html">basics.rb</a>
+          <a class="source" href="s3_backup.html">s3_backup.rb</a>
+          <a class="source" href="s3_basics.html">s3_basics.rb</a>
+          <a class="source" href="s3_sandbox.html">s3_sandbox.rb</a>
+          <a class="source" href="ssh_basics.html">ssh_basics.rb</a>
+          <a class="source" href="ssh_deployment.html">ssh_deployment.rb</a>
+          <a class="source" href="ssh_sandbox.html">ssh_sandbox.rb</a>
+      </div>
+    </div>
+  </div>
+  <table cellspacing=0 cellpadding=0>
+  <thead>
+    <tr>
+      <th class=docs><h1>basics.rb</h1></th>
+      <th class=code></th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr id='section-1'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-1">&#182;</a>
+        </div>
+        <p>Virtual File System provides <strong>clean, simple and unified API over different storages</strong> (Local File System, AWS S3, SFTP, &hellip;).</p>
+
+<ul>
+<li>very simple and intuitive API.</li>
+<li>same API for different storages.</li>
+<li>work simultaneously with multiple storages.</li>
+<li>small codebase, easy to learn and extend.</li>
+<li>driver implementation is very simple, it is easy to create new drivers.</li>
+</ul>
+
+<p>Such unified API is possible because although the API of storages are different the core concept are almost the same.</p>
+
+<p>Install Vfs with Rubygems:</p>
+
+<pre><code>gem install vfs
+</code></pre>
+
+<p>Once installed, You can proceed with the example below. It uses local file system as storage, there&rsquo;s also <a href="s3_basics.html">S3 version</a> and <a href="ssh_basics.html">SFTP version</a> (also <a href="s3_backup.html">S3 backup</a> and <a href="ssh_deployment.html">SSH/SFTP deployment</a> examples availiable).</p>
+
+<p>The project is <a href="https://github.com/alexeypetrushin/vfs">hosted on GitHub</a>. You can report bugs and discuss features on the <a href="https://github.com/alexeypetrushin/vfs/issues">issues page</a>.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre></pre></div>
+      </td>
+    </tr>
+    <tr id='section-Example'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-Example">&#182;</a>
+        </div>
+        <h3>Example</h3>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre></pre></div>
+      </td>
+    </tr>
+    <tr id='section-3'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-3">&#182;</a>
+        </div>
+        <p>Preparing sandbox for our sample and cleaning it before starting
+(ignore the <code>$sandbox</code> variable, it&rsquo;s needed to reuse this code in S3 and SSH samples).</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="nb">require</span> <span class="s1">&#39;vfs&#39;</span>
+<span class="n">sandbox</span> <span class="o">=</span> <span class="vg">$sandbox</span> <span class="o">||</span> <span class="s1">&#39;/tmp/vfs_sandbox&#39;</span><span class="o">.</span><span class="n">to_dir</span><span class="o">.</span><span class="n">destroy</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-4'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-4">&#182;</a>
+        </div>
+        <p>Creating simple Hello World project.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="n">project</span> <span class="o">=</span> <span class="n">sandbox</span><span class="o">[</span><span class="s1">&#39;hello_world&#39;</span><span class="o">]</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-5'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-5">&#182;</a>
+        </div>
+        <p>Writing readme file (note that parent dirs where created automatically).</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="n">project</span><span class="o">[</span><span class="s1">&#39;readme.txt&#39;</span><span class="o">].</span><span class="n">write</span> <span class="s1">&#39;My App&#39;</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-6'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-6">&#182;</a>
+        </div>
+        <p>We can assign files and dirs to variables, now the <code>readme</code> variable refers to our readme.txt file.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="n">readme</span> <span class="o">=</span> <span class="n">project</span><span class="o">[</span><span class="s1">&#39;readme.txt&#39;</span><span class="o">]</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-7'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-7">&#182;</a>
+        </div>
+        <p>Let&rsquo;s ensure that it&rsquo;s all ok with our readme file and check it&rsquo;s attributes.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">name</span>                               <span class="c1"># =&gt; readme.txt</span>
+<span class="nb">p</span> <span class="o">[</span><span class="n">readme</span><span class="o">.</span><span class="n">basename</span><span class="p">,</span> <span class="n">readme</span><span class="o">.</span><span class="n">extension</span><span class="o">]</span>       <span class="c1"># =&gt; [&#39;readme&#39;, &#39;txt&#39;]</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">path</span>                               <span class="c1"># =&gt; /.../readme.txt</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">exist?</span>                             <span class="c1"># =&gt; true</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">file?</span>                              <span class="c1"># =&gt; true</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">dir?</span>                               <span class="c1"># =&gt; false</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">size</span>                               <span class="c1"># =&gt; 6</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">created_at</span>                         <span class="c1"># =&gt; 2011-09-09 13:20:43 +0400</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">updated_at</span>                         <span class="c1"># =&gt; 2011-09-09 13:20:43 +0400</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-8'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-8">&#182;</a>
+        </div>
+        <p>Reading &ndash; You can read all at once or do it sequentially (input stream
+will be automatically splitted into chunks of reasonable size).</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">read</span>                               <span class="c1"># =&gt; &quot;My shiny App&quot;</span>
+<span class="n">readme</span><span class="o">.</span><span class="n">read</span><span class="p">{</span><span class="o">|</span><span class="n">chunk</span><span class="o">|</span> <span class="nb">p</span> <span class="n">chunk</span><span class="p">}</span>                <span class="c1"># =&gt; &quot;My shiny App&quot;</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-9'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-9">&#182;</a>
+        </div>
+        <p>The same for writing &ndash; write all at once or do it sequentially
+(if there&rsquo;s no file it will be created, if it exists it will be rewriten).</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="n">readme</span><span class="o">.</span><span class="n">write</span> <span class="s2">&quot;My App v2&quot;</span>
+<span class="n">readme</span><span class="o">.</span><span class="n">write</span><span class="p">{</span><span class="o">|</span><span class="n">stream</span><span class="o">|</span> <span class="n">stream</span><span class="o">.</span><span class="n">write</span> <span class="s2">&quot;My App v3&quot;</span><span class="p">}</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">read</span>                               <span class="c1"># =&gt; &quot;My shiny App v3&quot;</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-10'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-10">&#182;</a>
+        </div>
+        <p>Appending content to existing file.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="n">readme</span><span class="o">.</span><span class="n">append</span> <span class="s2">&quot;How to install ...&quot;</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">size</span>                               <span class="c1"># =&gt; 27</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-11'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-11">&#182;</a>
+        </div>
+        <p>Copying and Moving. It also works exactly the same
+way if You copy or move files and dirs to other storages.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="n">readme</span><span class="o">.</span><span class="n">copy_to</span> <span class="n">project</span><span class="o">[</span><span class="s1">&#39;docs/readme.txt&#39;</span><span class="o">]</span>
+<span class="nb">p</span> <span class="n">project</span><span class="o">[</span><span class="s1">&#39;docs/readme.txt&#39;</span><span class="o">].</span><span class="n">exist?</span>         <span class="c1"># =&gt; true</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">exist?</span>                             <span class="c1"># =&gt; true</span>
+
+<span class="n">readme</span><span class="o">.</span><span class="n">move_to</span> <span class="n">project</span><span class="o">[</span><span class="s1">&#39;docs/readme.txt&#39;</span><span class="o">]</span>
+<span class="nb">p</span> <span class="n">project</span><span class="o">[</span><span class="s1">&#39;docs/readme.txt&#39;</span><span class="o">].</span><span class="n">exist?</span>         <span class="c1"># =&gt; true</span>
+<span class="nb">p</span> <span class="n">readme</span><span class="o">.</span><span class="n">exist?</span>                             <span class="c1"># =&gt; false</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-12'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-12">&#182;</a>
+        </div>
+        <p>Let&rsquo;s add empty Rakefile to our project.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="n">project</span><span class="o">[</span><span class="s1">&#39;Rakefile&#39;</span><span class="o">].</span><span class="n">write</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-13'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-13">&#182;</a>
+        </div>
+        <p>Operations with directories &ndash; checking our project exists and not empty.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="nb">p</span> <span class="n">project</span><span class="o">.</span><span class="n">exist?</span>                            <span class="c1"># =&gt; true</span>
+<span class="nb">p</span> <span class="n">project</span><span class="o">.</span><span class="n">empty?</span>                            <span class="c1"># =&gt; false</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-14'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-14">&#182;</a>
+        </div>
+        <p>Listing dir content. There are two versions of methods &ndash;
+without block the result will be Array of Entries, with block
+it will iterate over directory sequentially.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="nb">p</span> <span class="n">project</span><span class="o">.</span><span class="n">entries</span>                           <span class="c1"># =&gt; [/.../docs, /.../Rakefile]</span>
+<span class="nb">p</span> <span class="n">project</span><span class="o">.</span><span class="n">files</span>                             <span class="c1"># =&gt; [/.../Rakefile]</span>
+<span class="nb">p</span> <span class="n">project</span><span class="o">.</span><span class="n">dirs</span>                              <span class="c1"># =&gt; [/.../docs]</span>
+<span class="n">project</span><span class="o">.</span><span class="n">entries</span> <span class="k">do</span> <span class="o">|</span><span class="n">entry</span><span class="o">|</span>                  <span class="c1"># =&gt; [&quot;docs&quot;, false]</span>
+  <span class="nb">p</span> <span class="o">[</span><span class="n">entry</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">entry</span><span class="o">.</span><span class="n">file?</span><span class="o">]</span>               <span class="c1"># =&gt; [&quot;Rakefile&quot;, true]</span>
+<span class="k">end</span>
+<span class="nb">p</span> <span class="n">project</span><span class="o">.</span><span class="n">include?</span><span class="p">(</span><span class="s1">&#39;Rakefile&#39;</span><span class="p">)</span>              <span class="c1"># =&gt; true</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-15'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-15">&#182;</a>
+        </div>
+        <p>You can also use glob (if storage support it).</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="k">if</span> <span class="n">project</span><span class="o">.</span><span class="n">driver</span><span class="o">.</span><span class="n">local?</span>
+  <span class="nb">p</span> <span class="n">project</span><span class="o">.</span><span class="n">entries</span><span class="p">(</span><span class="s1">&#39;**/Rake*&#39;</span><span class="p">)</span>             <span class="c1"># =&gt; [/.../Rakefile]</span>
+  <span class="nb">p</span> <span class="n">project</span><span class="o">[</span><span class="s1">&#39;**/Rake*&#39;</span><span class="o">]</span>                     <span class="c1"># =&gt; [/.../Rakefile]</span>
+<span class="k">end</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-16'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-16">&#182;</a>
+        </div>
+        <p>The result of dir listing is just an array of Entries, so
+You can use it to do interesting things. For example this code will
+calculates the size of sources in our project.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="k">if</span> <span class="n">project</span><span class="o">.</span><span class="n">driver</span><span class="o">.</span><span class="n">local?</span>
+  <span class="n">project</span><span class="o">[</span><span class="s1">&#39;**/*.rb&#39;</span><span class="o">].</span><span class="n">collect</span><span class="p">(</span><span class="o">&amp;</span><span class="ss">:size</span><span class="p">)</span><span class="o">.</span><span class="n">reduce</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="ss">:+</span><span class="p">)</span>
+<span class="k">end</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-17'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-17">&#182;</a>
+        </div>
+        <p>Copying and moving &ndash; let&rsquo;s create another project by cloning our hello_world.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="n">project</span><span class="o">.</span><span class="n">copy_to</span> <span class="n">sandbox</span><span class="o">[</span><span class="s1">&#39;another_project&#39;</span><span class="o">]</span>
+<span class="nb">p</span> <span class="n">sandbox</span><span class="o">[</span><span class="s1">&#39;another_project&#39;</span><span class="o">].</span><span class="n">entries</span>        <span class="c1"># =&gt; [/.../docs, .../Rakefile]</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-18'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-18">&#182;</a>
+        </div>
+        <p>Cleaning sandbox.</p>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre><span class="n">sandbox</span><span class="o">.</span><span class="n">destroy</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-19'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-19">&#182;</a>
+        </div>
+        <p>In this example we covering basics of <strong>Virtual File System</strong>, if You are interesting You can also take
+a look at <a href="s3_backup.html">S3 backup</a> and <a href="ssh_deployment.html">SSH/SFTP deployment</a> examples.</p>
+
+      </td>
+      <td class=code>
+        <div class='highlight'><pre></pre></div>
+      </td>
+    </tr>
+  </table>
+</div>
+</body>