wontomedia 0.0.1

data/README.markdown

@@ -0,0 +1,56 @@
+WontoMedia "README" file
+Copyright (C) 2010 - Glen E. Ivey
+  (see the end of this file for copyright/licensing information)
+
+
+## This is WontoMedia ##
+
+WontoMedia is a Ruby-on-Rails web app for community creation of an
+information classification scheme.  WontoMedia is free software
+(licensed under the AGPL v3), and is being developed by a dispersed
+volunteer team using agile methods.
+
+This README will be expanded as the project matures.  Until that time,
+you can find additional, general information in the following places:
+
+    http://wontomedia.rubyforge.org/
+    http://rubyforge.org/projects/wontomedia/
+    http://wiki.wontology.org/Main_Page
+
+In particular, simple installation instuctions are on the last page
+above, with more details at:
+
+    http://wiki.wontology.org/InstallFromScratch
+    http://wiki.wontology.org/SettingUpYourDevelopmentEnvironment
+
+Once you've got WontoMedia, you can find some design and workflow
+documentation in the WontoMedia source directory under the `doc`
+directory.  If you run the `rake doc:app` command, RDoc documentation
+will be extracted and can be viewed in a browser starting from
+`doc/app/index.html`.
+
+And if you have any questions or feedback about the projet, there are
+our:
+
+    forum        http://rubyforge.org/forum/?group_id=7903
+    email list   wontomedia-development at rubyforge dot org
+                 http://rubyforge.org/mail/?group_id=7903
+    bug tracker  http://rubyforge.org/tracker/?group_id=7903
+
+
+Finally, you can also find us at:
+
+    http://github.com/gleneivey/wontomedia/tree/master
+    http://www.pivotaltracker.com/projects/9280/stories
+    http://twitter.com/wontomedia
+
+----------------------------------------------------------------
+
+    Permission is granted to copy, distribute and/or modify this
+    document under the terms of the GNU Free Documentation License,
+    Version 1.3, published by the Free Software Foundation; with no
+    Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+
+    You should have received a copy of the GNU Free Documentation
+    License along with document in the file COPYING.DOCUMENTATION.  If
+    not, see <http://www.gnu.org/licenses/>.

data/Rakefile

@@ -0,0 +1,185 @@
+# WontoMedia - a wontology web application
+# Copyright (C) 2010 - Glen E. Ivey
+#    www.wontology.com
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License version
+# 3 as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program in the file COPYING and/or LICENSE.  If not,
+# see <http://www.gnu.org/licenses/>.
+
+
+require(File.join(File.dirname(__FILE__), 'config', 'boot'))
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'tasks/rails'
+
+if ENV["RAILS_ENV"].nil?
+  ENV["RAILS_ENV"] = RAILS_ENV = "test"
+end
+
+
+
+        ############################################################
+        # block to use Jeweler to generate our gemspec, gem, etc.
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name = "wontomedia"
+    s.rubyforge_project = "wontomedia"
+    s.summary = "WontoMedia is a Ruby-on-Rails web app for community creation of an information classification scheme"
+    s.description = <<-ENDOSTRING
+      WontoMedia is a Ruby-on-Rails web app for community creation of
+      an information classification scheme.  WontoMedia is free
+      software (licensed under the AGPL v3), and is being developed by
+      a dispersed volunteer team using agile methods.
+ENDOSTRING
+
+    s.email = "gleneivey@wontology.org"
+    s.homepage = "http://wontomedia.rubyforge.org"
+    s.authors = ["Glen E. Ivey"]
+
+    s.has_rdoc = true
+    s.extra_rdoc_files = ["README"]
+
+    s.files =  FileList["[A-Z]*", "assets/wontomedia-sample.rb",
+      "vendor/plugins/asset_packager/**/*", "doc/*", "doc/scripts/*",
+      "{app,config,bin,db,default-custom,generators,lib,public,script}/**/*"].
+        exclude("database.yml", "wontomedia.rb",
+            "**/*_packaged.js", "**/*_packaged.css"
+          ) do |maybe_exclude|
+	    File.symlink?( maybe_exclude )
+	  end
+    s.test_files = []
+    # Note: 1) Explicitly add any other non-testing packages under 'vendor'
+    # 2) Exclude all of our symbolic links
+    # 3)
+    #     .autotest cucumber.yml .gitignore
+    # the testing directories
+    #     deploy doc features policy test
+    # and the working/transitory directories
+    #     log pkg tmp
+    # aren't included because developers are expected to pull from Git
+
+    s.add_dependency 'rails', '~>2.2'
+  end
+
+  task :build => :gemspec    # don't build a gem from a stale spec
+  Jeweler::RubyforgeTasks.new do |rubyforge|
+    rubyforge.doc_task = "doc:app"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "WARNING: Missing development dependency.  'Jeweler' and/or 'rubyforge' not available. Install them with:\n    'sudo gem install rubyforge'\n    'sudo gem install technicalpickles-jeweler -s http://gems.github.com'"
+end
+
+
+  # documented rake_task.clear method missing?
+class Rake::Task
+  def clear!
+    @actions.clear
+    @prerequisites.clear
+  end
+end
+
+
+        ############################################################
+        # update default rake tasks for our test directory structure
+
+namespace :test do
+  # make test:units mean what it normally means
+  Rake::Task[:units].clear!
+  Rake::TestTask.new(:units => "db:test:prepare") do |t|
+    t.libs << "test"
+    t.pattern = 'test/unit/app/models/**/*_test.rb'
+    t.verbose = true
+  end
+  Rake::Task['test:units'].comment =
+    "Run the model tests in test/unit/app/models"
+end
+
+
+        ############################################################
+        # new rake tasks for our unit-like tests
+
+namespace :test do
+  Rake::TestTask.new(:views => "db:test:prepare") do |t|
+    t.libs << "test"
+    t.pattern = 'test/unit/app/views/**/*_test.rb'
+    t.verbose = true
+  end
+  Rake::Task['test:views'].comment =
+    "Run the view unit tests (test/unit/app/views/**/*_test.rb)"
+
+  Rake::TestTask.new(:helpers => "db:test:prepare") do |t|
+    t.libs << "test"
+    t.pattern = 'test/unit/app/helpers/**/*_test.rb'
+    t.verbose = true
+  end
+  Rake::Task['test:helpers'].comment =
+    "Run the view-helper unit tests (test/unit/app/helpers/**/*_test.rb)"
+
+  Rake::TestTask.new(:dbunits => "db:test:prepare") do |t|
+    t.libs << "test"
+    t.pattern = 'test/unit/db/**/*_test.rb'
+    t.verbose = true
+  end
+  Rake::Task['test:dbunits'].comment =
+    "Run the database unit tests (test/unit/db/**/*_test.rb)"
+
+    # Note: migration tests using migration_test_helper disrupts
+    # loaded fixtures, so can't run in same Ruby process as other unit
+    # tests, which breaking into separate rake task accomplishes
+  Rake::TestTask.new(:dbmigrations => "db:test:prepare") do |t|
+    t.libs << "test"
+    t.pattern = 'test/db_migrations_test.rb'
+    t.verbose = true
+  end
+  Rake::Task['test:dbmigrations'].comment =
+    "Run the database migration unit test (test/db_migrations_test.rb)"
+
+  task :db => [ "test:dbunits", "test:dbmigrations" ]
+  Rake::Task['test:db'].comment =
+    "Run database tests (test:dbunits, test:dbmigrations)"
+
+
+        ############################################################
+        # now some new "umbrella" test tasks
+
+  desc "Execute all development tests in test/unit."
+  Rake::TestTask.new(:dev => "db:test:prepare") do |t|
+    t.libs << "test"
+    t.pattern = 'test/unit/**/*_test.rb'
+    t.verbose = true
+  end
+
+  desc "Execute all project-policy audit tests."
+  task :policies do
+    ruby File.join( "policy", "ckFilesUtils", "buildLinksIgnoreFile.rb" )
+    ruby File.join( "policy", "ckFilesUtils", "ckForTabs.rb" )
+    ruby File.join( "policy", "ckFilesUtils", "ckCopyrightNotices.rb" )
+    ruby File.join( "policy", "ckFilesUtils", "ckCustomizationFilesPresent.rb" )
+  end
+
+  desc "Execute all the tests for Ruby code."
+  task :ruby => [ "test:dev", "test:dbmigrations", "test:functionals",
+    "test:integration", "build", "cucumber:static_ok"]
+end # namespace :test
+
+
+
+# redefine Rail's basic test task so that we get a reasonable execution order
+Rake::Task[:test].clear!
+desc 'Run all unit, functional, integration, and policy checks'
+task :test => [ "test:policies", "asset:packager:build_all", "test:dev",
+                "test:dbmigrations", "test:functionals", "test:javascripts",
+                "test:integration", "build", "cucumber:ok" ]

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 0
+:minor: 0
+:patch: 1

data/app/controllers/admin_controller.rb

@@ -0,0 +1,144 @@
+#--
+# WontoMedia - a wontology web application
+# Copyright (C) 2010 - Glen E. Ivey
+#    www.wontology.com
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License version
+# 3 as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program in the file COPYING and/or LICENSE.  If not,
+# see <http://www.gnu.org/licenses/>.
+#++
+
+
+require 'yaml'
+
+# There is no model matching this controller.  It is intended to
+# provide access to and processing of pages used to administer a
+# WontoMedia installation.
+class AdminController < ApplicationController
+
+  # GET /admin/
+  #
+  # This action renders the primary administration page.  This page
+  # includes links to <tt>/items.yaml</tt> and
+  # <tt>/connections.n3</tt> so that an administrator can download the
+  # complete content of a wontology for backup.  It also includes form
+  # controls for uploading <tt>.yaml</tt> files of Item records and
+  # <tt>.n3</tt> files of Connection records to be added to the
+  # installation's database.
+  def index
+    @this_is_non_information_page = true
+  end
+
+  # POST /admin/item_up
+  #
+  # This is a form processing action supporting a file-upload control
+  # for <tt>.yaml</tt> files of Items.
+  def item_up
+    @this_is_non_information_page = true
+    count = 0
+    flash[:error] ||= ""
+    YAML::load(params[:item_upload][:itemfile]).each do |item|
+
+      if item.is_a? Item
+        # need to create a new item object so that it saves to db as "new"
+        item_hash = ItemHelper.item_to_hash(item)
+        name = item.name
+      elsif item.is_a? YAML::Object
+        # this is magic dependent on the internals of the YAML::Object class
+        item_hash = item.instance_eval { @ivars }['attributes']
+        name = item_hash['name'] || item_hash[:name]
+      else
+        flash[:error] <<
+          "YAML parser generated an object of type '#{item.class}'.\n"
+        redirect_to :action => 'index'
+        return
+      end
+
+      n = ItemHelper.new_typed_item(
+        item_hash['sti_type'] || item_hash[:sti_type] )
+      if n.nil?
+        err_str = "No/bad sti_type for item '#{name}', " +
+          "tried to create '#{item_hash.inspect}'.\n"
+        logger.error(err_str)
+        flash[:error] << err_str
+      else
+        # even if ID present, don't copy; let db assign a new value
+        n.name        = name
+        n.title       = item_hash['title']       || item_hash[:title]
+        n.description = item_hash['description'] || item_hash[:description]
+        n.flags       = item_hash['flags']       || item_hash[:flags]
+        if n.flags.nil?
+          n.flags = 0
+        end
+
+        if n.save
+          count += 1
+        else
+          err_str = "Could not save item named 'n.name': #{n.errors.inspect}\n"
+          logger.error(err_str)
+          flash[:error] << err_str
+        end
+      end
+    end
+
+    flash[:notice] = "Created #{count} new items."
+    redirect_to :action => 'index'
+  end
+
+  # POST /admin/connection_up
+  #
+  # This is a form processing action supporting a file-upload control
+  # for <tt>.n3</tt> files of Connections.  <b>Note</b> that
+  # WontoMedia currently uses a <em>trivial, fragile</em> N3 processor
+  # that is unlikely to process N3 files other than those that
+  # WontoMedia produces.
+  def connection_up
+    @this_is_non_information_page = true
+    count = unparsed = 0
+    flash[:error] =""
+
+    params[:connection_upload][:connectionfile].readlines.each do |n3line|
+      # this is a really, *really* bad N3 parser. Almost certainly won't
+      # handly any but the most trivial input (like what we export :-)
+      if n3line =~ /<#([^>]+)>[^<]+<#([^>]+)>[^<]+<#([^>]+)>[^.]+\./
+        e = Connection.new(
+          :subject   => Item.find_by_name($1),
+          :predicate => Item.find_by_name($2),
+          :obj       => Item.find_by_name($3),
+          :flags     => 0
+                     )
+        if e.nil?
+          err_stry = "Couldn't create connection for #{$1} #{$2} #{$3}.\n"
+          logger.error(err_str)
+          flash[:error] << err_str
+        else
+          if e.save
+            count += 1
+          else
+            err_stry = "Couldn't save connection for #{$1} #{$2} #{$3}.\n"
+            logger.error(err_str)
+            flash[:error] << err_str
+          end
+        end
+      else
+        unparsed += 1
+      end
+    end
+
+    flash[:notice] = "Created #{count} new connections."
+    if unparsed > 0
+      flash[:notice] <<
+        "(Discarded #{unparsed} non-connection lines from input file)"
+    end
+    redirect_to :action => 'index'
+  end
+end

data/app/controllers/application_controller.rb

@@ -0,0 +1,29 @@
+#--
+# WontoMedia - a wontology web application
+# Copyright (C) 2010 - Glen E. Ivey
+#    www.wontology.com
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License version
+# 3 as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program in the file COPYING and/or LICENSE.  If not,
+# see <http://www.gnu.org/licenses/>.
+#++
+
+
+# This is the Rails-standard ApplicationController class, which
+# inherits from <tt>ActionController::Base</tt> and is the base class
+# for all of WontoMedia's controller classes.  See the source for
+# WontoMedia's global controller configuration.
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+  protect_from_forgery
+  filter_parameter_logging :password
+end

data/app/controllers/connections_controller.rb

@@ -0,0 +1,150 @@
+#--
+# WontoMedia - a wontology web application
+# Copyright (C) 2010 - Glen E. Ivey
+#    www.wontology.com
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License version
+# 3 as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program in the file COPYING and/or LICENSE.  If not,
+# see <http://www.gnu.org/licenses/>.
+#++
+
+
+require Rails.root.join( 'lib', 'helpers', 'connection_helper')
+
+# See also the matching model Connection
+class ConnectionsController < ApplicationController
+  Mime::Type.register "application/x-n3", :n3
+
+
+  # GET /connections
+  #
+  # Note that +index+ is capable of rendering in multiple
+  # formats. <tt>/connections</tt> and <tt>/connections.html</tt>
+  # yield a human-readable page in HTML markup.
+  # <tt>/connections.n3</tt> renders all Connections in the database
+  # as N3-format text, with no additional prose or links intended for
+  # users.  For more information on N3 (Notation3) see
+  # http://en.wikipedia.org/wiki/Notation3.  Note that, in order to
+  # support this, this controller registers the MIME type
+  # <tt>application/x-n3</tt> with Rails, and associates it with the
+  # <tt>.n3</tt> file extension.
+  def index
+    @connections = Connection.all.reverse
+    respond_to do |wants|
+      wants.html
+      wants.n3 do
+        con = @connections.reject { |connection|
+          (connection.flags & Connection::DATA_IS_UNALTERABLE) != 0 }
+        render :text => ConnectionHelper.connection_array_to_n3(con)
+      end
+    end
+  end
+
+  # GET /connections/new
+  def new
+    @this_is_non_information_page = true
+    @connection = Connection.new
+    populate_for_new_update
+  end
+
+  # POST /connections
+  def create
+    @connection = Connection.new(params[:connection])
+    @connection.flags = 0
+
+    if @connection.save
+      flash[:notice] = 'Connection was successfully created.'
+      redirect_to(@connection)
+    else
+      populate_for_new_update
+      @this_is_non_information_page = true
+      render :action => "new"
+    end
+  end
+
+  # GET /connections/1
+  def show
+    # set @connection for view to use for link building
+    begin
+      @connection = Connection.find(params[:id])
+    rescue
+      render :file => "#{RAILS_ROOT}/public/404.html", :status => 404
+      return
+    end
+
+    # populate these here because I didn't want view causing db queries
+    @subject = @connection.subject
+    @predicate = @connection.predicate
+    @obj = @connection.obj
+    @connection_desc = @connection.connection_desc
+  end
+
+  # GET /connections/1/edit
+  def edit
+    begin
+      @this_is_non_information_page = true
+      @connection = Connection.find(params[:id])
+    rescue
+      render :file => "#{RAILS_ROOT}/public/404.html", :status => 404
+      return
+    end
+
+    populate_for_new_update
+  end
+
+  # PUT /connections/1
+  def update
+    begin
+      @connection = Connection.find(params[:id])
+    rescue
+      render :file => "#{RAILS_ROOT}/public/404.html", :status => 404
+      return
+    end
+
+    if (@connection.flags & Connection::DATA_IS_UNALTERABLE) != 0
+      flash[:error] = 'This Connection cannot be altered.'
+      redirect_to connection_path(@connection)
+    elsif !@connection.update_attributes(params[:connection])
+      populate_for_new_update
+      @this_is_non_information_page = true
+      render :action => "edit"
+    else
+      flash[:notice] = 'Connection was successfully updated.'
+      redirect_to connection_path(@connection)
+    end
+  end
+
+  # DELETE /connections/1
+  def destroy
+    begin
+      @connection = Connection.find(params[:id])
+    rescue
+      render :file => "#{RAILS_ROOT}/public/404.html", :status => 404
+      return
+    end
+
+    if (@connection.flags & Connection::DATA_IS_UNALTERABLE) != 0
+      flash[:error] = 'This Connection cannot be altered.'
+      redirect_to connection_path(@connection)
+    else
+      @connection.destroy
+      redirect_to connections_url
+    end
+  end
+
+private
+
+  def populate_for_new_update
+    @items = ItemHelper.not_qualified
+    @verbs = PropertyItem.all
+  end
+end