smc-get 0.2.0.beta1 → 0.3.0.beta1

data/HISTORY.rdoc

@@ -1,31 +1,53 @@
-This file documents the the changes that have been made
-to smc-get between versions. It's *not* intended to serve
-as a full-blown changelog, for this you have to install git
-and issue a <tt>git log</tt> command in the project directory.
-
-Bugfixes are written in <i>italic</i>, mayor changes in <b>bold</b> font.
-
-== 0.2.0-beta1
-
-* <b>Added a completely new SMC package format: smcpak. These are XZ-compressed
-  tarballs allowing for easy deployment of packages. See the smcpak.rdoc file
-  for further information.</b>
-* <b>Rewrote nearly the full API. This release is 100%
-  incompatible with anything released so far.</b>
-* <b>New classes LocalRepository and RemoteRepository for
-  managing downloads and installations.</b>
-* <b><tt>smc-get list</tt> without arguments works a little different now. 
-  Instead of showing the installation time of a package it now shows the
-  time of the last update, which allows you to better keep track of
-  what is out of date.</b>
-* <b>Added <tt>smc-get update</tt> for a fully automated update of all (or
-  selected) installed packages.</b>
-* <b>Added <tt>smc-get build</tt> to automatically build SMC packages either
-  interactively or as an automated process.</b>
-* Added modification detection via SHA1 checksums.
-* New dependency on the {ruby-xz gem}[http://rubygems.org/gems/ruby-xz].
-* New dependency on the {minitar gem}[http://rubygems.org/gems/minitar].
-* New dependency on liblzma[http://tukaani.org/xz/].
-* Official bugtracker is now at GitHub: https://github.com/Luiji/smc-get/issues.
-* Added this file (HISTORY.rdoc) for collecting change information.
-
+This file documents the the changes that have been made
+to smc-get between versions. It's *not* intended to serve
+as a full-blown changelog, for this you have to install git
+and issue a <tt>git log</tt> command in the project directory.
+
+Bugfixes are written in <i>italic</i>, mayor changes in <b>bold</b> font.
+If a change is related to a ticket
+{on our issue tracker}[https://github.com/Luiji/smc-get/issues],
+the corresponding ticket is given in square brackets [ and ].
+
+== 0.3.0-beta1
+
+* Lots of smaller fixes and internal code improvements
+* We have a working default repository now!
+* Check specs for validness before they're installed
+* <i>Fixed a problem with <tt>smc-get uninstall</tt> not removing
+  directories.</i>
+* <b>Added the <tt>server</tt> command to <tt>smc-get</tt>.
+* Experimental script for converting Luiji's GitHub repo to the new
+  SMCPAK format.
+* <b>Added --local option to <tt>smc-get install</tt> for installing local
+  package files.</b>
+
+== 0.2.0-beta2
+
+* <i>Fixed world handling in packages [#4]</i>
+* <i>Added missing dependency tracking [#3]</i>
+* <i>Fixed startup crash on permission error.</i>
+
+== 0.2.0-beta1
+
+* <b>Added a completely new SMC package format: smcpak. These are XZ-compressed
+  tarballs allowing for easy deployment of packages. See the smcpak.rdoc file
+  for further information.</b>
+* <b>Rewrote nearly the full API. This release is 100%
+  incompatible with anything released so far.</b>
+* <b>New classes LocalRepository and RemoteRepository for
+  managing downloads and installations.</b>
+* <b><tt>smc-get list</tt> without arguments works a little different now. 
+  Instead of showing the installation time of a package it now shows the
+  time of the last update, which allows you to better keep track of
+  what is out of date.</b>
+* <b>Added <tt>smc-get update</tt> for a fully automated update of all (or
+  selected) installed packages.</b>
+* <b>Added <tt>smc-get build</tt> to automatically build SMC packages either
+  interactively or as an automated process.</b>
+* Added modification detection via SHA1 checksums.
+* New dependency on the {ruby-xz gem}[http://rubygems.org/gems/ruby-xz].
+* New dependency on the {minitar gem}[http://rubygems.org/gems/minitar].
+* New dependency on liblzma[http://tukaani.org/xz/].
+* Official bugtracker is now at GitHub: https://github.com/Luiji/smc-get/issues.
+* Added this file (HISTORY.rdoc) for collecting change information.
+

data/README.rdoc

@@ -1,163 +1,163 @@
-= SMC-GET -- level repository manager for Secret Maryo Chronicles
-smc-get - Library and command-line for managing SMC level packages.
-
-Author::      Luiji Maryo (mailto:luiji@users.sourceforge.net)
-Contributor:: Marvin Gülker (mailto:sutniuq@gmx.net)
-Copyright::   Copyright (C) 2010-2011 Entertaining Software, Inc.
-Copyright::   Copyright (C) 2011 Marvin Gülker
-License::     GNU General Public License (see COPYING)
-
-= Synopsis for use as a command-line tool
-  smc-get install mypackage
-  smc-get uninstall mypackage
-  smc-get help
-
-= Synopsis for use as a library
-  require 'smc_get'
-  # Initialize the library
-  SmcGet.setup
-  
-  # Bind to local and remote repositories
-  rr = SmcGet::RemoteRepository.new("http://example.org/smc-repo")
-  lr = SmcGet::LocalRepository.new("/usr/share/smc")
-  
-  # Get a package
-  path = rr.fetch_package("mypackage")
-  pkg = SmcGet::Package.from_file(pkg)
-  
-  # Install it!
-  lr.install(pkg)
-  
-  #...or remove it.
-  lr.uninstall("mypackage")
-
-= Description
-smc-get is a library and command-line tool for installing, uninstalling, etc.
-level packages from the Secret Maryo Chronicles Contributed Levels Repository.
-
-== Prototype Notice
-
-This program is a prototype for functionality that will eventually be merged
-with Secret Maryo Chronicles. It is subject to change and should not be used
-for anything other then testing.
-
-= Usage
-
-== Using it as a command-line
-smc-get's main purpose is to be used as a command-line utility.  It should be
-executed in the syntax:
- smc-get COMMAND [PARAMETERS...]
-Where <tt>COMMAND</tt> is the command and <tt>PARAMATERS...</tt> are the
-parameters for that command.
-
-To get help on the various commands, use the help command.
-  smc-get help [COMMAND]
-Ommit the +COMMAND+ if you want general usage information.
-
-=== Configuration file
-smc-get requires a configuration file when used as a commandline tool.
-By default it searches for <tt>smc-get.yml</tt> in the <b>config/</b>
-subdirectory of your smc-get installation, then for <tt>smc-get-conf.yml</tt>
-in the user's home directory and then for the file specified via the <tt>-c</tt>
-commandline switch, if existant. Values set in later evaluated configuration
-files override those in prevously evaluated ones; see
-  smc-get help
-for more explanation. If you want to use the CUI from your scripts, you
-can specify a config file via <tt>-c</tt>, but make sure it contains all
-possible options, otherwise those in the global or user-level config files
-may affect your program. See below for an example.
-
-Be careful when using +sudo+, because it changes the environment variables.
-smc-get may not find your user-level configuration file when using sudo,
-because it derives the path from the +USER+ environment variable which may
-get set to +root+ when using +sudo+.
-
-In the configuration file you can set some general options, look into
-the file which is quite self-explanatory. A sample configuration may
-look like this:
-  data_directory: "/usr/local/share/smc"
-  repo_url: "ftp://ftp.example.org/smc
-
-== Using it as a library
-smc-get, although mainly targetted at being a command-line utility, may also be
-used as a library.  This is useful when, for instance, creating a GUI front-end.
-
-To initialize the library, call SmcGet.setup which will do some basic initialization
-needed for use of the library.
-  SmcGet.setup
-For interacting with the SMC repository, smc-get exposes an object-oriented API
-centered around the Package and repository classes. Before you can do anything,
-you have to "establish" connections to a remote and a local repository, where
-remote repositories are repositories where <tt>smc-get</tt> downloads from,
-and local repositories are repositories where <tt>smc-get</tt> installs
-into, i.e. usually your SMC installation. You can use multiple repositories
-if you know how to manage it.
-
-  rr = SmcGet::RemoteRepository.new("http://example.org/smc-repo")
-  lr = SmcGet::LocalRepository.new("/usr/local/share/smc")
-
-After you initialized the library
-as explained above, you can query, install and uninstall packages.
-
-  path = rr.fetch_package("mypackage")
-  pkg = SmcGet::Package.from_file(path)
-  lr.install(pkg)
-
-If any of the methods fails, it will raise various exceptions.  When creating a GUI,
-you should catch these exceptions and present them as message boxes.
-
-  begin
-    rr.fetch_package("mypackage")
-  rescue SmcGet::Errors::NoSuchPackageError => e
-    alert "No such package: #{e.package_name}!"
-  end
-
-All errors smc-get raises are subclasses of SmcGet::Errors::SmcGetError. That
-means, if you rescue from this exception, you can handle all package-related
-errors at once:
-
-  begin
-    lr.install(pkg)
-  rescue SmcGet::Errors::SmcGetError => e
-    alert e.message
-  end
-
-Furthermore, these error messages should have a pretty informative message set,
-so unless you want to localize the error messages you can just reach them
-through (the messages, not the whole exceptions, of course).
-
-The configuration file only contains settings for the commandline user
-interface, so you don't need it here. If you want to use the CUI from
-your scripts, do
-  require "smc_get"
-  require "smc_get/cui"
-  
-  cui = SmcGet::CUI.new(ARGV)
-  cui.start
-The configuration file from the <b>config/</b> directory will automatically
-be loaded as well as the user-level configuration file; you may specify another
-configuration file by placing the appropriate option in ARGV:
-  ARGV.unshift("-c")
-  ARGV.unshift("YOURCONFIGFILE.yml")
-  
-  cui = SmcGet::CUI.new(ARGV)
-  cui.start
-
-= License
-
-smc-get is licensed under the GNU General Public License version 3 or later. For
-more information, see COPYING.
-
-= Website
-
-This software was written by Entertaining Software, Inc. Visit us at
-http://www.entertainingsoftware.com.
-
-This software is hosted at GitHub. The project page can be found at
-https://github.com/Luiji/smc-get.
-
-This software was written for Secret Maryo Chronicles. Visit them at
-http://www.secretmaryo.org.
-
-Bugs related to this software may be reported at 
+= SMC-GET -- level repository manager for Secret Maryo Chronicles
+smc-get - Library and command-line for managing SMC level packages.
+
+Author::      Luiji Maryo (mailto:luiji@users.sourceforge.net)
+Contributor:: Marvin Gülker (mailto:sutniuq@gmx.net)
+Copyright::   Copyright (C) 2010-2011 Entertaining Software, Inc.
+Copyright::   Copyright (C) 2011 Marvin Gülker
+License::     GNU General Public License (see COPYING)
+
+= Synopsis for use as a command-line tool
+  smc-get install mypackage
+  smc-get uninstall mypackage
+  smc-get help
+
+= Synopsis for use as a library
+  require 'smc_get'
+  # Initialize the library
+  SmcGet.setup
+  
+  # Bind to local and remote repositories
+  rr = SmcGet::RemoteRepository.new("http://example.org/smc-repo")
+  lr = SmcGet::LocalRepository.new("/usr/share/smc")
+  
+  # Get a package
+  path = rr.fetch_package("mypackage")
+  pkg = SmcGet::Package.from_file(pkg)
+  
+  # Install it!
+  lr.install(pkg)
+  
+  #...or remove it.
+  lr.uninstall("mypackage")
+
+= Description
+smc-get is a library and command-line tool for installing, uninstalling, etc.
+level packages from the Secret Maryo Chronicles Contributed Levels Repository.
+
+== Prototype Notice
+
+This program is a prototype for functionality that will eventually be merged
+with Secret Maryo Chronicles. It is subject to change and should not be used
+for anything other then testing.
+
+= Usage
+
+== Using it as a command-line
+smc-get's main purpose is to be used as a command-line utility.  It should be
+executed in the syntax:
+ smc-get COMMAND [PARAMETERS...]
+Where <tt>COMMAND</tt> is the command and <tt>PARAMATERS...</tt> are the
+parameters for that command.
+
+To get help on the various commands, use the help command.
+  smc-get help [COMMAND]
+Ommit the +COMMAND+ if you want general usage information.
+
+=== Configuration file
+smc-get requires a configuration file when used as a commandline tool.
+By default it searches for <tt>smc-get.yml</tt> in the <b>config/</b>
+subdirectory of your smc-get installation, then for <tt>smc-get-conf.yml</tt>
+in the user's home directory and then for the file specified via the <tt>-c</tt>
+commandline switch, if existant. Values set in later evaluated configuration
+files override those in prevously evaluated ones; see
+  smc-get help
+for more explanation. If you want to use the CUI from your scripts, you
+can specify a config file via <tt>-c</tt>, but make sure it contains all
+possible options, otherwise those in the global or user-level config files
+may affect your program. See below for an example.
+
+Be careful when using +sudo+, because it changes the environment variables.
+smc-get may not find your user-level configuration file when using sudo,
+because it derives the path from the +USER+ environment variable which may
+get set to +root+ when using +sudo+.
+
+In the configuration file you can set some general options, look into
+the file which is quite self-explanatory. A sample configuration may
+look like this:
+  data_directory: "/usr/local/share/smc"
+  repo_url: "ftp://ftp.example.org/smc
+
+== Using it as a library
+smc-get, although mainly targetted at being a command-line utility, may also be
+used as a library.  This is useful when, for instance, creating a GUI front-end.
+
+To initialize the library, call SmcGet.setup which will do some basic initialization
+needed for use of the library.
+  SmcGet.setup
+For interacting with the SMC repository, smc-get exposes an object-oriented API
+centered around the Package and repository classes. Before you can do anything,
+you have to "establish" connections to a remote and a local repository, where
+remote repositories are repositories where <tt>smc-get</tt> downloads from,
+and local repositories are repositories where <tt>smc-get</tt> installs
+into, i.e. usually your SMC installation. You can use multiple repositories
+if you know how to manage it.
+
+  rr = SmcGet::RemoteRepository.new("http://example.org/smc-repo")
+  lr = SmcGet::LocalRepository.new("/usr/local/share/smc")
+
+After you initialized the library
+as explained above, you can query, install and uninstall packages.
+
+  path = rr.fetch_package("mypackage")
+  pkg = SmcGet::Package.from_file(path)
+  lr.install(pkg)
+
+If any of the methods fails, it will raise various exceptions.  When creating a GUI,
+you should catch these exceptions and present them as message boxes.
+
+  begin
+    rr.fetch_package("mypackage")
+  rescue SmcGet::Errors::NoSuchPackageError => e
+    alert "No such package: #{e.package_name}!"
+  end
+
+All errors smc-get raises are subclasses of SmcGet::Errors::SmcGetError. That
+means, if you rescue from this exception, you can handle all package-related
+errors at once:
+
+  begin
+    lr.install(pkg)
+  rescue SmcGet::Errors::SmcGetError => e
+    alert e.message
+  end
+
+Furthermore, these error messages should have a pretty informative message set,
+so unless you want to localize the error messages you can just reach them
+through (the messages, not the whole exceptions, of course).
+
+The configuration file only contains settings for the commandline user
+interface, so you don't need it here. If you want to use the CUI from
+your scripts, do
+  require "smc_get"
+  require "smc_get/cui"
+  
+  cui = SmcGet::CUI.new(ARGV)
+  cui.start
+The configuration file from the <b>config/</b> directory will automatically
+be loaded as well as the user-level configuration file; you may specify another
+configuration file by placing the appropriate option in ARGV:
+  ARGV.unshift("-c")
+  ARGV.unshift("YOURCONFIGFILE.yml")
+  
+  cui = SmcGet::CUI.new(ARGV)
+  cui.start
+
+= License
+
+smc-get is licensed under the GNU General Public License version 3 or later. For
+more information, see COPYING.
+
+= Website
+
+This software was written by Entertaining Software, Inc. Visit us at
+http://www.entertainingsoftware.com.
+
+This software is hosted at GitHub. The project page can be found at
+https://github.com/Luiji/smc-get.
+
+This software was written for Secret Maryo Chronicles. Visit them at
+http://www.secretmaryo.org.
+
+Bugs related to this software may be reported at 
 https://github.com/Luiji/smc-get/issues.

data/VERSION.txt

@@ -1 +1 @@
-0.2.0-beta1
+0.3.0-beta1

data/bin/smc-checksum

@@ -1,44 +1,44 @@
-#!/usr/bin/env ruby
-#Encoding: UTF-8
-
-require "pathname"
-require "digest/sha1"
-
-PROG = File.basename($0)
-
-if ARGV.include?("-h") or ARGV.include?("--help")
-  puts(<<HELP)
-USAGE:
-  #{PROG} [FILES...]
-
-Prints out all SHA1 checksums of the FILES given at the commandline.
-FILES that are directories are listed recursively. If no FILES
-are given, recursively lists the current directory.
-HELP
-exit
-end
-
-Signal.trap("SIGINT"){exit}
-Signal.trap("SIGTERM"){exit}
-
-ARGV.unshift(".") if ARGV.empty?
-
-ARGV.each do |arg|
-  begin
-    path = Pathname.new(arg)
-    
-    if path.file?
-      puts "#{path}: #{Digest::SHA1.hexdigest(File.read(path))}"
-    else
-      path.find do |sub_path|
-        puts "#{sub_path}: #{Digest::SHA1.hexdigest(File.read(sub_path))}" if sub_path.file?
-      end
-    end
-  rescue Errno::ENOENT => e
-    $stderr.puts("WARNING: Not found: #{arg}.")
-    $stderr.puts("Skipping.")
-  rescue Errno::EACCES => e
-    $stderr.puts("WARNING: Permission denied: #{arg}.")
-    $stderr.puts("Skipping.")
-  end
-end
+#!/usr/bin/env ruby
+#Encoding: UTF-8
+
+require "pathname"
+require "digest/sha1"
+
+PROG = File.basename($0)
+
+if ARGV.include?("-h") or ARGV.include?("--help")
+  puts(<<HELP)
+USAGE:
+  #{PROG} [FILES...]
+
+Prints out all SHA1 checksums of the FILES given at the commandline.
+FILES that are directories are listed recursively. If no FILES
+are given, recursively lists the current directory.
+HELP
+exit
+end
+
+Signal.trap("SIGINT"){exit}
+Signal.trap("SIGTERM"){exit}
+
+ARGV.unshift(".") if ARGV.empty?
+
+ARGV.each do |arg|
+  begin
+    path = Pathname.new(arg)
+    
+    if path.file?
+      puts "#{path}: #{Digest::SHA1.hexdigest(File.read(path))}"
+    else
+      path.find do |sub_path|
+        puts "#{sub_path}: #{Digest::SHA1.hexdigest(File.read(sub_path))}" if sub_path.file?
+      end
+    end
+  rescue Errno::ENOENT => e
+    $stderr.puts("WARNING: Not found: #{arg}.")
+    $stderr.puts("Skipping.")
+  rescue Errno::EACCES => e
+    $stderr.puts("WARNING: Permission denied: #{arg}.")
+    $stderr.puts("Skipping.")
+  end
+end