rwdtinker 1.83 → 1.84

data/lib/zip/zipfilesystem.rb

@@ -1,9 +1,42 @@
-require 'zip/zip'
+require 'lib/zip/zip'
 
 module Zip
+
+  # The ZipFileSystem API provides an API for accessing entries in 
+  # a zip archive that is similar to ruby's builtin File and Dir 
+  # classes.
+  #
+  # Requiring 'zip/zipfilesystem' includes this module in ZipFile
+  # making the methods in this module available on ZipFile objects.
+  #
+  # Using this API the following example creates a new zip file 
+  # <code>my.zip</code> containing a normal entry with the name
+  # <code>first.txt</code>, a directory entry named <code>mydir</code>
+  # and finally another normal entry named <code>second.txt</code>
+  #
+  #   require 'zip/zipfilesystem'
+  #   
+  #   Zip::ZipFile.open("my.zip", Zip::ZipFile::CREATE) {
+  #     |zipfile|
+  #     zipfile.file.open("first.txt", "w") { |f| f.puts "Hello world" }
+  #     zipfile.dir.mkdir("mydir")
+  #     zipfile.file.open("mydir/second.txt", "w") { |f| f.puts "Hello again" }
+  #   }
+  #
+  # Reading is as easy as writing, as the following example shows. The 
+  # example writes the contents of <code>first.txt</code> from zip archive
+  # <code>my.zip</code> to standard out.
+  #
+  #   require 'zip/zipfilesystem'
+  #   
+  #   Zip::ZipFile.open("my.zip") {
+  #     |zipfile|
+  #     puts zipfile.file.read("first.txt")
+  #   }
+
   module ZipFileSystem
 
-    def initialize
+    def initialize # :nodoc:
       mappedZip = ZipFileNameMapper.new(self)
       @zipFsDir  = ZipFsDir.new(mappedZip)
       @zipFsFile = ZipFsFile.new(mappedZip)
@@ -11,14 +44,26 @@ module Zip
       @zipFsFile.dir = @zipFsDir
     end
 
+    # Returns a ZipFsDir which is much like ruby's builtin Dir (class)
+    # object, except it works on the ZipFile on which this method is
+    # invoked
     def dir
       @zipFsDir
     end
     
+    # Returns a ZipFsFile which is much like ruby's builtin File (class)
+    # object, except it works on the ZipFile on which this method is
+    # invoked
     def file
       @zipFsFile
     end
-    
+
+    # Instances of this class are normally accessed via the accessor
+    # ZipFile::file. An instance of ZipFsFile behaves like ruby's
+    # builtin File (class) object, except it works on ZipFile entries.
+    #
+    # The individual methods are not documented due to their
+    # similarity with the methods in File
     class ZipFsFile
 
       attr_writer :dir
@@ -198,7 +243,7 @@ module Zip
 	@mappedZip.get_entry(fileName).size
       end
       
-      # nil for not found and nil for directories
+      # Returns nil for not found and nil for directories
       def size?(fileName)
 	entry = @mappedZip.find_entry(fileName)
 	return (entry == nil || entry.directory?) ? nil : entry.size
@@ -367,6 +412,12 @@ module Zip
       end
     end
 
+    # Instances of this class are normally accessed via the accessor
+    # ZipFile::dir. An instance of ZipFsDir behaves like ruby's
+    # builtin Dir (class) object, except it works on ZipFile entries.
+    #
+    # The individual methods are not documented due to their
+    # similarity with the methods in Dir
     class ZipFsDir
       
       def initialize(mappedZip)
@@ -431,7 +482,7 @@ module Zip
       alias rmdir  delete
       alias unlink delete
       
-      def mkdir(entryName, permissionInt = 0)
+      def mkdir(entryName, permissionInt = 0755)
         @mappedZip.mkdir(entryName, permissionInt)
       end
       
@@ -441,7 +492,7 @@ module Zip
 
     end
 
-    class ZipFsDirIterator
+    class ZipFsDirIterator # :nodoc:all
       include Enumerable
 
       def initialize(arrayOfFileNames)
@@ -481,7 +532,7 @@ module Zip
 
     # All access to ZipFile from ZipFsFile and ZipFsDir goes through a
     # ZipFileNameMapper, which has one responsibility: ensure
-    class ZipFileNameMapper
+    class ZipFileNameMapper # :nodoc:all
       include Enumerable
 
       def initialize(zipFile)
@@ -520,7 +571,7 @@ module Zip
                         &continueOnExistsProc)
       end
 
-      def mkdir(fileName, permissionInt = 0)
+      def mkdir(fileName, permissionInt = 0755)
         @zipFile.mkdir(expand_to_entry(fileName), permissionInt)
       end
 

data/lib/zip/ziprequire.rb

@@ -1,6 +1,35 @@
-require 'zip/zip'
+# With ziprequire you can load ruby modules from a zip file. This means
+# ruby's module include path can include zip-files.
+#
+# The following example creates a zip file with a single entry 
+# <code>log/simplelog.rb</code> that contains a single function 
+# <code>simpleLog</code>: 
+#
+#   require 'zip/zipfilesystem'
+#   
+#   Zip::ZipFile.open("my.zip", true) {
+#     |zf| 
+#     zf.file.open("log/simplelog.rb", "w") { 
+#       |f|
+#       f.puts "def simpleLog(v)"
+#       f.puts '  Kernel.puts "INFO: #{v}"'
+#       f.puts "end"
+#     }
+#   }
+#
+# To use the ruby module stored in the zip archive simply require
+# <code>zip/ziprequire</code> and include the <code>my.zip</code> zip 
+# file in the module search path. The following command shows one 
+# way to do this:
+#
+#   ruby -rzip/ziprequire -Imy.zip  -e " require 'log/simplelog'; simpleLog 'Hello world' "
 
-class ZipList
+#$: << 'data/rubycode.zip' << 'data/rubycode2.zip'
+
+
+require 'lib/zip/zip'
+
+class ZipList #:nodoc:all
   def initialize(zipFileList)
       @zipFileList = zipFileList
   end
@@ -23,7 +52,7 @@ class ZipList
 end
 
 
-module Kernel
+module Kernel #:nodoc:all
   alias :oldRequire :require
 
   def require(moduleName)

data/rwd_files/HowTo_Tinker.txt

@@ -228,8 +228,13 @@ http://www.erikveen.dds.nl/rubywebdialogs/index.html
 Thanks, Steven Gibson
 
 == Changelog
+version 1.84
+  added locale changer tab (have: en,es,ja,hi,nl,fr)
+  updated to newer Rubyzip library
+  
 version 1.83
   adding more Spanish and Hindu po strings
+  changed handling of log file
  
 version 1.82
   switch to po files for translation files

data/rwd_files/Tinkerhelptexthash.txt

@@ -1,4 +1,5 @@
- # Help files for RwdTinker core Application RwdTinker orginally (c) 2004 Steven Gibson under GPL. 
+
+# Help files for RwdTinker core Application RwdTinker orginally (c) 2004 Steven Gibson under GPL. 
    
   
  Helptext.update(  :network_help  => "Using over a Network: To serve the application over your local LAN,change the last line in the<br>
@@ -80,3 +81,4 @@ Then you should be able to login at: http://yourhostname:8080")
    You can view the list of rwdtinker applets you have installed already by clicking 'view already installed GEM applets'
  "
 )
+   Helptext.update( :localechanger_help => "#{Message[:locale_changer_help] }" )

data/rwdconfig.dist

@@ -7,7 +7,7 @@ ConfigLocation=""
 ##NAME: ($testharnessarray):(1.78)
 $testharnessarray = ["rwdtinker_all_tests"]
 ##NAME: (TestNow):(1.78)
-TestNow=false  # turning this on will run the unit tests
+TestNow= false # turning this on will run the unit tests
 ##NAME: ($testharness):(1.78)
 $testharness=true
 ##NAME: ($tinkerhelpaboutarray):(1.78)

data/tests/makedist.rb

@@ -15,7 +15,7 @@ require 'fileutils'
 
 DistroName = "rwdtinker"
 
-DistroVersion="1.83"
+DistroVersion="1.84"
 
 DistroTitle="#{DistroName}.dist"
 load "configuration/#{DistroTitle}"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rwdtinker
 version: !ruby/object:Gem::Version 
-  version: "1.83"
+  version: "1.84"
 platform: ruby
 authors: 
 - Steven Gibson
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-10-15 00:00:00 -07:00
+date: 2008-10-19 00:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -52,9 +52,11 @@ files:
 - code/superant.com.rwdtinkerbackwindow/listgemdirs.rb
 - code/superant.com.rwdtinkerbackwindow/viewlogfile.rb
 - code/superant.com.rwdtinkerbackwindow/diagnostictab.rb
+- code/superant.com.rwdtinkerbackwindow/showlocaleoptions.rb
 - code/superant.com.rwdtinkerbackwindow/listgemzips.rb
 - code/superant.com.rwdtinkerbackwindow/saveconfigurationrecord.rb
 - code/superant.com.rwdtinkerbackwindow/installremotegem.rb
+- code/superant.com.rwdtinkerbackwindow/changelocale.rb
 - code/superant.com.rwdtinkerbackwindow/rwdtinkerwin2version.rb
 - code/superant.com.rwdtinkerbackwindow/listinstalledfiles.rb
 - code/superant.com.rwdtinkerbackwindow/loadconfigurationrecord.rb
@@ -107,6 +109,7 @@ files:
 - gui/tinkerbackwindows/superant.com.tinkerhelpwindow/1appname.rwd
 - gui/tinkerbackwindows/superant.com.tinkerhelpwindow/9end.rwd
 - gui/tinkerbackwindows/superant.com.tinkerbackwindow
+- gui/tinkerbackwindows/superant.com.tinkerbackwindow/80localechanger.rwd
 - gui/tinkerbackwindows/superant.com.tinkerbackwindow/45installremotezip.rwd
 - gui/tinkerbackwindows/superant.com.tinkerbackwindow/70rwddiagnostics.rwd
 - gui/tinkerbackwindows/superant.com.tinkerbackwindow/1appname.rwd
@@ -145,11 +148,11 @@ files:
 - zips/tinkerbellw-0.03.zip
 - zips/rwdwmovies-0.98.zip
 - zips/temp.rb
-- zips/rwdwfoldeditor-0.05.zip
+- zips/rwdwfoldeditor-0.07.zip
 - zips/rwdwcalc-0.63.zip
 - zips/rwdwruby-1.08.zip
 - zips/wrubyslippers-1.08.zip
-- zips/rwdwmpd-0.07.zip
+- zips/rwdwhypernote-0.16.zip
 - tests/rdep.rb
 - tests/cleancnf.sh
 - tests/makedist.rb