mast 1.3.0 → 1.4.0

data/lib/mast/manifest.rb

@@ -4,10 +4,6 @@ module Mast
   require 'shellwords'
   require 'mast/core_ext'
 
-  # Manifest stores a list of package files, and optionally checksums.
-  #
-  # The class can be used to create and compare package manifests and digests.
-  #
   # TODO: Integrate file signing and general manifest better (?)
   #
   # TODO: Digester is in sign.rb too. Dry-up?
@@ -20,6 +16,13 @@ module Mast
   # to just [doc]. Otherwise we will get duplicate entries, b/c the #output
   # method is written for speed and low memory footprint. This might mean @include
   # can't use file globs.
+
+  # Manifest stores a list of package files, and optionally checksums.
+  #
+  # The class can be used to create and compare package manifests and digests.
+  #
+  # Note that the #diff method currently shells out. Eventually this will be
+  # internalized.
   #
   class Manifest
 
@@ -29,7 +32,9 @@ module Mast
 
     # No Manifest File Error.
     #
-    NoManifestError = Class.new(LoadError)
+    NoManifestError = Class.new(LoadError) do
+      def message; "ERROR: no manifest file"; end
+    end
 
     # By default mast will exclude any pathname matching
     # 'CVS', '_darcs', '.git*' or '.config'.
@@ -74,6 +79,9 @@ module Mast
     # Show as if another manifest (i.e. use file's bang options).
     attr_accessor :bang
 
+    # Omit mast header from manifest output.
+    attr_accessor :headless
+
     # What files to include. Defaults to ['*'].
     # Note that Mast automatically recurses through
     # directory entries, so using '**/*' would simply
@@ -92,6 +100,9 @@ module Mast
     # Files and checksums listed in file.
     #attr_reader :list
 
+    # An IO object to output manifest. Default is `$stdout`.
+    attr_accessor :io
+
     #
     alias_method :all?, :all
 
@@ -101,6 +112,10 @@ module Mast
     #
     alias_method :bang?, :bang
 
+    #
+    alias_method :headless?, :headless
+
+
     # New Manifest object.
     #
     def initialize(options={})
@@ -113,6 +128,7 @@ module Mast
       @bang      = false
       @digest    = nil
       @directory = Dir.pwd
+      @io        = $stdout
 
       change_options(options)
 
@@ -173,9 +189,10 @@ module Mast
     #end
 
     # Generate manifest.
-    def generate(out=$stdout)
+    def generate(out=nil)
+      out ||= self.io
       parse_topline unless read? if bang?
-      out << topline_string
+      out << topline_string unless headless?
       output(out)
     end
 
@@ -304,7 +321,8 @@ module Mast
   private
 
     #
-    def output(out=$stdout)
+    def output(out=nil)
+      out ||= self.io
       Dir.chdir(directory) do
         exclusions  # seed exclusions
         #rec_output('*', out)
@@ -315,7 +333,8 @@ module Mast
     end
 
     # Generate listing on the fly.
-    def rec_output(match, out=$stdout)
+    def rec_output(match, out=nil)
+      out ||= self.io
       out.flush unless Array === out
       #match = (location == dir ? '*' : File.join(dir,'*'))
       files = Dir.glob(match, File::FNM_DOTMATCH) - exclusions

data/man/man1/mast.1

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "MAST" "1" "November 2010" "RubyWorks" "Mast"
+.TH "MAST" "1" "October 2011" "RubyWorks" "Mast"
 .
 .SH "NAME"
 \fBmast\fR \- manifest generator
@@ -46,6 +46,10 @@ List files given in the manifest but are non\-existent\.
 Verify that a manifest matches actual\.
 .
 .TP
+\fB\-r\fR, \fB\-\-recent\fR
+Verify that a manifest is more recent than actual\.
+.
+.TP
 \fB\-\-clean\fR
 Remove non\-manifest files\. (Will ask for confirmation first\.)
 .
@@ -84,8 +88,12 @@ Exclude a file or dir from the manifest matching against full pathname\. You can
 Exclude a file or dir from the manifest matching against an entries basename\. You can use \-\-ignore repeatedly\.
 .
 .TP
-\fB\-q\fR, \fB\-\-quiet\fR
-Suppress any extraneous output\.
+\fB\-\-no\-head\fR
+Suppress mast header from output\.
+.
+.TP
+\fB\-\-debug\fR
+Run command with Ruby\'s $DEBUG flag set to \fBtrue\fR\.
 .
 .SH "EXAMPLES"
 \fBmast\fR

data/man/man1/mast.1.html

@@ -0,0 +1,154 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv='content-type' value='text/html;charset=utf8'>
+  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
+  <title>mast(1) - manifest generator</title>
+  <style type='text/css' media='all'>
+  /* style: man */
+  body#manpage {margin:0}
+  .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
+  .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
+  .mp h2 {margin:10px 0 0 0}
+  .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
+  .mp h3 {margin:0 0 0 4ex}
+  .mp dt {margin:0;clear:left}
+  .mp dt.flush {float:left;width:8ex}
+  .mp dd {margin:0 0 0 9ex}
+  .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
+  .mp pre {margin-bottom:20px}
+  .mp pre+h2,.mp pre+h3 {margin-top:22px}
+  .mp h2+pre,.mp h3+pre {margin-top:5px}
+  .mp img {display:block;margin:auto}
+  .mp h1.man-title {display:none}
+  .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
+  .mp h2 {font-size:16px;line-height:1.25}
+  .mp h1 {font-size:20px;line-height:2}
+  .mp {text-align:justify;background:#fff}
+  .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
+  .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
+  .mp u {text-decoration:underline}
+  .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
+  .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
+  .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
+  .mp b.man-ref {font-weight:normal;color:#434241}
+  .mp pre {padding:0 4ex}
+  .mp pre code {font-weight:normal;color:#434241}
+  .mp h2+pre,h3+pre {padding-left:0}
+  ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
+  ol.man-decor {width:100%}
+  ol.man-decor li.tl {text-align:left}
+  ol.man-decor li.tc {text-align:center;letter-spacing:4px}
+  ol.man-decor li.tr {text-align:right;float:right}
+  </style>
+  <style type='text/css' media='all'>
+  /* style: toc */
+  .man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
+  .man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
+  .man-navigation a:hover {color:#111;text-decoration:underline}
+  </style>
+</head>
+<!--
+  The following styles are deprecated and will be removed at some point:
+  div#man, div#man ol.man, div#man ol.head, div#man ol.man.
+
+  The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
+  .man-navigation should be used instead.
+-->
+<body id='manpage'>
+  <div class='mp' id='man'>
+
+  <div class='man-navigation' style='display:none'>
+    <a href="#NAME">NAME</a>
+    <a href="#SYNOPSIS">SYNOPSIS</a>
+    <a href="#DESCRIPTION">DESCRIPTION</a>
+    <a href="#COMMANDS">COMMANDS</a>
+    <a href="#OPTIONS">OPTIONS</a>
+    <a href="#EXAMPLES">EXAMPLES</a>
+    <a href="#SEE-ALSO">SEE ALSO</a>
+    </div>
+
+  <ol class='man-decor man-head man head'>
+    <li class='tl'>mast(1)</li>
+    <li class='tc'>Mast</li>
+    <li class='tr'>mast(1)</li>
+  </ol>
+
+  <h2 id="NAME">NAME</h2>
+<p class="man-name">
+  <code>mast</code> - <span class="man-whatis">manifest generator</span>
+</p>
+
+<h2 id="SYNOPSIS">SYNOPSIS</h2>
+
+<p><code>mast [&lt;command>] [&lt;options>...]</code></p>
+
+<h2 id="DESCRIPTION">DESCRIPTION</h2>
+
+<p>The manifest listing tool is used to list, create or update a
+manifest for a directory (eg. to define a "package"), or compare
+a manifest to actual directory contents. Mast is part of the
+ProUtils set of tools.</p>
+
+<p>When no command is given, a manifest is dumped to standard out.
+If --file is specified, it will generate to that file instead.</p>
+
+<h2 id="COMMANDS">COMMANDS</h2>
+
+<dl>
+<dt><code>-c</code>, <code>--create</code></dt><dd><p> Generate a new manifest. (default)</p></dd>
+<dt><code>-u</code>, <code>--update</code></dt><dd><p>Update an existing manifest.</p></dd>
+<dt><code>-l</code>, <code>--list</code></dt><dd><p>List the files given in the manifest file. (Use -f to specify an alternate file.)</p></dd>
+<dt><code>-D</code>, <code>--diff</code></dt><dd><p>Diff manifest file against actual.</p></dd>
+<dt><code>-n</code>, <code>--new</code></dt><dd><p>List existant files that are not given in the manifest.</p></dd>
+<dt><code>-o</code>, <code>--old</code></dt><dd><p>List files given in the manifest but are non-existent.</p></dd>
+<dt><code>-v</code>, <code>--verify</code></dt><dd><p>Verify that a manifest matches actual.</p></dd>
+<dt><code>-r</code>, <code>--recent</code></dt><dd><p>Verify that a manifest is more recent than actual.</p></dd>
+<dt class="flush"><code>--clean</code></dt><dd><p>Remove non-manifest files. (Will ask for confirmation first.)</p></dd>
+<dt><code>-h</code>, <code>--help</code></dt><dd><p>Display this help message.</p></dd>
+</dl>
+
+
+<h2 id="OPTIONS">OPTIONS</h2>
+
+<dl>
+<dt><code>-a</code>, <code>--all</code></dt><dd><p>Include all files. This deactivates deafult exclusions
+so it is possible to make complete list of all contents.</p></dd>
+<dt><code>-d</code>, <code>--dir</code></dt><dd><p>When creating a list include directory paths; by default
+only files are listed.</p></dd>
+<dt><code>-b</code>, <code>--bang</code></dt><dd><p>Generate manifest using the options from the bang line of the manifest file.</p></dd>
+<dt><code>-f</code>, <code>--file PATH</code></dt><dd><p>Path to manifest file. This applies to comparison commands.
+If not given then the file matching 'MANIFEST', case-insensitive
+and with an optional '.txt' extension, in the current directory
+is used. If the path of the manifest file is anything else then
+the --file option must be specified.</p></dd>
+<dt><code>-g</code>, <code>--digest TYPE</code></dt><dd><p>Include crytographic signiture. Type can be either
+md5, sha1, sha128, sha256, or sha512.</p></dd>
+<dt><code>-x</code>, <code>--exclude PATH</code></dt><dd><p>Exclude a file or dir from the manifest matching against
+full pathname. You can use --exclude repeatedly.</p></dd>
+<dt><code>-i</code>, <code>--ignore PATH</code></dt><dd><p>Exclude a file or dir from the manifest matching against
+an entries basename. You can use --ignore repeatedly.</p></dd>
+<dt><code>--no-head</code></dt><dd><p>Suppress mast header from output.</p></dd>
+<dt class="flush"><code>--debug</code></dt><dd><p>Run command with Ruby's $DEBUG flag set to <code>true</code>.</p></dd>
+</dl>
+
+
+<h2 id="EXAMPLES">EXAMPLES</h2>
+
+<p><code>mast</code><br />
+<code>mast -u -f PUBLISH</code></p>
+
+<h2 id="SEE-ALSO">SEE ALSO</h2>
+
+<p><span class="man-ref">ls<span class="s">(1)</span></span></p>
+
+
+  <ol class='man-decor man-foot man foot'>
+    <li class='tl'>RubyWorks</li>
+    <li class='tc'>October 2011</li>
+    <li class='tr'>mast(1)</li>
+  </ol>
+
+  </div>
+</body>
+</html>

data/{ronn → man/man1}/mast.1.ronn

@@ -15,6 +15,7 @@ ProUtils set of tools.
 When no command is given, a manifest is dumped to standard out.
 If --file is specified, it will generate to that file instead.
 
+
 ## COMMANDS
 
   * `-c`, `--create`:
@@ -38,12 +39,16 @@ If --file is specified, it will generate to that file instead.
   * `-v`, `--verify`:
     Verify that a manifest matches actual.
 
+  * `-r`, `--recent`:
+    Verify that a manifest is more recent than actual.
+
   * `--clean`:
     Remove non-manifest files. (Will ask for confirmation first.)
 
   * `-h`, `--help`:
     Display this help message.
 
+
 ## OPTIONS
 
   * `-a`, `--all`:
@@ -76,14 +81,19 @@ If --file is specified, it will generate to that file instead.
     Exclude a file or dir from the manifest matching against 
     an entries basename. You can use --ignore repeatedly.
 
-  * `-q`, `--quiet`:
-    Suppress any extraneous output.
+  * `--no-head`:
+    Suppress mast header from output.
+
+  * `--debug`:
+    Run command with Ruby's $DEBUG flag set to `true`.
+
 
 ## EXAMPLES
 
 `mast`<br>
 `mast -u -f PUBLISH`
 
+
 ## SEE ALSO
 
 ls(1)

metadata

@@ -1,116 +1,95 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: mast
-version: !ruby/object:Gem::Version 
-  hash: 27
-  prerelease: false
-  segments: 
-  - 1
-  - 3
-  - 0
-  version: 1.3.0
+version: !ruby/object:Gem::Version
+  version: 1.4.0
+  prerelease: 
 platform: ruby
-authors: 
-- Thomas Sawyer
+authors:
+- Trans
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-11-20 00:00:00 -05:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: syckle
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+date: 2011-10-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: detroit
+  requirement: &21819740 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: qed
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *21819740
+- !ruby/object:Gem::Dependency
+  name: qed
+  requirement: &21810260 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id002
-description: Mast is a command line tool for generating manifests and digests. Mast makes it easy to compare a manifest to a current directory structure, and to update the manifest with a simple command by storing the command option it the manifest file itself.
-email: proutils@googlegroups.com
-executables: 
+  prerelease: false
+  version_requirements: *21810260
+description: ! 'Mast is a command line tool for generating manifests and digests.
+  Mast makes
+
+  it easy to compare a manifest to a current directory structure, and to update
+
+  the manifest with a simple command by storing the command options it the
+
+  manifest file itself.'
+email:
+- transfire@gmail.com
+executables:
 - mast
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
+- HISTORY.rdoc
 - README.rdoc
-files: 
+- QED.rdoc
+- COPYING.rdoc
+files:
+- .ruby
 - bin/mast
 - lib/mast/cli.rb
 - lib/mast/core_ext.rb
 - lib/mast/manifest.rb
-- lib/mast/meta/data.rb
-- lib/mast/meta/package
-- lib/mast/meta/profile
 - lib/mast.rb
+- lib/mast.yml
 - lib/plugins/syckle/mast.rb
+- man/man1/index.txt
 - man/man1/mast.1
-- meta/data.rb
-- meta/package
-- meta/profile
-- qed/cli/applique/env.rb
-- qed/cli/overview.rdoc
-- ronn/index.txt
-- ronn/mast.1.ronn
+- man/man1/mast.1.html
+- man/man1/mast.1.ronn
 - HISTORY.rdoc
-- LICENSE
 - README.rdoc
-has_rdoc: true
-homepage: http://proutils.github.com/mast
-licenses: 
-- ""
+- QED.rdoc
+- COPYING.rdoc
+homepage: http://rubyworks.github.com/mast/
+licenses: []
 post_install_message: 
-rdoc_options: 
-- --title
-- Mast API
-- --main
-- README.rdoc
-require_paths: 
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: mast
-rubygems_version: 1.3.7
+rubyforge_project: 
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: Mast is a command line tool for generating manifests and digests.
 test_files: []
-