[](https://travis-ci.org/pikesley/nineteen-eighty-two)
[](https://gemnasium.com/pikesley/nineteen-eighty-two)
[](https://coveralls.io/r/pikesley/nineteen-eighty-two)
[](https://codeclimate.com/github/pikesley/nineteen-eighty-two)
[](https://rubygems.org/gems/nineteen-eighty-two)
[](http://pikesley.mit-license.org)
# 1982
## Sinclair Spectrum font as a Rubygem
A massively over-engineered solution to a problem that I'm almost 100% certain does not exist - rendering text in the 1982 Sinclair Spectrum character set, in a variety of formats
git clone https://github.com/pikesley/nineteen-eighty-two
cd nineteen-eighty-two
bundle
rake
Or just
gem install nineteen-eighty-two
## API
From the [specs](https://github.com/pikesley/nineteen-eighty-two/tree/master/spec/nineteen/eighty/two):
### Just the data
#### Transform a string into an array-of-arrays of bits
require 'nineteen/eighty/two'
module Nineteen::Eighty::Two
describe Spectrum do
it 'returns an array of arrays' do
expect(described_class['ab']).to eq [
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0],
[0, 0, 1, 1, 1, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0],
[0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 1, 0, 0, 0, 1, 0],
[0, 1, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 1, 0],
[0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
]
end
end
end
### Specific output formats
#### HTML table
require 'nineteen/eighty/two'
module Nineteen::Eighty::Two
module Formats
describe HTMLTable do
it 'makes a table' do
expect(described_class.format 'a').to eq (
"""
"""
)
end
end
end
#### JSON
require 'nineteen/eighty/two'
module Nineteen::Eighty::Two
module Formats
describe JSON do
expect(described_class.format 'ab').to eq ({
:id => 'ab',
:data => [
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0],
[0, 0, 1, 1, 1, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0],
[0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 1, 0, 0, 0, 1, 0],
[0, 1, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 1, 0],
[0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
]
}.to_json)
end
end
end
#### SVG
require 'nineteen/eighty/two'
module Nineteen::Eighty::Two
module Formats
describe SVG do
it 'returns an SVG' do
expect(described_class.format '/').to eq (
"""
""")
end
it 'sets the colour' do
expect(described_class.format '/', {colour: '#fa8100'}).to match /fill: #fa8100;/
end
end
end
end
#### Text
require 'nineteen/eighty/two'
module Nineteen::Eighty::Two
module Formats
describe Text do
it 'gives the correct string' do
expect(described_class.format 'ab').to eq (
"""
0000000000000000
0000000000100000
0011100000100000
0000010000111100
0011110000100010
0100010000100010
0011110000111100
0000000000000000
"""
).strip
end
it 'returns characters other than zeroes and ones' do
expect(described_class.format 'Sam', {on: 'X', off: '.'}).to eq (
"""
........................
..XXXX..................
.X........XXX....XX.X...
..XXXX.......X...X.X.X..
......X...XXXX...X.X.X..
.X....X..X...X...X.X.X..
..XXXX....XXXX...X.X.X..
........................
"""
).strip
end
end
end
## FAQ
Your questions, answered
### Why the stupid module structure?
I realise that `Nineteen::Eighty::Two::Formats::HTMLTable.format` is a ludicrously long method name, but it turns out if you do `bundle gem nineteen-eighty-two`, this module hierarchy is what you're presented with, and I actually kind of like it (I did try to call it `1982` but apparently that's not a kosher Gem name)
### Why doesn't it output in _${other_format}_
If you can think of another format I could support, let me know and I'll have a go. I am also [open to PRs](https://github.com/pikesley/nineteen-eighty-two/pulls), of course
### Where can I play with this?
I've wrapped this Gem in a RESTful API [over here](http://uncleclive.herokuapp.com/)
### Why have you done this?
Have you met me? Also, because I'm [moderately obsessed with this font](https://www.youtube.com/watch?v=Qt_J0jNqtZg)