crowi-client 0.1.0

data/lib/crowi/client/client.rb

@@ -0,0 +1,71 @@
+require 'singleton'
+require 'rest-client'
+require 'json'
+require 'yaml'
+require "easy_settings"
+
+require 'crowi/client/apireq/api_request_pages'
+require 'crowi/client/apireq/api_request_attachments'
+
+# Crowi のクライアントクラス
+class CrowiClient
+  include Singleton
+
+  # コンストラクタ（シングルトン）
+  def initialize
+    raise ArgumentError, 'Config url is required.'   unless EasySettings['url']
+    raise ArgumentError, 'Config token is required.' unless EasySettings['token']
+    @cp_entry_point = URI.join(EasySettings['url'], '/_api/').to_s
+  end
+
+  # APIリクエストを送信する
+  # @param [ApiRequestBase] req APIリクエスト
+  # @return [String] APIリクエストの応答（JSON形式）
+  def request(req)
+    req.param[:access_token] = EasySettings['token'] 
+    return req.execute URI.join(@cp_entry_point, req.entry_point).to_s
+  end
+
+  # ページIDを取得する
+  # @param [String] path_exp ページパス
+  # @return [String] ページID
+  def page_id(path_exp: nil)
+    ret = request(CPApiRequestPagesList.new path_exp: path_exp)
+    return ret&.data&.find { |p| p.path.match(path_exp) != nil }&.id
+  end
+
+  # ページが存在するか調べる
+  # @param [String] path ページパス
+  # @return [true/false] ページの存在
+  def page_exist?(path_exp: nil)
+    ret = request(CPApiRequestPagesList.new path_exp: path_exp)
+    return ret&.ok && ret&.data&.find { |p| p.path.match(path_exp) } != nil
+  end
+
+  # ページに添付ファイルが存在するか調べる
+  # @param [String] path_exp ページパス（正規表現）
+  # @param [String] attachment_name 添付ファイル名
+  # @return [true/false] 添付ファイルの存在
+  def attachment_exist?(path_exp: nil, attachment_name: nil)
+    ret = request(CPApiRequestAttachmentsList.new page_id: page_id(path_exp: path_exp))
+    return ret&.ok && ret&.data&.find { |a| a.originalName == attachment_name } != nil
+  end
+
+  # 指定した添付ファイルのIDを取得する
+  # @param  [String] path_exp ページパス（正規表現）
+  # @return [String] attachment's file name
+  def attachment_id(path_exp: nil, attachment_name: nil)
+      ret = request(CPApiRequestAttachmentsList.new page_id: page_id(path_exp: path_exp))
+      return ret&.data&.find { |a| a.originalName == attachment_name }&._id
+  end
+
+  # 指定した添付ファイル情報を取得する
+  # @param  [String] path_exp ページパス（正規表現）
+  # @return [String] attachment's file name
+  def attachment(path_exp: nil, attachment_name: nil)
+      ret = request(CPApiRequestAttachmentsList.new page_id: page_id(path_exp: path_exp))
+      return ret&.data&.find { |a| a.originalName == attachment_name }
+  end
+
+end
+

data/lib/crowi/client/model/crowi_attachment.rb

@@ -0,0 +1,36 @@
+require 'crowi/client/model/crowi_model'
+
+# Crowi Attachment model class
+class CrowiAttachment < CrowiModelBase
+  attr_reader :_id, :fileFormat, :fileName, :originalName, :filePath,
+              :creator, :page, :__v, :createdAt, :fileSize, :url
+
+  # Constractor
+  # @param [Hash] Attachment model shown as hash
+  # @todo Except running register method always called parse method.
+  def initialize(params = {})
+    init_params = {
+      _id: nil, fileFormat: '', fileName: '', originalName: '', filePath: nil,
+      creator: nil, page: '', __v: 0, createdAt: '', fileSize: 0, url: ''
+    }
+
+    params = init_params.merge(params.map { |k,v| [k.to_sym, v] }.to_h)
+    if (params[:_id] == nil)
+      raise ArgumentError.new('Parameters id is required.')
+    end
+
+    CrowiModelFactory.instance.register({
+      attachment_creator:   Proc.new { |param| param != nil && param.is_a?(String) ? param : CrowiUser.new(param) },
+      attachment_createdAt: Proc.new { |date_str|
+                              date_str != nil && DateTime.parse(date_str) },
+    })
+    maked_params = {}
+    params.each do |k,v|
+      maker = CrowiModelFactory.instance.maker('attachment_' + k.to_s)
+      maked_params[k] = maker.call(v)
+    end
+    super(maked_params)
+  end
+
+end
+

data/lib/crowi/client/model/crowi_model.rb

@@ -0,0 +1,52 @@
+require 'singleton'
+
+require 'crowi/client/model/crowi_model_base'
+require 'crowi/client/model/crowi_page'
+require 'crowi/client/model/crowi_page_revision'
+require 'crowi/client/model/crowi_user'
+require 'crowi/client/model/crowi_attachment'
+
+# Crowi model factory class
+# @abstract include singleton class
+# @attr_reader makers Model maker list
+class CrowiModelFactory
+  include Singleton
+  attr_reader :makers
+
+  # Constractor
+  def initialize
+    @makers = {}
+    @makers.default = Proc.new { |param|
+      next nil if param == nil
+      case param
+      when Array, String, Integer then
+        ret = param
+      when FalseClass then
+        ret = false
+      when TrueClass then
+        ret = true
+      end
+      next ret
+    }
+  end
+
+  # Register model maker
+  # @param [Hash] Model factory list
+  def register(makers = {})
+    makers.each do |model_name, model_make_proc|
+      unless model_make_proc.is_a?(Proc)
+        raise ArgumentError.new('Maker is required sub class of Class.')
+      end
+    end
+    @makers.merge!(makers)
+  end
+
+  # Get model maker
+  # @param [String] model_name Model name
+  # @return [Proc] Model maker
+  def maker(model_name)
+    return @makers[model_name&.to_sym]
+  end
+
+end
+

data/lib/crowi/client/model/crowi_model_base.rb

@@ -0,0 +1,12 @@
+# Crowi model base class
+class CrowiModelBase
+
+  # Constractor
+  def initialize(params = {})
+    params.each do |k,v|
+      instance_variable_set(:"@#{k}", v)
+    end
+  end
+
+end
+

data/lib/crowi/client/model/crowi_page.rb

@@ -0,0 +1,53 @@
+require 'crowi/client/model/crowi_model'
+
+# Crowi Page model class
+class CrowiPage < CrowiModelBase
+  GRANT_PUBLIC     = 1.freeze
+  GRANT_RESTRICTED = 2.freeze
+  GRANT_SPECIFIED  = 3.freeze
+  GRANT_OWNER      = 4.freeze
+
+  STATUS_WIP        = 'wip'.freeze
+  STATUS_PUBLISHED  = 'published'.freeze
+  STATUS_DELETED    = 'deleted'.freeze
+  STATUS_DEPRECATED = 'deprecated'.freeze
+
+  attr_reader :_id, :redirectTo, :updatedAt, :lastUpdateUser,
+              :creator, :path, :__v, :revision, :createdAt,
+              :commentCount, :seenUsers, :liker, :grantedUsers,
+              :grant, :status, :id
+
+  # Constract
+  # @param [Hash] params Prameters data show as Hash
+  # @todo Except running register method always called parse method.
+  def initialize(params = {})
+    init_params = {
+      _id: '', redirectTo: nil, updatedAt: '', lastUpdateUser: '',
+      creator: nil, path: nil, __v: 0, revision: nil, createdAt: '',
+      commentCount: 0, seenUsers: [], liker: [], grantedUsers: [],
+      grant: 0, status: '', id: ''
+    }
+
+    params = init_params.merge(params.map { |k,v| [k.to_sym, v] }.to_h)
+    if (params[:_id] == nil || params[:path] == nil || params[:id] == nil)
+      raise ArgumentError.new('Parameters _id, path and id are required.')
+    end
+
+    # @note Parameters lastUpdateUser and creator have two patterns ID only or Object.
+    CrowiModelFactory.instance.register({
+      page_updatedAt:      Proc.new { |str| str != nil && DateTime.parse(str) },
+      page_lastUpdateUser: Proc.new { |param| param != nil && param.is_a?(String) ? param : CrowiUser.new(param) },
+      page_creator:        Proc.new { |param| param != nil && param.is_a?(String) ? param : CrowiUser.new(param) },
+      page_createdAt:      Proc.new { |str| str != nil && DateTime.parse(str) },
+      page_revision:       Proc.new { |param| param != nil && CrowiPageRevision.new(param) },
+    })
+    maked_params = {}
+    params.each do |k,v|
+      maker = CrowiModelFactory.instance.maker('page_' + k.to_s)
+      maked_params[k] = maker.call(v)
+    end
+    super(maked_params)
+  end
+
+end
+

data/lib/crowi/client/model/crowi_page_revision.rb

@@ -0,0 +1,34 @@
+require 'crowi/client/model/crowi_model'
+
+# Crowi Page revision model class
+class CrowiPageRevision < CrowiModelBase
+  attr_reader :_id, :author, :body, :path, :__v, :createdAt, :format
+
+  # Constractor
+  # @param [Hash] User model shown as hash
+  # @todo Except running register method always called parse method.
+  def initialize(params = {})
+    init_params = {
+      _id: '', author: nil, body: nil, path: nil, __v: 0, createdAt: nil,
+      format: ''
+    }
+
+    params = init_params.merge(params.map { |k,v| [k.to_sym, v] }.to_h)
+    if (params[:_id] == nil ||  params[:path] == nil)
+      raise ArgumentError.new('Parameters _id and path are required.')
+    end
+
+    CrowiModelFactory.instance.register({
+      page_revision_createdAt: Proc.new { |date_str|
+                                          date_str != nil && DateTime.parse(date_str) },
+    })
+    maked_params = {}
+    params.each do |k,v|
+      maker = CrowiModelFactory.instance.maker('page_revision_' + k.to_s)
+      maked_params[k] = maker.call(v)
+    end
+    super(maked_params)
+  end
+
+end
+

data/lib/crowi/client/model/crowi_user.rb

@@ -0,0 +1,35 @@
+require 'crowi/client/model/crowi_model'
+
+# Crowi User model class
+class CrowiUser < CrowiModelBase
+  attr_reader :_id, :email, :username, :name,
+              :admin, :createdAt, :status, :lang, :isGravatarEnabled
+
+  # Constractor
+  # @param [Hash] User model shown as hash
+  # @todo Except running register method always called parse method.
+  def initialize(params = {})
+    init_params = {
+      _id: nil, email: nil, username: nil, name: '',
+      admin: false, createdAt: '', status: 0, lang: '', isGravatarEnabled: false
+    }
+
+    params = init_params.merge(params.map { |k,v| [k.to_sym, v] }.to_h)
+    if (params[:_id] == nil || params[:email] == nil || params[:username] == nil)
+      raise ArgumentError.new('Parameters id and email and name are required.')
+    end
+
+    CrowiModelFactory.instance.register({
+      user_createdAt: Proc.new { |date_str|
+                        date_str != nil && DateTime.parse(date_str) },
+    })
+    maked_params = {}
+    params.each do |k,v|
+      maker = CrowiModelFactory.instance.maker('user_' + k.to_s)
+      maked_params[k] = maker.call(v)
+    end
+    super(maked_params)
+  end
+
+end
+

data/lib/crowi/client/version.rb

@@ -0,0 +1,5 @@
+module Crowi
+  module Client
+    VERSION = "0.1.0"
+  end
+end

metadata

@@ -0,0 +1,167 @@
+--- !ruby/object:Gem::Specification
+name: crowi-client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ryu Sato
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-04-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !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: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-json_matcher
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: easy_settings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: crowi-client is client of crowi with use API.
+email:
+- ryu@weseek.co.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- config/settings.yml
+- crowi-client.gemspec
+- lib/crowi-client.rb
+- lib/crowi/client/apireq/api_request_attachments.rb
+- lib/crowi/client/apireq/api_request_base.rb
+- lib/crowi/client/apireq/api_request_pages.rb
+- lib/crowi/client/client.rb
+- lib/crowi/client/model/crowi_attachment.rb
+- lib/crowi/client/model/crowi_model.rb
+- lib/crowi/client/model/crowi_model_base.rb
+- lib/crowi/client/model/crowi_page.rb
+- lib/crowi/client/model/crowi_page_revision.rb
+- lib/crowi/client/model/crowi_user.rb
+- lib/crowi/client/version.rb
+homepage: https://github.com/ryu-sato/crowi-client
+licenses:
+- MIT
+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.7.6
+signing_key: 
+specification_version: 4
+summary: Client of crowi
+test_files: []