https://github.com/manfred/unichars

A library that wraps Glib2 Unicode manipulation methods to speed up ActiveSupport::Multibyte
https://github.com/manfred/unichars

Last synced: 9 months ago
JSON representation

A library that wraps Glib2 Unicode manipulation methods to speed up ActiveSupport::Multibyte

• Host: GitHub
• URL: https://github.com/manfred/unichars
• Owner: Manfred
• License: mit
• Created: 2008-06-13T15:58:06.000Z (about 18 years ago)
• Default Branch: master
• Last Pushed: 2014-09-24T13:30:38.000Z (almost 12 years ago)
• Last Synced: 2025-07-09T10:04:53.361Z (12 months ago)
• Language: Ruby
• Homepage:
• Size: 345 KB
• Stars: 13
• Watchers: 3
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Unichars

Unichars is a simple wrapper around Glib2. It was originally written to speed up ActiveSupport::Multibyte on Ruby 1.8 but it can probably used for other things as well.

# Installation

## Max OS X

You have to install Glib2. We suggest Homebrew, but anything goes.

	$ brew install glib

After that you can install the gem:

	$ gem install unichars

## Ubuntu and Debian

	$ apt-get install libglib2.0-dev

	$ gem install unichars

# Examples

## Rails

In you Gemfile add:

	gem 'unichars'

Add config/initializers/unichars.rb:

	ActiveSupport::Multibyte.proxy_class = Unichars

After that you can just use Unichars through the character proxy on String:

	'¡Ay Dios mío!'.chars.reverse

## ActiveSupport without Rails

Note that you probably want to load ActiveSupport before loading Unichars because Unichars subclasses itself from ActiveSupport::Multibyte::Chars when you do so.

	require 'rubygems'

	require 'active_support/all'

	require 'unichars'

	ActiveSupport::Multibyte.proxy_class = Unichars

After that you can just use Unichars through the character proxy on String:

	'¡Ay Dios mío!'.chars.reverse

## Plain Ruby code

Yeah, so, ehm. Yeah.

	require 'rubygems'

	require 'unichars'

After that you can do:

	Unichars.new('¡Ay Dios mío!').reverse

Or possibly:

	class String

	  def mb_chars

	    Unichars.new(self)

	  end

	end