teliaxr 0.0.1 → 0.0.2

data/README.rdoc

@@ -4,35 +4,42 @@
 
 == DESCRIPTION:
 
-Unofficial ruby api to Teliax Dashboard, it will one day allow you to manage your teliax acct from 
+Unofficial ruby api to the Teliax Dashboard 
 
 
 == FEATURES/PROBLEMS:
- It doesnt do much at the time
+ *current features* 
+
+ # logs in to your teliax account using supplied credentials
+ # checks your account balance,
+ # list your current numbers
+ # list your destinations, 
+ # change proxy settings for existing numbers
+ # change destination settings for existing numbers
+ # search availability for new numbers (not implemented)
 
- Can login to your teliax account and list your numbers
 
  Since it is unofficial and it relies on scrapping Teliax web sites it may broke if they change their website. YMMV
 
 
 == SYNOPSIS:
 
-  teliax = Teliaxr::API.new(username, password)
-  teliax.login
-  teliax.numbers
-  teliax.numbers_list
-    1234567890
-    1234567891
-    1234567892
+  +teliax = Teliaxr::API.new(username, password)+
+  teliax.account_balance
+
+  teliax.destinations
+  teliax.proxies
+  number teliax.numbers.first
+
+  teliax.set_proxy_for_number(number, "atlanta")
 
 == REQUIREMENTS:
 
- mechanize  0.9.3
- nokogiri
+ mechanize-0.9.3
 
 == INSTALL:
 
- sudo gem install teliaxr
+ sudo gem install teliaxr --source=http://gemcutter.org
 
 == LICENSE:
 

data/lib/teliaxr.rb

@@ -2,48 +2,187 @@ $:.unshift(File.dirname(__FILE__)) unless
   $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 module Teliaxr
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
   require 'rubygems' 
   I_KNOW_I_AM_USING_AN_OLD_AND_BUGGY_VERSION_OF_LIBXML2=1
   require 'mechanize'
   require 'nokogiri'
 
   class API
-    attr_reader :page
+    attr_reader :page, :account_number
+
+# ====  
+#  takes a username and password to log in to the teliax dashboard
     def initialize(username, password, url=nil)
       @username = username
       @password = password
-      @url = url
-      @url ||= "https://www.teliax.com"
+      @teliax_url = url
+      @teliax_url ||= "https://www.teliax.com"
       @agent = WWW::Mechanize.new
-      get_main_page
+      @numbers_list = {}
+      @destinations_list = {}
+      @proxies = {
+        "denver" => {:proxy_url => "den.teliax.net", :proxy_id => "1"},
+        "new york" => {:proxy_url => "nyc.teliax.net", :proxy_id => "2"},
+        "los angeles" => {:proxy_url => "lax.teliax.net", :proxy_id => "3"},
+        "atlanta" => {:proxy_url => "atl.teliax.net", :proxy_id => "4"},
+        "fax" => {:proxy_url => "fax.teliax.net", :proxy_id => "7"}
+      }
+      @balance = nil 
+      @account = nil
+
+      get_page(@teliax_url)
+      login
+      account_balance
+      account_number
+    end
+
+    private
+    def click_link_by_name(name)
+      #clicks link by name
+       @page = @agent.click( @page.links.select {|l| l.text =~/#{name}/}.first )
+    end
+
+    def get_link_by_name(name)
+       @page.links.select {|l| l.text =~/#{name}/}.first 
     end
 
-    def get_main_page
-      @page = @agent.get @url
+    def get_page(url)
+      @page = @agent.get url
     end
 
+
     def login
+      #i should check that i am on the login page first
       form = @page.forms.first
       form['login'] = @username
       form['password'] = @password
-      form.submit
       @page = form.submit
-
     end
+    
+    def url_for_number(nr)
+      "#{@teliax_url}/customers/#{@account}/numbers/#{numbers[nr][:number_id]}"
+    end
+
+    public
+
+# ====   
+#  returns account balance as float
+    def account_balance(force_update=false) 
+      #should check if force update has been requested  
+      return @balance unless @balance.nil?
+      @balance = @page.search("div#site_left_nav_headerBlack a").first.content.gsub(/Balance \$/,'').to_f
+    end 
 
-    def numbers
-      @page = @agent.click( @page.links.select {|l| l.text =~/Numbers/}.first )
+
+# ====  
+#  returns account number
+    def account_number(force_update=false) 
+      return @account unless @account.nil?
+      @account = @page.search("div#site_left_nav_headerBlack").text.to_a.last.gsub(/\D/,'')
     end
 
-    def numbers_list
+
+# ====  
+#  returns numbers list as an array, pass parameter force_reload to update list
+    def numbers(force_reload=false)
+      unless @numbers_list.empty?  
+        if force_reload == false
+          return @numbers_list 
+        end
+      end
+
+      #puts "RELOADING: force: #{force_reload} list.empty?: #{@numbers_list.empty?}"
+
+      click_link_by_name "Numbers" #goes to the numbers website
+      @numbers_list={}
       @page.search('div#site_content_container_center table tbody tr').each do |tr|
-      tr.search('td:nth-child(1)').each do |td|
-        puts td.content
+
+        @numbers_list[tr.search('td:nth-child(1)').first.content.gsub(/\D/,'')] = {
+          :number_id => tr.search('td:nth-child(3) @id').text.split("_").last.strip,
+          :gateway_id => tr.search('td:nth-child(3) option[selected] @value'),
+          :gateway_name => tr.search('td:nth-child(3) option[selected]').text,
+          :destination_id => tr.search('td:nth-child(4) option[selected] @value'),
+          :destination_name => tr.search('td:nth-child(4) option[selected]').text.split(":").last.strip
+        } 
       end
+      @numbers_list
+    end
+
+
+# ==== 
+# returns current destination for this number 
+    def destination_for_number(nr,force_reload=false)
+      numbers(force_reload)[nr][:destination_name]
+    end
+
+
+# ====  
+# sets rings to destination for this number, weather is a device or another ring number
+    def set_destination_for_number(nr,destination_name)
+      
+      @page = @agent.post(url_for_number(nr), {"number[destination]" => destinations[destination_name][:destination_id], "_method" => "put"})
+    end
+
+# ==== 
+# returns proxy that is setup to originate calls to this number 
+    def proxy_for_number(nr,force_reload=false) 
+      numbers(force_reload)[nr][:gateway_name]
+    end
+
+# ==== 
+# set the proxy this number will be get originated from 
+    def set_proxy_for_number(nr,proxy_name) 
+      @page = @agent.post(url_for_number(nr), {"number[proxy_id]" => proxies[proxy_name][:proxy_id], "_method" => "put"})
+    end
+
+# ====   
+# returns list of teliax proxies
+    def proxies
+      @proxies
+    end
+
+# ====   
+#  returns list of teliax destinations
+    def destinations #
+      unless @destinations_list.empty?  
+          return @destinations_list
+      end
+
+      click_link_by_name "Numbers" #goes to the numbers website
+      @destinations_list={}
+      @page.search('div#site_content_container_center table tbody tr:first-of-type td:nth-child(4) option').each do |opt| 
+        destination_id =  opt.search('@value').text
+
+        if destination_id == "_"
+          destination_type = "nowhere"
+          destination_name = opt.text
+        else
+          destination_type = destination_id.split("_").first.downcase.strip
+
+          if destination_type == "number"
+            destination_name = opt.text.gsub(/\D/,'')
+          else
+            destination_name = opt.text.split(":").last.strip
+          end 
+        end
+          #puts destination_type
+          #puts destination_name
+          #puts destination_id
+
+        @destinations_list[destination_name] = {:destination_id => destination_id, :destination_type => destination_type }
+
       end
+      @destinations_list
     end
 
+# ====  
+#  returns list of new numbers based on area code
+    def search_for_new_numbers(area_code)
+    end
+    
+# === 
+#  returns list of links  this is test code
     def get_menu_links
       @page.search('div#site_left_nav_content div').each do |nav|
         nav.search('ul li a').each do |link|
@@ -53,4 +192,5 @@ module Teliaxr
     end
 
   end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: teliaxr
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Rene Mendoza
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-23 00:00:00 -05:00
+date: 2009-10-25 01:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -32,7 +32,7 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 2.3.3
     version: 
-description: Unofficial ruby api to Teliax Dashboard, it will one day allow you to manage your teliax acct from
+description: Unofficial ruby api to the Teliax Dashboard
 email: 
 - latiendamac@gmail.com
 executables: []
@@ -80,10 +80,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: teliaxr
-rubygems_version: 1.3.3
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
-summary: Unofficial ruby api to Teliax Dashboard, it will one day allow you to manage your teliax acct from
+summary: Unofficial ruby api to the Teliax Dashboard
 test_files: 
 - test/test_helper.rb
 - test/test_teliaxr.rb