haveapi-go-client 0.13.0

data/lib/haveapi/go_client/parameters/association.rb

@@ -0,0 +1,54 @@
+require 'haveapi/go_client/utils'
+
+module HaveAPI::GoClient
+  class Parameters::Association
+    include Utils
+
+    # @return [Parameter]
+    attr_reader :parameter
+
+    # @return [String]
+    attr_reader :go_type
+
+    # @return [String]
+    attr_reader :go_value_id
+
+    # @return [String]
+    attr_reader :go_value_label
+
+    # @return [Resource]
+    attr_reader :resource
+
+    def initialize(param, desc)
+      @parameter = param
+      @resource = find_resource(desc[:resource])
+      @go_type = resource.actions.detect { |a| a.name == 'show' }.output.go_type
+      @go_value_id = camelize(desc[:value_id])
+      @go_value_label = camelize(desc[:value_label])
+    end
+
+    protected
+    def find_resource(path)
+      root = parameter.io.action.resource.api_version
+      path = path.clone
+
+      loop do
+        name = path.shift
+        resource = root.resources.detect { |r| r.name == name }
+
+        if resource.nil?
+          fail "associated resource '#{name}' not found in "+
+                (root.is_a?(ApiVersion) ? 'root' : root.resource_path.map(&:name).join('.'))
+
+        elsif path.empty?
+          return resource
+
+        else
+          root = resource
+        end
+      end
+
+      fail 'programming error'
+    end
+  end
+end

data/lib/haveapi/go_client/parameters/base.rb

@@ -0,0 +1,66 @@
+require 'haveapi/go_client/utils'
+
+module HaveAPI::GoClient
+  class Parameters::Base
+    include Utils
+
+    # Register the parameter handler
+    #
+    # The block is called whenever a new parameter is to be instantiated. If
+    # this class supports the parameter, the block returns true, else false.
+    # The first class to return true is used.
+    #
+    # @yieldparam role [Symbol]
+    # @yieldparam direction [Symbol]
+    # @yieldparam name [String]
+    # @yieldparam desc [Hash]
+    # @yiledreturn [Boolean, nil]
+    def self.handle(&block)
+      Parameter.register(self, block)
+    end
+
+    # @return [InputOutput]
+    attr_reader :io
+
+    # Parameter name in the API
+    # @return [String]
+    attr_reader :name
+
+    # HaveAPI data type
+    # @return [String]
+    attr_reader :type
+
+    # Parameter name in Go
+    # @return [String]
+    attr_reader :go_name
+
+    # Go type for action input
+    # @return [String]
+    attr_reader :go_in_type
+
+    # Go type for action output
+    # @return [String]
+    attr_reader :go_out_type
+
+    def initialize(io, name, desc)
+      @io = io
+      @name = name
+      @type = desc[:type]
+      @desc = desc
+      @go_name = camelize(name)
+    end
+
+    def resolve
+      do_resolve
+      @desc = nil
+    end
+
+    protected
+    # @return [Hash]
+    attr_reader :desc
+
+    def do_resolve
+
+    end
+  end
+end

data/lib/haveapi/go_client/parameters/global_meta_includes.rb

@@ -0,0 +1,17 @@
+require 'haveapi/go_client/parameters/base'
+
+module HaveAPI::GoClient
+  class Parameters::GlobalMetaIncludes < Parameters::Base
+    handle do |role, direction, name, desc|
+      role == :global_meta \
+        && direction == :input \
+        && name == 'includes' \
+        && desc[:type] == 'Custom'
+    end
+
+    protected
+    def do_resolve
+      @go_in_type = @go_out_type = 'string'
+    end
+  end
+end

data/lib/haveapi/go_client/parameters/resource.rb

@@ -0,0 +1,20 @@
+require 'haveapi/go_client/parameters/base'
+
+module HaveAPI::GoClient
+  class Parameters::Resource < Parameters::Base
+    handle do |role, direction, name, desc|
+      desc[:type] == 'Resource'
+    end
+
+    # Pointer to the associated resource
+    # @return [Parameters::Association]
+    attr_reader :association
+
+    protected
+    def do_resolve
+      @association = Parameters::Association.new(self, desc)
+      @go_in_type = 'int64'
+      @go_out_type = association.go_type
+    end
+  end
+end

data/lib/haveapi/go_client/parameters/typed.rb

@@ -0,0 +1,30 @@
+require 'haveapi/go_client/parameters/base'
+
+module HaveAPI::GoClient
+  class Parameters::Typed < Parameters::Base
+    handle do |role, direction, name, desc|
+      !%w(Custom Resource).include?(desc[:type])
+    end
+
+    protected
+    def do_resolve
+      @go_in_type = get_go_type(desc[:type])
+      @go_out_type = get_go_type(desc[:type])
+    end
+
+    def get_go_type(v)
+      case v
+      when 'String', 'Text', 'Datetime'
+        'string'
+      when 'Integer'
+        'int64'
+      when 'Float'
+        'float64'
+      when 'Boolean'
+        'bool'
+      else
+        fail "unsupported data type '#{v}'"
+      end
+    end
+  end
+end

data/lib/haveapi/go_client/resource.rb

@@ -0,0 +1,133 @@
+require 'haveapi/go_client/utils'
+
+module HaveAPI::GoClient
+  class Resource
+    include Utils
+
+    # Resource name as returned by the API
+    # @return [String]
+    attr_reader :name
+
+    # Parent resource or API version
+    # @return [ApiServer, Resource]
+    attr_reader :parent
+
+    # Full name with underscores
+    # @return [String]
+    attr_reader :full_name
+
+    # Full name with dots
+    # @return [String]
+    attr_reader :full_dot_name
+
+    # Name in Go
+    # @return [String]
+    attr_reader :go_name
+
+    # Type in Go
+    # @return [String]
+    attr_reader :go_type
+
+    # Child resources
+    # @return [Array<Resource>]
+    attr_reader :resources
+
+    # Resource actions
+    # @return [Array<Action>]
+    attr_reader :actions
+
+    def initialize(parent, name, desc, prefix: nil)
+      @parent = parent
+      @name = name.to_s
+      @prefix = prefix
+      @full_name = resource_path.map(&:name).join('_')
+      @full_dot_name = resource_path.map(&:name).map(&:capitalize).join('.')
+      @go_name = camelize(name)
+      @go_type = full_go_type
+      @resources = desc[:resources].map { |k, v| Resource.new(self, k, v) }
+      @actions = desc[:actions].map do |k, v|
+        Action.new(self, k.to_s, v, prefix: prefix)
+      end
+    end
+
+    # @return [ApiVersion]
+    def api_version
+      tmp = parent
+      tmp = tmp.parent until tmp.is_a?(ApiVersion)
+      tmp
+    end
+
+    # @return [Array<Resource>]
+    def parent_resources
+      parents = []
+      tmp = parent
+
+      while tmp.is_a?(Resource)
+        parents << tmp
+        tmp = tmp.parent
+      end
+
+      parents.reverse
+    end
+
+    # @return [Array<Resource>]
+    def resource_path
+      parent_resources + [self]
+    end
+
+    def resolve_associations
+      actions.each { |a| a.resolve_associations }
+      resources.each { |r| r.resolve_associations }
+    end
+
+    def generate(gen)
+      ErbTemplate.render_to_if_changed(
+        'resource.go',
+        {
+          package: gen.package,
+          resource: self,
+        },
+        File.join(gen.dst, prefix_underscore("resource_#{full_name}.go"))
+      )
+
+      resources.each { |r| r.generate(gen) }
+
+      actions.each do |a|
+        ErbTemplate.render_to_if_changed(
+          'action.go',
+          {
+            package: gen.package,
+            action: a,
+          },
+          File.join(gen.dst, prefix_underscore("resource_#{full_name}_action_#{a.name}.go"))
+        )
+      end
+    end
+
+    protected
+    attr_reader :prefix
+
+    def prefix_underscore(s)
+      if prefix
+        "#{prefix}_#{s}"
+      else
+        s
+      end
+    end
+
+    def prefix_camel(s)
+      if prefix
+        camelize(prefix) + s
+      else
+        s
+      end
+    end
+
+    def full_go_type
+      names = ['Resource']
+      names.concat(parent_resources.map(&:go_name))
+      names << go_name
+      prefix_camel(names.join(''))
+    end
+  end
+end

data/lib/haveapi/go_client/utils.rb

@@ -0,0 +1,10 @@
+module HaveAPI::GoClient
+  module Utils
+    # Remove underscores and capitalize names
+    # @param v [String]
+    # @return [String]
+    def camelize(v)
+      v.to_s.split('_').map(&:capitalize).join('')
+    end
+  end
+end

data/lib/haveapi/go_client/version.rb

@@ -0,0 +1,5 @@
+module HaveAPI
+  module GoClient
+    VERSION = '0.13.0'
+  end
+end

data/lib/haveapi/go_client.rb

@@ -0,0 +1,21 @@
+require 'require_all'
+
+module HaveAPI
+  module GoClient
+    # @param name [String] template within the `../../template/` directory,
+    #                      without `.erb` suffix
+    # @return [String] absolute path to the template
+    def self.tpl(name)
+      File.join(
+        File.dirname(__FILE__),
+        '..', '..',
+        'template',
+        "#{name}.erb"
+      )
+    end
+  end
+end
+
+require_rel 'go_client/*.rb'
+require_rel 'go_client/authentication'
+require_rel 'go_client/parameters'

data/shell.nix

@@ -0,0 +1,23 @@
+let
+  pkgs = import <nixpkgs> {};
+  stdenv = pkgs.stdenv;
+
+in stdenv.mkDerivation rec {
+  name = "haveapi-go-client";
+
+  buildInputs = with pkgs;[
+    git
+    go
+    gotools
+    openssl
+    ruby
+  ];
+
+  shellHook = ''
+    export GEM_HOME=$(pwd)/.gems
+    export PATH="$GEM_HOME/.gems/bin:$PATH"
+    gem install bundler
+    bundler install
+    #export RUBYOPT=-rbundler/setup
+  '';
+}