yowl 0.4 → 0.4.1

checksums.yaml

@@ -0,0 +1,7 @@
+--- 
+SHA512: 
+  data.tar.gz: 23738f36ee9394b25bc5565b4ea4c0cdfc321a1c1ffe9753ee98bac5c1889fd9fba8ccdd2bd01c0545e95771b6600735e64113126dd807e8310cb9b7c48baf7b
+  metadata.gz: 743c59d56158eb0fa3560d7b29a8f71c7ad2e6aa3285492d1e04787715ad5f68347bcd69fbdb2bc4580dc820ca1207bbf5207b291e58bf679f5eec2368b4e5fa
+SHA1: 
+  data.tar.gz: 2fdfede9583613123938630b4af046c6dfd79dcf
+  metadata.gz: f78fbc86b4e91a602357efa863ec60b1b892cfec

data/CHANGES

@@ -1,3 +1,7 @@
+0.4.1
+
+- Resolve depencies using RubyGems
+- Add bash script for fast source installation of libraptor1
 
 0.4
 

data/README.md

@@ -1,6 +1,6 @@
-# YOWL
+# YOWL: Yet another OWL documentor
 
-Yet another OWL documentor. YOWL is a command line utility that can read a number of
+YOWL is a command line utility that can read a number of
 RDFS/OWL files, called the repository, and generate a documentation website from it,
 with visualisations like Class Diagrams (as SVG), Individuals Diagrams and Import Diagrams.
 
@@ -14,60 +14,55 @@ It also detects annotations from the following public ontologies:
   
 This is a fork of the original DOWL project at https://github.com/ldodds/dowl.
 
-# INSTALLATION
+## INSTALLATION
 
-## Installation on Mac OS X:
+### Install WGET, GraphViz, libraptor1:
 
-[Installation on Mac OS X](/jgeluk/yowl/blob/master/INSTALL-MACOSX.md)
+#### OS X
+You can do this using [macports](http://www.macports.org/install.php) or [homebrew](http://mxcl.github.com/homebrew/).
 
-## Installation on Ubuntu
-
-```bash
-apt-get install ruby rake gem
+Macports:
+```sh
+$ sudo port install wget graphviz
 ```
 
-## General
-
-Install all libraries used by YOWL:
+Homebrew:
+```sh
+$ sudo brew install wget graphviz
+```
 
-```bash
-[sudo] gem install ffi rdf rdf-raptor rdf-json rdf-trix sxp sparql ruby-graphviz
+Unfortunately, there is no clean way (as far as we know) to install libraptor1 via a package manager on OS X. Therefore we wrote a small shell script, `install-raptor.sh` to do it for you. 
+```sh
+$ sudo curl -k https://raw.github.com/jgeluk/yowl/build-sanity/install-raptor.sh | bash
 ```
 
-This version of YOWL is not yet available as a "gem" itself so it needs to be downloaded from Github:
+#### Ubuntu
 
 ```bash
-mkdir ~/downloads
-cd ~/downloads
-wget http://github.com/jgeluk/yowl/tarball/master -O yowl.tar.gz
-tar xvf yowl.tar.gz
-#
-# Remember the name of the root directory of the unpacked tarball
-# which looks like jgeluk-yowl-5ba77f5
-#
-sudo rm -rf /opt/yowl
-sudo mv ~/downloads/jgeluk-yowl-5ba77f5 /opt/yowl
-cd /opt/yowl
-sudo rake install
+$ sudo apt-get install wget graphviz libraptor1 rubygems
 ```
 
-Or get it with git:
+### Install via RubyGems
+```sh
+$ gem install yowl
+```
 
-```bash
-rm -rf /opt/yowl
-cd /opt
-git clone git@github.com:jgeluk/yowl.git
-cd /opt/yowl
-sudo rake install
+### Bleeding Edge/Development Builds
+```sh
+$ git clone https://github.com/jgeluk/yowl.git
+$ cd yowl/
+$ gem build yowl.gemspec
+$ gem install yowl
 ```
 
-# Usage
+## Usage
 
-Execute bin/yowl to see usage options:
+Execute `yowl -h` to see usage options:
 
 ```bash
-user@host:/opt/yowl# /opt/yowl/bin/yowl 
-Output will be generated in this directory: /opt/yowl
+$ yowl
+yowl [VERSION_WILL_APPEAR_HERE]
+
 Usage: YOWL [<options>]
 
 Specific options:
@@ -80,13 +75,13 @@ Common options:
     -?, -h, --help                   Show this message
     -V, --version                    Show version
     -v, --verbose                    Show verbose logging
+    -q, --quiet                      Suppress most logging
 ```
 
 For example, to generate a site for the PROV ontology,
 download the prov owl file and run YOWL as follows:
 
 ```bash
-/opt/yowl/bin/yowl -i /root/downloads/prov/*.owl -o /var/www/prov
+$ yowl -i /path/to/prov/*.owl -o /var/www/prov
 ```
 
-

data/Rakefile

@@ -1,58 +1,17 @@
 require 'rake'
-require 'rubygems'
-require 'rubygems/package_task'
 require 'rdoc/task'
 require 'rake/testtask'
 require 'rake/clean'
+if RUBY_VERSION < "1.9.2"
+  require "lib/yowl/version"
+else
+  require_relative "lib/yowl/version"
+end
 
-NAME = "yowl"
-VER = "0.4.pre"
-
-RDOC_OPTS = ['--quiet', '--title', 'yowl reference', '--main', 'README.md']
-
-PKG_FILES = %w(README.md INSTALL-MACOSX.md Rakefile CHANGES) + 
-  Dir.glob("{bin,test,examples,lib}/**/*")
+RDOC_OPTS = ['--quiet', '--title', '#{YOWL::NAME} reference', '--main', 'README.md']
 
 CLEAN.include ['*.gem', 'pkg']
 
-SPEC = Gem::Specification.new do |s|
-  s.platform = Gem::Platform::RUBY
-  s.summary = 'OWL visualization and documentation generator'
-  s.description = <<-EOF
-    Yet another OWL documentor. YOWL is a command line utility that can read a number of RDFS/OWL files, 
-    called the repository, and generate a documentation website from it, with visualisations like
-    Class Diagrams (as SVG), Individuals Diagrams and Import Diagrams.
-  EOF
-  s.name = NAME
-  s.version = VER
-  s.required_ruby_version = ">= 1.8.7"    
-  s.has_rdoc = true
-  s.extra_rdoc_files = ["README.md", "INSTALL-MACOSX.md", "CHANGES"]
-  s.rdoc_options = RDOC_OPTS
-  s.authors = ['Leigh Dodds', 'Jacobus Geluk']
-  s.email = ['leigh.dodds@talis.com', 'jacobus.geluk@gmail.com']
-  s.homepage = 'http://github.com/jgeluk/yowl'
-  s.files = PKG_FILES
-  s.require_path = "lib" 
-  s.bindir = "bin"
-  s.executables = ["yowl"]
-  s.test_file = "test/test_yowl.rb"
-  s.add_dependency("rdf-raptor", ">= 0.4.0")
-  s.add_dependency("ffi", ">= 1.1.5")
-  s.add_dependency("rdf", ">= 0.3.8")
-  s.add_dependency("rdf-raptor", ">= 0.4.2")
-  s.add_dependency("rdf-json", ">= 0.3.0")
-  s.add_dependency("rdf-trix", ">= 0.3.0")
-  s.add_dependency("sxp", ">= 0.0.14")
-  s.add_dependency("sparql", ">= 0.3.1")
-  s.add_dependency("ruby-graphviz", ">= 1.0.8")
-  s.rubyforge_project = 'nowarning'
-end
-      
-Gem::PackageTask.new(SPEC) do |pkg|
-    pkg.need_tar = true
-end
-
 RDoc::Task.new do |rdoc|
     rdoc.rdoc_dir = 'doc/rdoc'
     rdoc.options += RDOC_OPTS
@@ -64,13 +23,3 @@ Rake::TestTask.new do |test|
   test.verbose = true
 end
 
-desc "Install from a locally built copy of the gem"
-task :install do
-  sh %{rake package}
-  sh %{sudo gem install pkg/#{NAME}-#{VER}}
-end
-
-desc "Uninstall the gem"
-task :uninstall => [:clean] do
-  sh %{sudo gem uninstall #{NAME}}
-end

data/lib/yowl/version.rb

@@ -1,8 +1,8 @@
 module YOWL
   
   NAME = "yowl"
-  VERSION = "0.4"
+  VERSION = "0.4.1"
   
   NAME_AND_VERSION = "#{NAME} #{VERSION}"
   
-end
+end

metadata

@@ -1,51 +1,35 @@
 --- !ruby/object:Gem::Specification 
 name: yowl
 version: !ruby/object:Gem::Version 
-  hash: 3
-  prerelease: 
-  segments: 
-  - 0
-  - 4
-  version: "0.4"
+  version: 0.4.1
 platform: ruby
 authors: 
 - Leigh Dodds
 - Jacobus Geluk
+- Travis Kaufman
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2012-11-25 00:00:00 Z
+date: 2013-02-27 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: ffi
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 25
-        segments: 
-        - 1
-        - 1
-        - 5
-        version: 1.1.5
+        version: 1.2.0
   type: :runtime
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: json
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 1
-        segments: 
-        - 1
-        - 7
-        - 5
         version: 1.7.5
   type: :runtime
   version_requirements: *id002
@@ -53,15 +37,9 @@ dependencies:
   name: rdf
   prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        - 3
-        - 8
         version: 0.3.8
   type: :runtime
   version_requirements: *id003
@@ -69,15 +47,9 @@ dependencies:
   name: rdf-raptor
   prerelease: false
   requirement: &id004 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 11
-        segments: 
-        - 0
-        - 4
-        - 2
         version: 0.4.2
   type: :runtime
   version_requirements: *id004
@@ -85,15 +57,9 @@ dependencies:
   name: rdf-json
   prerelease: false
   requirement: &id005 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 19
-        segments: 
-        - 0
-        - 3
-        - 0
         version: 0.3.0
   type: :runtime
   version_requirements: *id005
@@ -101,15 +67,9 @@ dependencies:
   name: rdf-trix
   prerelease: false
   requirement: &id006 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 19
-        segments: 
-        - 0
-        - 3
-        - 0
         version: 0.3.0
   type: :runtime
   version_requirements: *id006
@@ -117,15 +77,9 @@ dependencies:
   name: rdf-xsd
   prerelease: false
   requirement: &id007 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        - 3
-        - 8
         version: 0.3.8
   type: :runtime
   version_requirements: *id007
@@ -133,65 +87,56 @@ dependencies:
   name: sxp
   prerelease: false
   requirement: &id008 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        - 0
-        - 14
         version: 0.0.14
   type: :runtime
   version_requirements: *id008
 - !ruby/object:Gem::Dependency 
-  name: sparql
+  name: sparql-client
   prerelease: false
   requirement: &id009 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 17
-        segments: 
-        - 0
-        - 3
-        - 1
-        version: 0.3.1
+        version: 0.3.0
   type: :runtime
   version_requirements: *id009
 - !ruby/object:Gem::Dependency 
-  name: ruby-graphviz
+  name: sparql
   prerelease: false
   requirement: &id010 !ruby/object:Gem::Requirement 
-    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.3.1
+  type: :runtime
+  version_requirements: *id010
+- !ruby/object:Gem::Dependency 
+  name: ruby-graphviz
+  prerelease: false
+  requirement: &id011 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 7
-        segments: 
-        - 1
-        - 0
-        - 8
         version: 1.0.8
   type: :runtime
-  version_requirements: *id010
-description: "    Yet another OWL documentor. YOWL is a command line utility that can read a number of RDFS/OWL files, \n    called the repository, and generate a documentation website from it, with visualisations like\n    Class Diagrams (as SVG), Individuals Diagrams and Import Diagrams.\n"
+  version_requirements: *id011
+description: "    Yet another OWL documentor. YOWL is a command line utility that can read a number of RDFS/OWL files,\n    called the repository, and generate a documentation website from it, with visualisations like\n    Class Diagrams (as SVG), Individuals Diagrams and Import Diagrams.\n"
 email: 
 - leigh.dodds@talis.com
 - jacobus.geluk@gmail.com
+- travis.kaufman@gmail.com
 executables: 
 - yowl
 extensions: []
 
 extra_rdoc_files: 
 - README.md
-- INSTALL-MACOSX.md
 - CHANGES
 files: 
 - README.md
-- INSTALL-MACOSX.md
 - Rakefile
 - CHANGES
 - bin/yowl
@@ -297,44 +242,35 @@ files:
 - lib/yowl/util.rb
 - lib/yowl/version.rb
 - lib/yowl.rb
-homepage: http://github.com/jgeluk/yowl
-licenses: []
+homepage: http://github.com/jgeluk/#{YOWL::NAME}
+licenses: 
+- MIT
+metadata: {}
 
 post_install_message: 
 rdoc_options: 
 - --quiet
 - --title
-- yowl reference
+- "#{YOWL::NAME} reference"
 - --main
-- README.md
+- " README.md"
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
-  - - ">="
+  - &id012 
+    - ">="
     - !ruby/object:Gem::Version 
-      hash: 57
-      segments: 
-      - 1
-      - 8
-      - 7
-      version: 1.8.7
+      version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  - *id012
 requirements: []
 
 rubyforge_project: nowarning
-rubygems_version: 1.8.24
+rubygems_version: 2.0.0
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: OWL visualization and documentation generator
 test_files: 
 - test/test_yowl.rb

data/INSTALL-MACOSX.md

@@ -1,109 +0,0 @@
-# Installation on Mac OS X
-
-Unfortunately, its not trivial to get YOWL to run on Mac OS X.
-
-You can either use MacPorts or HomeBrew to install some of the components that YOWL needs (graphviz
-and wget) and we also need Fink (for libraptor version 1).
-
-## MacPorts
-
-You first have to download and install MacPorts: http://www.macports.org/install.php
-
-Then use MacPorts to install GraphViz (which is used to generate the graphics) and wget:
-
-```
-sudo port install graphviz wget
-```
-
-## HomeBrew
-
-As an alternative to MacPorts, you can install HomeBrew and use that to install Graphviz,
-for installation instructions of HomeBrew look [here](https://github.com/mxcl/homebrew/wiki/Installation)
-or [here](http://mxcl.github.com/homebrew/).
-
-Once Brew is installed, install Graphviz and wget as follows:
-
-```
-sudo brew install graphviz wget
-```
-
-## Raptor 1
-
-YOWL depends on the Ruby package "ruby-rdf" which in turn depends on a C library called "raptor".
-Unfortunately, MacPorts recently dropped support for the older version of Raptor (version 1) that
-is used by ruby-rdf, so MacPorts can only install version 2, which is not compatible with ruby-rdf,
-so don't bother to install it.
-Another well known package manager for Mac OS X, HomeBrew, also can only install version 2
-of libraptor.
-
-There are two solutions available at this point (unless you have a better idea):
-
-### Building libraptor version 1 from source
-
-```
-mkdir -p ~/Work/build
-cd ~/Work/build
-wget http://download.librdf.org/source/raptor-1.4.21.tar.gz
-tar xvf raptor-1.4.21.tar.gz 
-cd raptor-1.4.21
-./configure "CPPFLAGS=-I/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk/usr/include"
-make
-sudo make install
-```
-
-As you can see in the configure line above, the build procedure assumes that you have Xcode installed, where it tries to find "curl/types.h".
-If you have this file installed elsewhere then change that location on the configure line. 
-One way to find "curl/types.h" is:
-
-```
-sudo locate types.h | grep curl
-```
-
-Or
-
-```
-sudo find /usr /opt /sw /Applications -name 'types.h' | grep curl
-```
-
-### Installing libraptor version 1 with Fink
-
-Besides MacPorts and HomeBrew, there's also Fink. Go to the Fink website, download
-and install Fink and then type:
-
-```
-sudo fink selfupdate
-sudo fink install raptor-bin
-```
-
-This will fail on Mac OS X Mountain Lion (10.8.x or later) because the raptor package
-as defined by Fink is dependent on an older version of curl, which does no longer have
-the "curl/types.h" file, which is needed by raptor, unless you configure it a bit
-differently:
-
-Open the Fink package file for raptor:
-
-```
-sudo vi /sw/fink/10.7/stable/main/finkinfo/libs/libraptor1-shlibs.info
-```
-
-Find the line that starts with "ConfigureParams:" and add the option --with-www=xml so
-that it looks as follows:
-```
-ConfigureParams: --enable-dependency-tracking --disable-static --enable-gtk-doc --with-www=xml
-```
-
-Then save the file and execute the following:
-
-```
-sudo fink rebuildpackage raptor-bin
-sudo fink install raptor-bin
-sudo ln -s /sw/lib/libraptor.1.dylib /usr/lib/libraptor.dylib
-```
-
-## Gems
-
-YOWL depends on various "ruby gems" that can be installed as follows:
-
-```
-sudo gem install ffi rdf rdf-raptor rdf-json rdf-trix sxp sparql ruby-graphviz
-```