random_jpg 0.1.0

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.rspec
+.rvmrc

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+- 1.9.2
+- 1.9.3

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in random_jpg.gemspec
+gemspec
+
+gem "rspec"
+gem "rake"

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Łukasz Adamczak
+
+MIT License
+
+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,56 @@
+# random_jpg
+
+random_jpg is a tool for easy downloading **random images from the web** for use in scripts, application test data etc.
+It runs silently in the background feeding random [Flickr](http://www.flickr.com) images to a [named pipe](http://en.wikipedia.org/wiki/Named_pipe) at a specified location, by default `/tmp/random.jpg`. By using a constant location, this simplifies a number of tasks related to downloading images.
+
+## Installation
+
+Install using:
+
+    $ gem install random_jpg
+
+## Requirements
+
+[![Build Status](https://secure.travis-ci.org/czak/random_jpg.png?branch=master)](http://travis-ci.org/czak/random_jpg)
+
+
+random_jpg is verified to run under:
+
+* Ruby 1.9.2
+* Ruby 1.9.3
+
+I'm using OS X and believe any Unix-based system will work.
+I don't expect it to work under Windows, since I'm using `mkfifo` internally.
+
+## Usage
+
+Typical scenario: run once, use everywhere.
+
+    $ random_jpg --daemon
+
+This creates the pipe at the default location `/tmp/random.jpg`. Now you can download 3 random images to `~/Desktop` using:
+
+    $ cp /tmp/random.jpg ~/Desktop/a.jpg
+    $ cp /tmp/random.jpg ~/Desktop/b.jpg
+    $ cp /tmp/random.jpg ~/Desktop/c.jpg
+
+Or you can use it for seed data in loops:
+
+```ruby
+10.times do
+  post = Post.new
+  post.title = Faker::Lorem.words
+  post.image = File.open('/tmp/random.jpg')
+  post.save!
+end
+```
+
+On each run, a new image will be downloaded and served.
+
+For full usage info, run:
+
+    $ random_jpg -h
+
+## Info
+
+random_jpg © 2012 [Łukasz Adamczak](http://czak.pl), read LICENSE file for details.

data/Rakefile

@@ -0,0 +1,7 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/random_jpg

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../lib') unless $LOAD_PATH.include?(File.dirname(__FILE__) + '/../lib')
+
+require "rubygems"
+require "random_jpg"
+
+begin
+  RandomJpg::Runner.new(ARGV).run
+  exit 0
+rescue RandomJpg::Error => e
+  STDERR.puts e.message
+  exit 1
+end

data/lib/random_jpg/error.rb

@@ -0,0 +1,3 @@
+module RandomJpg
+  class Error < StandardError; end
+end

data/lib/random_jpg/loader.rb

@@ -0,0 +1,18 @@
+require "net/http"
+require "json"
+
+module RandomJpg
+  class Loader
+    API_URL = "http://api.flickr.com/services/rest/?method=flickr.photos.getRecent&api_key=66c61b93c4723c7c3a3c519728eac252&per_page=1&extras=url_m&format=json"
+
+    def feed(path)
+      response = Net::HTTP.get URI(API_URL)
+      hash = JSON.parse response[14..-2]
+      image_data = Net::HTTP.get URI(hash["photos"]["photo"].first["url_m"])
+
+      File.open(path, "w") do |f|
+        f.write image_data
+      end
+    end
+  end
+end

data/lib/random_jpg/runner.rb

@@ -0,0 +1,51 @@
+require "optparse"
+
+module RandomJpg
+  class Runner
+    def initialize(args = [])
+      @path   = "/tmp/random.jpg"
+      @daemon = false
+      @force  = false
+      @loader = Loader.new
+
+      OptionParser.new do |opts|
+        opts.banner = "Usage: random_jpg [options]"
+        opts.separator ""
+        opts.separator "Options:"
+        opts.on("-p", "--path PATH", "Full path to the random image file") do |path|
+          @path = path
+        end
+        opts.on("-d", "--daemon", "Run in the background") do
+          @daemon = true
+        end
+        opts.on("-f", "--force", "Force overwrite if a file exists at given path") do
+          @force = true
+        end
+        opts.on_tail("-h", "--help", "Show this message") do
+          puts opts
+          exit
+        end
+      end.parse!(args)
+    end
+
+    def run
+      create_pipe(@path, @force)
+      Process.daemon if @daemon
+      trap("SIGINT") { File.unlink(@path); exit }
+      loop { @loader.feed(@path) }
+    end
+
+    def create_pipe(path, force = false)
+      if File.exists?(path)
+        if force
+          raise Error.new("Permission denied: #{path}") unless File.writable?(path)
+          File.unlink(path)
+        else
+          raise Error.new("Unable to create pipe: #{path}, file exists. Use --force to overwrite.")
+        end
+      end
+
+      system "mkfifo #{path}"
+    end
+  end
+end

data/lib/random_jpg/version.rb

@@ -0,0 +1,3 @@
+module RandomJpg
+  VERSION = "0.1.0"
+end

data/lib/random_jpg.rb

@@ -0,0 +1,4 @@
+require "random_jpg/version"
+require "random_jpg/error"
+require "random_jpg/runner"
+require "random_jpg/loader"

data/random_jpg.gemspec

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/random_jpg/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Łukasz Adamczak"]
+  gem.email         = ["lukasz@czak.pl"]
+  gem.description   = %q{RandomJpg is a tool for easy downloading random images for use in scripts, application test data etc. It runs silently in the background feeding random Flickr images to a named pipe at a specified location, by default /tmp/random.jpg.}
+  gem.summary       = %q{A command-line tool for easy downloading & reading random images from the web.}
+  gem.homepage      = "https://github.com/czak/random_jpg"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "random_jpg"
+  gem.require_paths = ["lib"]
+  gem.version       = RandomJpg::VERSION
+end

data/spec/random_jpg/runner_spec.rb

@@ -0,0 +1,52 @@
+require "spec_helper"
+
+module RandomJpg
+  describe Runner do
+    describe "#create_pipe(path, force = false)" do
+      let(:path) { "/tmp/fullpath.jpg" }
+
+      context "when no file exists at path" do
+        before { File.stub :exists? => false }
+
+        it "creates a named pipe and returns true" do
+          subject.should_receive(:system).with("mkfifo #{path}").and_return(true)
+          subject.create_pipe(path).should be_true
+        end
+      end
+
+      context "when a file exists at path" do
+        before { File.stub :exists? => true }
+
+        context "and force = false" do
+          it "raises a RandomJpg::Error" do
+            expect {
+              subject.create_pipe(path)
+            }.to raise_error(RandomJpg::Error)
+          end
+        end
+
+        context "and force = true" do
+          context "when user has write access to file" do
+            before { File.stub :writable? => true }
+
+            it "unlinks the original file and creates the pipe" do
+              File.should_receive(:unlink).with(path)
+              subject.should_receive(:system).with("mkfifo #{path}").and_return(true)
+              subject.create_pipe(path, true).should be_true
+            end
+          end
+
+          context "but user has no permission to write to the file" do
+            before { File.stub :writable? => false }
+
+            it "raises RandomJpg::Error" do
+              expect {
+                subject.create_pipe(path, true)
+              }.to raise_error(RandomJpg::Error)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+require "random_jpg"
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: random_jpg
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Łukasz Adamczak
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-23 00:00:00.000000000 Z
+dependencies: []
+description: RandomJpg is a tool for easy downloading random images for use in scripts,
+  application test data etc. It runs silently in the background feeding random Flickr
+  images to a named pipe at a specified location, by default /tmp/random.jpg.
+email:
+- lukasz@czak.pl
+executables:
+- random_jpg
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/random_jpg
+- lib/random_jpg.rb
+- lib/random_jpg/error.rb
+- lib/random_jpg/loader.rb
+- lib/random_jpg/runner.rb
+- lib/random_jpg/version.rb
+- random_jpg.gemspec
+- spec/random_jpg/runner_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/czak/random_jpg
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: A command-line tool for easy downloading & reading random images from the
+  web.
+test_files:
+- spec/random_jpg/runner_spec.rb
+- spec/spec_helper.rb