itexmo 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 95534a9da39e1612c1ad3a29791495b4a7a61fb649a176a1b3eb80d43791ff1d
+  data.tar.gz: c10000d90f3d5d192c6277a402fd0bd083e9fa9ca381f7df7402462d2180bb72
+SHA512:
+  metadata.gz: 50beb50e29d7380ba99f914e5e4e037d4dd603d78aa996b6f6c11cd901234d49e34f17a2313085acf5f3011300d1720716ee8507f4e106d43e85402738e92b4a
+  data.tar.gz: 9e3dee6604a2de80f81c377fc26e6fb30eeeed46427fc44119522fe85cad003873e8c1010fe36a60d708ff4656d882180a661eed2dd91e339eb6049329a49d4b

data/.env.sample

@@ -0,0 +1 @@
+ITEXMO_API_CODE=you-api-code-here

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+.env
+.byebug_history

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1 @@
+inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -0,0 +1,224 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2018-07-29 15:51:51 +0800 using RuboCop version 0.58.2.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 4
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: empty_lines, empty_lines_except_namespace, empty_lines_special, no_empty_lines, beginning_only, ending_only
+Layout/EmptyLinesAroundClassBody:
+  Exclude:
+    # - 'lib/itexmo/message.rb'
+    # - 'lib/itexmo/response_helper.rb'
+    # - 'lib/itexmo/service.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyleAlignWith, AutoCorrect, Severity.
+# SupportedStylesAlignWith: keyword, variable, start_of_line
+Layout/EndAlignment:
+  Exclude:
+    # - 'lib/itexmo/configuration.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: AllowForAlignment, ForceEqualSignAlignment.
+Layout/ExtraSpacing:
+  Exclude:
+    # - 'itexmo.gemspec'
+
+# Offense count: 158
+# Cop supports --auto-correct.
+# Configuration parameters: Width, IgnoredPatterns.
+Layout/IndentationWidth:
+  Exclude:
+    # - 'lib/itexmo/configuration.rb'
+    # - 'lib/itexmo/errors/authentication.rb'
+    # - 'lib/itexmo/errors/bad_request.rb'
+    # - 'lib/itexmo/errors/configuration.rb'
+    # - 'lib/itexmo/message.rb'
+    # - 'lib/itexmo/response_helper.rb'
+    # - 'lib/itexmo/service.rb'
+    # - 'lib/itexmo/sms.rb'
+    # - 'spec/itextmo/message_spec.rb'
+    # - 'spec/itextmo/response_helper_spec.rb'
+    # - 'spec/itextmo/service_spec.rb'
+    # - 'spec/itextmo/sms_spec.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Layout/LeadingBlankLines:
+  Exclude:
+    # - 'itexmo.gemspec'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: space, no_space
+Layout/SpaceAroundEqualsInParameterDefault:
+  Exclude:
+    # - 'lib/itexmo/message.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: AllowForAlignment.
+Layout/SpaceAroundOperators:
+  Exclude:
+    # - 'itexmo.gemspec'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, EnforcedStyleForEmptyBraces, SpaceBeforeBlockParameters.
+# SupportedStyles: space, no_space
+# SupportedStylesForEmptyBraces: space, no_space
+Layout/SpaceInsideBlockBraces:
+  Exclude:
+    # - 'Gemfile'
+    # - 'spec/itextmo/message_spec.rb'
+
+# Offense count: 9
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, EnforcedStyleForEmptyBraces.
+# SupportedStyles: space, no_space, compact
+# SupportedStylesForEmptyBraces: space, no_space
+Layout/SpaceInsideHashLiteralBraces:
+  Exclude:
+    # - 'lib/itexmo/message.rb'
+    # - 'spec/itextmo/service_spec.rb'
+
+# Offense count: 11
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: final_newline, final_blank_line
+Layout/TrailingBlankLines:
+  Exclude:
+    # - 'Gemfile'
+    # - 'lib/itexmo/errors/authentication.rb'
+    # - 'lib/itexmo/errors/bad_request.rb'
+    # - 'lib/itexmo/errors/configuration.rb'
+    # - 'lib/itexmo/message.rb'
+    # - 'lib/itexmo/response_helper.rb'
+    # - 'lib/itexmo/service.rb'
+    # - 'spec/itextmo/message_spec.rb'
+    # - 'spec/itextmo/response_helper_spec.rb'
+    # - 'spec/itextmo/service_spec.rb'
+    # - 'spec/itextmo/sms_spec.rb'
+
+# Offense count: 21
+# Cop supports --auto-correct.
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Exclude:
+    # - 'lib/generators/itexmo/templates/itexmo_initializer.rb'
+    # - 'lib/itexmo/configuration.rb'
+    # - 'lib/itexmo/message.rb'
+    # - 'lib/itexmo/response_helper.rb'
+    # - 'lib/itexmo/service.rb'
+    # - 'lib/itexmo/sms.rb'
+    # - 'spec/itextmo/message_spec.rb'
+    # - 'spec/itextmo/response_helper_spec.rb'
+    # - 'spec/itextmo/service_spec.rb'
+    # - 'spec/itextmo/sms_spec.rb'
+
+# Offense count: 1
+Lint/DuplicateMethods:
+  Exclude:
+    - 'lib/itexmo.rb'
+
+# Offense count: 1
+Metrics/AbcSize:
+  Max: 20
+
+# Offense count: 4
+# Configuration parameters: CountComments, ExcludedMethods.
+# ExcludedMethods: refine
+Metrics/BlockLength:
+  Max: 91
+
+# Offense count: 2
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+# Offense count: 2
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 33
+
+# Offense count: 4
+Style/Documentation:
+  Exclude:
+    # - 'spec/**/*'
+    # - 'test/**/*'
+    # - 'lib/itexmo/message.rb'
+    # - 'lib/itexmo/response_helper.rb'
+    # - 'lib/itexmo/service.rb'
+    # - 'lib/itexmo/sms.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/ExpandPathArguments:
+  Exclude:
+    # - 'itexmo.gemspec'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, UseHashRocketsWithSymbolValues, PreferHashRocketsForNonAlnumEndingSymbols.
+# SupportedStyles: ruby19, hash_rockets, no_mixed_keys, ruby19_no_mixed_keys
+Style/HashSyntax:
+  Exclude:
+    # - 'Rakefile'
+
+# Offense count: 6
+# Cop supports --auto-correct.
+Style/MutableConstant:
+  Exclude:
+    - 'lib/itexmo/message.rb'
+    # - 'lib/itexmo/service.rb'
+    - 'lib/itexmo/sms.rb'
+    # - 'lib/itexmo/version.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: PreferredDelimiters.
+Style/PercentLiteralDelimiters:
+  Exclude:
+    # - 'itexmo.gemspec'
+
+# Offense count: 26
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiterals:
+  Exclude:
+    # - 'Gemfile'
+    # - 'Rakefile'
+    # - 'bin/console'
+    # - 'itexmo.gemspec'
+    # - 'lib/itexmo/message.rb'
+    # - 'spec/itexmo_spec.rb'
+    # - 'spec/itextmo/sms_spec.rb'
+    # - 'spec/spec_helper.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: ExactNameMatch, AllowPredicates, AllowDSLWriters, IgnoreClassMethods, Whitelist.
+# Whitelist: to_ary, to_a, to_c, to_enum, to_h, to_hash, to_i, to_int, to_io, to_open, to_path, to_proc, to_r, to_regexp, to_str, to_s, to_sym
+Style/TrivialAccessors:
+  Exclude:
+    # - 'lib/itexmo/configuration.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+Style/UnneededPercentQ:
+  Exclude:
+    # - 'itexmo.gemspec'
+
+# Offense count: 46
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
+# URISchemes: http, https
+Metrics/LineLength:
+  Max: 226

data/.travis.yml

@@ -0,0 +1,22 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.1
+before_install: gem install bundler -v 1.16.1
+notifications: false
+
+env:
+  global:
+    - CC_TEST_REPORTER_ID=92300106cf271985d719c3538c2910fbb7e707656a50bc7b3d8e43d8f1762801
+
+before_script:
+  - bundle exec rspec && CODECLIMATE_REPO_TOKEN=92300106cf271985d719c3538c2910fbb7e707656a50bc7b3d8e43d8f1762801
+  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
+
+scripts:
+  - bundle exec rspec spec
+
+after_script:
+  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at denmarkmeralpis@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,14 @@
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in itexmo.gemspec
+gemspec
+
+group :test do
+  gem 'byebug'
+  gem 'generator_spec'
+  gem 'rubocop'
+  gem 'simplecov'
+  gem 'simplecov-console'
+end

data/Gemfile.lock

@@ -0,0 +1,195 @@
+PATH
+  remote: .
+  specs:
+    itexmo (0.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actioncable (5.2.0)
+      actionpack (= 5.2.0)
+      nio4r (~> 2.0)
+      websocket-driver (>= 0.6.1)
+    actionmailer (5.2.0)
+      actionpack (= 5.2.0)
+      actionview (= 5.2.0)
+      activejob (= 5.2.0)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 2.0)
+    actionpack (5.2.0)
+      actionview (= 5.2.0)
+      activesupport (= 5.2.0)
+      rack (~> 2.0)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (5.2.0)
+      activesupport (= 5.2.0)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.3)
+    activejob (5.2.0)
+      activesupport (= 5.2.0)
+      globalid (>= 0.3.6)
+    activemodel (5.2.0)
+      activesupport (= 5.2.0)
+    activerecord (5.2.0)
+      activemodel (= 5.2.0)
+      activesupport (= 5.2.0)
+      arel (>= 9.0)
+    activestorage (5.2.0)
+      actionpack (= 5.2.0)
+      activerecord (= 5.2.0)
+      marcel (~> 0.3.1)
+    activesupport (5.2.0)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    addressable (2.5.2)
+      public_suffix (>= 2.0.2, < 4.0)
+    ansi (1.5.0)
+    arel (9.0.0)
+    ast (2.4.0)
+    builder (3.2.3)
+    byebug (10.0.2)
+    concurrent-ruby (1.0.5)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    crass (1.0.4)
+    diff-lcs (1.3)
+    docile (1.3.1)
+    dotenv (2.5.0)
+    erubi (1.7.1)
+    generator_spec (0.9.4)
+      activesupport (>= 3.0.0)
+      railties (>= 3.0.0)
+    globalid (0.4.1)
+      activesupport (>= 4.2.0)
+    hashdiff (0.3.7)
+    hirb (0.7.3)
+    i18n (1.0.1)
+      concurrent-ruby (~> 1.0)
+    jaro_winkler (1.5.1)
+    json (2.1.0)
+    loofah (2.2.2)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    mail (2.7.0)
+      mini_mime (>= 0.1.1)
+    marcel (0.3.2)
+      mimemagic (~> 0.3.2)
+    method_source (0.9.0)
+    mimemagic (0.3.2)
+    mini_mime (1.0.0)
+    mini_portile2 (2.3.0)
+    minitest (5.11.3)
+    nio4r (2.3.1)
+    nokogiri (1.8.4)
+      mini_portile2 (~> 2.3.0)
+    parallel (1.12.1)
+    parser (2.5.1.2)
+      ast (~> 2.4.0)
+    powerpack (0.1.2)
+    public_suffix (3.0.2)
+    rack (2.0.5)
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rails (5.2.0)
+      actioncable (= 5.2.0)
+      actionmailer (= 5.2.0)
+      actionpack (= 5.2.0)
+      actionview (= 5.2.0)
+      activejob (= 5.2.0)
+      activemodel (= 5.2.0)
+      activerecord (= 5.2.0)
+      activestorage (= 5.2.0)
+      activesupport (= 5.2.0)
+      bundler (>= 1.3.0)
+      railties (= 5.2.0)
+      sprockets-rails (>= 2.0.0)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.0.4)
+      loofah (~> 2.2, >= 2.2.2)
+    railties (5.2.0)
+      actionpack (= 5.2.0)
+      activesupport (= 5.2.0)
+      method_source
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rainbow (3.0.0)
+    rake (10.5.0)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.1)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.1)
+    rubocop (0.58.2)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      powerpack (~> 0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.0, >= 1.0.1)
+    ruby-progressbar (1.9.0)
+    safe_yaml (1.0.4)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-console (0.4.2)
+      ansi
+      hirb
+      simplecov
+    simplecov-html (0.10.2)
+    sprockets (3.7.2)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (3.2.1)
+      actionpack (>= 4.0)
+      activesupport (>= 4.0)
+      sprockets (>= 3.0.0)
+    thor (0.20.0)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+    unicode-display_width (1.4.0)
+    webmock (3.4.2)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff
+    websocket-driver (0.7.0)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  byebug
+  dotenv (~> 2.5)
+  generator_spec
+  itexmo!
+  rails (~> 5.2)
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  rubocop
+  simplecov
+  simplecov-console
+  webmock (~> 3.4)
+
+BUNDLED WITH
+   1.16.1

data/LICENSE-MIT.md

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Nujian Den Mark Meralpis
+
+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,88 @@
+[![Build Status](https://travis-ci.org/denmarkmeralpis/itexmo.svg?branch=master)](https://travis-ci.org/denmarkmeralpis/itexmo)  [![Maintainability](https://api.codeclimate.com/v1/badges/e31181fc348630563d8e/maintainability)](https://codeclimate.com/github/denmarkmeralpis/itexmo/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/e31181fc348630563d8e/test_coverage)](https://codeclimate.com/github/denmarkmeralpis/itexmo/test_coverage) [![Gem Version](https://badge.fury.io/rb/itexmo.svg)](https://badge.fury.io/rb/itexmo)
+
+# iTexMo Ruby Plugin
+A ruby plugin that uses the iTexMo REST API. You can send SMS using itextmo gem without hassle.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'itexmo'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install itexmo
+
+Finally, generate initializer
+    
+    $ rails g initializer:itexmo
+    
+this will create a file under `config/initializer/itexmo.rb` Note: `api_code` should be supplied inside the itextmo.rb.
+
+## Usage
+### I. Sending an SMS
+Two ways of sending SMS
+```ruby
+message = Itexmo::Message.new(message: 'Your awesome message!', to: '0917XXXXXXX')
+message.send
+```
+or simply:
+
+```ruby
+Itexmo::Message.send(message: 'Your awesome message!', to: '0917XXXXXXXX')
+```
+
+### II. Checking of Service
+```ruby
+#Check API Service Status and your SMS Server Status
+Itexmo::Service.status
+
+# Check `api_code` Info and Status
+Itexmo::Service.apicode_info
+```
+### III. SMS Reports/Actions
+```ruby
+# Show Pending or Outgoing SMS:
+Itexmo::Sms.display_outgoing('desc') # default order is 'asc'
+
+# Delete All Pending or Outgoing SMS:
+Itexmo::Sms.delete_all_outgoing
+
+# Return All SMS Received (Corporate Premium Apicodes)
+Itexmo::Sms.display_messages 
+
+# Return All SMS Received using Originator as Filter (Corporate Premium Apicodes)
+Itexmo::Sms.display_messages_via_originator('0917XXXXXXX')
+
+# Delete All SMS Received using Originator as Filter (Corporate Premium Apicodes)
+Itexmo::Sms.delete_message_via_originator('0917XXXXXXX')
+
+# Delete an SMS Received using SMS ID as filter (Corporate Premium Apicodes)
+Itexmo::Sms.delete_message_via_id('105')
+
+# Delete All SMS Received (Corporate Premium Apicodes)
+Itexmo::Sms.delete_messages_all
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/denmarkmeralpis/itexmo. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## Code of Conduct
+
+Everyone interacting in the Itexmo project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[denmarkmeralpis]/itexmo/blob/master/CODE_OF_CONDUCT.md).
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://github.com/denmarkmeralpis/itexmo/blob/master/LICENSE.txt).
+
+## Donate
+
+[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=nujiandenmarkmeralpis@gmail.com&lc=US&item_name=For+Living&no_note=0&cn=&curency_code=USD&bn=PP-DonationsBF:btn_donateCC_LG.gif:NonHosted)

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'itexmo'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/itexmo.gemspec

@@ -0,0 +1,38 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'itexmo/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'itexmo'
+  spec.version       = Itexmo::VERSION
+  spec.authors       = ['Nujian Den Mark Meralpis']
+  spec.email         = ['denmarkmeralpis@gmail.com']
+
+  spec.summary       = 'A ruby plugin for sending SMS using itexmo API.'
+  spec.description   = 'A very simple way of sending SMS through itexmo.com REST API'
+  spec.homepage      = 'https://github.com/denmarkmeralpis/itexmo'
+  spec.license          = 'MIT'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against ' \
+      'public gem pushes.'
+  end
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'dotenv', '~> 2.5'
+  spec.add_development_dependency 'rails', '~> 5.2'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'webmock', '~> 3.4'
+end

data/lib/generators/itexmo/install_generator.rb

@@ -0,0 +1,18 @@
+require 'rails/generators'
+
+# name
+module Itexmo
+  # Generator
+  module Generators
+    # Class generatpr
+    class InstallGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path('templates', __dir__)
+      desc 'Creates itexmo.rb initializer for your application'
+
+      def copy_initializer
+        template 'itexmo_initializer.rb', 'config/initializers/itexmo.rb'
+        puts 'Done install! Configure the file in config/initializers/itexmo.rb'
+      end
+    end
+  end
+end

data/lib/generators/itexmo/templates/itexmo_initializer.rb

@@ -0,0 +1,7 @@
+Itexmo.configure do |config|
+  # Get it from itexmo.com
+  config.api_key = ENV['ITEXMO_API_CODE']
+
+  # uncomment this line if you like to override default priority
+  # config.priority = 'NORMAL'
+end

data/lib/itexmo.rb

@@ -0,0 +1,30 @@
+require 'itexmo/version'
+require 'itexmo/response_helper'
+require 'itexmo/configuration'
+require 'itexmo/message'
+require 'itexmo/service'
+require 'itexmo/sms'
+require 'itexmo/errors/authentication'
+require 'itexmo/errors/configuration'
+require 'itexmo/errors/bad_request'
+require 'generators/itexmo/install_generator'
+
+# itexmo configuration block
+module Itexmo
+  # class
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.reset
+    @configuration = Configuration.new
+  end
+
+  def self.configure
+    yield(configuration)
+  end
+end

data/lib/itexmo/configuration.rb

@@ -0,0 +1,19 @@
+# itexmo module
+module Itexmo
+  # cofiguration class
+  class Configuration
+    attr_writer :api_code, :priority
+
+    def initialize
+      @api_code = nil
+      @priority = 'NORMAL'
+    end
+
+    def api_code
+      raise Errors::Configuration, 'Itexmo api_code is missing! See documentation for configuration settings.' unless @api_code
+      @api_code
+    end
+
+    attr_reader :priority
+  end
+end

data/lib/itexmo/errors/authentication.rb

@@ -0,0 +1,5 @@
+module Itexmo
+  module Errors
+    class Authentication < StandardError; end
+  end
+end

data/lib/itexmo/errors/bad_request.rb

@@ -0,0 +1,5 @@
+module Itexmo
+  module Errors
+    class BadRequest < StandardError; end
+  end
+end

data/lib/itexmo/errors/configuration.rb

@@ -0,0 +1,5 @@
+module Itexmo
+  module Errors
+    class Configuration < StandardError; end
+  end
+end

data/lib/itexmo/message.rb

@@ -0,0 +1,78 @@
+require 'net/http'
+require 'json'
+
+# module
+module Itexmo
+  # message class
+  class Message
+    attr_accessor :api_code, :message, :to
+
+    PARAMS = {}
+    API_ENDPOINT = 'https://www.itexmo.com/php_api'.freeze
+
+    def initialize(options = {})
+      @api_code = Itexmo.configuration.api_code
+      @message  = options[:message]
+      @priority = options[:priority]
+      @to       = options[:to]
+    end
+
+    # default is NORMAL
+    def priority
+      @priority ||= Itexmo.configuration.priority
+    end
+
+    def send
+      uri = URI(API_ENDPOINT + '/api.php')
+
+      request = Net::HTTP.post_form(uri, parameters)
+      response = request.body
+
+      case response
+      when '0'
+        { code: 200, message: 'Success! Message is now on queue and will be sent soon.' }
+      when '1'
+        raise Errors::BadRequest, 'Invalid value for parameter to'
+      when '2'
+        raise Errors::BadRequest, 'Number prefix not supported. Please contact itexmo'
+      when '3'
+        raise Errors::Authentication, 'Invalid api_code'
+      when '4'
+        { code: 400, message: 'Maximum Message per day reached. This will be reset every 12MN' }
+      when '5'
+        raise Errors::BadRequest, 'Maximum allowed characters for message reached'
+      when '6'
+        { code: 422, message: 'System OFFLINE' }
+      when '7'
+        raise Errors::Authentication, 'Expired ApiCode'
+      when '8'
+        { code: 500, message: 'iTexMo Error. Please try again later.' }
+      when '9'
+        raise Errors::BadRequest, 'Invalid Function Parameters'
+      when '10'
+        { code: 422, message: "Recipient's number is blocked due to FLOODING, message was ignored" }
+      when '11'
+        { code: 422, message: "Recipient's number is blocked temporarily due to HARD sending (after 3 retries of sending and message still failed to send) and the message was ignored. Try again after an hour. " }
+      when '12'
+        raise Errors::BadRequest, "Invalid request. You can't set message priorities on non corporate apicodes"
+      when '13'
+        raise Errors::BadRequest, 'Invalid or Not Registered Custom Sender ID.'
+      end
+    end
+
+    def self.send(options = {})
+      instance = new(options)
+      instance.send
+    end
+
+    private
+
+    def parameters
+      PARAMS['1'] = to
+      PARAMS['2'] = message
+      PARAMS['3'] = api_code
+      PARAMS['5'] = priority
+      PARAMS
+    end
+  end
+end

data/lib/itexmo/response_helper.rb

@@ -0,0 +1,37 @@
+require 'net/http'
+require 'json'
+# helper
+module Itexmo
+  # helper
+  class ResponseHelper
+    attr_accessor :body
+
+    def initialize(body)
+      @body = body
+    end
+
+    def parse
+      case body
+      when 'INVALID', 'INVALID_APICODE'
+        raise Errors::Authentication, 'invalid api_code'
+      when 'INVALID PARAMETERS'
+        raise Errors::BadRequest, 'invalid parameters'
+      when 'EMPTY'
+        []
+      when 'ERROR'
+        { code: 422, message: 'unable to do action' }
+      when 'SUCCESS'
+        { code: 200, message: 'action succeeded' }
+      when 'NOT_SUPPORTED'
+        raise Errors::Authentication, 'api_code is not a corporate one'
+      else
+        JSON.parse(body, symbolize_names: true)
+      end
+    end
+
+    def self.parse(body)
+      instance = new(body)
+      instance.parse
+    end
+  end
+end

data/lib/itexmo/service.rb

@@ -0,0 +1,45 @@
+require 'net/http'
+require 'json'
+# module
+module Itexmo
+  # service
+  class Service
+    attr_accessor :api_code
+
+    API_ENDPOINT = 'https://www.itexmo.com/php_api'.freeze
+
+    def initialize
+      @api_code = Itexmo.configuration.api_code
+    end
+
+    def status
+      uri = URI(API_ENDPOINT + '/serverstatus.php')
+      uri.query = URI.encode_www_form(parameters)
+      request = Net::HTTP.get_response(uri)
+      ResponseHelper.parse(request.body)
+    end
+
+    def self.status
+      instance = new
+      instance.status
+    end
+
+    def apicode_info
+      uri = URI(API_ENDPOINT + '/apicode_info.php')
+      uri.query = URI.encode_www_form(parameters)
+      request = Net::HTTP.get_response(uri)
+      ResponseHelper.parse(request.body)
+    end
+
+    def self.apicode_info
+      instance = new
+      instance.apicode_info
+    end
+
+    private
+
+    def parameters
+      { 'apicode' => api_code }
+    end
+  end
+end

data/lib/itexmo/sms.rb

@@ -0,0 +1,109 @@
+require 'net/http'
+require 'json'
+# module
+module Itexmo
+  # sms
+  class Sms
+    attr_accessor :api_code
+
+    API_ENDPOINT = 'https://www.itexmo.com/php_api'.freeze
+    PARAMETERS = {}
+
+    def initialize
+      @api_code = Itexmo.configuration.api_code
+      PARAMETERS['apicode'] = api_code
+    end
+
+    def display_outgoing(sortby = 'asc')
+      PARAMETERS[:sortby] = sortby
+      uri                  = URI(API_ENDPOINT + '/display_outgoing.php')
+      uri.query            = URI.encode_www_form(PARAMETERS)
+      request              = Net::HTTP.get_response(uri)
+      PARAMETERS.except!(:sortby)
+      ResponseHelper.parse(request.body)
+    end
+
+    def self.display_outgoing(sortby = 'asc')
+      instance = new
+      instance.display_outgoing(sortby)
+    end
+
+    def delete_all_outgoing
+      uri = URI(API_ENDPOINT + '/delete_outgoing_all.php')
+      uri.query = URI.encode_www_form(PARAMETERS)
+      request   = Net::HTTP.get_response(uri)
+      ResponseHelper.parse(request.body)
+    end
+
+    def self.delete_all_outgoing
+      instance = new
+      instance.delete_all_outgoing
+    end
+
+    def display_messages
+      uri = URI(API_ENDPOINT + '/display_messages.php')
+      uri.query = URI.encode_www_form(PARAMETERS)
+      request   = Net::HTTP.get_response(uri)
+      ResponseHelper.parse(request.body)
+    end
+
+    def self.display_messages
+      instance = new
+      instance.display_messages
+    end
+
+    def display_messages_via_originator(originator)
+      PARAMETERS[:originator] = originator
+      uri       = URI(API_ENDPOINT + '/display_messages_via_originator.php')
+      uri.query = URI.encode_www_form(PARAMETERS)
+      request   = Net::HTTP.get_response(uri)
+      PARAMETERS.except!(:originator)
+      ResponseHelper.parse(request.body)
+    end
+
+    def self.display_messages_via_originator(originator)
+      instance = new
+      instance.display_messages_via_originator(originator)
+    end
+
+    def delete_message_via_originator(originator)
+      PARAMETERS[:originator] = originator
+      uri       = URI(API_ENDPOINT + '/delete_message_via_originator.php')
+      uri.query = URI.encode_www_form(PARAMETERS)
+      request   = Net::HTTP.get_response(uri)
+      PARAMETERS.except!(:originator)
+      ResponseHelper.parse(request.body)
+    end
+
+    def self.delete_message_via_originator(originator)
+      instance = new
+      instance.delete_message_via_originator(originator)
+    end
+
+    def delete_message_via_id(id)
+      PARAMETERS[:id] = id
+      uri       = URI(API_ENDPOINT + '/delete_message_via_id.php')
+      uri.query = URI.encode_www_form(PARAMETERS)
+      request   = Net::HTTP.get_response(uri)
+      PARAMETERS.except!(:id)
+      ResponseHelper.parse(request.body)
+    end
+
+    def self.delete_message_via_id(originator)
+      instance = new
+      instance.delete_message_via_id(originator)
+    end
+
+    def delete_messages_all
+      uri = URI(API_ENDPOINT + '/delete_messages_all.php')
+      uri.query = URI.encode_www_form(PARAMETERS)
+      request   = Net::HTTP.get_response(uri)
+      ResponseHelper.parse(request.body)
+    end
+
+    def self.delete_messages_all
+      instance = new
+      instance.delete_messages_all
+    end
+  end
+end

data/lib/itexmo/version.rb

@@ -0,0 +1,3 @@
+module Itexmo
+  VERSION = '0.0.1'.freeze
+end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: itexmo
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Nujian Den Mark Meralpis
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-07-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+description: A very simple way of sending SMS through itexmo.com REST API
+email:
+- denmarkmeralpis@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".env.sample"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE-MIT.md
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- itexmo.gemspec
+- lib/generators/itexmo/install_generator.rb
+- lib/generators/itexmo/templates/itexmo_initializer.rb
+- lib/itexmo.rb
+- lib/itexmo/configuration.rb
+- lib/itexmo/errors/authentication.rb
+- lib/itexmo/errors/bad_request.rb
+- lib/itexmo/errors/configuration.rb
+- lib/itexmo/message.rb
+- lib/itexmo/response_helper.rb
+- lib/itexmo/service.rb
+- lib/itexmo/sms.rb
+- lib/itexmo/version.rb
+homepage: https://github.com/denmarkmeralpis/itexmo
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: A ruby plugin for sending SMS using itexmo API.
+test_files: []