play 0.0.1

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,87 @@
+PATH
+  remote: .
+  specs:
+    play (0.0.1)
+      SystemTimer
+      activerecord
+      mustache
+      mysql2
+      oa-oauth
+      rack (~> 1.2.2)
+      ruby-audioinfo
+      sinatra
+      sqlite3
+      yajl-ruby
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    SystemTimer (1.2.3)
+    activemodel (3.0.7)
+      activesupport (= 3.0.7)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.7)
+      activemodel (= 3.0.7)
+      activesupport (= 3.0.7)
+      arel (~> 2.0.2)
+      tzinfo (~> 0.3.23)
+    activesupport (3.0.7)
+    addressable (2.2.5)
+    apetag (1.1.2)
+      cicphash (>= 1.0.0)
+    arel (2.0.9)
+    builder (2.1.2)
+    cicphash (1.0.0)
+    faraday (0.6.1)
+      addressable (~> 2.2.4)
+      multipart-post (~> 1.1.0)
+      rack (< 2, >= 1.1.0)
+    flacinfo-rb (0.4)
+    i18n (0.5.0)
+    mocha (0.9.12)
+    mp4info (1.7.3)
+    multi_json (1.0.1)
+    multipart-post (1.1.0)
+    mustache (0.99.3)
+    mysql2 (0.2.7)
+    nokogiri (1.4.4)
+    oa-core (0.2.4)
+    oa-oauth (0.2.4)
+      faraday (~> 0.6.1)
+      multi_json (>= 0.0.5)
+      nokogiri (~> 1.4.2)
+      oa-core (= 0.2.4)
+      oauth (~> 0.4.0)
+      oauth2 (~> 0.4.1)
+    oauth (0.4.4)
+    oauth2 (0.4.1)
+      faraday (~> 0.6.1)
+      multi_json (>= 0.0.5)
+    rack (1.2.2)
+    ruby-audioinfo (0.1.7)
+      apetag (= 1.1.2)
+      flacinfo-rb (>= 0.4)
+      mp4info (>= 1.7.3)
+      ruby-mp3info (>= 0.6.3)
+      ruby-ogginfo (>= 0.3.1)
+      wmainfo-rb (>= 0.5)
+    ruby-mp3info (0.6.13)
+    ruby-ogginfo (0.6.5)
+    running_man (0.2.1)
+    sinatra (1.2.6)
+      rack (~> 1.1)
+      tilt (< 2.0, >= 1.2.2)
+    sqlite3 (1.3.3)
+    tilt (1.3)
+    tzinfo (0.3.27)
+    wmainfo-rb (0.6)
+    yajl-ruby (0.8.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  mocha
+  play!
+  running_man

data/README.md

@@ -0,0 +1,139 @@
+# Play
+Play is your company's dj.
+
+## Background
+
+We want to play music at our office. Everyone has their own library on their
+own machines, and everyone except for me plays shitty music. Play is designed
+to make office music more palatable.
+
+Play is **api-driven** and **web-driven**. All music is dropped on a central
+Mac system. Once it's available to Play, users can control what's being played.
+Users can either use a nice web view or the API, which lends itself for use on
+the command line or through Campfire.
+
+Play will play all the songs that are added to its Queue. Play will play the
+crap out of that Queue. And you know what?  If there's nothing left in the
+Queue, Play will figure out who's in the office and play something that they'll
+like.
+
+No shit.
+
+## Install
+
+The underlying tech of Play uses `afplay` to control music (for now), so you'll
+need a Mac. `afplay` is just a simple command-line wrapper to OS X's underlying
+music libraries, so it should come preinstalled with your Mac, and it should
+play anything iTunes can play.
+
+Play also expects MySQL to be installed.
+
+### Install the gem
+
+Play itself is installed with a gem.
+
+    gem install play
+
+### Fill out ~/.play.yml
+
+You'll need to set up your configuration values, which we store in
+`~/.play.yml`. You can view the [example file on
+GitHub](https://github.com/holman/play/blob/master/play.yml.example).
+
+### Set up your database
+
+This is a bit of a pain that we'll correct eventually. For now, create your
+MySQL database by hand. We expect the database to be called `play`, but it's
+really pulled from whatever you have in `~/.play.yml`. When that's set up, run:
+
+    bin/play --migrate
+
+### Set up your GitHub application
+
+Next, go to GitHub and [register a new OAuth
+application](https://github.com/account/applications/new). Users sign in with
+their GitHub account. Copy the Client ID and Client Secret into Play's
+`~/.play.yml` file.
+
+### Set up your music folder
+
+Next, tell Play where to look for music. It's the `path` attribute in
+`~/.play.yml`. We'll then look at your path and import everything
+recursively when you run:
+
+    play -i
+
+## Play
+
+Once you're all set up, you can spin up the web app with:
+
+    play -w
+
+You can hit the server at [localhost:5050](http://localhost:5050). Queue some
+hawt, hawt music up. We'll wait.
+
+Ready? Cool. The only thing left to do is actually start the music server.
+That's done with:
+
+    play -d
+
+You'll detach it and put it in the background, where it will sit waiting for
+salacious music to play for you. When you want to kill it for reals, run:
+
+    play -s
+
+For all the fun commands and stuff you can do, just run:
+
+    play -h
+
+
+## Set up your office (optional)
+
+This isn't a required step. If nothing's in the queue and Play has still been
+told to play something, it'll just play random music. But you can set it up so
+it will play a suitable artist for someone who's currently in the office.
+
+That particular step is left to the reader's imagination — here at GitHub we
+poll our router's ARP tables and update an internal application with MAC
+addresses — but all Play cares about is a URL that returns comma-separated
+string identifiers. We get that string by hitting the `office_url` in
+`~/.play.yml`. The string that's returned from that URL should look
+something like this:
+
+    holman,kneath,defunkt
+
+That means those three handsome lads are in the office right now. Once we get
+that, we'll compare each of those with the users we have in our database. We do
+that by checking a user attribute called `office_string`, which is just a
+unique identifier to associate back to Play's user accounts. In this example,
+I'd log into my account and change my `office_string` to be "holman" so I could
+match up. It could be anything, though; we actually use MAC addresses here.
+
+## Local development
+
+If you're going to hack on this locally, you can use the normal process for
+writing a Sintara app (`rackup`, `shotgun`, et cetera). The only thing we kind
+of do differently in Play is we disable the GitHub OAuth callback (since your
+development URL is different than it would be in production).
+
+To actually use it locally, we'll automatically create a user called `user` for
+you when you first access the app. That way you can actually mess around
+without having to hit GitHub or create a user manually.
+
+None of this happens if you launch Play with `bin/play -d`.
+
+## Current Status
+
+This is pretty rough. For the most part it should run pretty reliably for you,
+but there's a bit of setup and configuration that I'd like to refine and do
+away with until it's "ready" for prime time.
+
+Once it's ready, pretty sure I'm going to make the most awesome screencast, and
+then it's balls-out from there.
+
+## ♬ ★★★
+
+This was created by [Zach Holman](http://zachholman.com). You can follow me on
+Twitter as [@holman](http://twitter.com).
+
+I usually find myself playing Justice, Kanye West, and Muse at the office.

data/Rakefile

@@ -0,0 +1,185 @@
+require 'rubygems'
+require 'rake'
+require 'date'
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def rubyforge_project
+  name
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+#############################################################################
+#
+# Standard tasks
+#
+#############################################################################
+
+task :default => :test
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+desc "Generate RCov test coverage and open in your browser"
+task :coverage do
+  require 'rcov'
+  sh "rm -fr coverage"
+  sh "rcov test/test_*.rb"
+  sh "open coverage/index.html"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "#{name} #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/#{name}.rb"
+end
+
+#############################################################################
+#
+# Custom tasks (add your own tasks here)
+#
+#############################################################################
+
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__) + '/lib')
+
+require 'yaml'
+
+task :environment do
+  ENV['RACK_ENV'] ||= 'development'
+  require 'lib/play'
+  require "bundler/setup"
+end
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/play"
+end
+
+namespace :db do
+  task :create do
+    config = YAML::load(File.open("#{ENV['HOME']}/.play.yml"))
+    `mysql -u#{config['db']['user']} \
+      --password='#{config['db']['password']}' \
+      --execute=\'CREATE DATABASE #{config['db']['database']} CHARACTER SET utf8 COLLATE utf8_unicode_ci;'`
+  end
+
+  task :drop do
+    config = YAML::load(File.open("#{ENV['HOME']}/.play.yml"))
+    `mysql --user=#{config['db']['user']} \
+           --password='#{config['db']['password']}' \
+           --execute='DROP DATABASE #{config['db']['database']};'`
+  end
+
+  desc "Migrate the database through scripts in db/migrate."
+  task :migrate => :environment do
+    ActiveRecord::Base.establish_connection(Play.config['db'])
+    ActiveRecord::Migrator.migrate("db/migrate")
+  end
+end
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+desc "Create tag v#{version} and build and push #{gem_file} to Rubygems"
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+desc "Build #{gem_file} into the pkg directory"
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+desc "Generate #{gemspec_file}"
+task :gemspec => :validate do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+  #comment this out if your rubyforge_project has a different name
+  replace_header(head, :rubyforge_project)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end
+
+desc "Validate #{gemspec_file}"
+task :validate do
+  libfiles = Dir['lib/*'] - ["lib/#{name}.rb", "lib/#{name}"]
+  unless libfiles.empty?
+    puts "Directory `lib` should only contain a `#{name}.rb` file and `#{name}` dir."
+    exit!
+  end
+  unless Dir['VERSION*'].empty?
+    puts "A `VERSION` file at root level violates Gem best practices."
+    exit!
+  end
+end

data/bin/play

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+
+require 'play'
+require 'optparse'
+
+parser = OptionParser.new do |opts|
+  opts.banner = "Usage: play [options] COMMAND"
+
+  opts.separator ""
+  opts.separator "Options:"
+
+  opts.on("--migrate", "Setup the database") do
+    ActiveRecord::Base.establish_connection(Play.config['db'])
+    ActiveRecord::Migrator.migrate("#{File.dirname(__FILE__)}/db/migrate")
+  end
+
+  opts.on("-d", "--detach", "Start the music server") do
+    ENV['RACK_ENV'] = 'production'
+    pid = fork { Play::Client.loop }
+    Process.detach(pid)
+  end
+
+  opts.on("-s", "--stop", "Stop the music server") do
+    Play::Client.stop
+  end
+
+  opts.on("-w", "--web", "Run the web instance") do
+    system("rackup -p 5050")
+  end
+
+  opts.on("-p", "--path", "Pause the music server") do |path|
+    Play::Client.pause
+  end
+
+  opts.on("-i", "--import", "Import new songs") do |import|
+    Play::Library.import_songs
+    exit
+  end
+
+  opts.on("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+
+end
+
+parser.parse!