smstools 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4180ff46eb40f9d709cf9895d1dc493aeec4203c
+  data.tar.gz: cba4fd705516f2418dfae93ce3732231e30faba5
+SHA512:
+  metadata.gz: b3b26b73c00f2acbb9e107ecc24738b97a713a3579c685339226b9ba369c0d2080ff7b40357a472c0dc9ebe41bca0f8ed38e28cd132242ce7ed3e514a78d69c3
+  data.tar.gz: 9b7a0e6a64fdaec4f8f05130dc3b4ac735f2848fddfd1bbd8d274ec2b6e9781fcdb993ef121357e77f6b4c486508a067e6480516a72fd33d7c28007397f0fde5

data/.gitignore

@@ -0,0 +1,17 @@
+*.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/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.1.1 (17 January 2014)
+
+* Initial release.

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in smstools.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Dimitar Dimitrov
+
+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,71 @@
+# Sms Tools
+
+A small collection of useful Ruby and JavaScript classes implementing often
+needed functionality for dealing with SMS messages.
+
+The gem is also a Rails engine and using it in your Rails app will allow you
+to also use the JavaScript classes via the asset pipeline.
+
+## Features
+
+The following features are available on both the server side and the client
+side:
+
+- Detection of the most optimal encoding for sending an SMS message (GSM 7-bit
+  or Unicode).
+- Correctly determining the message's length according to the most optimal
+  encoding.
+- Concatenation detection and concatenated message parts counting.
+
+And more.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'smstools'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install smstools
+
+## Usage
+
+The gem consists of both server-side (Ruby) and client-side classes. You can
+use either one.
+
+### Server-side code
+
+If you use the gem in Rails or via Bundler, just use the appropriate class,
+such as `SmsTools::EncodingDetection` or `SmsTools::GsmEncoding`.
+
+#### `EncodingDetection`
+#### `GsmEncoding`
+
+### Client-side code
+
+If you're using the gem in Rails 3.x or newer, you can just add the following
+to your `application.js` file to gain access to the JavaScript classes:
+
+    #= require 'sms_tools/all'
+
+Or require only the files you need:
+
+    #= require 'sms_tools/message'
+
+Note that this assumes you're using the asset pipeline. You need to have a
+CoffeeScript preprocessor set up.
+
+## Contributing
+
+1. [Fork the repo](http://github.com/mitio/smstools/fork)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Make your changes and provide tests for them
+4. Make sure all tests pass (run them with `bundle exec rake test`)
+5. Commit your changes (`git commit -am 'Add some feature'`)
+6. Push to the branch (`git push origin my-new-feature`)
+7. Send a pull request.

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler/gem_tasks'
+
+task :test do
+  test_files = Dir[File.expand_path('../spec/**/*_spec.rb', __FILE__)]
+  command    = "ruby -Ispec #{test_files.join ' '}"
+
+  puts "Running #{command}"
+  system command
+end
+
+task default: :test

data/lib/assets/javascripts/sms_tools/index.js.coffee

@@ -0,0 +1 @@
+#= require_tree .

data/lib/assets/javascripts/sms_tools/message.js.coffee

@@ -0,0 +1,58 @@
+window.SmsTools ?= {}
+
+class SmsTools.Message
+  maxLengthForEncoding:
+    gsm:
+      normal: 160
+      concatenated: 153
+    unicode:
+      normal: 70
+      concatenated: 67
+
+  doubleByteCharsInGsmEncoding:
+    '^':  true
+    '{':  true
+    '}':  true
+    '[':  true
+    '~':  true
+    ']':  true
+    '|':  true
+    '€':  true
+    '\\': true
+
+  gsmEncodingPattern: /^[0-9a-zA-Z@Δ¡¿£_!Φ"¥Γ#èΛ¤éΩ%ùΠ&ìΨòΣçΘΞ:Ø;ÄäøÆ,<Ööæ=ÑñÅß>Üüåɧà€~ \$\.\-\+\(\)\*\\\/\?\|\^\}\{\[\]\'\r\n]*$/
+
+  constructor: (@text) ->
+    @text                   = @text.replace /\r\n?/g, "\n"
+    @encoding               = @_encoding()
+    @length                 = @_length()
+    @concatenatedPartsCount = @_concatenatedPartsCount()
+
+  maxLengthFor: (concatenatedPartsCount) ->
+    messageType = if concatenatedPartsCount > 1 then 'concatenated' else 'normal'
+
+    concatenatedPartsCount * @maxLengthForEncoding[@encoding][messageType]
+
+  _encoding: ->
+    if @gsmEncodingPattern.test(@text) then 'gsm' else 'unicode'
+
+  _concatenatedPartsCount: ->
+    encoding = @encoding
+    length   = @length
+
+    if length <= @maxLengthForEncoding[encoding].normal
+      1
+    else
+      parseInt Math.ceil(length / @maxLengthForEncoding[encoding].concatenated), 10
+
+   # Returns the number of symbols, which the given text will take up in an SMS
+   # message, taking into account any double-space symbols in the GSM 03.38
+   # encoding.
+  _length: ->
+    length = @text.length
+
+    if @encoding == 'gsm'
+      for char in @text
+        length += 1 if @doubleByteCharsInGsmEncoding[char]
+
+    length

data/lib/sms_tools.rb

@@ -0,0 +1,7 @@
+require 'sms_tools/version'
+require 'sms_tools/encoding_detection'
+require 'sms_tools/gsm_encoding'
+
+if defined?(::Rails) and ::Rails.version >= '3.1'
+  require 'sms_tools/rails/engine'
+end

data/lib/sms_tools/encoding_detection.rb

@@ -0,0 +1,62 @@
+require 'sms_tools/gsm_encoding'
+
+module SmsTools
+  class EncodingDetection
+    MAX_LENGTH_FOR_ENCODING = {
+      gsm: {
+        normal:       160,
+        concatenated: 153,
+      },
+      unicode: {
+        normal:       70,
+        concatenated: 67,
+      },
+    }.freeze
+
+    attr :text
+
+    def initialize(text)
+      @text = text
+    end
+
+    def encoding
+      @encoding ||= GsmEncoding.valid?(text) ? :gsm : :unicode
+    end
+
+    def gsm?
+      encoding == :gsm
+    end
+
+    def unicode?
+      encoding == :unicode
+    end
+
+    def concatenated?
+      concatenated_parts > 1
+    end
+
+    def concatenated_parts
+      if length <= MAX_LENGTH_FOR_ENCODING[encoding][:normal]
+        1
+      else
+        (length.to_f / MAX_LENGTH_FOR_ENCODING[encoding][:concatenated]).ceil
+      end
+    end
+
+    def maximum_length_for(concatenated_parts)
+      message_type = concatenated_parts > 1 ? :concatenated : :normal
+
+      concatenated_parts * MAX_LENGTH_FOR_ENCODING[encoding][message_type]
+    end
+
+     # Returns the number of symbols, which the given text will take up in an SMS
+     # message, taking into account any double-space symbols in the GSM 03.38
+     # encoding.
+    def length
+      length = text.length
+      length += text.chars.count { |char| GsmEncoding.double_byte?(char) } if gsm?
+
+      length
+    end
+  end
+end

data/lib/sms_tools/gsm_encoding.rb

@@ -0,0 +1,195 @@
+module SmsTools
+  # UTF-8 to GSM-7 (GSM 03.38) mapping. Based on code from:
+  # https://github.com/threez/smspromote/blob/master/lib/smspromote/encoding.rb
+  module GsmEncoding
+    extend self
+
+    UTF8_TO_GSM_BASE_TABLE = {
+      0x0040 => "\x00", # COMMERCIAL AT
+      0x00A3 => "\x01", # POUND SIGN
+      0x0024 => "\x02", # DOLLAR SIGN
+      0x00A5 => "\x03", # YEN SIGN
+      0x00E8 => "\x04", # LATIN SMALL LETTER E WITH GRAVE
+      0x00E9 => "\x05", # LATIN SMALL LETTER E WITH ACUTE
+      0x00F9 => "\x06", # LATIN SMALL LETTER U WITH GRAVE
+      0x00EC => "\x07", # LATIN SMALL LETTER I WITH GRAVE
+      0x00F2 => "\x08", # LATIN SMALL LETTER O WITH GRAVE
+      0x00E7 => "\x09", # LATIN SMALL LETTER C WITH CEDILLA
+      0x000A => "\x0A", # LINE FEED
+      0x00D8 => "\x0B", # LATIN CAPITAL LETTER O WITH STROKE
+      0x00F8 => "\x0C", # LATIN SMALL LETTER O WITH STROKE
+      0x000D => "\x0D", # CARRIAGE RETURN
+      0x00C5 => "\x0E", # LATIN CAPITAL LETTER A WITH RING ABOVE
+      0x00E5 => "\x0F", # LATIN SMALL LETTER A WITH RING ABOVE
+      0x0394 => "\x10", # GREEK CAPITAL LETTER DELTA
+      0x005F => "\x11", # LOW LINE
+      0x03A6 => "\x12", # GREEK CAPITAL LETTER PHI
+      0x0393 => "\x13", # GREEK CAPITAL LETTER GAMMA
+      0x039B => "\x14", # GREEK CAPITAL LETTER LAMDA
+      0x03A9 => "\x15", # GREEK CAPITAL LETTER OMEGA
+      0x03A0 => "\x16", # GREEK CAPITAL LETTER PI
+      0x03A8 => "\x17", # GREEK CAPITAL LETTER PSI
+      0x03A3 => "\x18", # GREEK CAPITAL LETTER SIGMA
+      0x0398 => "\x19", # GREEK CAPITAL LETTER THETA
+      0x039E => "\x1A", # GREEK CAPITAL LETTER XI
+      0x00A0 => "\x1B", # ESCAPE TO EXTENSION TABLE
+      0x00C6 => "\x1C", # LATIN CAPITAL LETTER AE
+      0x00E6 => "\x1D", # LATIN SMALL LETTER AE
+      0x00DF => "\x1E", # LATIN SMALL LETTER SHARP S (German)
+      0x00C9 => "\x1F", # LATIN CAPITAL LETTER E WITH ACUTE
+      0x0020 => "\x20", # SPACE
+      0x0021 => "\x21", # EXCLAMATION MARK
+      0x0022 => "\x22", # QUOTATION MARK
+      0x0023 => "\x23", # NUMBER SIGN
+      0x00A4 => "\x24", # CURRENCY SIGN
+      0x0025 => "\x25", # PERCENT SIGN
+      0x0026 => "\x26", # AMPERSAND
+      0x0027 => "\x27", # APOSTROPHE
+      0x0028 => "\x28", # LEFT PARENTHESIS
+      0x0029 => "\x29", # RIGHT PARENTHESIS
+      0x002A => "\x2A", # ASTERISK
+      0x002B => "\x2B", # PLUS SIGN
+      0x002C => "\x2C", # COMMA
+      0x002D => "\x2D", # HYPHEN-MINUS
+      0x002E => "\x2E", # FULL STOP
+      0x002F => "\x2F", # SOLIDUS
+      0x0030 => "\x30", # DIGIT ZERO
+      0x0031 => "\x31", # DIGIT ONE
+      0x0032 => "\x32", # DIGIT TWO
+      0x0033 => "\x33", # DIGIT THREE
+      0x0034 => "\x34", # DIGIT FOUR
+      0x0035 => "\x35", # DIGIT FIVE
+      0x0036 => "\x36", # DIGIT SIX
+      0x0037 => "\x37", # DIGIT SEVEN
+      0x0038 => "\x38", # DIGIT EIGHT
+      0x0039 => "\x39", # DIGIT NINE
+      0x003A => "\x3A", # COLON
+      0x003B => "\x3B", # SEMICOLON
+      0x003C => "\x3C", # LESS-THAN SIGN
+      0x003D => "\x3D", # EQUALS SIGN
+      0x003E => "\x3E", # GREATER-THAN SIGN
+      0x003F => "\x3F", # QUESTION MARK
+      0x00A1 => "\x40", # INVERTED EXCLAMATION MARK
+      0x0041 => "\x41", # LATIN CAPITAL LETTER A
+      0x0042 => "\x42", # LATIN CAPITAL LETTER B
+      0x0043 => "\x43", # LATIN CAPITAL LETTER C
+      0x0044 => "\x44", # LATIN CAPITAL LETTER D
+      0x0045 => "\x45", # LATIN CAPITAL LETTER E
+      0x0046 => "\x46", # LATIN CAPITAL LETTER F
+      0x0047 => "\x47", # LATIN CAPITAL LETTER G
+      0x0048 => "\x48", # LATIN CAPITAL LETTER H
+      0x0049 => "\x49", # LATIN CAPITAL LETTER I
+      0x004A => "\x4A", # LATIN CAPITAL LETTER J
+      0x004B => "\x4B", # LATIN CAPITAL LETTER K
+      0x004C => "\x4C", # LATIN CAPITAL LETTER L
+      0x004D => "\x4D", # LATIN CAPITAL LETTER M
+      0x004E => "\x4E", # LATIN CAPITAL LETTER N
+      0x004F => "\x4F", # LATIN CAPITAL LETTER O
+      0x0050 => "\x50", # LATIN CAPITAL LETTER P
+      0x0051 => "\x51", # LATIN CAPITAL LETTER Q
+      0x0052 => "\x52", # LATIN CAPITAL LETTER R
+      0x0053 => "\x53", # LATIN CAPITAL LETTER S
+      0x0054 => "\x54", # LATIN CAPITAL LETTER T
+      0x0055 => "\x55", # LATIN CAPITAL LETTER U
+      0x0056 => "\x56", # LATIN CAPITAL LETTER V
+      0x0057 => "\x57", # LATIN CAPITAL LETTER W
+      0x0058 => "\x58", # LATIN CAPITAL LETTER X
+      0x0059 => "\x59", # LATIN CAPITAL LETTER Y
+      0x005A => "\x5A", # LATIN CAPITAL LETTER Z
+      0x00C4 => "\x5B", # LATIN CAPITAL LETTER A WITH DIAERESIS
+      0x00D6 => "\x5C", # LATIN CAPITAL LETTER O WITH DIAERESIS
+      0x00D1 => "\x5D", # LATIN CAPITAL LETTER N WITH TILDE
+      0x00DC => "\x5E", # LATIN CAPITAL LETTER U WITH DIAERESIS
+      0x00A7 => "\x5F", # SECTION SIGN
+      0x00BF => "\x60", # INVERTED QUESTION MARK
+      0x0061 => "\x61", # LATIN SMALL LETTER A
+      0x0062 => "\x62", # LATIN SMALL LETTER B
+      0x0063 => "\x63", # LATIN SMALL LETTER C
+      0x0064 => "\x64", # LATIN SMALL LETTER D
+      0x0065 => "\x65", # LATIN SMALL LETTER E
+      0x0066 => "\x66", # LATIN SMALL LETTER F
+      0x0067 => "\x67", # LATIN SMALL LETTER G
+      0x0068 => "\x68", # LATIN SMALL LETTER H
+      0x0069 => "\x69", # LATIN SMALL LETTER I
+      0x006A => "\x6A", # LATIN SMALL LETTER J
+      0x006B => "\x6B", # LATIN SMALL LETTER K
+      0x006C => "\x6C", # LATIN SMALL LETTER L
+      0x006D => "\x6D", # LATIN SMALL LETTER M
+      0x006E => "\x6E", # LATIN SMALL LETTER N
+      0x006F => "\x6F", # LATIN SMALL LETTER O
+      0x0070 => "\x70", # LATIN SMALL LETTER P
+      0x0071 => "\x71", # LATIN SMALL LETTER Q
+      0x0072 => "\x72", # LATIN SMALL LETTER R
+      0x0073 => "\x73", # LATIN SMALL LETTER S
+      0x0074 => "\x74", # LATIN SMALL LETTER T
+      0x0075 => "\x75", # LATIN SMALL LETTER U
+      0x0076 => "\x76", # LATIN SMALL LETTER V
+      0x0077 => "\x77", # LATIN SMALL LETTER W
+      0x0078 => "\x78", # LATIN SMALL LETTER X
+      0x0079 => "\x79", # LATIN SMALL LETTER Y
+      0x007A => "\x7A", # LATIN SMALL LETTER Z
+      0x00E4 => "\x7B", # LATIN SMALL LETTER A WITH DIAERESIS
+      0x00F6 => "\x7C", # LATIN SMALL LETTER O WITH DIAERESIS
+      0x00F1 => "\x7D", # LATIN SMALL LETTER N WITH TILDE
+      0x00FC => "\x7E", # LATIN SMALL LETTER U WITH DIAERESIS
+      0x00E0 => "\x7F", # LATIN SMALL LETTER A WITH GRAVE
+    }.freeze
+
+    UTF8_TO_GSM_EXTENSION_TABLE = {
+      0x000C => "\x1B\x0A", # FORM FEED
+      0x005E => "\x1B\x14", # CIRCUMFLEX ACCENT
+      0x007B => "\x1B\x28", # LEFT CURLY BRACKET
+      0x007D => "\x1B\x29", # RIGHT CURLY BRACKET
+      0x005C => "\x1B\x2F", # REVERSE SOLIDUS
+      0x005B => "\x1B\x3C", # LEFT SQUARE BRACKET
+      0x007E => "\x1B\x3D", # TILDE
+      0x005D => "\x1B\x3E", # RIGHT SQUARE BRACKET
+      0x007C => "\x1B\x40", # VERTICAL LINE
+      0x20AC => "\x1B\x65"  # EURO SIGN
+    }.freeze
+
+    UTF8_TO_GSM = UTF8_TO_GSM_BASE_TABLE.merge(UTF8_TO_GSM_EXTENSION_TABLE).freeze
+    GSM_TO_UTF8 = UTF8_TO_GSM.invert.freeze
+
+    def valid?(utf8_encoded_string)
+      utf8_encoded_string.unpack('U*').all? { |char| UTF8_TO_GSM[char] }
+    end
+
+    def double_byte?(char)
+      UTF8_TO_GSM_EXTENSION_TABLE[char.unpack('U').first]
+    end
+
+    def from_utf8(utf8_encoded_string)
+      gsm_encoded_string = ''
+
+      utf8_encoded_string.unpack('U*').each do |char|
+        if converted = UTF8_TO_GSM[char]
+          gsm_encoded_string << converted
+        else
+          raise "Unsupported symbol in GSM-7 encoding: 0x#{char.to_s(16).upcase}"
+        end
+      end
+
+      gsm_encoded_string
+    end
+
+    def to_utf8(gsm_encoded_string)
+      utf8_encoded_string = ''
+      escape              = false
+      escape_code         = "\e".freeze
+
+      gsm_encoded_string.each_char do |char|
+        if char == escape_code
+          escape = true
+        elsif escape
+          escape = false
+          utf8_encoded_string << [GSM_TO_UTF8[escape_code + char]].pack('U')
+        else
+          utf8_encoded_string << [GSM_TO_UTF8[char]].pack('U')
+        end
+      end
+
+      utf8_encoded_string
+    end
+  end
+end

data/lib/sms_tools/rails/engine.rb

@@ -0,0 +1,6 @@
+module SmsTools
+  module Rails
+    class Engine < ::Rails::Engine
+    end
+  end
+end

data/lib/sms_tools/version.rb

@@ -0,0 +1,3 @@
+module SmsTools
+  VERSION = '0.0.1'
+end

data/lib/smstools.rb

@@ -0,0 +1 @@
+require 'sms_tools'

data/smstools.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'sms_tools/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'smstools'
+  spec.version       = SmsTools::VERSION
+  spec.authors       = ['Dimitar Dimitrov']
+  spec.email         = ['me@ddimitrov.name']
+  spec.summary       = 'Small library of classes for common SMS-related functionality.'
+  spec.description   = 'Features SMS text encoding detection, length counting, concatenation detection and more. Can be used with or without Rails. Requires Ruby 1.9 or newer.'
+  spec.homepage      = 'https://github.com/mitio/smstools'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.5'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'minitest'
+  spec.add_development_dependency 'minitest-ansi'
+end

data/spec/sms_tools/encoding_detection_spec.rb

@@ -0,0 +1,153 @@
+require 'spec_helper'
+require 'sms_tools/encoding_detection'
+
+describe SmsTools::EncodingDetection do
+  it "exposes the original text as a method" do
+    detection_for('foo').text.must_equal 'foo'
+  end
+
+  describe "encoding" do
+    it "defaults to GSM encoding for empty messages" do
+      detection_for('').encoding.must_equal :gsm
+    end
+
+    it "returns GSM as encoding for simple ASCII text" do
+      detection_for('foo bar baz').encoding.must_equal :gsm
+    end
+
+    it "returns GSM as encoding for special symbols defined in GSM 03.38" do
+      detection_for('09azAZ@Δ¡¿£_!Φ"¥Γ#èΛ¤éΩ%ùΠ&ìΨòΣçΘΞ:Ø;ÄäøÆ,<Ööæ=ÑñÅß>Üüåɧà€~').encoding.must_equal :gsm
+    end
+
+    it "returns GSM as encoding for puntucation and newline symbols" do
+      detection_for('Foo bar {} [baz]! Larodi $5. What else?').encoding.must_equal :gsm
+      detection_for("Spaces and newlines are GSM 03.38, too: \r\n").encoding.must_equal :gsm
+    end
+
+    it "returns Unicode when non-GSM Unicode symbols are used" do
+      detection_for('Foo bar лароди').encoding.must_equal :unicode
+      detection_for('∞').encoding.must_equal :unicode
+    end
+  end
+
+  describe "message length" do
+    it "computes the length of trivial ANSI-only messages correctly" do
+      detection_for('').length.must_equal 0
+      detection_for('larodi').length.must_equal 6
+      detection_for('a' * 180).length.must_equal 180
+    end
+
+    it "computes the length of non-trivial GSM encoded messages correctly" do
+      detection_for('GSM: 09azAZ@Δ¡¿£_!Φ"¥Γ#èΛ¤éΩ%ùΠ&ìΨòΣçΘΞ:Ø;ÄäøÆ,<Ööæ=ÑñÅß>Üüåɧà').length.must_equal 63
+    end
+
+    it "correctly counts the length of whitespace-only messages" do
+      detection_for('     ').length.must_equal 5
+      detection_for("\r\n  ").length.must_equal 4
+    end
+
+    it "correctly counts the length of whitespace chars in GSM-encoded messages" do
+      detection_for('ΞØ     ').length.must_equal 7
+      detection_for("ΞØ\r\n  ").length.must_equal 6
+    end
+
+    it "counts double-space chars for GSM encoding" do
+      detection_for('^{}[~]|€\\').length.must_equal 18
+      detection_for('Σ: €').length.must_equal 5
+    end
+
+    it "computes the length of Unicode messages correctly" do
+      detection_for('кирилица').length.must_equal 8
+      detection_for('Я!').length.must_equal 2
+      detection_for("Уникод: ΞØ\r\n  ").length.must_equal 14
+      detection_for('Ю' * 200).length.must_equal 200
+    end
+
+    it "doesn't count double-space chars for Unicode encoding" do
+      detection_for('Уникод: ^{}[~]|€\\').length.must_equal 17
+      detection_for('Уникод: Σ: €').length.must_equal 12
+    end
+  end
+
+  describe "concatenated message parts counting" do
+    def concatenated_parts_for(length: nil, encoding: nil, must_be: nil)
+      SmsTools::EncodingDetection.new('').stub :length, length do |detection|
+        detection.stub :encoding, encoding do |detection|
+          detection.concatenated_parts.must_equal must_be
+        end
+      end
+    end
+
+    it "counts parts for GSM-encoded messages" do
+      concatenated_parts_for length: 0,   encoding: :gsm, must_be: 1
+      concatenated_parts_for length: 160, encoding: :gsm, must_be: 1
+      concatenated_parts_for length: 161, encoding: :gsm, must_be: 2
+      concatenated_parts_for length: 306, encoding: :gsm, must_be: 2
+      concatenated_parts_for length: 307, encoding: :gsm, must_be: 3
+      concatenated_parts_for length: 459, encoding: :gsm, must_be: 3
+      concatenated_parts_for length: 500, encoding: :gsm, must_be: 4
+    end
+
+    it "counts parts for Unicode messages" do
+      concatenated_parts_for length: 0,   encoding: :unicode, must_be: 1
+      concatenated_parts_for length: 70,  encoding: :unicode, must_be: 1
+      concatenated_parts_for length: 71,  encoding: :unicode, must_be: 2
+      concatenated_parts_for length: 134, encoding: :unicode, must_be: 2
+      concatenated_parts_for length: 135, encoding: :unicode, must_be: 3
+    end
+
+    it "counts parts for actual GSM-encoded and Unicode messages" do
+      detection_for('').concatenated_parts.must_equal 1
+      detection_for('Я').concatenated_parts.must_equal 1
+      detection_for('Σ' * 160).concatenated_parts.must_equal 1
+      detection_for('Σ' * 159 + '~').concatenated_parts.must_equal 2
+      detection_for('Я' * 133 + '~').concatenated_parts.must_equal 2
+    end
+  end
+
+  describe "maximum length for particular number of concatenated messages" do
+    it "works for GSM-encoded messages" do
+      detection_for('x').maximum_length_for(1).must_equal 160
+      detection_for('x').maximum_length_for(2).must_equal 306
+      detection_for('x').maximum_length_for(3).must_equal 459
+    end
+
+    it "works for Unicode messages" do
+      detection_for('ю').maximum_length_for(1).must_equal 70
+      detection_for('ю').maximum_length_for(2).must_equal 134
+      detection_for('ю').maximum_length_for(3).must_equal 201
+    end
+  end
+
+  describe "predicates" do
+    it "returns true for gsm? and false for unicode? if the encoding is GSM" do
+      detection_for('').stub :encoding, :gsm do |detection|
+        detection.must_be :gsm?
+        detection.wont_be :unicode?
+      end
+    end
+
+    it "returns false for gsm? and true for unicode? if the encoding is Unicode" do
+      detection_for('').stub :encoding, :unicode do |detection|
+        detection.wont_be :gsm?
+        detection.must_be :unicode?
+      end
+    end
+
+    it "returns true for concatenated? if concatenated_parts > 1" do
+      detection_for('').stub :concatenated_parts, 7 do |detection|
+        detection.must_be :concatenated?
+      end
+    end
+
+    it "returns false for concatenated? if concatenated_parts is 1" do
+      detection_for('').stub :concatenated_parts, 1 do |detection|
+        detection.wont_be :concatenated?
+      end
+    end
+  end
+
+  def detection_for(text)
+    SmsTools::EncodingDetection.new text
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+lib = File.expand_path('../../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'minitest/spec'
+require 'minitest/ansi'
+require 'minitest/autorun'
+
+MiniTest::ANSI.use!

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification
+name: smstools
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Dimitar Dimitrov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-ansi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Features SMS text encoding detection, length counting, concatenation
+  detection and more. Can be used with or without Rails. Requires Ruby 1.9 or newer.
+email:
+- me@ddimitrov.name
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/assets/javascripts/sms_tools/index.js.coffee
+- lib/assets/javascripts/sms_tools/message.js.coffee
+- lib/sms_tools.rb
+- lib/sms_tools/encoding_detection.rb
+- lib/sms_tools/gsm_encoding.rb
+- lib/sms_tools/rails/engine.rb
+- lib/sms_tools/version.rb
+- lib/smstools.rb
+- smstools.gemspec
+- spec/sms_tools/encoding_detection_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/mitio/smstools
+licenses:
+- MIT
+metadata: {}
+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.2.0
+signing_key: 
+specification_version: 4
+summary: Small library of classes for common SMS-related functionality.
+test_files:
+- spec/sms_tools/encoding_detection_spec.rb
+- spec/spec_helper.rb