Easily manage magic comments for encoding for your ruby 1.9 applications
Ruby
Latest commit a420afd Mar 23, 2015 @mryan43 Merge pull request #12 from weakish/master
README: update link.
Failed to load latest commit information.
bin clear existing encoding comments and code cleanup Aug 3, 2010
lib fixing search by existing comments Sep 10, 2012
CHANGELOG fixing search by existing comments Sep 11, 2012
LICENCE
README.rdoc README: update link. Mar 23, 2015
magic_encoding.gemspec

README.rdoc

Magic encoding

Magic Encoding is a little tool that allows you to quickly add or modify the magic comments that indicate source file encoding for an entire directory structure, please note that this tool only sets the comments, and does not perform any file encoding conversion whatsoever.

If you are looking for a way to convert files to a specific encoding, check out iconv (GNU)

I originally wrote this to get rid of “invalid multibyte char (US-ASCII)” errors when writing strings containing non ascii characters like éöàüèä in ruby on rails controllers

Installation

gem install magic_encoding

Usage

you can call the tool from the console with default parameters like so

magic_encoding

this will prepend every “.rb” file in the working directory (recursively) with the following line :

# -*- encoding : utf-8 -*-

Notes :

  • existing magic comments are replaced

  • the rest of the file remains unchanged

you can pass options to the tool to specify the desired encoding and the path where you want the tool to run, for example :

magic_encoding Shift-JIS /path/to/ruby/project

For more information on ruby >= 1.9 encoding features, check out graysoftinc.com/character-encodings/ruby-19s-three-default-encodings