hypothesis 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9c94a80a10fbaf61310d93b0faeb5d11e32b08d0
+  data.tar.gz: f7230d2e87642a4c2e126759f7e3d8ac574f50f1
+SHA512:
+  metadata.gz: 6e8a14f333d98897609163da4d16daf3c61a4f28c9508d60e78250a851704cd5563cc1f62a418ef80955309fe808afb04dcfdd259b8c5611ec0e48d05c3ecc7c
+  data.tar.gz: bb5691fb09a333d00d39f452dd747d8248e63b6c7b98aaba47a12e403022117a9a507ccb3f3d43c5e72cdebbc93f0ac5334b33350e5f2c72bc6484ed4411ae0a

data/README.md

@@ -0,0 +1,29 @@
+Unofficial [hypothesis](https://hypothes.is) ruby gem.
+
+### Installation
+
+```gem install hypothesis```
+
+### Usage
+
+You'll need to generate an API token on your [Hypothesis developer page](https://hypothes.is/account/developer).
+
+
+```ruby
+require 'rubygems'
+require 'hypothesis'
+
+hypothesis = Hypothesis::API.new('YOUR_HYPOTHESIS_API_KEY')
+puts hypothesis.search({ user: 'javier', limit: 10 })
+
+```
+
+That will output a JSON with the found items:
+
+```ruby
+ => {"rows"=>[{"updated"=>"2016-08-21T13:08:33.877253+00:00", "group"=>"__world__", "target"=>[{"source"=>"http://thelongandshort.org/society/war-on-cash", "selector"=>[{"endContainer"=>"/main[1]/article[1]/div[1]/div[6]/div[1]/p[3]", "startContainer"=>"/main[1]/article[1]/div[1]/div[6]/div[1]/p[3]", "type"=>"RangeSelector", "startOffset"=>0, "endOffset"=>368}, {"type"=>"TextPositionSelector", "end"=>9811, "start"=>9443}, {"exact"=>"Anyone defending cash in this context will be labelled as an anti-progress, reactionary, and nostalgic Luddite. That's why we must not defend cash. Rather, we should focus on pointing out that the Death of Cash means the Rise of Something Else. We are fighting a broader battle to maintain alternatives to the growing digital panopticon that is emerging all around us.", "prefix"=>"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n", "type"=>"TextQuoteSelector", "suffix"=>"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"}]}], "links"=>{"json"=>"https://hypothes.is/api/annotations/XUdzmGegAeaMle8incguxg", "html"=>"https://hypothes.is/a/XUdzmGegEeaNle8inzguxg", "incontext"=>"https://hyp.is/XUdzmGegAeaMle8incguxg/thelongandshort.org/society/war-on-cash"}, "tags"=>[], "text"=>"", "created"=>"2016-08-21T13:08:33.877245+00:00", "uri"=>"http://thelongandshort.org/society/war-on-cash", "user"=>"acct:javier@hypothes.is", "document"=>{"title"=>["The War on Cash"]}, "id"=>"XUdzmGegAeaMle8incguxg", "permissions"=>{"read"=>["acct:javier@hypothes.is"], "admin"=>["acct:javier@hypothes.is"], "update"=>["acct:javier@hypothes.is"], "delete"=>["acct:javier@hypothes.is"]}}], "total"=>1}
+```
+
+### API reference
+
+[The Hypothesis API](https://h.readthedocs.io/en/latest/api/)

data/bin/hypothesis

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+
+require 'hypothesis'
+Hypothesis::CLI.start(ARGV)

data/lib/hypothesis/api.rb

@@ -0,0 +1,43 @@
+require 'logger'
+require 'httparty'
+
+module Hypothesis
+  class API
+    BASE_ENDPOINT = 'https://hypothes.is/api/'.freeze
+    SEARCH_ENDPOINT = 'search'.freeze
+    ANNOTATIONS_ENDPOINT = 'annotations/'.freeze
+
+    def initialize(api_key)
+      @api_key = api_key
+    end
+
+    def root
+      get(BASE_ENDPOINT)
+    rescue => e
+      { error: e }
+    end
+
+    def search(params = {})
+      get(BASE_ENDPOINT + SEARCH_ENDPOINT, params)
+    rescue => e
+      { error: e }
+    end
+
+    def read(id)
+      get(BASE_ENDPOINT + ANNOTATIONS_ENDPOINT + id)
+    rescue => e
+      { error: e }
+    end
+
+    private
+
+    def get(url, options = {})
+      header = @api_key ? { 'Authorization' => 'Bearer ' + @api_key } : {}
+      HTTParty.get(url, query: options, headers: header).parsed_response
+    end
+
+    def log(msg)
+      puts msg if Hypothesis.log
+    end
+  end
+end

data/lib/hypothesis/version.rb

@@ -0,0 +1,3 @@
+module Hypothesis
+  VERSION = '0.0.1'.freeze
+end

data/lib/hypothesis.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+require_relative 'hypothesis/version'
+require_relative 'hypothesis/api'
+
+module Hypothesis
+  class << self
+    attr_accessor :log
+    attr_accessor :debug
+  end
+
+  self.log = false
+  self.debug = false
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: hypothesis
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Javier Arce
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.1
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.39.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.39.0
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+description: 'Ruby API for hypothesis '
+email: javierarce@gmail.com
+executables:
+- hypothesis
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/hypothesis
+- lib/hypothesis.rb
+- lib/hypothesis/api.rb
+- lib/hypothesis/version.rb
+homepage: https://github.com/javierarce/hypothesis
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.6
+signing_key: 
+specification_version: 4
+summary: Ruby API for hypothesis
+test_files: []