multistockphoto 0.1.0

data/tasks/deployment.rake

@@ -0,0 +1,34 @@
+desc 'Release the website and new gem version'
+task :deploy => [:check_version, :website, :release] do
+  puts "Remember to create SVN tag:"
+  puts "svn copy svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/trunk " +
+    "svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/tags/REL-#{VERS} "
+  puts "Suggested comment:"
+  puts "Tagging release #{CHANGES}"
+end
+
+desc 'Runs tasks website_generate and install_gem as a local deployment of the gem'
+task :local_deploy => [:website_generate, :install_gem]
+
+task :check_version do
+  unless ENV['VERSION']
+    puts 'Must pass a VERSION=x.y.z release version'
+    exit
+  end
+  unless ENV['VERSION'] == VERS
+    puts "Please update your version.rb to match the release version, currently #{VERS}"
+    exit
+  end
+end
+
+desc 'Install the package as a gem, without generating documentation(ri/rdoc)'
+task :install_gem_no_doc => [:clean, :package] do
+  sh "#{'sudo ' unless Hoe::WINDOZE }gem install pkg/*.gem --no-rdoc --no-ri"
+end
+
+namespace :manifest do
+  desc 'Recreate Manifest.txt to include ALL files'
+  task :refresh do
+    `rake check_manifest | patch -p0 > Manifest.txt`
+  end
+end

data/tasks/environment.rake

@@ -0,0 +1,7 @@
+task :ruby_env do
+  RUBY_APP = if RUBY_PLATFORM =~ /java/
+    "jruby"
+  else
+    "ruby"
+  end unless defined? RUBY_APP
+end

data/tasks/website.rake

@@ -0,0 +1,17 @@
+desc 'Generate website files'
+task :website_generate => :ruby_env do
+  (Dir['website/**/*.txt'] - Dir['website/version*.txt']).each do |txt|
+    sh %{ #{RUBY_APP} script/txt2html #{txt} > #{txt.gsub(/txt$/,'html')} }
+  end
+end
+
+desc 'Upload website files to rubyforge'
+task :website_upload do
+  host = "#{rubyforge_username}@rubyforge.org"
+  remote_dir = "/var/www/gforge-projects/#{PATH}/"
+  local_dir = 'website'
+  sh %{rsync -aCv #{local_dir}/ #{host}:#{remote_dir}}
+end
+
+desc 'Generate and upload website files'
+task :website => [:website_generate, :website_upload, :publish_docs]

data/test/test_helper.rb

@@ -0,0 +1,6 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/multistockphoto'
+
+def after(d)
+  yield if DateTime.now > d
+end

data/test/test_multistockphoto.rb

@@ -0,0 +1,177 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+
+class TestMultistockphoto < Test::Unit::TestCase
+
+  REAL_TRANSFER = false
+  
+  def setup
+    @fotolia_user         = ENV['FOTOLIA_USER'] 
+    @fotolia_password     = ENV['FOTOLIA_PASSWORD'] 
+    @fotolia_ftp_user     = ENV['FOTOLIA_FTP_USER'] 
+    @fotolia_ftp_password = ENV['FOTOLIA_FTP_PASSWORD'] 
+    @zoonar_user          = ENV['ZOONAR_USER']
+    @zoonar_password      = ENV['ZOONAR_PASSWORD']
+    @aldi_user            = ENV['ALDI_USER']
+    @aldi_password        = ENV['ALDI_PASSWORD']
+  end
+  
+
+  def test_call_msp
+    assert_equal "multistockphoto 0.0.1\n", `ruby bin/multistockphoto --version`
+  end
+
+  def test_transfer_all
+    if false
+      expected = "multistockphoto V. 0.1.0
+end
+end
+transfering all photos
+== transfering to fotolia.de
+sending foto1.jpg ... OK
+sending foto2.jpg ... OK
+sending foto3.jpg ... OK
+== transfering to site2.de
+sending foto1.jpg ... OK
+sending foto2.jpg ... OK
+sending foto3.jpg ... OK
+== transfering to site3.de
+sending foto1.jpg ... OK
+sending foto2.jpg ... OK
+sending foto3.jpg ... OK
+      "
+
+      output = `system bin/multistockphoto --transfer-all`
+   
+      assert_equal expected, output 
+    end  
+  end
+
+  def after(d)
+    yield if DateTime.now > d
+  end
+  
+  def test_site_object
+    if false
+      site1 = Site.new("Fotolia")
+      assert_kind_of Site, site1
+      assert_equal "Fotolia", site1.name
+    end    
+  end
+  
+  def test_multistockphoto_group
+    if false
+      #msp = Multistockphoto::Transfer.new
+      fotolia = Fotolia.new
+      zoonar  = Zoonar.new
+      msp.add_site fotolia
+      msp.add_site zoonar
+      msp.send_directory('upload')
+      assert ['fotolia','zoonar'], msp.sites
+    end
+  end
+  
+  def test_fotolia
+    fotolia = Fotolia.new("Fotolia")
+    fotolia.ftp_user = @fotolia_ftp_user
+    fotolia.ftp_password = @fotolia_ftp_password
+    
+    assert_kind_of Fotolia, fotolia
+    assert_equal "Fotolia", fotolia.name
+    
+    fotolia.user = @fotolia_user
+    fotolia.password = @fotolia_password
+    
+    assert_equal @fotolia_user, fotolia.user
+    assert_equal @fotolia_password, fotolia.password
+    
+  end
+  
+  def test_photo
+    photo = Photo.new("123.jpg")
+    assert_kind_of Photo, photo
+    assert_equal "123.jpg", photo.filename
+  end
+
+  def test_fotolia_transfer_1
+    if REAL_TRANSFER
+      fotolia = Fotolia.new("Fotolia")
+      fotolia.user = @fotolia_user
+      fotolia.password = @fotolia_password
+      photo = Photo.new("test/1234.jpg")
+      #assert fotolia.transfer(photo)
+      #TODO: zwei Gruende, warum das fehlschlagen kann:
+      # 1. Datei nicht vorhanden
+      # 2. Argument kein Photo-Objekt
+      # => bessere Tests
+      #    assert_raise (RuntimeError) {
+      #      fotolia.transfer("123.jpg")
+      #    }
+    end
+  end
+  
+  #  def test_fotolia_transfer_existing_picture
+  #    fotolia = Fotolia.new("Fotolia")
+  #    fotolia.user = @fotolia_user
+  #    fotolia.password = @fotolia_password
+  #    photo = Photo.new("/media/LACIE/private/CF-Card/DCIM/119CANON/IMG_3267_zugeschnitten_blank_names.jpg")
+  #    assert fotolia.transfer(photo)
+  #  end
+
+  def test_fotolia_transfer_existing_no_duplicate_picture
+    if REAL_TRANSFER
+      fotolia = Fotolia.new("Fotolia")
+      fotolia.user = @fotolia_user
+      fotolia.password = @fotolia_password
+      fotolia.ftp_user = @fotolia_ftp_user
+      fotolia.ftp_password = @fotolia_ftp_password
+      photo = Photo.new("/media/LACIE/private/CF-Card/DCIM/119CANON/IMG_3267_zugeschnitten_blank_names.jpg")
+      assert_equal :duplicate, fotolia.transfer(photo)
+    end
+  end
+  
+  def test_config_params_fotolia
+    fotolia = Fotolia.new("Fotolia Site")
+    assert fotolia.user
+    assert fotolia.password
+    assert fotolia.ftp_user
+    assert fotolia.ftp_password
+    assert_equal @fotolia_user, fotolia.user
+    assert_equal @fotolia_password, fotolia.password
+    assert_equal @fotolia_ftp_user, fotolia.ftp_user
+    assert_equal @fotolia_ftp_password, fotolia.ftp_password
+  end
+  
+  def test_config_params_zoonar
+    zoonar = Zoonar.new("zoonar Site")
+    assert zoonar.user
+    assert zoonar.password
+    assert_equal @zoonar_user, zoonar.user
+    assert_equal @zoonar_password, zoonar.password
+    #kein ftp assert_equal @zoonar_ftp_user, zoonar.ftp_user
+    #kein ftp assert_equal @zoonar_ftp_password, zoonar.ftp_password
+  end
+  
+  def test_aldi
+    site = Aldi.new("ALDI")
+    
+    assert_kind_of Aldi, site
+    assert_equal "ALDI", site.name
+    
+    site.user = @aldi_user
+    site.password = @aldi_password
+    
+    assert site.user
+    assert site.password
+    
+    assert_equal @aldi_user, site.user
+    assert_equal @aldi_password, site.password
+  end
+  
+  def test_aldi_transfer
+    site = Aldi.new("ALDI")
+    photo = Photo.new("/media/LACIE/private/CF-Card/DCIM/119CANON/IMG_3267_zugeschnitten_blank_names.jpg")
+      site.transfer(photo)
+    
+  end
+end

data/website/index.html

@@ -0,0 +1,257 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>
+      multistockphoto
+  </title>
+  <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
+<style>
+
+</style>
+  <script type="text/javascript">
+    window.onload = function() {
+      settings = {
+          tl: { radius: 10 },
+          tr: { radius: 10 },
+          bl: { radius: 10 },
+          br: { radius: 10 },
+          antiAlias: true,
+          autoPad: true,
+          validTags: ["div"]
+      }
+      var versionBox = new curvyCorners(settings, document.getElementById("version"));
+      versionBox.applyCornersToAll();
+    }
+  </script>
+</head>
+<body>
+<div id="main">
+
+    <h1>multistockphoto</h1>
+    <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/multistockphoto"; return false'>
+      <p>Get Version</p>
+      <a href="http://rubyforge.org/projects/multistockphoto" class="numbers">0.1.0</a>
+    </div>
+    <h1>&#x2192; &#8216;multistockphoto&#8217;</h1>
+
+
+	<h2>What</h2>
+
+
+	<p>This program is intended to work with the german versions of the photo sites fotolia.de and zoonar.de.
+Photographers can upload their photos to this sites. 
+Currently it works only with the german version. If you&#8217;re interested to adapt
+it to other languages please email me.</p>
+
+
+	<p>Dieses Programm bietet bequemen Upload von eigenen Photos zu Photo-Seiten wie
+fotolia.de, zoonar.de oder anderen, bei denen man eigene Bilder zum Verkauf
+anbieten kann. 
+Neue Photos werden automatisch zu allen Seiten hochgeladen, bei denen man 
+registriert ist.</p>
+
+
+	<h2>Installing</h2>
+
+
+	<p><pre class='syntax'><span class="ident">sudo</span> <span class="ident">gem</span> <span class="ident">install</span> <span class="ident">multistockphoto</span></pre></p>
+
+
+	<h2>The basics</h2>
+
+
+	<p>Nach der Installation lege irgendwo einen Ordner namens &#8216;multistockphoto&#8217; an!
+Innerhalb dieses Ordners lege bitte einen weiteren Ordner namens &#8216;upload&#8217; an!</p>
+
+
+	<p>Du benötigst jetzt noch eine Datei namens &#8216;config.yaml&#8217; mit folgendem Inhalt:</p>
+
+
+<pre>
+--- 
+:zoonar: 
+  :password: 'lalala'
+  :user: 'hugo'
+:fotolia: 
+  :user: 'hugo'
+  :password: 'lalal9589'
+  :ftp_user: '34567798'
+  :ftp_password: 'hugolala19589'
+</pre>
+
+	<p>Trage dort deine Zugangsdaten ein! Achtung: Die Einrückung links ist wichtig. 
+Im Gem-Directory ist eine Vorlage, die du kopieren kannst.
+Wenn du nicht bei allen aufgelisteten Sites Mitglied bist oder die Bilder dort
+hochladen möchtest, dann lösche einfach
+die entsprechenden Abschnitte &#8211; du ersparst dir und den jeweiligen Servern 
+unnötige Last, die bei fehlerhaften Einloggversuchen vergeudet wird.</p>
+
+
+	<p>Wenn du ein oder mehrere neue Bilder hochladen willst, kopiere die Bilddateien
+in den upload-Ordner!
+Dann rufe (innerhalb des multistockphoto-Ordners) das Kommando</p>
+
+
+<pre>
+multistockphoto --send-all
+</pre>
+
+	<p>auf! Dieses erledigt den Upload aller neuen Photos zu allen definierten 
+Photo-Sites.</p>
+
+
+	<p>Die Photo-Dateien im upload-Ordner müssen nach dem Upload nicht gelöscht
+werden &#8211; bei einem weiteren Aufruf werden bereits gesendete Photos nicht noch
+einmal gesendet.</p>
+
+
+	<p>Alle Dateien mit den Endungen .PNG, .JPG, .GIF, .JPEG werden hochgeladen. Groß-
+oder Kleinschreibung ist egal.</p>
+
+
+	<p>Das Programm erstellt (im Directory multistockphoto) eine Datei namens
+&#8216;sendeliste.dat&#8217;, in der die erfolgreichen Uploads mit Site, Dateiname und
+Datum/Uhrzeit protokolliert werden. Diese Datei darf nicht gelöscht werden, 
+da diese Datei auch dazu dient, festzustellen, ob ein Datei schon gesendet 
+wurde.
+Kurz: falls eine Photo-Datei in dieser Datei noch nicht auftaucht, wird
+sie an die betreffende Seit gesendet. Bei Problemen bei einzelnen Uploads kann
+man aber in dieser Datei z.B. eine Zeile löschen, was zur Folge hat, daß 
+diese Datei beim nächsten Aufruf erneut hochgeladen wird.</p>
+
+
+	<p>Je nach Photo-Site mußt du dann dort online noch Stichworte und ggf. andere
+Daten zu den einzelnen Bildern eintragen.</p>
+
+
+	<p>Einzelne Sites handhaben dies unterschiedlich.</p>
+
+
+	<p>Beispiel: Bei fotolia.de mußt du deine Photos hochladen, dann noch Stichworte
+und verschiedene Vertragsbedingungen festlegen. Dann erst werden deine Bilder
+geprüft und entweder angenommen oder abgelehnt.</p>
+
+
+	<p>Bei zoonar.de wiederum läuft es so, daß du erst nur die Bilder hochlädst, dann 
+werden sie begutachtet; angenommen oder abgelehnt und erst wenn sie 
+angenommen wurden, kannst du Schlagworte vergeben. Dies hat natürlich den
+Vorteil, daß man für abgelehnte Photos erst gar keine Schlagworte vergeben muß
+(kann).</p>
+
+
+	<p>Diese Nachbearbeitung auf der jeweiligen Seite ist derzeit noch nötig, es ist aber
+geplant, daß auch z.B. die Schlagworte von diesem Programm schon gesetzt werden
+können.</p>
+
+
+	<h2>Demonstration of usage</h2>
+
+
+	<p>Wechseln in Arbeitsdirectory:</p>
+
+
+<pre>$ cd multistockphoto
+</pre>
+
+<pre> 
+$ multistockphoto --help
+Usage: multistockphoto [-hvsa]
+
+Specific options:
+
+Common options: 
+    -h, --help                       Show this message
+    -v, --version                    Show version
+   -sa, --send-all                   Send all files
+</pre>
+
+	<p>Senden aller noch nicht hochgeladenen Photos:</p>
+
+
+<pre>
+$ multistockphoto --send-all
+send-all
+upload/img_2746.jpg
+fotolia:upload/img_2746.jpg
+zoonar:upload/img_2746.jpg
+</pre>
+
+	<h2>Forum</h2>
+
+
+	<p><a href="http://groups.google.com/group/multistockphoto">http://groups.google.com/group/multistockphoto</a></p>
+
+
+	<h2>How to submit patches</h2>
+
+
+	<p>Read the <a href="http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/">8 steps for fixing other people&#8217;s code</a> and for section <a href="http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/#8b-google-groups">8b: Submit patch to Google Groups</a>, use the Google Group above.</p>
+
+
+	<p><span class="caps">TODO</span> &#8211; pick <span class="caps">SVN</span> or Git instructions</p>
+
+
+	<p>The trunk repository is <code>svn://rubyforge.org/var/svn/multistockphoto/trunk</code> for anonymous access.</p>
+
+
+	<p><span class="caps">OOOORRRR</span></p>
+
+
+	<p>You can fetch the source from either:</p>
+
+
+	<ul>
+	<li>rubyforge: <a href="http://rubyforge.org/scm/?group_id=6180">http://rubyforge.org/scm/?group_id=6180</a></li>
+	</ul>
+
+
+<pre>git clone git://rubyforge.org/multistockphoto.git</pre>
+
+	<ul>
+	<li>github: <a href="http://github.com/GITHUB_USERNAME/multistockphoto/tree/master">http://github.com/GITHUB_USERNAME/multistockphoto/tree/master</a></li>
+	</ul>
+
+
+<pre>git clone git://github.com/GITHUB_USERNAME/multistockphoto.git</pre>
+
+	<p><span class="caps">TODO</span> &#8211; add &#8220;github_username: username&#8221; to ~/.rubyforge/user-config.yml and newgem will reuse it for future projects.</p>
+
+
+	<ul>
+	<li>gitorious: <a href="git://gitorious.org/multistockphoto/mainline.git">git://gitorious.org/multistockphoto/mainline.git</a></li>
+	</ul>
+
+
+<pre>git clone git://gitorious.org/multistockphoto/mainline.git</pre>
+
+	<h3>Build and test instructions</h3>
+
+
+<pre>cd multistockphoto
+rake test
+rake install_gem</pre>
+
+	<h2>License</h2>
+
+
+	<p>This code is free to use under the terms of the <span class="caps">MIT</span> license.</p>
+
+
+	<h2>Contact</h2>
+
+
+	<p>Comments are welcome. Send an email to <a href="mailto:thopre@gmail.com">Thomas Preymesser</a> email 
+or via the <a href="http://groups.google.com/group/multistockphoto">forum</a></p>
+    <p class="coda">
+      <a href="FIXME email">FIXME full name</a>, 6th May 2008<br>
+      Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
+    </p>
+</div>
+
+<!-- insert site tracking codes here, like Google Urchin -->
+
+</body>
+</html>

data/website/index.txt

@@ -0,0 +1,188 @@
+h1. multistockphoto
+
+h1. → 'multistockphoto'
+
+
+h2. What
+
+This program is intended to work with the german versions of the photo sites fotolia.de and zoonar.de.
+Photographers can upload their photos to this sites. 
+Currently it works only with the german version. If you're interested to adapt
+it to other languages please email me.
+ 
+Dieses Programm bietet bequemen Upload von eigenen Photos zu Photo-Seiten wie
+fotolia.de, zoonar.de oder anderen, bei denen man eigene Bilder zum Verkauf
+anbieten kann. 
+Neue Photos werden automatisch zu allen Seiten hochgeladen, bei denen man 
+registriert ist.
+
+h2. Installing
+
+<pre syntax="ruby">sudo gem install multistockphoto</pre>
+
+h2. The basics
+
+Nach der Installation lege irgendwo einen Ordner namens 'multistockphoto' an!
+Innerhalb dieses Ordners lege bitte einen weiteren Ordner namens 'upload' an!
+
+Du benötigst jetzt noch eine Datei namens 'config.yaml' mit folgendem Inhalt:
+
+<pre>
+--- 
+:zoonar: 
+  :password: 'lalala'
+  :user: 'hugo'
+:fotolia: 
+  :user: 'hugo'
+  :password: 'lalal9589'
+  :ftp_user: '34567798'
+  :ftp_password: 'hugolala19589'
+</pre>
+
+Trage dort deine Zugangsdaten ein! Achtung: Die Einrückung links ist wichtig. 
+Im Gem-Directory ist eine Vorlage, die du kopieren kannst.
+Wenn du nicht bei allen aufgelisteten Sites Mitglied bist oder die Bilder dort
+hochladen möchtest, dann lösche einfach
+die entsprechenden Abschnitte - du ersparst dir und den jeweiligen Servern 
+unnötige Last, die bei fehlerhaften Einloggversuchen vergeudet wird.
+
+Wenn du ein oder mehrere neue Bilder hochladen willst, kopiere die Bilddateien
+in den upload-Ordner!
+Dann rufe (innerhalb des multistockphoto-Ordners) das Kommando
+
+<pre>
+multistockphoto --send-all
+</pre>
+
+auf! Dieses erledigt den Upload aller neuen Photos zu allen definierten 
+Photo-Sites.
+
+Die Photo-Dateien im upload-Ordner müssen nach dem Upload nicht gelöscht
+werden - bei einem weiteren Aufruf werden bereits gesendete Photos nicht noch
+einmal gesendet.
+
+Alle Dateien mit den Endungen .PNG, .JPG, .GIF, .JPEG werden hochgeladen. Groß-
+oder Kleinschreibung ist egal.
+
+Das Programm erstellt (im Directory multistockphoto) eine Datei namens
+'sendeliste.dat', in der die erfolgreichen Uploads mit Site, Dateiname und
+Datum/Uhrzeit protokolliert werden. Diese Datei darf nicht gelöscht werden, 
+da diese Datei auch dazu dient, festzustellen, ob ein Datei schon gesendet 
+wurde.
+Kurz: falls eine Photo-Datei in dieser Datei noch nicht auftaucht, wird
+sie an die betreffende Seit gesendet. Bei Problemen bei einzelnen Uploads kann
+man aber in dieser Datei z.B. eine Zeile löschen, was zur Folge hat, daß 
+diese Datei beim nächsten Aufruf erneut hochgeladen wird.
+
+Je nach Photo-Site mußt du dann dort online noch Stichworte und ggf. andere
+Daten zu den einzelnen Bildern eintragen.
+
+Einzelne Sites handhaben dies unterschiedlich.
+
+Beispiel: Bei fotolia.de mußt du deine Photos hochladen, dann noch Stichworte
+und verschiedene Vertragsbedingungen festlegen. Dann erst werden deine Bilder
+geprüft und entweder angenommen oder abgelehnt.
+
+Bei zoonar.de wiederum läuft es so, daß du erst nur die Bilder hochlädst, dann 
+werden sie begutachtet; angenommen oder abgelehnt und erst wenn sie 
+angenommen wurden, kannst du Schlagworte vergeben. Dies hat natürlich den
+Vorteil, daß man für abgelehnte Photos erst gar keine Schlagworte vergeben muß
+(kann).
+
+Diese Nachbearbeitung auf der jeweiligen Seite ist derzeit noch nötig, es ist aber
+geplant, daß auch z.B. die Schlagworte von diesem Programm schon gesetzt werden
+können.
+
+h2. Demonstration of usage
+
+Wechseln in Arbeitsdirectory:
+
+<pre>$ cd multistockphoto
+</pre>
+
+<pre> 
+$ multistockphoto --help
+Usage: multistockphoto [-hvsa]
+
+Specific options:
+
+Common options: 
+    -h, --help                       Show this message
+    -v, --version                    Show version
+   -sa, --send-all                   Send all files
+</pre>
+
+Senden aller noch nicht hochgeladenen Photos:
+
+<pre>
+$ multistockphoto --send-all
+send-all
+upload/img_2746.jpg
+fotolia:upload/img_2746.jpg
+zoonar:upload/img_2746.jpg
+</pre>
+
+h2. Forum
+
+"http://groups.google.com/group/multistockphoto":http://groups.google.com/group/multistockphoto
+
+
+h2. How to submit patches
+
+Read the "8 steps for fixing other people's code":http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/ and for section "8b: Submit patch to Google Groups":http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/#8b-google-groups, use the Google Group above.
+
+TODO - pick SVN or Git instructions
+
+The trunk repository is <code>svn://rubyforge.org/var/svn/multistockphoto/trunk</code> for anonymous access.
+
+OOOORRRR
+
+You can fetch the source from either:
+
+<% if rubyforge_project_id %>
+
+* rubyforge: "http://rubyforge.org/scm/?group_id=<%= rubyforge_project_id %>":http://rubyforge.org/scm/?group_id=<%= rubyforge_project_id %>
+
+<pre>git clone git://rubyforge.org/multistockphoto.git</pre>
+
+<% else %>
+
+* rubyforge: MISSING IN ACTION
+
+TODO - You can not created a RubyForge project, OR have not run <code>rubyforge config</code>
+yet to refresh your local rubyforge data with this projects' id information.
+
+When you do this, this message will magically disappear!
+
+Or you can hack website/index.txt and make it all go away!!
+
+<% end %>
+
+* github: "http://github.com/GITHUB_USERNAME/multistockphoto/tree/master":http://github.com/GITHUB_USERNAME/multistockphoto/tree/master
+
+<pre>git clone git://github.com/GITHUB_USERNAME/multistockphoto.git</pre>
+
+
+TODO - add "github_username: username" to ~/.rubyforge/user-config.yml and newgem will reuse it for future projects.
+
+
+* gitorious: "git://gitorious.org/multistockphoto/mainline.git":git://gitorious.org/multistockphoto/mainline.git
+
+<pre>git clone git://gitorious.org/multistockphoto/mainline.git</pre>
+
+h3. Build and test instructions
+
+<pre>cd multistockphoto
+rake test
+rake install_gem</pre>
+
+
+h2. License
+
+This code is free to use under the terms of the MIT license. 
+
+h2. Contact
+
+Comments are welcome. Send an email to "Thomas Preymesser":mailto:thopre@gmail.com email 
+or via the "forum":http://groups.google.com/group/multistockphoto
+