textamerica 0.1

data/README

@@ -0,0 +1,13 @@
+== Welcome to TextAmerica
+
+TextAmerica is a ruby library for interacting with TextAmerica.com
+
+== Usage
+    require 'textAmerica'    
+    @tamerica = TextAmerica::Client.new <APIKEY>, <USERNAME>, <PASSWORD>
+
+== About
+
+Author::    Mark Lussier  (mailto:mlussier@gmail.com)
+Copyright:: Copyright (c) 2005 Mark Lussier
+License::   BSD

data/Rakefile

@@ -0,0 +1,75 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rake/contrib/rubyforgepublisher'
+
+PKG_VERSION = "0.1"
+
+PKG_FILES = FileList[
+    "lib/**/*", "bin/*", "test/**/*", "[A-Z]*", "Rakefile", "doc/**/*"
+]
+
+desc "Default Task"
+task :default => [ :test ]
+
+# Run the unit tests
+desc "Run all unit tests"
+Rake::TestTask.new("test") { |t|
+  t.libs << "lib"
+  t.pattern = 'test/*/*_test.rb'
+  t.verbose = true
+}
+
+# Genereate the RDoc documentation
+desc "Create documentation"
+Rake::RDocTask.new("doc") { |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+}
+
+# Genereate the package
+spec = Gem::Specification.new do |s|
+
+  #### Basic information.
+
+  s.name = 'textamerica'
+  s.version = PKG_VERSION
+  s.summary = <<-EOF
+   A Ruby API for interacting with TextAmerica.com
+  EOF
+  s.description = <<-EOF
+   A Ruby API for interacting with TextAmerica.com
+  EOF
+
+  #### Which files are to be included in this gem?  Everything!  (Except CVS directories.)
+
+  s.files = PKG_FILES
+
+  #### Load-time details: library and application (you will need one or both).
+
+  s.require_path = 'lib'
+  s.autorequire = 'textamerica'
+
+  #### Documentation and testing.
+
+  s.has_rdoc = true
+
+  #### Author and project details.
+
+  s.author = "Mark Lussier"
+  s.email = "mlussier@gmail.com"
+  s.homepage = "http://rubyforge.org/projects/textamerica/"
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+desc "Publish to RubyForge"
+task :rubyforge do
+    Rake::RubyForgePublisher.new('textamerica', 'intabulas').upload
+end

data/lib/textamerica.rb

@@ -0,0 +1,242 @@
+#!/usr/local/bin/ruby
+
+##
+# Ruby API for TextAmerica (See http://www.textamerica.com/api.aspx)
+# Copyright 2005 Mark Lussier
+#
+# HISTORY:
+#
+#       0.1 [2005-04-13]: Initial release
+#
+##
+
+
+require 'xmlrpc/client'
+require 'base64'
+
+
+module TextAmerica
+
+  class Client
+ 
+    #
+    def initialize( apikey, username, password)
+      #@client = XMLRPC::Client.new('xml.api.textamerica.com', '/', 80) 
+      @client = XMLRPC::Client.new('localhost', "/",3333) 
+      @apikey = apikey
+      @username = username
+      @password = password
+    end
+   
+   
+    ##
+    # ta.Moblog Methods
+    ##
+   
+    # Returns a list of the owners moblogs
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Moblog.GetMyMoblogs
+    def getMyMoblogs
+      return @client.call( 'ta.Moblog.GetMyMoblogs', @apikey, @username, @password )
+    end
+    
+    # Returns a list of community moblog
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Moblog.GetCommunityMoblogs
+    def getCommunityMoblogs( which ) 
+      return @client.call( 'ta.Moblog.GetCommunityMoblogs', @apikey, @username, @password, which)
+    end
+    
+    # Changes the specific properties of your moblog such as title, text, domain, secret word. Returns a MoblogID
+    # 
+    # See http://www.textamerica.com/apicalls.aspx?call=Moblog.Update
+    def update( moblogid, domain, secretword, title, text, approvaltype, allowcomments )
+      return @client.call( 'ta.Moblog.Update', @apikey, @username, @password, moblogid,
+                           domain, secretword, title, text, approvaltype, allowcomments)
+    end
+   
+    # Updates the title of a moblog. Returns the MoblogID.
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Moblog.ChangeTitle
+    def changeTitle( moblogid, title)
+      return @client.call( 'ta.Moblog.ChangeTitle', @apikey, @username, @password, moblogid, title)
+    end
+
+    # Updates the description of a moblog. Returns the MoblogID
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Moblog.ChangeText
+    def changeText( moblogid, text)
+      return @client.call( 'ta.Moblog.ChangeText', @apikey, @username, @password, moblogid, text)
+    end
+
+    # Changes an existing moblog domain. Returns the MoblogID 
+    #  
+    # See http://www.textamerica.com/apicalls.aspx?call=Moblog.ChangeDomain
+    def changeDomain( moblogid, domain)
+      return @client.call( 'ta.Moblog.ChangeDomain', @apikey, @username, @password, moblogid, domain)
+    end   
+
+    # Changes the secret word of a moblog. Returns the MoblogID
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Moblog.ChangeSecretWord
+    def changeSecretWord( moblogid, secretword)
+      return @client.call( 'ta.Moblog.ChangeSecretWord', @apikey, @username, @password, moblogid, secretword)
+    end 
+   
+    ##
+    # ta.Bookmarks Methods
+    ##
+   
+    # Updates or creates a new bookmark list. Returns the bookmark list id.
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Bookmarks.Update
+    def bookmarksUpdate( listid, title)
+      return @client.call( 'ta.Bookmarks.Update', @apikey, @username, @password, listid, title)
+    end 
+   
+    # Assigns a bookmark list to a specified moblog.
+    # 
+    # See http://www.textamerica.com/apicalls.aspx?call=Bookmarks.Assign
+    def bookmarksAssign( moblogid, listid)
+      return @client.call( 'ta.Bookmarks.Assign', @apikey, @username, @password, moblogid, listid)
+    end 
+
+    # Removes a bookmark list from a specified moblog
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Bookmarks.UnAssign
+    def bookmarksUnAssign( moblogid, listid)
+      return @client.call( 'ta.Bookmarks.UnAssign', @apikey, @username, @password, moblogid, listid)
+    end 
+ 
+    # http://www.textamerica.com/apicalls.aspx?call=Bookmarks.Delete
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Bookmarks.Delete
+    def bookmarksDelete( listid)
+      return @client.call( 'ta.Bookmarks.Delete', @apikey, @username, @password, listid)
+    end 
+   
+    # Updates or creates a new URL on a specified list.
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Bookmarks.UpdateURL
+    def bookmatksUpdateUrl(listid, title, url, target)
+        return @client.call( 'ta.Bookmarks.UpdateUrl', @apikey, @username, @password, listid, title, url, target)
+    end
+   
+    # Removes a URL from a specified bookmark list.  
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Bookmarks.RemoveURL
+    def bookmatksRemoveUrl(listid, url)
+      return @client.call( 'ta.Bookmarks.RemoveUrl', @apikey, @username, @password, listid, url)
+    end
+   
+
+    ##
+    # ta.Favorites Methods
+    ##   
+
+    # Returns a list of the owners moblogs.
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Favorites.Update
+    def favoritesUpdate( listid, listtitle)
+      return @client.call( 'ta.Favorites.Update', @apikey, @username, @password, listid, listtitle)
+    end 
+   
+    # Assigns a Favorites List to be displayed on a moblog.
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Favorites.Assign
+    def favoritesAssign( moblogid, listid)
+      return @client.call( 'ta.Favorites.Assign', @apikey, @username, @password, moblogid, listid)
+    end 
+
+    # Remove a moblog to a Favorites List.
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Favorites.Delete
+    def favoritesDelete( listid, listtitle)
+      return @client.call( 'ta.Favorites.Delete', @apikey, @username, @password, listid, listtitle)
+    end 
+
+    # Add a moblog to a Favorites List
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Favorites.AddMoblog
+    def favoritesAddMoblog( listid, moblogurl)
+      return @client.call( 'ta.Favorites.AddMoblog', @apikey, @username, @password, listid, moblogurl)
+    end 
+    
+    # Remove a moblog to a Favorites List. 
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Favorites.RemoveMoblog
+    def favoritesRemoveMoblog( listid, moblogurl)
+      return @client.call( 'ta.Favorites.RemoveMoblog', @apikey, @username, @password, listid, moblogurl)
+    end 
+   
+    ##
+    # ta.Template Methods
+    ##
+   
+    # Updates the section HTML for a specified moblog
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Template.UpdateSection
+    def templateUpdateSection(moblogid, sectionid, htmlcode)
+        return @client.call( 'ta.Template.UpdateSection', @apikey, @username, @password, moblogid, sectionid, htmlcode)
+    end
+   
+    # Sets a template for a specified moblog from the textamerica template library
+    #   
+    # See http://www.textamerica.com/apicalls.aspx?call=Template.SetTemplate
+    def templateSetTemplate(moblogid, graphicid, layoutid)
+        return @client.call( 'ta.Template.SetTemplate', @apikey, @username, @password, moblogid, graphicid, layoutid)
+    end
+   
+   
+    ##
+    # ta.Keywords Methods
+    ##
+ 
+    # Adds keywords to a specified entry / image
+    # 
+    # See http://www.textamerica.com/apicalls.aspx?call=Keywords.Add
+    def keywordsAdd(entryid, keywords)
+      return @client.call(  'ta.Keywords.Add', @apikey, @username, @password, entryid, keywords)
+    end
+   
+    ##
+    # ta.Entry Methods
+    ##
+
+    # Updates or creates a new image entry. Returns the EntryID.
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Entry.Update
+    def entryUpdate( moblogid, entryid, title, text, categoryid, imagedata, filetype)
+      return @client.call(  'ta.Entry.Update', @apikey, @username, @password, moblogid, entryid, title, text, categoryid, imagedata, filetype)
+    end
+
+    # Updates or creates a new image entry. Returns the EntryID.
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Entry.Update
+    def entryUpdateEx( moblogid, entryid, title, text, categoryid, file, filetype)
+        if File.exists?( file)      
+           imagedata = File.open(file, "rb") {|f| f.read} 
+           return @client.call( 'ta.Entry.Update', @apikey, @username, @password, moblogid, entryid, title, text, 
+                                 categoryid, XMLRPC::Base64.encode(imagedata), filetype)
+        end
+        
+    end
+
+    # Deletes a specified entry from a moblog. Returns "OK".   
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Entry.Delete    
+    def entryDelete( moblogid, entryid)
+        return @client.call(  'ta.Entry.Delete', @apikey, @username, @password, moblogid, entryid)
+    end
+   
+    # Deletes a specified entry from a moblog. Returns "OK".
+    #
+    # See http://www.textamerica.com/apicalls.aspx?call=Entry.Delete   
+    def entryDelete?( moblogid, entryid)
+        result = @client.call(  'ta.Entry.Delete', @apikey, @username, @password, moblogid, entryid)
+        return result == 'OK'
+    end
+  
+  end
+  
+end

data/test/test_helper.rb

@@ -0,0 +1,4 @@
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+require 'test/unit'
+require 'textamerica'

data/test/textamerica/textamerica_test.rb

@@ -0,0 +1,18 @@
+require File.dirname(__FILE__) + '/../test_helper'
+class TextAmericaTest < Test::Unit::TestCase
+
+	def setup
+		@tamerica = TextAmerica::Client.new( 'TA113805', '<USERNAME>', '<PASSWORD>')
+	end
+
+
+    def test_getMyMoblogs
+       assert_nothing_raised { moblogs = @tamerica.getMyMoblogs }
+    end
+
+    def test_getCommunityMoblogs
+       assert_nothing_raised { moblogs = @tamerica.getCommunityMoblogs 5 }
+    end
+
+    
+end

metadata

@@ -0,0 +1,42 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.10
+specification_version: 1
+name: textamerica
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+date: 2005-04-14
+summary: A Ruby API for interacting with TextAmerica.com
+require_paths: 
+  - lib
+email: mlussier@gmail.com
+homepage: http://rubyforge.org/projects/textamerica/
+rubyforge_project: 
+description: A Ruby API for interacting with TextAmerica.com
+autorequire: textamerica
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+    - 
+      - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+  version: 
+platform: ruby
+authors: 
+  - Mark Lussier
+files: 
+  - lib/textamerica.rb
+  - test/test_helper.rb
+  - test/textamerica
+  - test/textamerica/textamerica_test.rb
+  - Rakefile
+  - README
+test_files: []
+rdoc_options: []
+extra_rdoc_files: []
+executables: []
+extensions: []
+requirements: []
+dependencies: []