rwdtinker 1.42 → 1.43

data/Readme.txt

@@ -1,21 +1,151 @@
-rwdapplications are web brower applications
+= RwdTinker framework for RubyWebDialogs
 
-The GUI interface used is RubyWebDialogs 
 
-RubyWebDialogs is a platform independent graphical user interface for Ruby applications. It generates HTML and serves it with an internal HTTP server, so you can use your favorite web browser as the front end for your Ruby application. All this means, that it can be used on almost every platform, like Ruby itself. http://www.erikveen.dds.nl/rubywebdialogs/
+RwdTinker is a web brower interface to and system for developing programs
+
+== Usage
+
+
+How to Use the Tinker framework Program (rwdtinker)
+
+
+1. stand alone application
+2. framework for building applications
+3. Open brower windows with html documents
+
+The GUI interface used is RubyWebDialogs 
 
 
-Start the program by:
-changing to the directory and
+Start the program by typing 
 ruby init.rb
 
 Then point your web browser to:
 http://localhost:7705/
 
-Or to the port that shows on the console or in the config.cnf file
 
-Requirements:
-RubyWebDialogs - I am using 0.0.11 2004-3-9
+== Viewing installed Applets:
+
+ 
+Go to "List Scripts" tab
+
+
+     You can get a list of all installed applets by clicking the listfiles button
+     
+      To see the text of a install file
+       Type in the name of the file you want.
+      
+       type it without the inf ending
+       rwdapplet-0.1
+       
+       Then click the "View Installed File" button
+       
+       If it finds the file it will open it. It displays the text the search box.
+
+      You can uninstall applets on this screen
+      
+== Installing Applets
+
+   click on the "Selection Panel"
+   click on Rwdtinker Back Window
+
+      You can download an applet created by someone else
+      put the file in the zips directory
+      
+      click on the "list zips" tab
+      click on "list applets available for installing"
+      
+      chose the applet you want
+      click on "install applet"
+      If all goes well the applet should be installed.
+      You will need to restart rwdtinker to see the new screens
+      
+      
+== Changing configuration file
+
+ click on "Edit Configuration"
+ You can view the configuration file
+ 
+  You can edit the configuration
+  
+  Remember to reload the configuration variables if you want your
+  changes used.
+
+== Manually installing applets
+ 
+* unzip an applet
+       
+      unzip the applet into the program directoy
+      unzip randomapplet.zip
+      
+      This should place the needed files in the correct directories
+      
+
+== Creating Applets
+
+To add code, commands and gui tabs
+
+Move program files into a directory under the code directory.
+Move gui files into a directory under the gui directory.
+ The gui directory name you create is important, because the gui
+ rwd file is built in alpha order by directory name
+
+
+There are two ways to add applets to the directories.
+
+ Creating code
+
+
+* Manually write code and gui files
+
+      The files go into your code directory
+      the filenames for code do not matter
+      
+      The gui files go into your gui directory
+      The gui files need to be in order by name and end with .rwd
+        
+
+      
+      If you need a config file that goes in the configuration directory
+
+ internationalization and localization are helped by replacing the
+  gui files in the subdirectories under gui
+ 
+      
+== Documents
+  
+  
+  when you click on a document name, the document should pop up in a 
+  browser window, or in another browser tab.
+
+To exit, press the x inside the browser window.
+
+== Languages
+
+
+ You can add tranlations in the lang subdirectory
+ You change the $lang constant in Tinker config file in the configuration directory
+ You can see one translation on the install applet tab, after you have installed and applet
+ 
+== Using over a Network
+  
+To serve the application over your local LAN,change the last line in the
+init.rb file to something like:
+RwdTinker.file(RWDFile).serve(8080, "-r" ? ".rwduids" : nil)
+Then you should be able to login at: http://yourhostname:8080
+
+You have to authorize yourself. The .rwuids example is a string with
+the name of the authorization file, relative to the home directory
+of the user that started the service. This file has to be in the form of:
+
+user1 = password
+user2 = pass phrase
+
+Thus the file .rwduids might contain:
+
+erik = secret
+ 
+== Requirements:
+RubyWebDialogs - I am using 0.1.2 
  This package you downloaded should have a runtime version of 
  the needed rubywebdialog files
 
@@ -23,21 +153,25 @@ Ruby I am using version 1.8.2
 
 I have tested this under Linux-Debian kernel 2.6.9
 
-Operation:
+= Operation:
 The code files reside in the code directory and are combined before 
 the main Class is loaded
 
 The rwd files in gui are combined before the gui is activated
 
-Trouble shooting:
+Translated text reside in the lang directory
+
+== Installing:
 
 untar the file
-tar zxvf rwdapplication-x.y.tar.gz
+tar zxvf rwdtinker-x.y.tar.gz
 then cd to the directory
-cd rwdapplication-x.y
+cd rwdshell-x.y
 then start the init.rb program file
 ruby init.rb
-
+Then point your browser at http://localhost:7705
+or where it tells you.
+Trouble shooting:
 
 If the program is not working, try looking at the ev subdirectory. That is where
 the runtime of rubywebdialogs are.
@@ -52,6 +186,129 @@ Closing the browser doesn't terminate the application. You have to use the appli
 
 Don't use the back-button of the browser! Strange and unpredictable things may and will happen!
 
-Steven Gibson
-stevengibson@superant.com
-http://rwdapplications.rubyforge.org/
+RubyWebDialogs is a platform independent graphical user interface for Ruby applications. It generates HTML and serves it with an internal HTTP server, so you can use your favorite web browser as the front end for your Ruby application. All this means, that it can be used on almost every platform, like Ruby itself. http://www.erikveen.dds.nl/rubywebdialogs/
+
+== Credits
+
+Thanks go to:
+
+* Matz, for creating Ruby in the first place.
+* Erik, for creating RubyWebDialogs.
+* Charlotte, my wife for coming up for the name Tinker.
+
+== License
+
+rwdtinker is copyright (c) 2004 Steven Gibson.  It is free software, and may be redistributed
+under the terms of the GPL licence: 
+
+== Contact
+  For more information see:
+http://rwdapplications.rubyforge.org/wiki/wiki.pl
+
+
+For more information about RubyWebDialogs see:
+http://www.erikveen.dds.nl/rubywebdialogs/index.html
+
+Thanks, Steven Gibson
+
+== Changelog
+version 1.43
+ changed setup variables file for live changes
+ added editing and reloading of config file
+ added unzip filename to config file
+
+version 1.42
+ update for live update system
+ update applets for live update
+ code file name cleanup
+
+version 1.41
+ l10n work es,nl, jp
+ separated out languge.cnf
+ added zip applets refreshacpi, rwdcalc
+
+version 1.40
+ removed extra lines from init.rb
+ fixed help second window
+ added some tranlations for Spanish 
+ More work on l10n
+
+version 1.3
+ refactored gui files to do easier i10n
+ removed lang directories under gui
+ added lang files under lang dir
+ removed redundant code files left from moving applet handling to back window
+ removed zipped applets not yet refactored
+ 
+version 1.24
+ added internet usage instructions to HowTo_Tinker.txt
+ removed  HowTo_Tinker.html
+ added panels for Helpabout
+ changed photo logo tab to only have embedded picture, no button
+
+version 1.23
+ moving diagnostic tab and applet handling tabs to second window
+ added selection panel tab to choose secondary windows.
+
+version 1.21
+ changing version on help screen to be button
+ added version window
+ added diagnostic tab
+ 
+version 1.2
+ added gemspec for creating a rwdtinker.gem
+ added rdoc comments
+ changed order on remove applets tab
+
+version 1.1
+ changed order of elements on install applet tab
+ Add more i81n ablility - added lang directorys for language hash files
+ added in test file using WATIR stands for "Web Application Testing In Ruby,
+
+version 1.0
+ Improved name selection in zips and applet screens
+ added rubyslippers applet and rwdrefreshacpi applets as zips
+
+version 0.9
+ Fixed bug introduced in 0.8 - code files not sorted correctly - class end was not in correct location
+ updated RubyWebDialogs for people who do not have it installed
+ added rwdschedule applet as zip file
+
+version 0.8
+ changed location of code files 
+ only directory of code files needs to be added to inf file
+ changed location of gui files 
+ only directory of gui files needs to be added to inf file
+ Added constants in conf file for code location and gui location
+ removed all zips not yt updated to new directory layout
+ change loading of conf files to not need intermediate file
+ and favicon.ico
+
+version 0.7
+ moved changelog to HowTo_Tinker.html
+ copied english gui text to the dirs I think we should translate to
+ update backup zip files to newest versions
+ upgraded the ev directory - for those who don't have RubyWebDialogs
+
+version 0.6
+ updated version number
+ changed merge name to rwdtinker.rb
+
+version 0.4
+ added zip listing and installing - Linux only
+
+Version 0,3
+ changed name to Tinker
+
+Version 0.2
+ added some i18n directories for the gui files
+
+Version 0.1
+ first public version released
+ includes document screen
+ Open Photo screen
+ included configuration directory
+ zips directories
+ installed directory
+ installed applet lister
+

data/code/xb1rwdtinkerbackwindow/installapplet.rb

@@ -3,9 +3,10 @@
     nametext = "%s" % [@a_installapplet]
 	 
         begin # exception trapped block
-   	 fileName = "zips/" + nametext + ".zip"
+   	 fullname =  nametext + ".zip"
+     fileName = File.join($zipslocation,fullname)
   	
-	        commandline = "unzip -o " + fileName
+	        commandline = $unzipprogram + fileName
          system( commandline+' > temp.output' )
         
     

data/code/xb1rwdtinkerbackwindow/listzips.rb

@@ -1,7 +1,9 @@
 # this code is to list the zipped applets that can be installed
-def listzipfilestoinstall
-  fileList      = Dir.new("zips").entries.sort.reverse.delete_if { |x| ! (x =~ /zip$/) }
-  @zipslistresult  = fileList.rwd_method("fillziptoinstallname")
+def listzipfilestoinstall
+ if File.exist?($zipslocation)
+  fileList      = Dir.new($zipslocation).entries.sort.delete_if { |x| ! (x =~ /zip$/) }
+  @zipslistresult  = fileList.rwd_method("fillziptoinstallname")
+  end
 end
  
 def fillziptoinstallname(inffile)

data/code/xb1rwdtinkerbackwindow/loadconfigurationrecord.rb

@@ -0,0 +1,32 @@
+   # this method views an existing address record
+  def loadconfigurationrecord
+ 
+         require 'fileutils'
+         if TinkerWin2ConfigurationFileName 
+               @a_configurationfilename = TinkerWin2ConfigurationFileName 
+         end
+	      
+        begin # exception trapped block
+       
+       Dir.chdir($progdir)
+	      fileName = File.join(ConfigurationDir, TinkerWin2ConfigurationFileName)
+        
+	      fd = File.open(fileName,"r")
+	      @a_configline1=        fd.readline.chomp
+	      @a_configline2 =  fd.readline.chomp
+        @a_configline3 = fd.readline.chomp
+          @a_configline4 = fd.readline.chomp
+        @a_configline5 = fd.readline.chomp
+         @a_configline6 = fd.readline.chomp 
+          @a_configline7 =fd.readline.chomp
+          @a_configline8 = fd.readline.chomp
+	 
+	      while ! fd.eof?
+	        @extraconfigdatadisplay = fd.readline
+	      end
+        fd.close
+        rescue SystemCallError, StandardError
+            $stderr.print "system call error: " + $!
+        end # exception rescue
+
+  end

data/code/xb1rwdtinkerbackwindow/loadconfigurationvariables.rb

@@ -0,0 +1,13 @@
+   # this method clears the on screen variables
+   def loadconfigurationvariables
+   
+   configfiletoload = File.join(ConfigurationDir,TinkerWin2ConfigurationFileName)
+   begin
+    load configfiletoload
+    @extraconfigdatadisplay = ""
+@newconfigurationresult = "Config Variables loaded"
+rescue
+ @extraconfigdatadisplay = ""
+ @newconfigurationresult = "loading error"
+ end
+  end

data/code/xb1rwdtinkerbackwindow/saveconfigurationrecord.rb

@@ -0,0 +1,18 @@
+  # this method adds a new address record
+  def saveconfigurationrecord 
+   require 'fileutils'
+   if @a_configurationfilename
+   newname = "%s" %   [@a_configurationfilename] # grab the filename to create
+   newdata =@a_configline1.to_s + "\n" + @a_configline2.to_s + "\n" + @a_configline3.to_s + "\n" + @a_configline4.to_s + "\n" + @a_configline5.to_s + "\n" + @a_configline6.to_s + "\n" + @a_configline7.to_s + "\n" + @a_configline8.to_s + "\n"
+	 
+        begin # exception trapped block
+          fileName = File.join( ConfigurationDir, newname )
+        	fd = File.open(fileName,"w")
+	        fd.print(newdata) # save the record info to the file
+	        fd.close
+          @newconfigurationresult=newdata # show the record info in the browser
+        rescue SystemCallError, StandardError
+            $stderr.print "system call error: " + $!
+        end # exception rescue
+    end
+  end

data/configuration/rwdplayscriptsversion.cnf

@@ -0,0 +1,2 @@
+
+RwdShellVersion = "0.92"

data/configuration/rwdtinker.cnf

@@ -1,12 +1,12 @@
 
+ConfigurationDir = "configuration" # for use in program - init.rb has this value without using this constant
 CodeName = "rwdtinker"
 CodeNameFile = CodeName + ".rb"
 LangNameFile = "rwdlanguage.rb"
 RWDFile	= "rwdtinker.rwd"
- @@codedir = "code"
- @@guidir = "gui" 
- @@langdir = "lang"
-
-TempLangHashFile = @@langdir + "/" + "templangfile.rb"
-LocalLangHashFile = @@langdir + "/" + "xlocallangfile.rb" 
-$port = 7705
+LangDir = "lang"
+TempLangHashFile = LangDir + "/" + "templangfile.rb"
+LocalLangHashFile = LangDir + "/" + "xlocallangfile.rb" 
+ CodeDir = "code"
+ GuiDir = "gui" 
+ $port = 7705

data/configuration/rwdtinkerversion.cnf

@@ -1,2 +1,2 @@
 
-RwdTinkerVersion = "1.42"
+RwdTinkerVersion = "1.43"

data/configuration/tinkerwin2variables.cnf

@@ -0,0 +1,8 @@
+
+TinkerWin2ConfigurationFileName = "tinkerwin2variables.cnf" # this file name - do not change
+$zipslocation = "zips" # location of applets to add
+$unzipprogram = "unzip -o " 
+
+
+
+

data/configuration/tinkerwin2version.cnf

@@ -1,3 +1,3 @@
 
-RwdTinkerWin2Version = "0.6"
+RwdTinkerWin2Version = "0.7"
 

data/gui/xb1rwdtinkerbackwindow/40editconfiguration.rwd

@@ -0,0 +1,36 @@
+$rwdguivar=
+"
+	<tab name=\"editconfigurationfile\" caption=\"Edit Configuration\">
+ <table>
+ <row> <p> </row>
+ <row> <p align=\"right\">You can view or edit the rwdtinker applet confiruration file here</row>
+ <row> <p> </row>
+ <horizontal>
+      <button caption=\"Load Record\" action=\"loadconfigurationrecord\"/>
+      <button caption=\"Save Changes\" action=\"saveconfigurationrecord\"/>
+      <button caption=\"Reload Variables\" action=\"loadconfigurationvariables\"/>
+      
+
+
+    
+    </horizontal>
+    <table>
+      <row> <p align=\"right\">FileName:</p>  <text name=\"a_configurationfilename\"/> </row>
+      <row> <p align=\"right\">1:</p>  <text name=\"a_configline1\"/> </row>
+      <row> <p align=\"right\">2:</p>  <text name=\"a_configline2\"/> </row>
+      <row> <p align=\"right\">3:</p>  <text name=\"a_configline3\"/> </row>
+      <row> <p align=\"right\">4:</p>  <text name=\"a_configline4\"/> </row>
+      <row> <p align=\"right\">5:</p>  <text name=\"a_configline5\"/> </row>
+      <row> <p align=\"right\">6:</p>  <text name=\"a_configline6\"/> </row>
+      <row> <p align=\"right\">7:</p>  <text name=\"a_configline7\"/> </row>
+      <row> <p align=\"right\">8:</p>  <text name=\"a_configline8\"/> </row>
+
+    </table>
+    <p>%extraconfigdatadisplay%</p>
+    <p>
+    <p>%newconfigurationresult%</p>
+     
+      
+
+	</tab>"
+

data/init.rb

@@ -73,7 +73,7 @@ $progdir = File::expand_path( File.dirname(__FILE__))
  Dir.chdir($progdir) # change back to top program directory
 
  # build the English Language hash file from the parts
- startlangdir = @@langdir +"/" + "en"
+ startlangdir = File.join(LangDir,"en")
  #get a list of the files and subdirectories on the starting directory only
         alanghash = Array.new(Dir[startlangdir].entries.sort)
         #loop through the list, ignore the files and add all new directories found
@@ -108,7 +108,7 @@ $progdir = File::expand_path( File.dirname(__FILE__))
   Dir.chdir($progdir) # change back to top program directory
  
  # build the local Language hash file from the parts
- startlangdir = @@langdir +"/" + $lang
+ startlangdir = File.join(LangDir,$lang)
  #get a list of the files and subdirectories on the starting directory only
         alanghash = Array.new(Dir[startlangdir].entries.sort)
         #loop through the list, ignore the files and add all new directories found
@@ -145,11 +145,11 @@ $tempdoc = " "
 
  # build the language hash constant object from the lang parts
  #get a list of the files in lang directory only
-        alangfile = Dir.new(@@langdir).entries.sort.reverse.delete_if { |x| ! (x =~ /rb$/) }
+        alangfile = Dir.new(LangDir).entries.sort.reverse.delete_if { |x| ! (x =~ /rb$/) }
         alangfile.length.times{
         fileName = alangfile.pop
         Dir.chdir($progdir)
-        Dir.chdir(@@langdir) 
+        Dir.chdir(LangDir) 
         fileLangA=File.open("#{fileName}","r")        #opens the file thats in fileName as read only
         $tempdoc += fileLangA.read    #reads the file into the doc string
         fileLangA.close    
@@ -165,7 +165,7 @@ Dir.chdir($progdir)
 
  # build the actual program from the code parts
  #get a list of the files and subdirectories on the starting directory only
-        a = Array.new(Dir[@@codedir].entries.sort)
+        a = Array.new(Dir[CodeDir].entries.sort)
         #loop through the list, ignore the files and add all new directories found
         a.each do |x|
           #if a directory...
@@ -198,7 +198,7 @@ Dir.chdir($progdir)
 # build the actual GUI from the gui parts
  $tempdoc = " "
  #get a list of the files and subdirectories on the starting directory only
-        a = Array.new(Dir[@@guidir].entries.sort)
+        a = Array.new(Dir[GuiDir].entries.sort)
         #loop through the list, ignore the files and add all new directories found
         a.each do |x|
                 #if a directory...

data/rwd_files/HowTo_Tinker.txt

@@ -22,24 +22,10 @@ ruby init.rb
 Then point your web browser to:
 http://localhost:7705/
 
-== Installing Applets
-
-* unzip an applet
-
-      You can download an applet created by someone else
-      put the file in the zips directory
-      unzip the directory into the program directoy
-      unzip randomapplet.zip
-      
-      This should right the needed files in the correct directories
-      
-      
-
-
-
-Viewing a installed Applets:
 
+== Viewing installed Applets:
 
+ 
 Go to "List Scripts" tab
 
 
@@ -55,9 +41,46 @@ Go to "List Scripts" tab
        
        If it finds the file it will open it. It displays the text the search box.
 
+      You can uninstall applets on this screen
+      
+== Installing Applets
+
+   click on the "Selection Panel"
+   click on Rwdtinker Back Window
+
+      You can download an applet created by someone else
+      put the file in the zips directory
+      
+      click on the "list zips" tab
+      click on "list applets available for installing"
+      
+      chose the applet you want
+      click on "install applet"
+      If all goes well the applet should be installed.
+      You will need to restart rwdtinker to see the new screens
+      
+      
+== Changing configuration file
+
+ click on "Edit Configuration"
+ You can view the configuration file
+ 
+  You can edit the configuration
+  
+  Remember to reload the configuration variables if you want your
+  changes used.
 
+== Manually installing applets
+ 
+* unzip an applet
+       
+      unzip the applet into the program directoy
+      unzip randomapplet.zip
+      
+      This should place the needed files in the correct directories
+      
 
-== Adding Applets
+== Creating Applets
 
 To add code, commands and gui tabs
 
@@ -88,10 +111,6 @@ There are two ways to add applets to the directories.
   gui files in the subdirectories under gui
  
       
-
-
-
-  
 == Documents
   
   
@@ -100,8 +119,6 @@ There are two ways to add applets to the directories.
 
 To exit, press the x inside the browser window.
 
-
-
 == Languages
 
 
@@ -194,7 +211,12 @@ http://www.erikveen.dds.nl/rubywebdialogs/index.html
 
 Thanks, Steven Gibson
 
-== Changelog:
+== Changelog
+version 1.43
+ changed setup variables file for live changes
+ added editing and reloading of config file
+ added unzip filename to config file
+
 version 1.42
  update for live update system
  update applets for live update

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.4
 specification_version: 1
 name: rwdtinker
 version: !ruby/object:Gem::Version 
-  version: "1.42"
-date: 2005-01-12
+  version: "1.43"
+date: 2005-01-17
 summary: rwdtinker application is a framework to program for RubyWebDialogs.
 require_paths: 
   - "."
@@ -39,11 +39,15 @@ files:
   - code/xb1rwdtinkerbackwindow/diagnostictab.rb
   - code/xb1rwdtinkerbackwindow/rwdtinkerwin2version.rb
   - code/xb1rwdtinkerbackwindow/listinstalledfiles.rb
-  - configuration/tinkerwin2.cnf
+  - code/xb1rwdtinkerbackwindow/loadconfigurationrecord.rb
+  - code/xb1rwdtinkerbackwindow/loadconfigurationvariables.rb
+  - code/xb1rwdtinkerbackwindow/saveconfigurationrecord.rb
+  - configuration/rwdtinker.cnf
   - configuration/rwdtinkerversion.cnf
   - configuration/language.cnf
-  - configuration/rwdtinker.cnf
   - configuration/tinkerwin2version.cnf
+  - configuration/rwdplayscriptsversion.cnf
+  - configuration/tinkerwin2variables.cnf
   - ev/sgml.rb
   - ev/xml.rb
   - ev/net.rb
@@ -78,11 +82,12 @@ files:
   - gui/xa5rwdtinkercallablewindow/1appname.rwd
   - gui/xa5rwdtinkercallablewindow/9end.rwd
   - gui/xb1rwdtinkerbackwindow/1appname.rwd
-  - gui/xb1rwdtinkerbackwindow/2tab1.rwd
   - gui/xb1rwdtinkerbackwindow/9backend.rwd
-  - gui/xb1rwdtinkerbackwindow/4arwdlistapplets.rwd
   - gui/xb1rwdtinkerbackwindow/3arwddiagnostics.rwd
-  - gui/xb1rwdtinkerbackwindow/4arwdlistzips.rwd
+  - gui/xb1rwdtinkerbackwindow/50rwdlistapplets.rwd
+  - gui/xb1rwdtinkerbackwindow/80tab1.rwd
+  - gui/xb1rwdtinkerbackwindow/50rwdlistzips.rwd
+  - gui/xb1rwdtinkerbackwindow/40editconfiguration.rwd
   - gui/ya1helpaboutbegin/ya0helpscreenstart.rwd
   - gui/yg5rwdhelpabout/1appname.rwd
   - gui/yg5rwdhelpabout/3copyright.rwd

data/configuration/tinkerwin2.cnf

@@ -1,3 +0,0 @@
-
-ZipsLocation = "zips" # not yet functional
-