teaas 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8e881463c35ff5a40a172a85494f34ed1825f5e7
+  data.tar.gz: 1640619a6f1fa74fc9065c3575c28bc69cc08c54
+SHA512:
+  metadata.gz: b825bf9b0a945669e93102ee7d9cd365bd558eb2778679a788d405b7da1161d8b373fb018612519abc5f85654f31e8668488a6a7969f68b7cfe048ff4c085793
+  data.tar.gz: 8a133564f2c2edc087cb982d3f6705bd8e9abe8fb0fddb79edbe63cf5c8bdd0fa4632f5c323bad955644b00f2e814ba91917acdb7211541fcf021770a153eff6

data/.gitignore

@@ -0,0 +1,36 @@
+.DS_Store
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+ - "1.9.2"
+ - "1.9.3"
+ - "2.2.3"
+
+script: bundle exec rspec spec

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Bill Rastello
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,77 @@
+# teaas
+![Build status](https://api.travis-ci.org/wjr1985/teaas.svg?branch=master)
+## Total Emojis as a Service
+
+Total Emojis as a Service (Teaas / TEAAS) is a lightweight library that wraps around [RMagick](https://github.com/rmagick/rmagick) and allows easy manipulation of emojis or emoji-like GIFs. Right now, it supports "Turbo"ing the emoji, or making it spin. This is a very early version, with more features and bug fixes to come in the future.
+
+## Requirements
+
+- Ruby 1.9.2 or higher
+- `rmagick` ~> 2.15.4. `rmagick` requires ImageMagick to be installed where this is running. Some free hosts (Heroku a notable example) have this installed already, while others may not. Additionally, the Ruby you're using needs to be able to compile C extensions.
+
+### "Turbo"ing / Turboize
+
+"Turbo"ing or Turboize involves changing the GIF animation delay to 1 second, and adjusting the ticks per second to make the emoji speed up or slow down.
+
+### Spin
+
+Spinning an image just takes the image that is input and makes it spin clockwise. It was intended for static images, however it does support spinning the last frame on an animated GIF.
+
+**NOTE**: Spinning is buggy right now, and only works best on images that are square (32x32 for example). Images that are not square may return invalid results.
+
+**NOTE**: Spinning removes any transparency from the image.
+
+## Documentation
+Docs are in [YARD](http://yardoc.org/) format. To build the HTML docs, just `gem install yard` then run `yard`. If you'd rather not use YARD, you can just read the documentation for the methods in the source files.
+
+# Example
+If you're looking for a full example, I built a hacky, yet functional, example Heroku app [here](https://github.com/wjr1985/teaas_heroku_example).
+
+If you're just interested in code snippets, check these out:
+
+## Turbo
+### From a file
+```ruby
+image_path = "image.gif"
+
+result = Teaas::Turbo.turbo_from_file(image_path, false)
+// result contains an array of image blobs
+```
+
+### From a `Magick::ImageList`
+
+```ruby
+image = Magick::ImageList.new
+
+//populate image here
+
+result = Teaas::Turbo.turbo(image, false)
+// result contains an array of image blobs
+```
+
+## Spin
+### From a file
+```ruby
+image_path = "image.gif"
+
+spin_result = Teaas::Spin.spin_from_file(image_path)
+final_result = Teaas::Turbo.turbo(spin_result, false)
+// final_result contains an array of image blobs
+```
+
+### From a `Magick::ImageList`
+```ruby
+image = Magick::ImageList.new
+
+//populate image here
+
+spin_result = Teaas::Spin.spin(image)
+final_result = Teaas::Turbo.turbo(spin_result, false)
+// final_result contains an array of image blobs
+```
+
+# Questions / PRs, etc.
+Feel free to open a GitHub issue or file a pull request if you have a question or would like something added.
+
+# License
+It's MIT. See the [LICENSE](https://github.com/wjr1985/teaas/blob/master/LICENSE) file.

data/lib/teaas.rb

@@ -0,0 +1,4 @@
+require 'rmagick'
+
+require 'teaas/spin.rb'
+require 'teaas/turboize.rb'

data/lib/teaas/spin.rb

@@ -0,0 +1,35 @@
+module Teaas
+  class Spin
+
+    # Takes in an image, rotates it 90, 180, and 270 degrees, then returns an animated spinning image. Best when used with {Teaas::Turboize.turbo} to generate multiple rotation speeds.
+    #
+    # @param original_img [Magick::ImageList] The image to be rotated
+    # @return [Magick::ImageList] The spinning image
+    def self.spin(original_img)
+      spinny_image = Magick::ImageList.new
+      img = original_img.flatten_images
+      img.format = "gif"
+
+      spinny_image << img
+      spinny_image << img.rotate(90)
+      spinny_image << img.rotate(180)
+      spinny_image << img.rotate(270)
+
+      spinny_image
+    end
+
+    # Takes in a path to an image, rotates it 90, 180, and 270 degrees, then returns an animated spinning image. Best when used with {Teaas::Turboize.turbo} to generate multiple rotation speeds. This is a wrapper around {Teaas::Spin.spin}
+    #
+    # @param path [String] Path to the image to be spun
+    # @return [Magick::ImageList] The spinning image
+    def self.spin_from_file(path)
+      img = Magick::ImageList.new
+
+      # Grab the first element in array to prevent strange things when an
+      # animated image is submitted
+      img.read(path)[0]
+
+      spin(img)
+    end
+  end
+end

data/lib/teaas/turboize.rb

@@ -0,0 +1,53 @@
+module Teaas
+  class Turboize
+
+    # Takes in an image, a resize parameter, and optionally speeds, and returns an image or images that are sped up or slowed down.
+    #
+    # @param img [Magick::ImageList] The image to be turboized
+    # @param resize [Integer or Falsey] The size of the largest dimension (eg. 32) for the image, or falsey if no resizing should occur
+    # @param speeds [Array] An array of Integers that determines the ticks per second for the resulting animated image
+    # @return [Array] An array of image blobs that match each specified speed
+    def self.turbo(img, resize, speeds=[2, 5, 10, 20, 30, 40])
+      if resize
+        img = img.coalesce
+        img.each do |frame|
+          frame.change_geometry(resize) do |cols, rows, i|
+            i.resize!(cols, rows)
+          end
+        end
+      end
+
+      image_blobs = []
+      speeds.each do |turbo|
+        image_blobs << turboize_individual_image(img, turbo).to_blob
+      end
+
+      image_blobs
+    end
+
+    # Takes in a path to an image, a resize parameter, and optionally speeds, and returns an image or images that are sped up or slowed down. This method is just a wrapper around {Teaas::Turboize.turbo}
+    #
+    # @param path [String] The path to the image to be turboized
+    # @param resize Truthy if the image should be resized, falsey or nil if it should not
+    # @param speeds [Array] An array of Integers that determines the ticks per second for the resulting animated image
+    # @return [Array] An array of image blobs that match each specified speed
+    def self.turbo_from_file(path, resize, speeds=[2, 5, 10, 20, 30, 40])
+      img = Magick::ImageList.new
+      img.read(path)
+
+      turbo(img, resize, speeds)
+    end
+
+    # Takes in a `Magick::ImageList` and adjusts the GIF image delay, ticks per second, and iterations.
+    #
+    # @param img [Magick::ImageList]
+    # @param turbo [Integer] the ticks per second
+    # @return [Magick::ImageList]
+    def self.turboize_individual_image(img, turbo)
+      img.delay = 1
+      img.ticks_per_second = turbo
+      img.iterations = 0
+      img
+    end
+  end
+end

data/teaas.gemspec

@@ -0,0 +1,14 @@
+Gem::Specification.new do |s|
+  s.name        = 'teaas'
+  s.version     = '0.1.0'
+  s.licenses    = ['MIT']
+  s.summary     = "Total Emojis as a Service"
+  s.description = "Gem to manipulate emoji-sized images"
+  s.authors     = ["Bill Rastello"]
+  s.email       = 'github@billrastello.com'
+  s.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  s.homepage    = 'https://www.github.com/wjr1985/teaas/'
+
+  s.add_runtime_dependency 'rmagick', '~> 2.15'
+  s.add_development_dependency 'rspec', '~> 3.4'
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: teaas
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Bill Rastello
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.15'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+description: Gem to manipulate emoji-sized images
+email: github@billrastello.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- lib/teaas.rb
+- lib/teaas/spin.rb
+- lib/teaas/turboize.rb
+- teaas.gemspec
+homepage: https://www.github.com/wjr1985/teaas/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Total Emojis as a Service
+test_files: []
+has_rdoc: