folio 0.1.0

data/MANIFEST

@@ -0,0 +1,234 @@
+doc
+doc/rdoc
+doc/rdoc/fr_file_index.html
+doc/rdoc/classes
+doc/rdoc/classes/Folio
+doc/rdoc/classes/Folio/FileObject.html
+doc/rdoc/classes/Folio/BlockDevice.html
+doc/rdoc/classes/Folio/Link.html
+doc/rdoc/classes/Folio/Document.html
+doc/rdoc/classes/Folio/CharacterDevice.html
+doc/rdoc/classes/Folio/Pipe.html
+doc/rdoc/classes/Folio/Device.html
+doc/rdoc/classes/Folio/Socket.html
+doc/rdoc/classes/Folio/Prompt.html
+doc/rdoc/classes/Folio/Directory.html
+doc/rdoc/classes/Folio/FileNotFound.html
+doc/rdoc/classes/Folio.html
+doc/rdoc/rdoc-style.css
+doc/rdoc/files
+doc/rdoc/files/README.html
+doc/rdoc/files/METADATA.html
+doc/rdoc/files/lib
+doc/rdoc/files/lib/folio
+doc/rdoc/files/lib/folio/fileobject_rb.html
+doc/rdoc/files/lib/folio/link_rb.html
+doc/rdoc/files/lib/folio/document_rb.html
+doc/rdoc/files/lib/folio/errors_rb.html
+doc/rdoc/files/lib/folio/device_rb.html
+doc/rdoc/files/lib/folio/prompt_rb.html
+doc/rdoc/files/lib/folio/socket_rb.html
+doc/rdoc/files/lib/folio/pipe_rb.html
+doc/rdoc/files/lib/folio/directory_rb.html
+doc/rdoc/files/lib/folio_rb.html
+doc/rdoc/files/NEWS.html
+doc/rdoc/files/COPYING.html
+doc/rdoc/fr_class_index.html
+doc/rdoc/index.html
+doc/rdoc/created.rid
+doc/rdoc/fr_method_index.html
+doc/ri
+doc/ri/Folio
+doc/ri/Folio/Prompt
+doc/ri/Folio/Prompt/chmod-i.yaml
+doc/ri/Folio/Prompt/touch-i.yaml
+doc/ri/Folio/Prompt/%2b-i.yaml
+doc/ri/Folio/Prompt/glob-i.yaml
+doc/ri/Folio/Prompt/mkdir-i.yaml
+doc/ri/Folio/Prompt/ln-i.yaml
+doc/ri/Folio/Prompt/mv-i.yaml
+doc/ri/Folio/Prompt/files-i.yaml
+doc/ri/Folio/Prompt/entries-i.yaml
+doc/ri/Folio/Prompt/rm_rf-i.yaml
+doc/ri/Folio/Prompt/paths-i.yaml
+doc/ri/Folio/Prompt/mkdir_p-i.yaml
+doc/ri/Folio/Prompt/pwd-i.yaml
+doc/ri/Folio/Prompt/%2f-i.yaml
+doc/ri/Folio/Prompt/ln_sf-i.yaml
+doc/ri/Folio/Prompt/chown-i.yaml
+doc/ri/Folio/Prompt/ln_s-i.yaml
+doc/ri/Folio/Prompt/directories-i.yaml
+doc/ri/Folio/Prompt/cp-i.yaml
+doc/ri/Folio/Prompt/rmdir-i.yaml
+doc/ri/Folio/Prompt/localize-i.yaml
+doc/ri/Folio/Prompt/chown_r-i.yaml
+doc/ri/Folio/Prompt/mode-i.yaml
+doc/ri/Folio/Prompt/cp_r-i.yaml
+doc/ri/Folio/Prompt/install-i.yaml
+doc/ri/Folio/Prompt/rm_r-i.yaml
+doc/ri/Folio/Prompt/cdesc-Prompt.yaml
+doc/ri/Folio/Prompt/chmod_r-i.yaml
+doc/ri/Folio/Prompt/file-i.yaml
+doc/ri/Folio/Prompt/to_s-i.yaml
+doc/ri/Folio/Prompt/%5b%5d-c.yaml
+doc/ri/Folio/Prompt/new-c.yaml
+doc/ri/Folio/Prompt/fileutils-i.yaml
+doc/ri/Folio/Prompt/cd-i.yaml
+doc/ri/Folio/Prompt/rm-i.yaml
+doc/ri/Folio/Prompt/ls-i.yaml
+doc/ri/Folio/Link
+doc/ri/Folio/Link/lstat-i.yaml
+doc/ri/Folio/Link/link%3f-i.yaml
+doc/ri/Folio/Link/cdesc-Link.yaml
+doc/ri/Folio/Link/lchmod-i.yaml
+doc/ri/Folio/Link/lchown-i.yaml
+doc/ri/Folio/Link/symlink%3f-i.yaml
+doc/ri/Folio/Link/new-c.yaml
+doc/ri/Folio/Link/readlink-i.yaml
+doc/ri/Folio/Link/method_missing-i.yaml
+doc/ri/Folio/FileObject
+doc/ri/Folio/FileObject/chmod-i.yaml
+doc/ri/Folio/FileObject/split-i.yaml
+doc/ri/Folio/FileObject/unlink_force-i.yaml
+doc/ri/Folio/FileObject/rm_f-i.yaml
+doc/ri/Folio/FileObject/readable%3f-i.yaml
+doc/ri/Folio/FileObject/touch-i.yaml
+doc/ri/Folio/FileObject/symlink-i.yaml
+doc/ri/Folio/FileObject/writable_real%3f-i.yaml
+doc/ri/Folio/FileObject/delete_force-i.yaml
+doc/ri/Folio/FileObject/atime-i.yaml
+doc/ri/Folio/FileObject/ln-i.yaml
+doc/ri/Folio/FileObject/readable_real%3f-i.yaml
+doc/ri/Folio/FileObject/mv-i.yaml
+doc/ri/Folio/FileObject/size%3f-i.yaml
+doc/ri/Folio/FileObject/owned%3f-i.yaml
+doc/ri/Folio/FileObject/chardev%3f-i.yaml
+doc/ri/Folio/FileObject/link-i.yaml
+doc/ri/Folio/FileObject/grpowned%3f-i.yaml
+doc/ri/Folio/FileObject/stat%21-i.yaml
+doc/ri/Folio/FileObject/identical%3f-i.yaml
+doc/ri/Folio/FileObject/%3c%3d%3e-i.yaml
+doc/ri/Folio/FileObject/blockdev%3f-i.yaml
+doc/ri/Folio/FileObject/util-i.yaml
+doc/ri/Folio/FileObject/delete-i.yaml
+doc/ri/Folio/FileObject/relative-i.yaml
+doc/ri/Folio/FileObject/utime-i.yaml
+doc/ri/Folio/FileObject/fnmatch%3f-i.yaml
+doc/ri/Folio/FileObject/ln_sf-i.yaml
+doc/ri/Folio/FileObject/chown-i.yaml
+doc/ri/Folio/FileObject/restat-i.yaml
+doc/ri/Folio/FileObject/ln_s-i.yaml
+doc/ri/Folio/FileObject/inspect-i.yaml
+doc/ri/Folio/FileObject/size-i.yaml
+doc/ri/Folio/FileObject/exists%3f-i.yaml
+doc/ri/Folio/FileObject/cp-i.yaml
+doc/ri/Folio/FileObject/setgid%3f-i.yaml
+doc/ri/Folio/FileObject/symlink_force-i.yaml
+doc/ri/Folio/FileObject/socket%3f-i.yaml
+doc/ri/Folio/FileObject/unlink-i.yaml
+doc/ri/Folio/FileObject/%3d%3d-i.yaml
+doc/ri/Folio/FileObject/zero%3f-i.yaml
+doc/ri/Folio/FileObject/setuid%3f-i.yaml
+doc/ri/Folio/FileObject/exist%3f-i.yaml
+doc/ri/Folio/FileObject/basename-i.yaml
+doc/ri/Folio/FileObject/ctime-i.yaml
+doc/ri/Folio/FileObject/cdesc-FileObject.yaml
+doc/ri/Folio/FileObject/ln_f-i.yaml
+doc/ri/Folio/FileObject/file%3f-i.yaml
+doc/ri/Folio/FileObject/directory%3f-i.yaml
+doc/ri/Folio/FileObject/stat-i.yaml
+doc/ri/Folio/FileObject/install-i.yaml
+doc/ri/Folio/FileObject/to_s-i.yaml
+doc/ri/Folio/FileObject/extname-i.yaml
+doc/ri/Folio/FileObject/%5b%5d-c.yaml
+doc/ri/Folio/FileObject/writable%3f-i.yaml
+doc/ri/Folio/FileObject/link_force-i.yaml
+doc/ri/Folio/FileObject/mtime-i.yaml
+doc/ri/Folio/FileObject/new-c.yaml
+doc/ri/Folio/FileObject/pipe%3f-i.yaml
+doc/ri/Folio/FileObject/rename-i.yaml
+doc/ri/Folio/FileObject/sticky%3f-i.yaml
+doc/ri/Folio/FileObject/rm-i.yaml
+doc/ri/Folio/FileObject/dirname-i.yaml
+doc/ri/Folio/FileObject/fnmatch-i.yaml
+doc/ri/Folio/Pipe
+doc/ri/Folio/Pipe/cdesc-Pipe.yaml
+doc/ri/Folio/Pipe/new-c.yaml
+doc/ri/Folio/Pipe/pipe%3f-i.yaml
+doc/ri/Folio/Socket
+doc/ri/Folio/Socket/cdesc-Socket.yaml
+doc/ri/Folio/Socket/new-c.yaml
+doc/ri/Folio/Document
+doc/ri/Folio/Document/open-i.yaml
+doc/ri/Folio/Document/read-i.yaml
+doc/ri/Folio/Document/cdesc-Document.yaml
+doc/ri/Folio/Document/executable%3f-i.yaml
+doc/ri/Folio/Document/readlines-i.yaml
+doc/ri/Folio/Document/delete-i.yaml
+doc/ri/Folio/Document/intialize-i.yaml
+doc/ri/Folio/Document/unlink-i.yaml
+doc/ri/Folio/Document/truncate-i.yaml
+doc/ri/Folio/Document/file%3f-i.yaml
+doc/ri/Folio/Document/executable_real%3f-i.yaml
+doc/ri/Folio/FileNotFound
+doc/ri/Folio/FileNotFound/cdesc-FileNotFound.yaml
+doc/ri/Folio/Device
+doc/ri/Folio/Device/cdesc-Device.yaml
+doc/ri/Folio/Device/new-c.yaml
+doc/ri/Folio/BlockDevice
+doc/ri/Folio/BlockDevice/blockdev%3f-i.yaml
+doc/ri/Folio/BlockDevice/cdesc-BlockDevice.yaml
+doc/ri/Folio/CharacterDevice
+doc/ri/Folio/CharacterDevice/chardev%3f-i.yaml
+doc/ri/Folio/CharacterDevice/cdesc-CharacterDevice.yaml
+doc/ri/Folio/Directory
+doc/ri/Folio/Directory/%2b-i.yaml
+doc/ri/Folio/Directory/entries-i.yaml
+doc/ri/Folio/Directory/rm_rf-i.yaml
+doc/ri/Folio/Directory/paths-i.yaml
+doc/ri/Folio/Directory/delete-i.yaml
+doc/ri/Folio/Directory/chroot-i.yaml
+doc/ri/Folio/Directory/%2f-i.yaml
+doc/ri/Folio/Directory/chdir-i.yaml
+doc/ri/Folio/Directory/foreach-i.yaml
+doc/ri/Folio/Directory/unlink-i.yaml
+doc/ri/Folio/Directory/rmdir-i.yaml
+doc/ri/Folio/Directory/cdesc-Directory.yaml
+doc/ri/Folio/Directory/chown_r-i.yaml
+doc/ri/Folio/Directory/directory%3f-i.yaml
+doc/ri/Folio/Directory/cp_r-i.yaml
+doc/ri/Folio/Directory/rm_r-i.yaml
+doc/ri/Folio/Directory/chmod_r-i.yaml
+doc/ri/Folio/Directory/new-c.yaml
+doc/ri/Folio/Directory/cd-i.yaml
+doc/ri/Folio/cdesc-Folio.yaml
+doc/ri/created.rid
+test
+test/test_folio.rb
+test/test_helper.rb
+test/fixture
+test/fixture/foo.txt
+test/fixture/sub
+test/fixture/bar.txt
+README
+METADATA
+demo
+demo/sample1
+demo/sample1/bar
+demo/sample1/foo
+demo/sample1/foo/foo.txt
+demo/sample1/tryme.rb
+lib
+lib/folio
+lib/folio/link.rb
+lib/folio/pipe.rb
+lib/folio/directory.rb
+lib/folio/device.rb
+lib/folio/errors.rb
+lib/folio/document.rb
+lib/folio/fileobject.rb
+lib/folio/socket.rb
+lib/folio/prompt.rb
+lib/folio.rb
+NEWS
+COPYING

data/METADATA

@@ -0,0 +1,8 @@
+name      : folio
+version   : 0.1.0
+status    : alpha
+homepage  : http://folio.rubyforge.org
+author    : trans <transfire@gmail.com>
+summary   : Folio is a better way to access the file system.
+abstract  : Folio is a better way to access the file system.
+

data/NEWS

@@ -0,0 +1,9 @@
+= News & Release Notes
+
+== 0.1.0 // 2008-08-18
+
+Folio was spawned by ruby-talk:311762.
+
+This is the initial release of Folio.
+As such it is very much an alpha release!!!
+

data/README

@@ -0,0 +1,69 @@
+= Folio
+
+  http://folio.rubyforge.org
+
+== Introduction
+
+Folio is a "better way" to access the filesystem in your Ruby programs.
+It works by elmulating the behavior of a command shell. So just as
+you @cd@ up and down the file hierarchy at a shell prompt, you do the
+same against a Filio Prompt object.
+
+In addition Folio wraps all the common File System objects, providing a
+more intutive means of handling these in an dobject-oriented manner.
+For instance, Folio::Link represents a link on the file system, and just
+as the link references another file, so de the Folio::Link object 
+deletgate to another Folio file object.
+
+
+== Usage
+
+Since this is such an early release the API is still subject to change.
+But the basic idea remains the same:
+
+  require 'folio'
+
+  # get a folio prompt on the current directory (Dir.pwd).
+  cursor = Folio::Prompt.new
+
+  # return a list of directory's entries as strings.
+  cursor.ls
+
+  # return a list of directories as Directory objects.
+  cursor.directories
+
+  # return a list of regular files as Document objects.
+  cursor.documents
+
+  # Change down to the foo directory.
+  cursor.cd('foo')
+
+  # return a list of all entries as File objects.
+  p cursor.files
+
+
+
+== Install
+
+You know the Gem drill.
+
+  $ gem install folio
+
+And you may know the Setup drill.*
+
+  $ tar -xvzf folio-0.1.0.tgz
+  $ cd folio-0.1.0.tgz
+  $ ruby setup.rb
+
+*requires <a href="http://setup.rubyforge.org">Ruby Setup</a>
+
+== Resources
+
+<a href="rio.rubyforge.org">Rio<a> is a similar too. It's very well documented, but has a different
+design philiosophy having it's own more unique DSL.
+
+== Copying
+
+Folio is Copyright (c)2008 Tiger Ops & Thomas Sawyer
+Folio is distributed under the terms of the GPLv3.
+

data/demo/sample1/foo/foo.txt

@@ -0,0 +1 @@
+This is Foo file.

data/demo/sample1/tryme.rb

@@ -0,0 +1,14 @@
+require 'folio'
+
+cursor = Folio::Prompt.new(File.dirname(__FILE__))
+
+p cursor.ls
+
+p cursor.directories
+
+p cursor.files
+
+cursor.cd('foo')
+
+p cursor.files
+

data/doc/rdoc/classes/Folio/BlockDevice.html

@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <title>Class: Folio::BlockDevice</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+    <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+
+    <script language="JavaScript" type="text/javascript">
+    // <![CDATA[
+
+        function toggleSource( id )
+        {
+          var elem
+          var link
+
+          if( document.getElementById )
+          {
+            elem = document.getElementById( id )
+            link = document.getElementById( "l_" + id )
+          }
+          else if ( document.all )
+          {
+            elem = eval( "document.all." + id )
+            link = eval( "document.all.l_" + id )
+          }
+          else
+            return false;
+
+          if( elem.style.display == "block" )
+          {
+            elem.style.display = "none"
+            link.innerHTML = "show source"
+          }
+          else
+          {
+            elem.style.display = "block"
+            link.innerHTML = "hide source"
+          }
+        }
+
+        function openCode( url )
+        {
+          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
+        }
+      // ]]>
+    </script>
+  </head>
+
+  <body>
+  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
+  <td class="file-title"><span class="file-title-prefix">Class</span><br />Folio::BlockDevice</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../files/lib/folio/device_rb.html">lib/folio/device.rb</a>
+        </td>
+      </tr>
+    <tr>
+      <td>Parent:</td>
+      <td>
+        <a href="Device.html">
+Device
+         </a>
+     </td>
+   </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+
+  <div id="bodyContent">
+      <div id="content">
+
+  <div class="description"><p>
+Block device
+</p>
+</div>
+
+
+
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000031">blockdev?</a></li>
+  </ul>
+
+
+
+
+
+
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000031"></a><b>blockdev?</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000031_source')" id="l_M000031_source">show source</a> ]</p>
+  <div id="M000031_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/folio/device.rb, line 24</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">blockdev?</span> ; <span class="ruby-keyword kw">true</span> ; <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+
+  </div>
+
+    </body>
+</html>

data/doc/rdoc/classes/Folio/CharacterDevice.html

@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <title>Class: Folio::CharacterDevice</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+    <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+
+    <script language="JavaScript" type="text/javascript">
+    // <![CDATA[
+
+        function toggleSource( id )
+        {
+          var elem
+          var link
+
+          if( document.getElementById )
+          {
+            elem = document.getElementById( id )
+            link = document.getElementById( "l_" + id )
+          }
+          else if ( document.all )
+          {
+            elem = eval( "document.all." + id )
+            link = eval( "document.all.l_" + id )
+          }
+          else
+            return false;
+
+          if( elem.style.display == "block" )
+          {
+            elem.style.display = "none"
+            link.innerHTML = "show source"
+          }
+          else
+          {
+            elem.style.display = "block"
+            link.innerHTML = "hide source"
+          }
+        }
+
+        function openCode( url )
+        {
+          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
+        }
+      // ]]>
+    </script>
+  </head>
+
+  <body>
+  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
+  <td class="file-title"><span class="file-title-prefix">Class</span><br />Folio::CharacterDevice</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../files/lib/folio/device_rb.html">lib/folio/device.rb</a>
+        </td>
+      </tr>
+    <tr>
+      <td>Parent:</td>
+      <td>
+        <a href="Device.html">
+Device
+         </a>
+     </td>
+   </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+
+  <div id="bodyContent">
+      <div id="content">
+
+  <div class="description"><p>
+Character device
+</p>
+</div>
+
+
+
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000139">chardev?</a></li>
+  </ul>
+
+
+
+
+
+
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000139"></a><b>chardev?</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000139_source')" id="l_M000139_source">show source</a> ]</p>
+  <div id="M000139_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/folio/device.rb, line 17</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chardev?</span> ; <span class="ruby-keyword kw">true</span> ; <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+
+  </div>
+
+    </body>
+</html>