k_ext-github 0.0.2

data/bin/setup

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

data/hooks/pre-commit

@@ -0,0 +1,87 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'English'
+
+# NOTE: you may need change file permissions
+#       chmod +x hooks/pre-commit
+
+exit 0 if ARGV.include?('--no-verify')
+
+warning_keywords = %w[console.log]
+keywords = %w[binding.pry console.dir byebug debugger]
+files_changed = `git diff-index --name-only HEAD --`.split
+
+# puts '----------------------------------------------------------------------'
+# puts remove files changed from the pre-commit checking if they are one of the following files
+# puts '----------------------------------------------------------------------'
+# files_changed = files_changed - ['hooks/pre-commit']
+# files_changed = files_changed - ['hooks/update-version']
+
+# byebug may need to be in these files
+files_changed -= ['Gemfile']
+files_changed -= ['Gemfile.lock']
+files_changed -= ['.gitignore']
+files_changed -= ['README.md']
+
+files_changed = files_changed.reject { |f| f.downcase.end_with?('.json') }
+files_changed = files_changed.reject { |f| f.downcase.end_with?('.yml') }
+
+# ignore files from specific folders
+
+file_groups = files_changed.select do |item|
+  item.start_with?('hooks') # ||
+  # item.start_with?('lib/generators')
+end
+
+files_changed -= file_groups
+
+# remove files that are changed because they are deleted
+files_changed = files_changed.select { |filename| File.file?(filename) }
+
+# puts '----------------------------------------------------------------------'
+# puts 'Files Changed'
+# puts '----------------------------------------------------------------------'
+# puts files_changed
+# puts '----------------------------------------------------------------------'
+
+unless files_changed.length.zero?
+  # puts "#{keywords.join('|')}"
+  # puts "#{files_changed.join(' ')}"
+
+  `git grep -q -E "#{warning_keywords.join('|')}" #{files_changed.join(' ')}`
+
+  if $CHILD_STATUS.exitstatus.zero?
+    puts '' # Check following lines:''
+    puts $CHILD_STATUS.exitstatus
+    files_changed.each do |file|
+      warning_keywords.each do |keyword|
+        # puts "#{keyword} ::: #{file}"
+        `git grep -q -E #{keyword} #{file}`
+        if $CHILD_STATUS.exitstatus.zero?
+          line = `git grep -n #{keyword} #{file} | awk -F ":" '{print $2}'`.split.join(', ')
+          puts "WARNING:\t\033[31m#{file}\033[0m contains #{keyword} at line \033[33m#{line}\033[0m."
+        end
+      end
+    end
+  end
+
+  `git grep -q -E "#{keywords.join('|')}" #{files_changed.join(' ')}`
+
+  if $CHILD_STATUS.exitstatus.zero?
+    puts '' # Check following lines:''
+    puts $CHILD_STATUS.exitstatus
+    files_changed.each do |file|
+      keywords.each do |keyword|
+        # puts "#{keyword} ::: #{file}"
+        `git grep -q -E #{keyword} #{file}`
+        if $CHILD_STATUS.exitstatus.zero?
+          line = `git grep -n #{keyword} #{file} | awk -F ":" '{print $2}'`.split.join(', ')
+          puts "ERROR  :\t\033[31m#{file}\033[0m contains #{keyword} at line \033[33m#{line}\033[0m."
+        end
+      end
+    end
+    puts '# Force commit with --no-verify'
+    exit 1
+  end
+end

data/hooks/update-version

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# NOTE: you may need change file permissions
+#       chmod +x hooks/update-version
+
+exit 1 if ARGV.empty?
+
+version = ARGV[0]
+version = version[1..-1] # revoke 'v' character, e.g. v0.1.1 becomes 0.1.1
+
+namespaces = %w[KExt Github]
+
+indent = 0
+output = ['# frozen_string_literal: true', '']
+
+namespaces.each do |namespace|
+  output.push "#{'  ' * indent}module #{namespace}"
+  indent += 1
+end
+
+output.push "#{'  ' * indent}VERSION = \'#{version}'"
+indent -= 1
+
+namespaces.each do
+  output.push "#{'  ' * indent}end"
+  indent -= 1
+end
+
+output.push('')
+
+printf "%-25<label>s : %<version>s\n", label: 'GEM VERSION', version: version
+File.open('lib/k_ext/github/version.rb', 'w+') { |f| f.write(output.join("\n")) }

data/k_ext-github.gemspec

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative 'lib/k_ext/github/version'
+
+Gem::Specification.new do |spec|
+  spec.required_ruby_version  = '>= 2.5'
+  spec.name                   = 'k_ext-github'
+  spec.version                = KExt::Github::VERSION
+  spec.authors                = ['David Cruwys']
+  spec.email                  = ['david@ideasmen.com.au']
+
+  spec.summary                = 'KExt/Github provides useful github extensions specifically for the klueless code generator'
+  spec.description            = <<-TEXT
+    KExt/Github provides useful github extensions specifically for the klueless code generator
+  TEXT
+  spec.homepage               = 'http://appydave.com/gems/k-ext-github'
+  spec.license                = 'MIT'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.' unless spec.respond_to?(:metadata)
+
+  # spec.metadata['allowed_push_host'] = "Set to 'http://mygemserver.com'"
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/klueless-io/k_ext-github'
+  spec.metadata['changelog_uri'] = 'https://github.com/klueless-io/k_ext-github/commits/master'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the RubyGem files that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.match(%r{^(test|spec|features)/})
+    end
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+  # spec.extensions    = ['ext/k_ext_github/extconf.rb']
+
+  spec.add_dependency 'k_log', '~> 0.0.0'
+  spec.add_dependency 'k_type', '~> 0.0.0'
+  # spec.add_dependency 'k_util'                , '~> 0.0.0'
+  spec.add_dependency 'octokit', '~> 4.0'
+
+  spec.add_dependency 'virtus', '~> 1.0.5'
+end

data/lib/k_ext/github.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'virtus'
+require 'k_log'
+
+require 'k_ext/github/version'
+require 'k_ext/github/configuration'
+require 'k_ext/github/models/hook'
+require 'k_ext/github/models/owner'
+require 'k_ext/github/models/repository'
+require 'k_ext/github/printer'
+require 'k_ext/github/api'
+
+module KExt
+  module Github
+    # raise KExt::Github::Error, 'Sample message'
+    class Error < StandardError; end
+
+    class << self
+      def configuration
+        @configuration ||= KExt::Github::Configuration.new
+      end
+
+      def reset
+        @configuration = KExt::Github::Configuration.new
+      end
+
+      def configure
+        yield(configuration)
+      end
+    end
+  end
+end
+
+if ENV['KLUE_DEBUG']&.to_s&.downcase == 'true'
+  namespace = 'KExt::Github::Version'
+  file_path = $LOADED_FEATURES.find { |f| f.include?('k_ext/github/version') }
+  version = KExt::Github::VERSION.ljust(9)
+  puts "#{namespace.ljust(35)} : #{version.ljust(9)} : #{file_path}"
+end

data/lib/k_ext/github/api.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+module KExt
+  module Github
+    # Print formatted log for GitHub data such as repositories
+    require 'octokit'
+
+    # The API provides a limited set of service methods for working against GitHub
+    class Api
+      include KLog::Logging
+      include Virtus.model
+
+      # attribute :client_id, String, :writer => :private
+      # attribute :secret, String, :writer => :private
+
+      # attribute :sites, Array[Netlify::Site], :writer => :private
+      attribute :client, Octokit::Client, writer: :private
+
+      def self.instance(access_token)
+        GithubApi.new(token: access_token)
+      end
+
+      # Create API for communicating with GitHub
+      #
+      # Provide token OR login/password
+      #
+      # Create a token here
+      # https://github.com/settings/tokens/new
+      #
+      # @param [String] token
+      # @param [String] login
+      # @param [String] password
+      def initialize(token: nil, login: nil, password: nil)
+        auth(token: token, login: login, password: password) if token || login || password
+      end
+
+      # Authenticate against GitHub with username and password or token
+      #
+      # Provide token OR login/password
+      #
+      # Create a token here
+      # https://github.com/settings/tokens/new
+      # @param [String] token
+      # @param [String] login
+      # @param [String] password
+      def auth(token: nil, login: nil, password: nil)
+        raise 'Provide credentials. Token or username/password' if token.nil? && (login.nil? || password.nil?)
+
+        self.client = if token.nil?
+                        Octokit::Client.new(login: login, password: password)
+                      else
+                        Octokit::Client.new(access_token: token)
+                      end
+
+        # Fetch the current user
+        log.kv 'GitHub User', client.user.name
+      end
+
+      # --------------------------------------------------------------------------------
+      # Service Actions
+      # --------------------------------------------------------------------------------
+
+      # list of repositories for this user
+      #
+      def repositories
+        items = @client.repositories({}, query: { per_page: 100 })
+
+        items.map { |item| KExt::Github::Models::Repository.new(item) }
+      end
+
+      # create repository
+      #
+      # @param [String] repository_name e.g. klueless-io/z-test-aerial.com
+      def create_repository(repository_name, **options)
+        @client.create_repository(repository_name, options)
+      end
+
+      # delete repository
+      #
+      # @param [String] repository_name e.g. klueless-io/z-test-aerial.com
+      def delete_repository(repository_name, **options)
+        @client.delete_repository(repository_name, **options)
+      end
+
+      # list of hooks for repository
+      #
+      # @param [String] repository_name e.g. klueless-io/z-test-aerial.com
+      def hooks(repository_name)
+        items = @client.hooks(repository_name)
+
+        items.map { |item| KExt::Github::Models::Hook.new(item) }
+      end
+
+      # list of repositories for organization
+      #
+      # @param [String] org_name Organization name
+      def organization_repositories(org_name)
+        items = @client.repositories(org_name, query: { per_page: 100 })
+
+        items.map { |item| KExt::Github::Models::Repository.new(item) }
+      end
+      # organization_repositories(org, options = {}) => Array<Sawyer::Resource> (also: #org_repositories, #org_repos)
+
+      # remove hook from repository by id
+      #
+      # @param [String] repository_name e.g. klueless-io/z-test-aerial.com
+      # @param [Integer] id hook ID
+      def remove_hook(repository_name, id)
+        @client.remove_hook(repository_name, id)
+      end
+
+      # remove all hooks in a repository
+      #
+      # @param [String] repository_name e.g. klueless-io/z-test-aerial.com
+      def remove_hooks(repository_name)
+        hooks = hooks(repository_name)
+
+        hooks.each do |hook|
+          @client.remove_hook(repository_name, hook.id)
+        end
+      end
+    end
+  end
+end

data/lib/k_ext/github/configuration.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module KExt
+  module Github
+    # Configuration class for KExt::Github
+    class Configuration
+      attr_accessor :user
+      attr_accessor :personal_access_token
+      attr_accessor :personal_access_token_delete
+
+      def initialize
+        @user = ENV['GITHUB_USER']
+        @personal_access_token = ENV['GITHUB_PERSONAL_ACCESS_TOKEN']
+        @personal_access_token_delete = ENV['GITHUB_PERSONAL_ACCESS_TOKEN_DELETE']
+      end
+    end
+  end
+end

data/lib/k_ext/github/models/hook.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module KExt
+  module Github
+    module Models
+      # This model represents a GitHub hook
+      class Hook
+        include Virtus.model
+
+        def initialize(attributes = nil)
+          # Virtus will take your attributes and match them to the attribute definitions listed below
+          super(attributes)
+        end
+
+        attribute :type, String
+        attribute :id, String
+        attribute :name, String
+        attribute :active, String
+        attribute :events, String
+        attribute :config, Hash
+        attribute :updated_at, String
+        attribute :created_at, String
+        attribute :url, String
+        attribute :test_url, String
+        attribute :ping_url, String
+        attribute :last_response, String
+      end
+    end
+  end
+end

data/lib/k_ext/github/models/owner.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module KExt
+  module Github
+    module Models
+      # This model represents a GitHub owner
+      class Owner
+        include Virtus.model
+
+        def initialize(attributes = nil)
+          # Virtus will take your attributes and match them to the attribute definitions listed below
+          super(attributes)
+        end
+
+        attribute :login, String
+      end
+    end
+  end
+end

data/lib/k_ext/github/models/repository.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module KExt
+  module Github
+    module Models
+      # This model represents a GitHub Repository
+      class Repository
+        include Virtus.model
+
+        def initialize(attributes = nil)
+          # Virtus will take your attributes and match them to the attribute definitions listed below
+          super(attributes)
+        end
+
+        attribute :id, String
+        attribute :node_id, String
+        attribute :name, String
+        attribute :full_name, String
+        attribute :private, String
+        attribute :description, String
+        attribute :url, String
+        attribute :created_at, String
+        attribute :updated_at, String
+        attribute :pushed_at, String
+        attribute :git_url, String
+        attribute :owner, KExt::Github::Models::Owner
+      end
+    end
+  end
+end