Sinister code obfuscation.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Gem Version

Machinator can perform code obfuscation on file content and directory structures.

It can be paired up with high level language deployment and/or compression routines to keep even Big Brother guessing. Or can it?

Terminal usage

As a ruby gem

machinator -h

Or (with the source) you can just:

ruby bin/machinator -h


Machinator lets you define the schema for obfuscation.

A schema (in YAML) is defined in a .machinator file in the directory being operated on, or a manually specified Hash resource.

A schema has a words and a names hash collection, with each key/pair being a regular expression and strings to replace with any occurences, respectively.

An example:

words: {

names: {
    SomeFile\.js$: ABC.js

Any words are matched against the entire file. File names are obfuscated afterwards (will only be matched once).

Using In Code

require "machinator"
winston =
winston.neverspeak(source, schema)

The source can be an actual string to obfuscate, a File object, or a directory/file path to operate on. Keep in mind that the Obfuscator module will overwrite any files/directories that matches the schema.

Note: If you specify a string to obfusctate that is actually a valid file/directory path it will operate on that instead.

Manipulating Strings

In the case of passing in a string an obfuscated copy will be returned.

new_string = winston.neverspeak("some string to obfuscate", {
  "words" => {
    /^some\sstring/ => "something"

Operating on Files and Directories

You can operate on a single file, where the first matched names key/pair is applied to the file name and any words are applied against the file content.

# renames to
winston.neverspeak("", {
  "names" => {
    /bar$/ => "foo"

If you specify a directory all files and directories inside will be operated on (recursively, bottom up), applying names/words matches to each file.

# let somedir have 'afile' in it
winston.neverspeak("somedir", {
  "names" => {
    /afile$/ => "thefile"

Note: This will recurse (fairly deep) so make sure the passed in directory is correct, or you could possibly bring on the apocalypse.


You can pass in a block to filter file operations (both words and names).

winston.neverspeak("somedir", schema) { |path|
} # will operate on every file found




This project ascribes to semantic versioning.


rake test (need mocha, and rake… if you want)


Copyright 2010 Brent Lintner

The MIT License