clian 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 264474ee5d137de6c6e52c4be3bc48823b49e1df
+  data.tar.gz: af85fb3abf76f468645c2441219dc4f01fa275d7
+SHA512:
+  metadata.gz: 1abf1a099b6ce0fba76dbdf54d56d02f862775f11526682994e19b7faaa26dec1d5d41eab1f950d4752f04c542e2c39da6f976a7654706d8002b46526ffc8da2
+  data.tar.gz: d6f70db664e52fbe32c3faf942d6c9fc2dd4a36cd55fdbccf94908351ebee4f9153e66ef8be74c617aa6f3eb81ba887f01e0b8b045298c3f812df117e1a8598c

data/.gitignore

@@ -0,0 +1,52 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+#
+# Added from https://raw.github.com/github/gitignore/master/Ruby.gitignore
+#
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+#
+# Added from /Users/nom/sys/bin/gem-new
+#
+/vendor

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.3.0
+before_install: gem install bundler -v 1.11.2

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Yoshinari Nomura
+
+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/Rakefile

@@ -0,0 +1,6 @@
+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 "clian"
+
+# 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/clian.gemspec

@@ -0,0 +1,37 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+git = File.expand_path('../.git', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'clian/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "clian"
+  spec.version       = Clian::VERSION
+  spec.authors       = ["Yoshinari Nomura"]
+  spec.email         = ["nom@quickhack.net"]
+
+  spec.summary       = %q{Small set of Ruby classes helpful for creation of CLI tools.}
+  spec.description   = %q{Small set of Ruby classes helpful for creation of CLI tools.}
+  spec.homepage      = "https://github.com/yoshinari-nomura/clian"
+  spec.license       = "MIT"
+
+  spec.files         = if Dir.exist?(git)
+                         `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+                       else
+                         Dir['**/*']
+                       end
+
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "thor", ">= 0.19.1"
+  spec.add_runtime_dependency "google-api-client", "0.9.pre4"
+  spec.add_runtime_dependency "googleauth"
+  spec.add_runtime_dependency "launchy"
+  spec.add_runtime_dependency "mail"
+
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/lib/clian/authorizer.rb

@@ -0,0 +1,44 @@
+require 'google/apis/gmail_v1'
+require 'googleauth'
+require 'googleauth/stores/file_token_store'
+require 'launchy'
+require "thor"
+
+module Clian
+  # https://github.com/google/google-auth-library-ruby#example-command-line
+  # https://github.com/google/google-api-ruby-client#example-usage
+  # http://stackoverflow.com/questions/12572723/rails-google-client-api-unable-to-exchange-a-refresh-token-for-access-token
+  #
+  class Authorizer
+    def initialize(client_id, client_secret, scope, token_store_path)
+      @authorizer = Google::Auth::UserAuthorizer.new(
+        Google::Auth::ClientId.new(client_id, client_secret),
+        scope,
+        Google::Auth::Stores::FileTokenStore.new(file: token_store_path)
+      )
+    end
+
+    def credentials(user_id = "default")
+      @authorizer.get_credentials(user_id)
+    end
+
+    def auth_interactively(user_id = "default", shell = Thor.new.shell)
+      oob_uri = "urn:ietf:wg:oauth:2.0:oob"
+
+      url = @authorizer.get_authorization_url(base_url: oob_uri)
+      begin
+        Launchy.open(url)
+      rescue
+        puts "Open URL in your browser:\n #{url}"
+      end
+
+      code = shell.ask "Enter the resulting code:"
+
+      @authorizer.get_and_store_credentials_from_code(
+        user_id:  user_id,
+        code:     code,
+        base_url: oob_uri
+      )
+    end
+  end # Authorizer
+end # Clian

data/lib/clian/cli.rb

@@ -0,0 +1,203 @@
+require "thor"
+
+module Clian
+  class Cli < Thor
+    ################################################################
+    # config files
+
+    CONFIG_HOME = File.join((ENV["XDG_CONFIG_HOME"] || "~/.config"), basename)
+    CONFIG_FILE = "config.yml"
+    CONFIG_PATH = File.join(CONFIG_HOME, CONFIG_FILE)
+
+    def self.config_home ; CONFIG_HOME; end
+    def self.config_path ; CONFIG_PATH; end
+
+    ################################################################
+    # rbenv support:
+    # If this file is a symlink, and bound to a specific ruby
+    # version via rbenv (indicated by RBENV_VERSION),
+    # I want to resolve the symlink and re-exec
+    # the original executable respecting the .ruby_version
+    # which should indicate the right version.
+    #
+    def self.bundler_rbenv_setup(command_path)
+      if File.symlink?(command_path) and ENV["RBENV_VERSION"]
+        ENV["RBENV_VERSION"] = nil
+        shims_path = File.expand_path("shims", ENV["RBENV_ROOT"])
+        ENV["PATH"] = shims_path + ":" + ENV["PATH"]
+        exec(File.readlink(__FILE__), *ARGV)
+      end
+
+      gemfile = File.expand_path("../../Gemfile", command_path)
+
+      if File.exists?(gemfile + ".lock")
+        ENV["BUNDLE_GEMFILE"] = gemfile
+        require "bundler/setup"
+      end
+    end
+
+    ################################################################
+    # register preset options
+
+    def self.named_option(name, options)
+      @named_options ||= {}
+      @named_options[name] = options
+    end
+
+    def self.expand_option(*names)
+      expand_named_option(:method, *names)
+    end
+
+    def self.expand_class_option(*names)
+      expand_named_option(:class, *names)
+    end
+
+    def self.expand_named_option(type, *names)
+      names.each do |name|
+        options = @named_options[name]
+        if type == :class
+          class_option name, options
+        else
+          method_option name, options
+        end
+      end
+    end
+    private_class_method :expand_named_option
+
+    # default options
+    named_option :debug,   :desc => "Set debug flag", :type => :boolean
+    named_option :profile, :desc => "Set profiler flag", :type => :boolean
+    named_option :config,  :desc => "Set config path (default: #{CONFIG_PATH})", :banner => "FILE"
+    named_option :dry_run, :desc => "Perform a trial run with no changes made", :type => :boolean
+
+    ################################################################
+    # command name mappings
+
+    map ["--version", "-v"] => :version
+
+    map ["--help", "-h"] => :help
+
+    default_command :help
+
+    ################################################################
+    # Command: help
+    ################################################################
+
+    desc "help [COMMAND]", "Describe available commands or one specific command"
+
+    def help(command = nil)
+      super(command)
+    end
+
+    ################################################################
+    # Command: version
+    ################################################################
+    desc "version", "Show version"
+
+    def version
+      puts Clian::VERSION
+    end
+
+    ################################################################
+    # Command: completions
+    ################################################################
+    check_unknown_options! :except => :completions
+
+    desc "completions [COMMAND]", "List available commands or options for COMMAND", :hide => true
+
+    long_desc <<-LONGDESC
+      List available commands or options for COMMAND
+      This is supposed to be a zsh compsys helper"
+    LONGDESC
+
+    def completions(*command)
+      help = self.class.commands
+      global_options = self.class.class_options
+      Clian::Command::Completions.new(help, global_options, command, config)
+    end
+
+    ################################################################
+    # Command: config
+    ################################################################
+    desc "configuration", "Show current configuration in various formats."
+
+    def configuration(name = nil)
+      puts Clian::Converter::Emacs.new.to_emacs(config.get_value(name))
+    end
+
+    ################################################################
+    # add some hooks to Thor
+
+    no_commands do
+      def invoke_command(command, *args)
+        setup_global_options unless command.name == "init"
+        result = super
+        teardown
+        result
+      end
+    end
+
+    ################################################################
+    # private
+
+    private
+
+    def exit_on_error(&block)
+      begin
+        yield if block_given?
+      rescue Clian::ConfigurationError => e
+        STDERR.print "ERROR: #{e.message}.\n"
+        exit 1
+      end
+    end
+
+    attr_reader :builder, :config, :calendar
+
+    def setup_global_options
+      exit_on_error do
+        # @config = Clian::Config.create_from_file(options[:config] || CONFIG_PATH)
+        # @builder ||= Clian::Builder.new(@config)
+        # if @config.general.tzid
+        #  Clian.default_tzid = @config.general.tzid
+        #end
+
+        # calname  = options[:calendar] || @config.calendars.first.name
+        # @config.general.repository = options[:repository] if options[:repository]
+
+        # self.class.calendar ||= builder.calendar(calname)
+        # @calendar = self.class.calendar
+      end
+
+      # load_plugins
+
+      # if options[:profile]
+      #   require 'profiler'
+      #   Profiler__.start_profile
+      # end
+      # if options[:debug]
+      #   require "pp"
+      #   $MHC_DEBUG = true
+      #   $MHC_DEBUG_FOR_DEVELOPER = true if ENV["MHC_DEBUG_FOR_DEVELOPER"]
+      # end
+    end
+
+    def load_plugins
+      config_path = options[:config] || DEFAULT_CONFIG_PATH
+      plugin_dir  = File.dirname(config_path)
+
+      Dir.glob(File.expand_path("plugins/*.rb", plugin_dir)) do |rb|
+        require rb
+      end
+    end
+
+    def teardown
+      if options[:profile]
+        Profiler__.print_profile($stdout)
+      end
+    end
+
+    def symbolize_keys(hash)
+      Hash[hash.map {|k,v| [k.to_sym, v]}]
+    end
+  end
+end

data/lib/clian/config.rb

@@ -0,0 +1,205 @@
+require 'yaml'
+require 'pp'
+
+module Clian
+  module Config
+    ################################################################
+    # Syntax table manipulation
+    class Syntax
+      def initialize(syntax_config)
+        @syntax_config = syntax_config
+      end
+
+      def keyword_symbols
+        @syntax_config.keys
+      end
+
+      def keywords
+        keyword_symbols.map {|sym| sym.to_s.upcase }
+      end
+
+      def keyword?(word)
+        if word.is_a?(Symbol)
+          keyword_symbols.member?(word)
+        else
+          # String
+          keywords.member?(word)
+        end
+      end
+
+      def instance_variable_name(word)
+        return nil unless keyword?(word)
+        return '@' + as_symbol(word).to_s
+      end
+
+      def item_class(word)
+        return nil unless keyword?(word)
+        @syntax_config[as_symbol(word)]
+      end
+
+      private
+      def as_symbol(word)
+        word.to_s.downcase.sub(/^@+/, "").to_sym
+      end
+    end # class Syntax
+
+    ################################################################
+    # Parse Key-Value object in YAML
+    class Element
+
+      def self.create_from_yaml_file(yaml_file)
+        yaml_string = File.open(File.expand_path(yaml_file)).read
+        return create_from_yaml_string(yaml_string, yaml_file)
+      end
+
+      def self.create_from_yaml_string(yaml_string, filename = nil)
+        hash = YAML.load(yaml_string, filename) || {}
+        return new(hash)
+      end
+
+      # class General < Clian::Config::Element
+      #   define_syntax :client_id => String,
+      #                 :client_secret => String,
+      #                 :token_store => String,
+      #                 :context_store => String,
+      #                 :default_user => String
+      # end # class General
+      #
+      def self.define_syntax(config)
+        @syntax = Syntax.new(config)
+        @syntax.keyword_symbols.each do |sym|
+          attr_reader sym
+        end
+      end
+
+      def self.syntax
+        return @syntax
+      end
+
+      def initialize(hash = {})
+        @original_hash = hash
+        (hash || {}).each do |key, val|
+          raise Clian::ConfigurationError, "config syntax error (#{key})" unless syntax.keyword?(key)
+          var = syntax.instance_variable_name(key)
+          obj = create_subnode(key, val)
+          instance_variable_set(var, obj)
+        end
+      end
+
+      attr_reader :original_hash
+
+      def get_value(dot_separated_string = nil)
+        if dot_separated_string.to_s == ""
+          return original_hash
+        end
+
+        key, subkey = dot_separated_string.to_s.upcase.split(".", 2)
+        subnode = get_subnode(key)
+
+        if subnode.respond_to?(:get_value)
+          return subnode.get_value(subkey)
+        else
+          return subnode.to_s
+        end
+      end
+
+      def to_yaml
+        return self.to_hash.to_yaml
+      end
+
+      def to_hash
+        hash = {}
+        syntax.keywords.each do |key|
+          var = syntax.instance_variable_name(key)
+          obj = instance_variable_get(var)
+          obj = obj.respond_to?(:to_hash) ? obj.to_hash : obj.to_s
+          hash[key] = obj
+        end
+        return hash
+      end
+
+      private
+      def syntax
+        self.class.syntax
+      end
+
+      def get_subnode(key)
+        raise Clian::ConfigurationError, "Invalid key: #{key}" unless syntax.keyword?(key)
+        return instance_variable_get(syntax.instance_variable_name(key))
+      end
+
+      def create_subnode(keyword, value)
+        item_class = syntax.item_class(keyword)
+        if item_class.is_a?(Array)
+          return List.new(item_class.first, value)
+        elsif item_class == String
+          return value.to_s
+        else
+          return item_class.new(value)
+        end
+      end
+
+    end # class Base
+
+    ################################################################
+    # Parse Array object in YAML
+    class List < Element
+      include Enumerable
+
+      def initialize(item_class, array = [])
+        @original_hash = array
+        @configs = []
+        (array || []).each do |value|
+          item = item_class.new(value)
+          @configs << item
+        end
+      end
+
+      def [](key)
+        @configs.find {|c| c.name == key}
+      end
+
+      alias_method :get_subnode, :[]
+
+      def <<(conf)
+        @configs << conf
+      end
+
+      def to_hash # XXX: actually, it returns a Array
+        return @configs.map {|c| c.respond_to?(:to_hash) ? c.to_hash : c.to_s}
+      end
+
+      def each
+        @configs.each do |conf|
+          yield conf
+        end
+      end
+    end # class List
+
+    ################################################################
+    # Syntax table manipulation
+    class Toplevel < Element
+      DEFAULT_DIR  = ENV["XDG_CONFIG_HOME"] || "~/.config"
+      DEFAULT_FILE = "config.yml"
+
+      def self.default_home(package_name)
+        File.join(DEFAULT_DIR, package_name)
+      end
+
+      def self.default_path(package_name)
+        File.join(default_home(package_name), DEFAULT_FILE)
+      end
+
+      def self.create_from_file(file_name = self.default_path)
+        unless File.exists?(File.expand_path(file_name))
+          raise ConfigurationError, "config file '#{file_name}' not found"
+        end
+        begin
+          return create_from_yaml_file(file_name)
+        rescue Psych::SyntaxError, Clian::ConfigurationError => e
+          raise ConfigurationError, e.message
+        end
+      end
+    end # class Toplevel
+  end # class Config
+end # module Clian

data/lib/clian/version.rb

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

data/lib/clian.rb

@@ -0,0 +1,12 @@
+require "clian/version"
+
+module Clian
+  class ConfigurationError < StandardError ; end
+
+  dir = File.dirname(__FILE__) + "/clian"
+
+  autoload :Authorizer,           "#{dir}/authorizer.rb"
+  autoload :Cli,                  "#{dir}/cli.rb"
+  autoload :Config,               "#{dir}/config.rb"
+  autoload :VERSION,              "#{dir}/version.rb"
+end

metadata

@@ -0,0 +1,170 @@
+--- !ruby/object:Gem::Specification
+name: clian
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Yoshinari Nomura
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-09-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+- !ruby/object:Gem::Dependency
+  name: google-api-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.pre4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.pre4
+- !ruby/object:Gem::Dependency
+  name: googleauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: launchy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mail
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !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: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Small set of Ruby classes helpful for creation of CLI tools.
+email:
+- nom@quickhack.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- Rakefile
+- bin/console
+- bin/setup
+- clian.gemspec
+- lib/clian.rb
+- lib/clian/authorizer.rb
+- lib/clian/cli.rb
+- lib/clian/config.rb
+- lib/clian/version.rb
+homepage: https://github.com/yoshinari-nomura/clian
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Small set of Ruby classes helpful for creation of CLI tools.
+test_files: []