rwdaddresses 0.93 → 0.94

data/Readme.txt

@@ -1,57 +1,207 @@
-rwdapplications are web brower applications
+= Rwd Address Book			
 
-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/
+== How to Use the Address Book (rwdaddresses)
 
+There are two ways to add records to rwdaddresses address book.
 
-Start the program by:
-changing to the directory and
-ruby init.rb
+== Adding Records
 
-Then point your web browser to:
-http://localhost:7705/
+1. Use the "New File" tab
+      The first field is the most important. It is the filename that
+      will be created. I use the person's name with caps and no spaces
+      RingoStarr
 
-Or to the port that shows on the console or in the config.cnf file
+      The following lines for entry are for you to fill in as you want.
+      When you are finished press the CreateFile button 
 
-Requirements:
-RubyWebDialogs - I am using 0.0.11 2004-3-9
- This package you downloaded should have a runtime version of 
- the needed rubywebdialog files
+2. Manually add an entry for a person record
+      You can use a text editor to create a record
+      put information on separate lines. You can have as many lines as you want
+      name the file with caps and no spaces and end with .nam
+      RingoStarr.nam<
 
-Ruby I am using version 1.8.2
+      Save your file to the names/ subdirectory
+      
 
-I have tested this under Linux-Debian kernel 2.6.9
+This is similar to how you add a photo to the book.
 
-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
+== Viewing an address book entry:
 
-Trouble shooting:
 
-untar the file
-tar zxvf rwdapplication-x.y.tar.gz
-then cd to the directory
-cd rwdapplication-x.y
-then start the init.rb program file
-ruby init.rb
+Go to "View Contact" tab
 
+       Type in the name of the contact you want.
+      
+       Type it as the record file is saved: (caps, no space)
+       StevenGibson
+       
+       Then click the "Open" button
+       
+       If it finds the record it will open it. It displays the record as text  under the search box.
 
-If the program is not working, try looking at the ev subdirectory. That is where
-the runtime of rubywebdialogs are.
 
-for long term installation, I would suggest putting most files in a lib directory
-like /usr/lib/rwdshell
-then make a writable directory the local directory for command files to be written
-like ~/rwdshell
 
+== Viewing Photo
 
-Closing the browser doesn't terminate the application. You have to use the application's close-button  And terminating the application doesn't terminate the application when running in network mode. You just log out.
 
-Don't use the back-button of the browser! Strange and unpredictable things may and will happen!
+Click on the ? at the top right of window
 
-Steven Gibson
-stevengibson@superant.com
-http://rwdapplications.rubyforge.org/
+
+   If it finds a photo for the person it will replace the window with the photo
+   
+   
+   it will look for the same name as the record with the extension .png
+  
+   
+   To return to the address book, click on back arrows at the top right.
+   
+   For now you need to add photos manually.
+   
+   add them to the names/  directory
+
+== List Files
+
+Click on "List Files"
+
+
+
+   clicking on the "ListFiles" button will list all
+   the files found in the names/ directory 
+
+
+== Add Info
+
+  For edits to records go to the contacts utilities tab
+  You can
+    Rename contacts
+    Delete contacts
+    attach photos to contacts
+
+== Attach photo
+ on the Contacts Utilities tab
+ select the name record,
+ put a png photo in the /tmp  directory
+ select the photo
+ click on Attach photo, it will rename the photo and copy it to the
+ addresses directory
+ 
+ == Sync for multiple computers
+
+ If you are like me, you have more than one system
+ I use rwdTinker at home on my Linux laptop
+ at work I use it on XP
+ on the go I use rwdtinker on my Zaurus PDA
+ So I am adding contact record on different machines.
+ There is  a function to help sync the separate systems
+  
+ in "Selection Panel" click on "Open Schedule Sync Window"
+ 
+ First you need your ftp details set in the
+ configuration/rwdaddresses.cnf file
+ 
+ you can upload your contacts from your local names directory to the ftp site
+ you can download contacts from the ftp site to your local updates directory
+ you can perform a sync which finds remote contacts and adds them to your local
+ names directory
+ 
+== Change to using png photos instead of jpg
+  
+  If you want to
+  Need to change one line in file rwdaddresses.cnf
+  Need to add nophoto.png  in  names
+ 
+== Documents
+  
+  
+  when you click on a document name, the document should pop up in a 
+  browser window, or in another browser tab.
+
+== 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
+
+== Contacts
+  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 0.94
+ updated for rwdtinker 1.44 - refactored gui files
+ Changed gui directory names - more like  Java package titles
+  added back window for sync tasks
+ added configuration viewing
+ added ftp file download for sync
+ added ftp file upload for sync
+ add update files and addresses sync compares
+ 
+version 0.93
+ updated for rwdtinker 1.42 - semi-live updating
+
+version 0.92
+ updated for rwdtinker 1.41
+ updated some l10n data
+ switched to jpg for contact photos
+ fixed rename for nil new name
+ 
+version 0.91
+ updated for rwdtinker 1.4
+ Added configuration viewing
+ 
+version 0.9
+ added edit commands to change contact record
+ Rename contacts
+ Delete contacts
+ attach photos to contacts
+
+version 0.8
+ updated for version 1.23 of rwdtinker
+
+version 0.7
+ changed directory structure for rwdtinker 0.9 and later
+ added conf file for name record directory location
+ split inf file for sample data
+ update HowTo_Addresses.html with info on serving over a LAN
+ improved name selection on the main screen
+
+version 0.6
+ update handling of photo, when none found
+ reduced sizes of sample photos 
+
+version 0.5
+ revised to fit into rwdtinker framework
+
+Version 0.4
+ Corrected photo xml
+ changed order of action buttons
+ added help-about window
+
+Version 0.3
+ split code into sections - moved to code directory
+ added license file
+ split rwd gui file into sections
+ Photos added
+
+Version 0.2
+ first public version released

data/code/{xb1rwdtinkerbackwindow → rwdtinkerbackwindow}/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 → rwdtinkerbackwindow}/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/rwdtinkerbackwindow/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/rwdtinkerbackwindow/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/rwdtinkerbackwindow/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/code/superant.com.rwdaddresses/downloadrwdaddressfiles.rb

@@ -0,0 +1,34 @@
+def downloadrwdaddressfiles
+ require 'net/ftp'
+ BasicSocket.do_not_reverse_lookup = true 
+ @rwdaddressesftpdisplays = ""
+  begin
+ ftp = Net::FTP::new($rwdaddresses_ftpsite)
+ @rwdaddressesftpdisplay  = "files downloaded" + "\n" 
+ ftp.debug_mode = false
+ ftp.login($rwdaddresses_ftplogin, $rwdaddresses_ftppassword)
+ ftp.chdir($rwdaddresses_ftpdirectory)
+ print "I'm in the directory ", ftp.pwd(), "\n"
+ schfiles = ftp.nlst($rwdaddresses_ftpdirectory) 
+   schfiles.each do |x|
+                          #adjust the filters to the files you want to see...
+                             if(!test(?d,x))
+                                   if x =~ /nam/
+                                      lastslash = x.rindex('/')+1
+                                      newstring = x.slice!(lastslash..256)
+                                     localupdatefile = File.join($rwdaddresses_updatedirectory, "#{newstring}")
+                                     ftp.getbinaryfile("#{newstring}" , localupdatefile )
+                                 @rwdaddressesftpdisplay  =   @rwdaddressesftpdisplay + newstring + "\n"                               
+                             end
+                             end
+                             
+                         end
+   ftp.close
+  
+ rescue
+   if ftp
+     ftp.close
+   end
+ @rwdaddressesftpdisplay = "ftp error"
+ end
+end

data/code/{gl3addresses/gl4listnamerecord.rb → superant.com.rwdaddresses/listnamerecord.rb}

@@ -1,8 +1,10 @@
  # this code is to list the contact names
  def listnamerecordfiles
+  if File.exist?($addressfiles_directory)
    fileList      = Dir.new($addressfiles_directory).entries.sort.delete_if { |x| ! (x =~ /nam$/) }
    @listphotosfromtmp = ""
    @listnamerecordfilesresult  = fileList.rwd_method("fillcontactrecordname")
+  end
  end
  
  # this method is to help fill in list of names

data/code/superant.com.rwdaddresses/runrwdaddresssyncbackwindow.rb

@@ -0,0 +1,9 @@
+# Application RwdAddresses orginally (c) 2004 Steven Gibson under GPL. 
+# This application is a contact book
+# For more information about  see http://www.rubyforge.net/projects/rwdapplications
+  
+  # call the window  
+  def runrwdaddressessyncbackwindow
+   @rwd_window = "rwdaddressessyncwindow"
+   end   
+   

data/code/superant.com.rwdaddresses/syncrwdaddress.rb

@@ -0,0 +1,30 @@
+def syncrwdaddressdata
+    require 'fileutils'
+   @rwdaddressessyncresult  = ""
+ begin
+    
+@rwdaddressessyncresult  = "updating local files" + "\n" 
+    Dir.chdir($progdir)
+    
+    localfileListarray = Dir.new($addressfiles_directory).entries.sort.delete_if { |tmpfile| ! (tmpfile =~ /nam$/) }
+      remotefileListarray = Dir.new($rwdaddresses_updatedirectory ).entries.sort.delete_if { |tmpfile| ! (tmpfile =~ /nam$/) }
+  
+    tempupdatefilelistarray = remotefileListarray -   localfileListarray 
+    
+   if  tempupdatefilelistarray
+           tempupdatefilelistarray.each do |temp|
+            tmpfilenametosync = File.join($rwdaddresses_updatedirectory,temp)
+            tmpfilenamecopied = File.join($addressfiles_directory,temp)
+             FileUtils.cp( tmpfilenametosync, tmpfilenamecopied)
+            @rwdaddressessyncresult  =   @rwdaddressessyncresult + temp + "\n"   
+      
+      end
+      end
+
+  
+rescue
+ 
+
+print "sync error"
+end
+end