jakewendt-simply_documents 1.3.4

data/README.rdoc

@@ -0,0 +1,70 @@
+= SimplyDocuments
+
+== ToDo
+
+
+
+== Required Gem Sources
+
+ gem sources -a http://rubygems.org
+ gem sources -a http://gems.github.com
+
+
+== Required Gems
+
+* {jakewendt-assert_this_and_that}[http://github.com/jakewendt/assert_this_and_that]
+* {jakewendt-ruby_extension}[http://github.com/jakewendt/ruby_extension] - modifications, updates and patches for ruby.
+* rails ~> 2
+* chronic
+* ruby-hmac
+* aws-s3
+* ssl_requirement
+* ryanb-acts-as-list
+* RedCloth
+* paperclip
+* thoughtbot-factory_girl
+* {jakewendt-simply_helpful}[http://github.com/jakewendt/simply_helpful]
+* {jakewendt-simply_authorized}[http://github.com/jakewendt/simply_authorized]
+* {jakewendt-calnet_authenticated}[http://github.com/jakewendt/calnet_authenticated]
+
+
+== Installation and Usage
+
+ cp config/s3.yml.example config/s3.yml
+ # Add your own s3 access keys.  Leave 'test' as it is.
+ 
+ config.gem 'jakewendt-simply_documents',
+   :source => 'http://rubygems.org'
+
+ class User (or whatever)
+    document_owner
+ end
+
+ script/generate simply_documents
+
+ User.find_create_and_update_by_uid('859908').deputize
+
+== Testing (as an app)
+
+ rake db:migrate
+ rake db:fixtures:load
+ rake test
+ script/server
+
+
+== Gemified with Jeweler
+
+ vi Rakefile
+ rake version:write
+
+ rake version:bump:patch
+ rake version:bump:minor
+ rake version:bump:major
+
+ rake gemspec
+
+ rake install
+ rake release
+
+
+Copyright (c) 2010 [Jake Wendt], released under the MIT license

data/app/controllers/documents_controller.rb

@@ -0,0 +1,99 @@
+class DocumentsController < ApplicationController
+
+	before_filter :login_required
+
+	before_filter :may_maintain_pages_required
+	before_filter :document_required, :only => :show
+	before_filter :id_required, 
+		:only => [ :edit, :update, :destroy, :preview ]
+
+	def show
+		if @document.document.path.blank?
+			flash[:error] = "Does not contain a document"
+			redirect_to preview_document_path(@document)
+		elsif @document.document.exists?
+			#puts "Document exists!"
+			if @document.document.options[:storage] == :filesystem #	&&
+#				File.exists?(@document.document.path)
+				#	basically development or non-s3 setup
+				send_file @document.document.path
+			else
+				#puts "Storage is S3?"
+
+#	Privacy filters are still not active
+				#	basically a private s3 file
+#				redirect_to @document.s3_url
+				redirect_to @document.document.expiring_url
+
+			end
+		else
+			flash[:error] = "Document does not exist at the expected location."
+			redirect_to preview_document_path(@document)
+		end
+	end
+
+	def preview
+#		#	otherwise looks for template for pdf, jpg or whatever
+#		params[:format] = 'html'
+	end
+
+	def index
+		@documents = Document.all
+	end
+
+	def new
+		@document = Document.new
+	end
+
+	def create
+		@document = Document.new(params[:document])
+		@document.save!
+		redirect_to preview_document_path(@document)
+	rescue ActiveRecord::RecordInvalid
+		flash.now[:error] = "Error"
+		render :action => 'new'
+	end
+
+	def update
+		@document.update_attributes!(params[:document])
+		redirect_to preview_document_path(@document)
+	rescue ActiveRecord::RecordInvalid
+		flash.now[:error] = "Error"
+		render :action => 'edit'
+	end
+
+	def destroy
+		@document.destroy
+		redirect_to documents_path
+	end
+
+protected
+
+	def id_required
+		if !params[:id].blank? and Document.exists?(params[:id])
+			@document = Document.find(params[:id])
+		else
+			access_denied("Valid document id required!", documents_path)
+		end
+	end
+
+	def document_required
+		if !params[:id].blank? and Document.exists?(params[:id])
+			@document = Document.find(params[:id])
+		elsif !params[:id].blank? and Document.exists?(
+			:document_file_name => "#{params[:id]}.#{params[:format]}")
+			documents = Document.find(:all, :conditions => {
+			:document_file_name => "#{params[:id]}.#{params[:format]}"})
+#	Due to the unique index, there can be only one!
+#			if documents.length > 1
+#				access_denied("More than one document matches #{params[:id]}!", 
+#					documents_path)
+#			else
+				@document=documents[0]
+#			end
+		else
+			access_denied("Valid document id required!", documents_path)
+		end
+	end
+
+end

data/app/models/document.rb

@@ -0,0 +1,28 @@
+require 'hmac-sha1'
+#
+#	http://amazon.rubyforge.org/
+#
+class Document < ActiveRecord::Base
+	belongs_to :owner, :polymorphic => true
+
+	validates_presence_of :title
+	validates_length_of :title, :minimum => 4
+
+	validates_uniqueness_of :document_file_name, :allow_nil => true
+
+	before_validation :nullify_blank_document_file_name
+
+	has_attached_file :document,
+		YAML::load(ERB.new(IO.read(File.expand_path(
+			File.join(File.dirname(__FILE__),'../..','config/document.yml')
+		))).result)[Rails.env]
+
+	def nullify_blank_document_file_name
+		self.document_file_name = nil if document_file_name.blank?
+	end
+
+	def to_s
+		title
+	end
+
+end

data/app/views/documents/_document.html.erb

@@ -0,0 +1,15 @@
+<% content_tag_for( :tr, document, :class => 'row' ) do %>
+<td class='title'>
+<%= link_to document.title, preview_document_path(document) %>
+</td>
+<td class='path'>
+<%= document.document_file_name %>
+</td>
+<td class='manage'>
+<%= button_link_to 'Edit', edit_document_path(document) %>&nbsp;
+<% destroy_link_to 'Destroy', document_path(document) do %>
+<%= hidden_field_tag 'confirm', "Destroy document '#{document}'?", 
+	:id => nil %>
+<% end %>
+</td>
+<% end %><!-- class='document row' -->

data/app/views/documents/_form.html.erb

@@ -0,0 +1,13 @@
+<% stylesheets('documents') %>
+
+<%= f.wrapped_text_field :title %>
+
+<div>
+<div class='document'>
+	<%= f.wrapped_file_field :document %>
+	<% unless @document.new_record? -%>
+		(<%= @document.document.url -%>)
+	<% end -%><br />
+</div>
+</div>
+<%= f.wrapped_text_area :abstract %>

data/app/views/documents/edit.html.erb

@@ -0,0 +1,14 @@
+<h2>Editing Document</h2>
+
+<% form_for(@document,
+		:html => { :multipart => true }) do |f| %>
+  <%= f.error_messages %>
+  <%= render 'form',:f => f %>
+<p>
+<%= f.submit( "Update this Document" )%>&nbsp;
+<%= button_link_to 'Preview this Document', 
+	preview_document_path(@document) %>&nbsp;
+<%= button_link_to 'Download this Document', @document %>&nbsp;
+<%= button_link_to 'Back to Documents', documents_path %>
+</p>
+<% end %>

data/app/views/documents/index.html.erb

@@ -0,0 +1,15 @@
+<% javascripts('simply_helpful') %>
+<% stylesheets('documents') %>
+
+<h2>Documents</h2>
+<% if @documents.length > 0 %>
+<table id='documents'><tbody>
+<%= render :partial => 'document', :collection => @documents %>
+</tbody></table><!-- id='documents' -->
+<% else %>
+Sorry, but no documents yet.
+<% end %>
+
+<p>
+<%= button_link_to 'Create New Document', new_document_path %>
+</p>

data/app/views/documents/new.html.erb

@@ -0,0 +1,11 @@
+<h2>New Document</h2>
+
+<% form_for(@document,
+		:html => { :multipart => true }) do |f| %>
+	<%= f.error_messages %>
+<%= render 'form',:f => f %>
+<p>
+<%= f.submit( "Create new Document" )%>
+<%= button_link_to 'Back to Documents', documents_path %>
+</p>
+<% end %>

data/app/views/documents/preview.html.erb

@@ -0,0 +1,17 @@
+<%# stylesheets('document') %>
+
+<p>
+  <b>Title:</b>
+  <%=h @document.title %>
+</p>
+
+<p>
+  <b>Abstract:</b>
+  <%=h @document.abstract %>
+</p>
+
+<%= button_link_to 'Download this Document', 
+	document_path(@document) %>&nbsp;
+<%= button_link_to 'Edit this Document', 
+	edit_document_path(@document) %>&nbsp;
+<%= button_link_to 'Back to Documents', documents_path %>

data/config/document.yml

@@ -0,0 +1,54 @@
+#DEFAULTS: &DEFAULTS
+#  :styles:
+#    :full: '900'
+#    :large: '800'
+#    :medium: '600'
+#    :small: '150x50'
+
+#	:attachment is the attachment name NOT the model name
+#	for document they are the same
+
+<% common = "documents/:id/:filename" %>
+
+#>> Rails.root.to_s.split('/')
+#=> ["", "var", "lib", "tomcat5", "webapps", "clic", "WEB-INF"]
+
+#>> Rails.root.to_s.split('/')
+#=> ["", "Users", "jakewendt", "github_repo", "jakewendt", "ucb_ccls_clic"]
+
+<% 
+app_name = ( defined?(RAILS_APP_NAME) ) ? 
+	RAILS_APP_NAME :
+	Rails.root.to_s.split('/').reject{|x|x ==  "WEB-INF"}.last 
+%>
+
+development:
+  :path: <%= "#{Rails.root}/development/#{common}" %>
+#  <<: *DEFAULTS
+
+test:
+  :path: <%= "#{Rails.root}/test/#{common}" %>
+#  <<: *DEFAULTS
+
+#production:
+#  :path: <%= "/home/tomcat/#{app_name}/:attachment/:id/:filename" %>
+##	#  <<: *DEFAULTS
+
+production:
+  #	Set the storage class to RRS which is cheaper than 
+  #	the default of STANDARD
+  :s3_headers:
+    x-amz-storage-class: REDUCED_REDUNDANCY
+  # public_read or private
+  :s3_permissions: :private
+  :storage: :s3
+  :s3_protocol: https
+  :s3_credentials: <%="#{Rails.root}/config/s3.yml" %>
+  :bucket: <%= app_name %>
+  #	common has a : as the first char so it needs special care
+  #	or the string will magically be turned into a symbol
+  #	which isn't what we want 
+  #	Not anymore.
+  :path: <%= common %>
+  # S3 must have a defined path or will generate
+  # "Stack level too deep" errors

data/config/routes.rb

@@ -0,0 +1,5 @@
+ActionController::Routing::Routes.draw do |map|
+
+	map.resources :documents, :member => { :preview => :get }
+
+end

data/generators/simply_documents/simply_documents_generator.rb

@@ -0,0 +1,87 @@
+class SimplyDocumentsGenerator < Rails::Generator::Base
+
+	def manifest
+		#	See Rails::Generator::Commands::Create
+		#	rails-2.3.10/lib/rails_generator/commands.rb
+		#	for code methods for record (Manifest)
+		record do |m|
+			m.directory('config/autotest')
+			m.file('autotest_simply_documents.rb', 'config/autotest/simply_documents.rb')
+			m.directory('lib/tasks')
+			m.file('simply_documents.rake', 'lib/tasks/simply_documents.rake')
+
+#			File.open('Rakefile','a'){|f| 
+#				f.puts <<-EOF
+##	From `script/generate simply_documents` ...
+#require 'simply_documents/test_tasks'
+#				EOF
+#			}
+#
+#			File.open('.autotest','a'){|f| 
+#				f.puts <<-EOF
+##	From `script/generate simply_documents` ...
+#require 'simply_documents/autotest'
+#				EOF
+#			}
+
+			%w( create_documents
+				add_attachments_document_to_document 
+				polymorphicize_document_owner
+				).each do |migration|
+				m.migration_template "migrations/#{migration}.rb",
+					'db/migrate', :migration_file_name => migration
+			end
+
+			m.directory('public/javascripts')
+			Dir["#{File.dirname(__FILE__)}/templates/javascripts/*js"].each{|file| 
+				f = file.split('/').slice(-2,2).join('/')
+				m.file(f, "public/javascripts/#{File.basename(file)}")
+			}
+			m.directory('public/stylesheets')
+			Dir["#{File.dirname(__FILE__)}/templates/stylesheets/*css"].each{|file| 
+				f = file.split('/').slice(-2,2).join('/')
+				m.file(f, "public/stylesheets/#{File.basename(file)}")
+			}
+#			m.directory('test/functional/documents')
+#			Dir["#{File.dirname(__FILE__)}/templates/functional/*rb"].each{|file| 
+#				f = file.split('/').slice(-2,2).join('/')
+#				m.file(f, "test/functional/documents/#{File.basename(file)}")
+#			}
+#			m.directory('test/unit/documents')
+#			Dir["#{File.dirname(__FILE__)}/templates/unit/*rb"].each{|file| 
+#				f = file.split('/').slice(-2,2).join('/')
+#				m.file(f, "test/unit/documents/#{File.basename(file)}")
+#			}
+		end
+	end
+
+end
+module Rails::Generator::Commands
+	class Create
+		def migration_template(relative_source, 
+				relative_destination, template_options = {})
+			migration_directory relative_destination
+			migration_file_name = template_options[
+				:migration_file_name] || file_name
+			if migration_exists?(migration_file_name)
+				puts "Another migration is already named #{migration_file_name}: #{existing_migrations(migration_file_name).first}: Skipping" 
+			else
+				template(relative_source, "#{relative_destination}/#{next_migration_string}_#{migration_file_name}.rb", template_options)
+			end
+		end
+	end #	Create
+	class Base
+	protected
+		#	the loop through migrations happens so fast
+		#	that they all have the same timestamp which
+		#	won't work when you actually try to migrate.
+		#	All the timestamps MUST be unique.
+		def next_migration_string(padding = 3)
+			@s = (!@s.nil?)? @s.to_i + 1 : if ActiveRecord::Base.timestamped_migrations
+				Time.now.utc.strftime("%Y%m%d%H%M%S")
+			else
+				"%.#{padding}d" % next_migration_number
+			end
+		end
+	end	#	Base
+end