subject 0.0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Benjamin Bock, Topic Maps Lab, http://www.topicmapslab.de
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,88 @@
+# subj3ct - The DNS for the Semantic Web
+
+This is a Ruby adapter for the subj3ct.com webservice.
+
+Subj3ct is an infrastructure technology for Web 3.0 applications. These are
+applications that are organised around subjects and semantics rather than
+documents and links. Subj3ct provides the technology and services to enable
+Web 3.0 applications to define and exchange subject definitions.
+
+Or in other words: Subj3ct.com is for the Semantic Web what DNS is for the internet.
+
+## Quick Links
+
+ * [Subj3ct.com](http://www.subj3ct.com/)
+ * [Wiki](http://wiki.github.com/bb/subj3ct)
+ * [Bugs](http://github.com/bb/subj3ct/issues)
+ * [Gem](http://rubygems.org/gems/subj3ct)
+
+## Installing
+
+Install the gem:
+
+    gem install subj3ct
+
+## Usage
+
+First, you have to require the library in your Ruby project (or directly in IRB):
+
+    require 'subj3ct'
+
+Then you can query the subj3ct.com webservice with different queries:
+
+Query a specific subject - to be specific: its subject identity record -  using it's identifier:
+
+     Subj3ct.identifier("http://www.topicmapslab.de/publications/TMRA_2009_subj3ct_a_subject_identity_resolution_service")
+
+Query all subjects associated with a given resource (i.e. with a given web address). The result is a list of subjects (without representation or equivalence statements):
+
+     Subj3ct.resource("http://en.wikipedia.org/wiki/Topic_Maps")
+
+To get the representation and equivalence statements for one of the results you can fetch the complete subject record:
+
+    result = Subj3ct.resource("http://en.wikipedia.org/wiki/Topic_Maps")
+    full_subject = result.subjects.first.fetch
+
+If you don't know a web address or identifier URI for the thing you're interested in, try a full text search:
+
+    Subj3ct.search("my query")
+
+To query a specific number of items at a time, the query methods `identifier`, `resource`, `starts_with` and `search` accept a keyword parameter `:take` to specify the maximum number of items to query. The maximum allowed take is 50.
+To display the results paginated, an offset, may be passed using the `:skip` keyword. The search results also feature methods like `fetch_next` to get the next page etc.. The following example fetches the first 5 pages, each page showing 3 results, then it fetches page 20:
+
+    result = Subj3ct.search("benjamin bock", :take => 3)
+    while result.next? && result.current_page < 5
+       result = result.fetch_next
+    end
+    
+    result.fetch_page(20)
+
+## Subj3ct vs. Subject
+
+The official name is "Subj3ct", however in this API, you can also use "Subject" which may be easier to remember or to type for normal, n0n-1337 people. It should work for the gem, for the require and for the main module.
+
+## Plans
+
+ * starts_with doesn't work at all. It looks like this is a server side problem.
+ * Documentation. Currently the code is barely documented, this should be changed soon.
+ * Write tests. Uh... of course we have tests... they're almost done...
+ * Write support. Currently this lib is only reading subj3ct.com. It should be able to register feeds with the service and to create a feed from existing data.
+ * Caching. A minimal caching solution should be built in.
+ * Reduce dependencies. Currently this lib uses active_support only for `blank?`. Instead of open-uri a direct HTTP call could be done.
+ * Threadsafe use of unencrypted and SSL usage in parallel. Due to the current architecture, you can't do SSL-encrypted and unencrypted queries in parallel in a threadsafe way. To work around that, the class methods should be moved to a query processor which should be instantiated and configured if this is needed.
+
+## Contribute!
+
+Subj3ct is a young and ambitious service. It's free, will stay free and needs your help. Contribute to this library! Create bindings for other languages! Publish your data as linked data to the web and register it with subj3ct.com.
+
+## Note on Patches/Pull Requests
+ 
+ * Fork the project.
+ * Make your feature addition or bug fix.
+ * Add tests for it. This is important so I don't break it in a future version unintentionally.
+ * Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+ * Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 Benjamin Bock, [Topic Maps Lab](http://www.topicmapslab.de/). See LICENSE for details.

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification 
+name: subject
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Benjamin Bock
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-15 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: subj3ct
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 29
+        segments: 
+        - 0
+        - 0
+        - 1
+        version: 0.0.1
+  type: :runtime
+  version_requirements: *id003
+description: |
+  ==== subj3ct - The DNS for the Semantic Web
+  
+  This is a Ruby adapter for the subj3ct.com webservice.
+  
+  Subj3ct is an infrastructure technology for Web 3.0 applications. These are
+  applications that are organised around subjects and semantics rather than
+  documents and links. Subj3ct provides the technology and services to enable
+  Web 3.0 applications to define and exchange subject definitions.
+  
+  Or in other words: Subj3ct.com is for the Semantic Web what DNS is for the internet.
+  
+  ==== Installing
+  
+  Install the gem:
+  
+      gem install subj3ct
+  
+  ==== Usage
+  
+  Query a specific subject - to be specific: its subject identity record -  using it's identifier:
+  
+   Subj3ct.identifier("http://www.topicmapslab.de/publications/TMRA_2009_subj3ct_a_subject_identity_resolution_service")
+  
+  See the README or the github page for more examples.
+  
+  ==== Subj3ct vs. Subject
+  
+  The official name is "Subj3ct", however in this API, you can also use "Subject" which may be easier to remember or to type for normal, n0n-1337 people. It should work for the gem, for the require and for the main module.
+  
+  ==== Contribute!
+  
+  Subj3ct is a young and ambitious service. It's free, will stay free and needs your help. Contribute to this library! Create bindings for other languages! Publish your data as linked data to the web and register it with subj3ct.com.
+  
+  ==== Note on Patches/Pull Requests
+   
+   * Fork the project on http://github.bb/subj3ct
+   * Make your feature addition or bug fix.
+   * Add tests for it. This is important so I don't break it in a future version unintentionally.
+   * Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+   * Send me a pull request. Bonus points for topic branches.
+  
+  ==== Copyright
+  
+  Copyright (c) 2010 Benjamin Bock, Topic Maps Lab. See LICENSE for details.
+
+email: bb--github.com@bock.be
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- LICENSE
+- README.markdown
+has_rdoc: true
+homepage: http://github.com/bb/subj3ct
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby bindings for Subj3ct.com, the DNS for the semantic web.
+test_files: []
+