yury / gsm_encoder

ruby GSM 03.38 encoder/decoder

GSMEncoder encodes and decodes Ruby Strings to and from the SMS default alphabet. It also supports the default extension table. The default alphabet and it's extension table is defined in GSM 03.38

This is port of Twitter's Java implementation

Installation

NOTE: ruby >= 1.9.2 is required

gem install gsm_encoder

Usage

require 'gsm_encoder'

# encoding
GSMEncoder.encode 'hello @ world' # => binary string

# decoding
GSMEncoder.decode(GSMEncoder.encode('hi')) # => 'hi'

# can encode?
GSMEncoder.can_encode?('`') # => false

# replaces unsupported chars with '?'
GSMEncoder.encode('`') # => '?'

# replaces unsupported chars with a provided value ' '
GSMEncoder.encode('`', ' ') # => ' '

Updates

0.1.1

Added support for Spanish shift

0.1.2

Fixed bug when encoding line feed & carriage return

0.1.3

Adds the ability to provide the character used when encoding unsupported strings

0.1.4

Code cleanup and speedup

0.1.5

Even faster. About 4 times. Many thanks to @dlarrabee

gsm_encoder's Issues

Old version in gem repository

Hi,

I just tried your gem and like it very much, but I spoted one problem.

When I installed it by
gem install gsm_encoder
Version I got is one without last commit - can_encode?

[Question] Why certain characters are escaped?

Hi!

If I do GSMEncoder.encode('$') it retrieves "\x02". Why is that? '$' is included in GSM 03.38.

Thanks,

Maicol

ö ä ü not possible

Hello,

I've started using your library which worked fine until I've tried to send ä, ü or ö. These chars are very often used in the german language. They are always getting replaced with some different special chars.

Output:

latest :001 > GSMEncoder.encode("ä")
 => "{" 
latest :002 > GSMEncoder.encode("ü")
 => "~" 
latest :003 > GSMEncoder.encode("ö")
 => "|" 

I've fought it's only a displaying issue in the Ruby console but it isn't. Tested this with 2 different SMS gateway provider, they are always arriving wrongly.

Is there something that I need todo before I can send these chars? I'm 100% sure that these chars are available in the GSM charset. I can send them manually on my phone without any issues to other phones.

Regards
Alexander