repertoire-repertoire-devtools 0.0.1

data/bin/merb_persist

@@ -0,0 +1,109 @@
+#!/usr/bin/ruby
+
+# Adapted from mongrel_rails_persist by Christopher York on 09/16/2008
+
+# Copyright (c) 2007 Apple Inc.  All Rights Reserved.
+
+# Create a launchd plist to run merb persistently across reboots
+
+class MerbPersist
+	require 'osx/cocoa'
+	include OSX
+	
+	def initialize(args)
+		@merb_root = Dir.pwd
+		@port = 4000
+		@user = nil
+		@group = nil
+		@merb_args = []
+		
+		while opt = args.shift
+			case opt
+			when '-m', '--merb-root' then @merb_root = args.shift
+			when '-p', '--port'				
+				@port = args.shift
+				[opt, @port].each { |i| @merb_args << i }
+			when '-u', '--user' then @user = args.shift
+			when '-g', '--group' then @group = args.shift
+			when '-d', '--daemonize', '-c', '--cluster-nodes'
+				# Silently remove the daemonize option as it doesn't work well with launchd
+			else
+				[opt, args.shift].each { |i| @merb_args << i }
+			end
+		end
+		
+		@label = "edu.mit.hyperstudio.persist.port#{@port}.merb_server"
+		@plist_path = "/Library/LaunchDaemons/#{@label}.plist"
+	end
+	
+	def start
+		if ! test(?d,File.dirname(@plist_path))
+			raise unless system('/bin/mkdir', '-m', '0755', @plist_path)
+			raise unless system('/usr/sbin/chown', 'root:wheel', @plist_path)
+		end
+		
+		h = {}
+		h['Label'] = @label
+		h['OnDemand'] = false
+		h['KeepAlive'] = true
+		h['ProgramArguments'] = [@merb_root + '/bin/merb', @merb_args].flatten.compact
+		h['WorkingDirectory'] = @merb_root
+		h['UserName'] = @user if @user
+		h['GroupName'] = @group if @group
+		h['StandardErrorPath'] = "/var/log/merb_persist_#{@port}.log"
+		if h['UserName'] || h['GroupName']
+			# Ensure that the log file is writable by the specified user:group
+			system('/usr/bin/touch', h['StandardErrorPath']) unless test(?e, h['StandardErrorPath'])
+			raise unless system('/usr/sbin/chown', "#{h['UserName']}:#{h['GroupName']}", h['StandardErrorPath'])
+		end
+
+		data = NSPropertyListSerialization.dataFromPropertyList_format_errorDescription(h, NSPropertyListXMLFormat_v1_0, nil)
+		plist = NSString.alloc.initWithData_encoding(data, NSUTF8StringEncoding)
+		File.open(@plist_path, 'w') { |f| f.puts plist }
+		
+		`/bin/launchctl unload #{@plist_path} >/dev/null 2>&1`
+		raise unless system('/bin/launchctl', 'load', @plist_path)
+		puts "Loaded #{@plist_path}.\nMerb instance should persist across reboot."
+		puts "To stop: #{File.basename($0)} stop -p #{@port}"
+	end
+	
+	def stop
+		raise unless system('/bin/launchctl', 'unload', @plist_path)
+		File.delete(@plist_path)
+		puts "Unloaded and deleted #{@plist_path}."
+	end
+	
+	def restart
+		raise unless system('/bin/launchctl', 'unload', @plist_path)
+		sleep(2)
+		raise unless system('/bin/launchctl', 'load', @plist_path)
+	end
+end
+
+if __FILE__ == $0
+	usage = <<EOU
+Usage: #{File.basename($0)} -h | [start | restart | stop] [options]
+This is a launchd wrapper for merb.
+See merb command for details.
+EOU
+
+	if ARGV.empty? || ARGV.include?('-h') || ARGV.include?('--help')
+	  $stderr.puts usage
+		exit
+	end
+	
+	begin
+		action = ARGV.shift.to_sym
+		m = MerbPersist.new(ARGV)
+		if m.respond_to?(action)
+			m.send(action)
+		else
+			raise ArgumentError, "#{action}: unknown action"
+		end
+	rescue ArgumentError => e
+		$stderr.puts e.message
+		$stderr.puts usage
+	rescue => e
+		$stderr.puts e.message
+	end
+end

data/bin/postgresql_crontab_sweep

@@ -0,0 +1,150 @@
+#!/usr/bin/ruby
+
+# Copyright (c) 2008 MIT.  All Rights Reserved.
+
+require "rubygems"
+require "pg"
+
+#
+# Basic support for crontab-type tasks within PostgreSQL
+#
+#   This script makes it easy to schedule periodic tasks in your PostgreSQL database
+#   Fits a variety of use-cases: updating full text indexes, cleaning up stale caches, expiring accounts, etc.
+#
+#   Initial Hyperstudio use is to maintain full text indexes for database models with many joins
+#     (1) moves expensive indexing operations outside of the initial database transaction
+#     (2) avoids complicated set of hand-tuned triggers and functions on dependent tables
+#     (2) ensures data consistency and integrity by rebuilding index periodically
+#
+#   Before running, create the crontab table as follows:
+#
+#     CREATE TABLE crontab(id SERIAL PRIMARY KEY,
+#                   notice TEXT NOT NULL,
+#                    task TEXT NOT NULL, 
+#                    interval INTERVAL NOT NULL, 
+#                  last_updated_at TIMESTAMP WITHOUT TIME ZONE NOT NULL DEFAULT 'epoch',
+#                   failing BOOLEAN NOT NULL DEFAULT false,
+#                   message TEXT);
+#
+#   This script makes a single sweep through the crontab list, executing pending tasks.  To use,
+#     run as a cron script (standard UNIX), or launchd task (OS X).
+#
+#   If you would like the script to set up the database table and a basic launchd task, you can use
+#     the following shortcut:
+#   `sudo postgresql_crontab_sweep install <database-name>`
+#     on the command line (OS X only).  This will generate the relevant files, tables, and start the 
+#     update polling process.
+#
+#   Each task is executed in a separate transaction, so they fail or succeed separately.  If the
+#     task commits, its timestamp is updated.  If it aborts, last_updated_at will show the most
+#     recent successful run, and the failing and message fields will be set.
+#
+#   Parameters:  -d <database> -p <port> -h <host> -u <user> -p <password>  [ all are optional ]
+#           or:  install <database>
+#
+#   Because this script should only be run locally to the database, it expects postgres to accept
+#     your user without a password prompt (see pg_hba.conf to configure).  Usually this user will
+#     be 'postgres', the db admin role.  When writing tasks, keep in mind that this user will
+#     execute them.  You may need to qualify tables in separate schemas, and grant access to appropriately.
+#
+#   Christopher York 12/8/2008
+#
+
+
+def run(dbparams)                          
+  # setup and connect
+  cron_conn = PGconn.open(dbparams)
+  forking  = false
+
+  # get the pending database cron tasks
+  pending  = cron_conn.exec("SELECT id, notice, task, interval, last_updated_at FROM crontab WHERE last_updated_at + interval < now();")
+
+  pending.each do |crontask|
+    # fork a sub-process for each task, with its own database connection
+    forking ||= true
+    fork do
+      task_conn = PGconn.open(dbparams)
+      begin
+        # all postgresql cron tasks take place in their own transaction (which is the reason for this script - not possible in plpgsql)
+        task_conn.transaction do 
+          puts crontask[:notice]
+          task_conn.exec("UPDATE crontab SET last_updated_at = now(), failing = false, message = NULL WHERE id = #{ crontask['id'] }")
+          task_conn.exec(crontask['task'])
+        end
+      rescue PGError => e  
+        STDERR.puts "ERROR!  #{ Time.now } - #{ e.message }"
+        task_conn.exec("UPDATE crontab SET failing = true, message = '#{ e.message }' WHERE id = #{ crontask['id'] }")
+      end
+      task_conn.close
+      exit!
+    end
+  end
+
+  cron_conn.close
+  Process.wait if forking   # avoid zombies by waiting for child processes to finish
+end
+
+def install(dbparams)
+  launchd_plist = <<-END_OF_PLIST
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>edu.mit.hyperstudio.postgresql.crontab.plist</string>
+  <key>OnDemand</key>
+  <false/>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/bin/postgresql_crontab_sweep</string>
+    <string>-d</string>
+    <string>#{dbparams['dbname']}</string>
+  </array>
+  <key>StartCalendarInterval</key>
+  <dict>
+    <key>StartInterval</key>
+    <integer>5</integer>
+  </dict>
+</dict>
+</plist>
+END_OF_PLIST
+
+  create_table = <<-END_OF_CREATE_TABLE
+CREATE TABLE crontab(id SERIAL PRIMARY KEY,
+                     notice TEXT NOT NULL,
+                     task TEXT NOT NULL, 
+                     interval INTERVAL NOT NULL, 
+                     last_updated_at TIMESTAMP WITHOUT TIME ZONE NOT NULL DEFAULT 'epoch',
+                     failing BOOLEAN NOT NULL DEFAULT false,
+                     message TEXT);
+END_OF_CREATE_TABLE
+
+  File.open('/Library/LaunchDaemons/edu.mit.hyperstudio.postgresql.crontab.plist', 'w') { |f| f.write(launchd_plist) }
+  
+  conn = PGconn.open(dbparams)
+  conn.exec(create_table)
+  conn.close
+end
+
+
+# parse params, with defaults
+
+opts = {
+  :dbname   => 'hyperstudio_development',
+  :user     => 'postgres',
+  :port     => 5432,
+  :host     => 'localhost'
+}
+
+while opt = ARGV.shift
+	case opt
+	when '-d' then opts['dbname'] = ARGV.shift
+	when '-p' then opts['port'] = ARGV.shfit
+	when '-u' then opts['user'] = ARGV.shift
+	when '-p' then opts['password'] = ARGV.shift
+  when 'install' then install(opts) && exit
+  end
+end
+
+run(opts)
+exit

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: repertoire-repertoire-devtools
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Christopher York
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-15 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ruby-pg
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+    version: 
+description: Development and server tools for use with Hyperstudio Repertoire
+email: yorkc@mit.edu
+executables: 
+- merb_persist
+- postgresql_crontab_sweep
+extensions: []
+
+extra_rdoc_files: 
+- README.txt
+files: 
+- README.txt
+has_rdoc: false
+homepage: http://hyperstudio.mit.edu/repertoire
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Server and development tools for use with Hyperstudio Repertoire
+test_files: []
+