smsforall 0.0.2

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*~

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 drakmail
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,41 @@
+# Smsforall
+
+Client for smsforall.ru site API (http://www.smsforall.ru/doc/api/)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'smsforall'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install smsforall
+
+## Usage
+
+Usage is pretty simple:
+
+    sms = Smsforall::Sms.new("test", "test", :test) #  for test
+	# for production:
+    # sms = Smsforall::Sms.new("login", "password")
+    balance = sms.get_balance()
+    message = sms.send_message("sender", "sms text", "79251233232")
+    status = sms.get_status(message)
+    puts "#{balance}, #{message}, #{status}"
+
+## Command-line client
+
+smsforall-gem also provides command line utility `smsforall`. You may see usage instructions by executing `smsforall -h`.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/smsforall

@@ -0,0 +1,91 @@
+#!/usr/bin/env ruby
+
+require 'smsforall'
+require 'optparse'
+
+# Parameters parsing
+options = {}
+ 
+optparse = OptionParser.new do|opts|
+  opts.banner = "Usage: smsforall (-l login -p password|--test) COMMAND [options] ..."
+
+  opts.separator  ""
+  opts.separator  "Commands"
+  opts.separator  "     balance                   : get balance"
+  opts.separator  "     send SENDER NUMBER TEXT   : send SMS with TEXT to NUMBER"
+  opts.separator  "     status TRANSACTION        : get status of transaction"
+  opts.separator  ""
+  opts.separator  "Options"
+ 
+  # Define the options, and what they do
+  options[:login] = nil
+  opts.on( '-l', '--login LOGIN', 'Login' ) do|login|
+    options[:login] = login
+  end
+ 
+  options[:password] = nil
+  opts.on( '-p', '--password PASSWORD', 'Password' ) do|password|
+    options[:password] = password
+  end
+ 
+  options[:test] = :production
+  opts.on( '-t', '--test', 'Enable test mode' ) do
+    options[:test] = :test
+  end
+ 
+  opts.on( '-h', '--help', 'Display this screen' ) do
+    puts opts
+    exit
+  end
+end
+ 
+optparse.parse!
+
+if options[:test] == :test
+  puts "[WARNING]: test mode enabled!"
+  options[:login] = "test"
+  options[:password] = "test"
+end
+
+if not (options[:login] && options[:password])
+  puts "[ERROR]: you must provide login and password!"
+  exit
+end
+
+if not %w[balance send status].include?(ARGV[0])
+  puts "[ERROR]: command not defined!"
+  exit
+end
+
+# actions
+def get_balance(login, password, test)
+  sms = Smsforall::Sms.new(login,password, test)
+  puts "[INFO]: getting balance for #{login}"
+  balance = sms.get_balance()
+  puts "#{balance}"
+end
+
+def send_sms(login, password, test, sender, number, text)
+  if not (sender && number && text)
+    puts "[ERROR]: wrong number of parameters!"
+    exit
+  end
+  puts "[INFO]: sending SMS to #{number}"
+  sms = Smsforall::Sms.new(login,password, test)
+  transaction = sms.send_message(sender, text, number)
+  puts "#{transaction}"
+end
+
+def get_status(login, password, test, transaction)
+  puts "[INFO]: getting status"
+  sms = Smsforall::Sms.new(login,password, test)
+  status = sms.get_status(transaction)["status"]
+  puts "#{status}"
+end
+
+# route command
+action = case ARGV[0]
+           when "balance" then get_balance(options[:login], options[:password], options[:test])
+           when "send" then send_sms(options[:login], options[:password], options[:test], ARGV[1], ARGV[2], ARGV[3])
+           when "status" then get_status(options[:login], options[:password], options[:test], ARGV[1])
+end

data/lib/smsforall/version.rb

@@ -0,0 +1,4 @@
+module Smsforall
+  # GEM version
+  VERSION = "0.0.2"
+end

data/lib/smsforall.rb

@@ -0,0 +1,56 @@
+require "smsforall/version"
+require 'net/http'
+require 'cgi'
+require 'digest'
+require 'json'
+
+# Main module for Smsforall API class
+module Smsforall
+  # Class for interaction with smsforall.ru API
+  class Sms
+    attr_reader :username, :password, :api
+
+    # Initialize Sms-API class. For testing purporoses set mode to :test
+    def initialize(username, password, mode=:production)
+      @username = username
+      @password = Digest::MD5.hexdigest(password)
+      modes = {:production => "/api/", :test => "/testapi/"}
+      @api = modes[mode]
+    end
+
+    # Return user balance
+    def get_balance()
+      do_request("balance", {})["balance"]
+    end
+
+    # Send message
+    def send_message(sender,text,msisdn)
+      do_request("send", { :msisdn => msisdn, :sender => sender, :text => text })["transactionid"]
+    end
+    
+    # Get status of transaction
+    def get_status(transactionid)
+      do_request("status", { :transactionid => transactionid })
+    end
+
+    private
+    # Simple HTTP GET request wrapper
+    def http_get(domain,path,params)
+      return Net::HTTP.get(domain, "#{path}?".concat(params.collect { |k,v| "#{k}=#{CGI::escape(v.to_s)}" }.join('&'))) if not params.nil?
+      return Net::HTTP.get(domain, path)
+    end
+
+    # Convert hash to inner signature format
+    def to_signature(parameters)
+      parameters.map{|k,v| "#{v}"}.join('')
+    end
+    
+    # Send request to smsforall
+    def do_request(action,parameters)
+      request_parameters = { :action => action, :login => @username}.merge(parameters)
+      signature = Digest::MD5.hexdigest( to_signature( request_parameters.merge({:password => @password}) ) )
+      request_parameters["signature"] = signature
+      result = JSON.parse(http_get("www.smsforall.ru",@api,request_parameters.merge(parameters) ))
+    end
+  end
+end

data/smsforall.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/smsforall/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["drakmail"]
+  gem.email         = ["drakmail@delta.pm"]
+  gem.description   = %q{Interaction with smsforall.ru API}
+  gem.summary       = %q{Sending SMS with smsforall.ru API}
+  gem.homepage      = "https://github.com/drakmail/smsforall-gem"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "smsforall"
+  gem.require_paths = ["lib"]
+  gem.version       = Smsforall::VERSION
+
+  gem.add_dependency 'json'
+
+  gem.add_development_dependency 'rspec'
+end

data/spec/api_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe Smsforall do
+  sms = Smsforall::Sms.new("test","test", :test)
+  balance = sms.get_balance()
+  message = sms.send_message("sender", "sms text", "79251233232")
+  status = sms.get_status(message)
+  puts "#{balance}, #{message}, #{status}"
+end

data/spec/api_spec.rb~

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe Smsforall do
+  pending "write it"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require 'smsforall'
+
+RSpec.configure do |config|
+  config.color_enabled = true
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: smsforall
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.2
+platform: ruby
+authors: 
+- drakmail
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-08-30 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: Interaction with smsforall.ru API
+email: 
+- drakmail@delta.pm
+executables: 
+- smsforall
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/smsforall
+- lib/smsforall.rb
+- lib/smsforall/version.rb
+- smsforall.gemspec
+- spec/api_spec.rb
+- spec/api_spec.rb~
+- spec/spec_helper.rb
+homepage: https://github.com/drakmail/smsforall-gem
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Sending SMS with smsforall.ru API
+test_files: 
+- spec/api_spec.rb
+- spec/api_spec.rb~
+- spec/spec_helper.rb