mediumite 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e94cf3460cb0d169c187700e4e021ab1c4b33510
+  data.tar.gz: 13f7a4f5eea070c4ebf4ddbf6e0c4c42646bf506
+SHA512:
+  metadata.gz: 853597e576e7c374d1c22229941c21e227e6776d50e8d12f6251ea5dc4b34e98561ca0b55cffed64a7cef86e218408685763e7fe1d599d99f47ece2dbd338574
+  data.tar.gz: b1af352c0d6c3f5e495177cf53fb2f17b6773aae4ff54881b4772d960935f0ab980aaae2878429e7b8a2443a223c211fb9f85f320dd2e07bdbb3fbfca65faae8

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mediumite.gemspec
+gemspec

data/README.md

@@ -0,0 +1,94 @@
+# Mediumite [![CircleCI](https://circleci.com/gh/rejasupotaro/mediumite.svg?style=svg)](https://circleci.com/gh/rejasupotaro/mediumite)
+
+This is simple wrapper for the Medium API written in Ruby.
+For full API documentation, see [Medium/medium-api-docs: Documentation for Medium's OAuth2 API](https://github.com/Medium/medium-api-docs#32-publications)
+
+# Usage
+
+## Authentication
+
+In order to publish on behalf of a Medium account, you will need an access token. Medium  offers two ways to acquire an access token: browser-based OAuth authentication, and self-issued access tokens. Currently this library supports only self-issued access tokens.
+
+You can generate/revoke an access token from the [Settings page](https://medium.com/me/settings) of your Medium account.
+
+Using the access token, initlize `Mediumite::Client`.
+
+```ruby
+client = Mediumite::Client.new(token: your_access_token)
+```
+
+## Resources
+
+### Users
+
+#### Getting the authenticated user’s details
+
+Returns details of the user who has granted permission to the application.
+
+Example:
+
+```ruby
+> client.user
+=> {:id=>"5303d74c64f66366f00cb9b2a94f3251bf5",
+  :username=>"majelbstoat",
+  :name=>"Jamie Talbot",
+  :url=>"https://medium.com/@majelbstoat",
+  :imageUrl=>"https://images.medium.com/0*fkfQiTzT7TlUGGyI.png"}
+```
+
+### Publications
+
+#### Listing the user’s publications
+
+Returns a full list of publications that the user is related to in some way: This includes all publications the user is subscribed to, writes to, or edits.
+
+Example:
+
+```ruby
+> client.get_publications
+=> [{:id=>"b969ac62a46b",
+  :name=>"About Medium",
+  :description=>"What is this thing and how does it work?",
+  :url=>"https://medium.com/about",
+  :imageUrl=>"https://cdn-images-1.medium.com/fit/c/200/200/0*ae1jbP_od0W6EulE.jpeg"}
+,
+  {:id=>"b45573563f5a",
+  :name=>"Developers",
+  :description=>"Medium’s Developer resources",
+  :url=>"https://medium.com/developers",
+  :imageUrl=>"https://cdn-images-1.medium.com/fit/c/200/200/1*ccokMT4VXmDDO1EoQQHkzg@2x.png"}
+]
+```
+
+### Posts
+
+#### Creating a post
+
+Creates a post on the authenticated user’s profile.
+
+Example:
+
+```ruby
+> post = Mediumite::Post.new(title: "Liverpool FC", body: "# Liverpool FC\nYou’ll never walk alone.")
+> client.create_post(post)
+=> {:id=>"e6f36a",
+  :title=>"Liverpool FC",
+  :authorId=>"5303d74c64f66366f00cb9b2a94f3251bf5",
+  :url=>"https://medium.com/@majelbstoat/liverpool-fc-e6f36a",
+  :canonicalUrl=>"http://jamietalbot.com/posts/liverpool-fc",
+  :publishStatus=>"draft",
+  :publishedAt=>1442286338435,
+  :license=>"",
+  :licenseUrl=>"https://medium.com/policy/9db0094a1e0f"
+  :tags=>[]}
+```
+
+You can specify these parameters below.
+
+| Parameter | Type | Required? | Description |
+|----|----|----|----|
+| title | string | required | The title of the post. |
+| body | string | required | The body of the post, in a valid, semantic, markdown or HTML fragment. Further markups may be supported in the future. For a full list of accepted HTML tags, see [here](https://medium.com/@katie/a4367010924e). |
+| format | string | optional | The format of the "body" field. There are two valid values, "markdown", and "html". The default is "markdown" |
+| tags | string array | optional | Tags to classify the post. Only the first three will be used. Tags longer than 25 characters will be ignored. |
+| publish_status | string | optional | The status of the post. Valid values are “public”, “draft”, or “unlisted”. The default is “draft”. |

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "mediumite"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/circle.yml

@@ -0,0 +1,21 @@
+## Customize the test machine
+machine:
+
+  # Version of ruby to use
+  ruby:
+    version:
+      2.2.3
+
+## Customize dependencies
+dependencies:
+  pre:
+    - gem install bundler --pre
+
+  override:
+    - bundle install -j4: # note ':' here
+        timeout: 180 # fail if command has no output for 3 minutes
+
+## Customize test commands
+test:
+  override:
+    - bundle exec rspec

data/lib/mediumite.rb

@@ -0,0 +1,6 @@
+require "mediumite/version"
+require "mediumite/client"
+require "mediumite/post"
+
+module Mediumite
+end

data/lib/mediumite/client.rb

@@ -0,0 +1,46 @@
+require "sawyer"
+
+module Mediumite
+  class Client
+    def initialize(options = {})
+      @options = options
+    end
+
+    def inspect
+      inspected = super
+      inspected = inspected.gsub! token, "#{'*'*token.length}" if token
+      inspected
+    end
+
+    def token
+      @options[:token]
+    end
+
+    def agent
+      @agent ||= Sawyer::Agent.new("https://api.medium.com/v1") do |http|
+        http.headers[:content_type] = "application/json"
+        http.authorization "Bearer", token
+      end
+    end
+
+    def request(method, path, data = {})
+      agent.call(method, URI::Parser.new.escape(path.to_s), data).data.data
+    end
+
+    def user
+      @user ||= request(:get, "me")
+    end
+
+    def get_publications
+      request(:get, "users/#{user.id}/publications")
+    end
+
+    def create_post(post)
+      if post.under_publication?
+        request(:post, "publications/#{post.publication_id}/posts", post.to_json)
+      else
+        request(:post, "users/#{user.id}/posts", post.to_json)
+      end
+    end
+  end
+end

data/lib/mediumite/post.rb

@@ -0,0 +1,28 @@
+require "json"
+
+module Mediumite
+  class Post
+    def initialize(content)
+      @content = content
+    end
+
+    def publication_id
+      @content[:publication_id]
+    end
+
+    def under_publication?
+      !!@content[:publication_id]
+    end
+
+    def to_json
+      {
+        title: @content[:title],
+        contentFormat: @content[:format] ||= "markdown",
+        content: @content[:body],
+        canonicalUrl: @content[:canonical_url],
+        tags: @content[:tags],
+        publishStatus: @content[:publish_status] ||= "draft"
+      }.to_json
+    end
+  end
+end

data/lib/mediumite/version.rb

@@ -0,0 +1,3 @@
+module Mediumite
+  VERSION = "0.1.0"
+end

data/mediumite.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mediumite/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "mediumite"
+  spec.version       = Mediumite::VERSION
+  spec.authors       = ["Kentaro Takiguchi"]
+  spec.email         = ["takiguchi0817@gmail.com"]
+
+  spec.summary       = %q{Simple wrapper for the Medium API written in Ruby.}
+  spec.description   = %q{Simple wrapper for the Medium API written in Ruby.}
+  spec.homepage      = "https://github.com/rejasupotaro/mediumite"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "sawyer"
+  spec.add_development_dependency "pry"
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: mediumite
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kentaro Takiguchi
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-08-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sawyer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Simple wrapper for the Medium API written in Ruby.
+email:
+- takiguchi0817@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- circle.yml
+- lib/mediumite.rb
+- lib/mediumite/client.rb
+- lib/mediumite/post.rb
+- lib/mediumite/version.rb
+- mediumite.gemspec
+homepage: https://github.com/rejasupotaro/mediumite
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Simple wrapper for the Medium API written in Ruby.
+test_files: []