djanoa 0.0.1

data/LICENSE.md

@@ -0,0 +1,24 @@
+Copyright (c) 1998, Regents of the University of California
+All rights reserved.
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+* Neither the name of the University of California, Berkeley nor the
+  names of its contributors may be used to endorse or promote products
+  derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY
+EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,52 @@
+Djanoa
+======
+
+Interface Ruby pour envoyer des SMS avec la plateforme [Djanoa](http://www.djanoa.com).
+
+Installation
+------------
+```bash
+gem install djanoa
+```
+
+Utilisation
+-----------
+
+Il faut d'abord créer un compte sur [le site de djanoa](http://www.djanoa.com).
+
+Ensuite vous faites les configurations
+```ruby
+Djanoa.configure do |config|
+  config.from = VOTRE_NUMERO_COURT
+  config.account_code = CODE_DE_VOTRE_COMPTE
+  config.application_pass = MOT_DE_PASSE
+end
+```
+
+ensuite pour envoyer un SMS il suffit de faire :
+
+```ruby
+Djanoa.send_sms '221777777777', 'juste pour tester mon gem'
+```
+
+Gestion des erreurs
+-------------------
+
+Si vous voulez allez plus loin vous pouvez récupérer la réponse et voir s'il n'y a pas d'erreur.
+
+Le code suivant permet d'envoyer un SMS et, s'il y'a une erreur, affiche le code de l'erreur, le message d'erreur ainsi que l'adresse IP de l'envoyeur.
+```ruby
+r = Djanoa.send_sms '221777777777', 'juste pour tester mon gem'
+
+if r.sent?
+  puts r.error.code
+  puts r.error.message
+  puts r.error.ip
+else
+  puts "le sms est envoyé"
+end
+```
+
+Copyright
+---------
+Copyright 2013 Cheikh Sidya CAMARA. Voir [la LICENSE](https://github.com/scicasoft/djanoa/blob/master/LICENSE.md) pour plus de détails.

data/djanoa.gemspec

@@ -0,0 +1,20 @@
+# coding: utf-8
+Gem::Specification.new do |s|
+  s.name               = "djanoa"
+  s.version            = "0.0.1"
+  s.default_executable = "djanoa"
+
+  s.add_dependency 'rest-client', '>= 1.6.7'
+  s.add_dependency "nokogiri", "~> 1.5.6"
+  s.required_rubygems_version = '>= 1.3.6'
+  s.authors = ["Cheikh Sidya CAMARA"]
+  s.date = %q{2013-03-07}
+  s.description = %q{une gem pour interfacer les applications ruby avec la plateforma Djanoa}
+  s.email = %q{scicasoft@gmail.com}
+  s.files = %w(LICENSE.md README.md djanoa.gemspec)
+  s.files += Dir.glob("lib/**/*.rb")
+  s.homepage = %q{http://rubygems.org/gems/djanoa}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = s.description
+end

data/lib/djanoa/error.rb

@@ -0,0 +1,18 @@
+module Djanoa
+  class Error
+    attr_reader :code, :message, :ip
+
+    # Instantiates a new django error object
+    # @param code [Integer]
+    # @param message [String]
+    # @param ip [String]
+    # @return [Djanoa::Error]
+
+    def initialize code, message, ip
+      @code = code
+      @message = message
+      @ip = ip
+      self
+    end
+  end
+end

data/lib/djanoa/response.rb

@@ -0,0 +1,29 @@
+require 'nokogiri'
+
+module Djanoa
+  class Response
+    attr_reader :sent, :error
+
+    # Instantiates a new response object
+    # @param response [String]
+    # @return [Djanoa::Response]
+
+    def initialize response = ""
+      doc = Nokogiri::Slop response
+      @sent = doc.root.name == "DjanoaResponse" ? true : false
+      unless @sent
+        code = doc.DjanoaError.Code.content.to_i
+        message = doc.DjanoaError.Error.content
+        ip = doc.DjanoaError.IP.content
+        @error = Error.new code, message, ip
+      end
+
+      self
+    end
+
+    # @return [Boolean]
+    def sent?
+      return @sent
+    end
+  end
+end

data/lib/djanoa.rb

@@ -0,0 +1,36 @@
+require 'djanoa/error'
+require 'djanoa/response'
+
+require 'uri'
+require 'rest-client'
+
+module Djanoa
+  BASE_URL = "http://djanoa.com/sms/"
+  class << self
+    attr_writer :from, :account_code, :application_pass
+    attr_reader :response
+
+    # A method to allow configuration options to be set in a block
+    # @return [Djanoa]
+    def configure
+      yield self
+      self
+    end
+
+    # Send a new sms
+    # @param phone [String]
+    # @param message [String]
+    # @return [Djanoa::Response]
+    def send_sms phone, message
+      message = URI.escape message
+      response = RestClient.get "#{sender_base_url}/?from=#{@from}&to=#{phone}&text=#{message}&pass=#{@application_pass}"
+      @response = Response.new response
+    end
+
+    private
+
+    def sender_base_url
+      "#{BASE_URL}#{@account_code}/out"
+    end
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: djanoa
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Cheikh Sidya CAMARA
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: &18793600 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.6.7
+  type: :runtime
+  prerelease: false
+  version_requirements: *18793600
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &19633140 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.6
+  type: :runtime
+  prerelease: false
+  version_requirements: *19633140
+description: une gem pour interfacer les applications ruby avec la plateforma Djanoa
+email: scicasoft@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- djanoa.gemspec
+- lib/djanoa/error.rb
+- lib/djanoa/response.rb
+- lib/djanoa.rb
+homepage: http://rubygems.org/gems/djanoa
+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: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: une gem pour interfacer les applications ruby avec la plateforma Djanoa
+test_files: []