cl-magic 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 504fca48eea3cb6eca83e8025a98e4f3187f19286b81134b42b53a0a639f2b9b
+  data.tar.gz: 1269ba9642497c4e7541598d3ba180a09b2e5c033627ae9e60cbd545ba3f4e91
+SHA512:
+  metadata.gz: b56850adb7d7182d6a72777236902b7b961493f3780c209675c268381c4ccfc78a339ea740f38ed9dd16c2a96f8c102efa24ea3527435699830219b7a5b9e8c9
+  data.tar.gz: a83324b6a355286f9ad2cfaf7b034ca93b710f2706da1fb4e1b61722575a6477e42763d669b082bc72dc308fa5c78195cedaa64c755f9ef4d250f98b36e443b0

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in cl-magic.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "minitest", "~> 5.0"

data/Gemfile.lock

@@ -0,0 +1,47 @@
+PATH
+  remote: .
+  specs:
+    cl-magic (0.3.0)
+      optparse-subcommand
+      pastel
+      tty-command
+      tty-logger
+      tty-prompt
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    byebug (11.1.3)
+    minitest (5.18.0)
+    optparse-subcommand (1.0.0)
+    pastel (0.8.0)
+      tty-color (~> 0.5)
+    rake (13.0.6)
+    tty-color (0.6.0)
+    tty-command (0.10.1)
+      pastel (~> 0.8)
+    tty-cursor (0.7.1)
+    tty-logger (0.6.0)
+      pastel (~> 0.8)
+    tty-prompt (0.23.1)
+      pastel (~> 0.8)
+      tty-reader (~> 0.8)
+    tty-reader (0.9.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+      wisper (~> 2.0)
+    tty-screen (0.8.1)
+    wisper (2.0.1)
+
+PLATFORMS
+  arm64-darwin-21
+  ruby
+
+DEPENDENCIES
+  byebug
+  cl-magic!
+  minitest (~> 5.0)
+  rake (~> 13.0)
+
+BUNDLED WITH
+   2.3.6

data/README.md

@@ -0,0 +1,211 @@
+# CL-MAGIC
+
+Magic tools for a turnkey developer experience.
+
+## Installation
+
+```
+gem install cl-magic
+```
+
+And make it available everywhere
+
+```
+# find magic tools
+MAGIC_INSTALLED_AT="$(gem info cl-magic | grep Installed | cut -d':' -f2 | xargs)/gems"
+MAGIC_DIR="$(ls -d1 $MAGIC_INSTALLED_AT/cl-magic-*)"
+
+# install vendorized gems
+cd $MAGIC_DIR bundle install --path=vendor
+
+# symlink
+ln -s $MAGIC_DIR/bin/cl /usr/local/bin
+```
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+# OLD OLD OLD OLD OLD OLD OLD OLD OLD OLD OLD OLD
+
+# Terminal
+
+* `sudo nano /etc/motd`
+* add some [ascii art](https://www.asciiart.eu/) to bring you joy
+* make your prompt not suck PROMPT='\w $ '
+* or [customize the prompt](https://ss64.com/bash/syntax-prompt.html) yourself
+
+## IOS
+
+Install [iTerm2](https://iterm2.com/) and fix the coloring
+
+By adding the following to your `.zshrc`
+
+```
+export CLICOLOR=1
+export TERM=xterm-256color
+```
+
+Install [homebrew](https://brew.sh/)
+
+# Useful packages
+
+Install the basics: `jq git vim`
+* mac `the_silver_searcher`
+* linux `silversearcher-ag`
+
+## IOS
+
+Database clients
+
+```
+brew install libpq
+brew link --force libpq
+brew install mysql-client
+```
+
+Github CLI
+
+```
+brew install gh
+```
+
+## Linux
+
+Database clients
+
+```
+sudo apt-get install default-mysql-client postgresql-client
+```
+
+Github CLI
+
+* [install instructions](https://github.com/cli/cli/blob/trunk/docs/install_linux.md)
+
+# Editor
+
+[VSCode](https://code.visualstudio.com/)
+
+# Docker
+
+Install docker
+
+* [docker desktop](https://docs.docker.com/get-docker/)
+* [docker on linux](https://docs.docker.com/engine/install/debian/)
+
+Resources
+
+* go to your docker desktop -> preferences -> resources and set CPU=5 and Memory 10GB
+* give it a healthy amount of resources if you don't like waiting and want to avoid Error 137
+* Remember to "apply & restart" or restart with `sudo systemctl restart docker`
+
+# Git
+Often pre-installed, but you need to configure it by editing `~/.gitconfig`
+
+```
+[user]
+    email = you@domain.com
+    name = First Last
+[core]
+    excludesfile = ~/.gitignore
+[alias]
+    map = log --pretty=oneline --abbrev-commit --graph --all
+    ls = log --graph --pretty=oneline --abbrev-commit
+[pull]
+    rebase = true
+[init]
+    defaultBranch = main
+[log]
+    abbrevcommit = yes
+[fetch]
+    prune = true
+```
+
+# SSH key
+
+* generate a key with `ssh-keygen`, if you don't already have one?
+* go with the default name `id_rsa` and give it a password
+* then cat `~/.ssh/id_rsa.pub` and copy the contents to github settings ssh keys
+
+# Cloud tools
+
+## Install gcloud
+
+* confirm python works `python3 --version`; if not install it `brew install python3`.
+* then follow instructions: [Install the Google Cloud CLI](https://cloud.google.com/sdk/docs/install-sdk)
+* when you `gcloud init`, you'll need to know your project name and zone
+
+## K8 tools
+
+Install [kubectl](https://kubernetes.io/docs/tasks/tools/)
+
+Install Krew
+* Kubectl [has plugins](https://kubernetes.io/docs/tasks/extend-kubectl/kubectl-plugins/) and
+* the [krew plugin manager](https://krew.sigs.k8s.io/) helps you install them.
+* Use the [quickstart to install krew](https://krew.sigs.k8s.io/docs/user-guide/setup/install/#bash).
+
+K8 Logs
+
+* [stern](https://github.com/wercker/stern) is a must have tool for reading logs
+* install with `kubectl krew install stern`
+
+## HashiCorp Vault & Terraform
+
+Linux users follow instructions on [terraform.io]](https://www.terraform.io/cli/install/apt)
+
+IOS instructions
+
+```
+brew tap hashicorp/tap
+brew install hashicorp/tap/vault
+brew install hashicorp/tap/terraform
+```
+
+# Programming
+
+## Node
+
+[nodenv](https://github.com/nodenv/nodenv) - manage different versions of node
+* NOTE: sometimes we install ancient versions with nodenv and that requires python2
+* you’ll have it by using the ENV variable (ex. `PYENV_VERSION=2.7.15 nodenv install some_ancient_version`)
+
+## Ruby
+
+[rbenv](https://github.com/rbenv/rbenv) - manage different versions of ruby
+
+# Magic Tools
+
+Correct version of ruby
+
+```
+rbenv install 2.7.5
+```
+
+Clone the repo and install the tools
+
+```
+bundle install --path=vendor
+```
+
+Symlink so it's available everywhere
+
+```
+sudo ln -s $(pwd)/bin/cl /usr/local/bin/cl
+```
+
+## DK command
+
+For the dk command you’ll want an alias
+
+```
+echo alias dk=\"cl dk\" >> ~/.zshrc
+source ~/.zshrc
+```
+
+You’ll want to ignore the generated .cl-dk.yaml that this command creates so `echo ".cl-dk.yml" >> ~/.gitignore`

data/bin/cl

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+# know where you were
+CL_WORKING_DIR="$(pwd)"
+
+# know where magic happens
+SOURCE="${BASH_SOURCE[0]}"
+while [ -h "$SOURCE" ]; do # resolve $SOURCE until the file is no longer a symlink
+  MAGIC_DIR="$( cd -P "$( dirname "$SOURCE" )" >/dev/null 2>&1 && pwd )"
+  SOURCE="$(readlink "$SOURCE")"
+  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE" # if $SOURCE was a relative symlink, we need to resolve it relative to the path where the symlink file was located
+done
+MAGIC_DIR="$( cd -P "$( dirname "$SOURCE" )/../lib/cl/magic" >/dev/null 2>&1 && pwd )"
+
+# make magic - with the correct version of ruby & the bundle
+cd $MAGIC_DIR
+RBENV_VERSION=2.7.5 CL_WORKING_DIR=$CL_WORKING_DIR bundle exec cl $@

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "cl/magic"
+
+# 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(__FILE__)

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/cl-magic.gemspec

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "lib/cl/magic/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "cl-magic"
+  spec.version = Cl::Magic::VERSION
+  spec.authors = ["Don Najd"]
+  spec.email = ["dnajd7@gmail.com"]
+  spec.summary = "Magic tools for a turnkey developer experience"
+  spec.description = ""
+  spec.homepage = "https://gitlab.com/beesbot/cl-magic"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.6.0"
+
+  # metadata
+  spec.metadata["allowed_push_host"] = "https://rubygems.org/"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://gitlab.com/beesbot/cl-magic"
+  spec.metadata["changelog_uri"] = "https://gitlab.com/beesbot/cl-magic"
+
+  # files
+  spec.files = Dir.glob("{bin,lib}/**/*")
+  spec.files << 'cl-magic.gemspec'
+  spec.files << 'Gemfile'
+  spec.files << 'Gemfile.lock'
+  spec.files << 'README.md'
+  spec.require_path = "lib"
+
+  # dependencies
+  spec.add_development_dependency "rake"
+  spec.add_dependency "optparse-subcommand"
+  spec.add_dependency "tty-logger"
+  spec.add_dependency "tty-command"
+  spec.add_dependency "tty-prompt"
+  spec.add_dependency "pastel"
+  spec.add_development_dependency "byebug"
+end

data/lib/cl/magic/cl

@@ -0,0 +1,97 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'tty-command'
+require 'cl/magic/common/logging.rb'
+
+
+@logger = get_logger()
+
+#
+# Features
+#
+
+def get_command_tree()
+  command_tree = {}
+  filenames = Dir.glob('cl-*').select { |e| File.file? e }
+  filenames.each do |filename|
+    fn_parts = filename.split('-')[1..-1]
+    case fn_parts.length
+    when 1
+      # add top level command
+      cmd_group = command_tree.fetch('', []) << {
+        cmd: fn_parts.first,
+        filename: filename,
+      }
+      command_tree[''] = cmd_group
+    else
+      # add nested command
+      cmd_group = command_tree.fetch(fn_parts.first, []) << {
+        cmd: fn_parts[1..-1].join('-'),
+        filename: filename,
+      }
+      command_tree[fn_parts.first] = cmd_group
+    end
+  end
+  return command_tree
+end
+
+def print_help(banner, command_tree)
+  puts banner
+  command_tree.keys.sort.each do |group|
+    puts ""
+    puts group unless group.empty?
+    sorted_commands = command_tree[group].sort_by{|h| h[:cmd]}
+    print_commands(sorted_commands)
+  end
+  puts ""
+end
+
+def print_commands(commands, prefix='   ')
+  commands.sort_by{|h| h[:cmd]}.each do |cmd_hash|
+    puts "#{prefix}#{cmd_hash[:cmd]}"
+  end
+end
+
+def execute_subcommand(subcommand, command_tree)
+  commands = command_tree.fetch(subcommand, [])
+
+  case commands.length
+  when 0
+    commands = command_tree[''] # global command?
+  else
+    commands = command_tree.fetch(subcommand, [])
+    subcommand = ARGV.shift if commands.any? # next part of command
+    if subcommand.nil?
+      print_commands(commands)
+      exit(0)
+    end
+  end
+  cmd = commands.select {|c| c[:cmd]==subcommand}.first
+  final = "bundle exec ./#{cmd[:filename]} #{ARGV.join(' ')}"
+  exec(final)
+end
+
+#
+# Options
+#
+
+banner = <<DOC
+
+Commmand Line Magic Tools
+
+Usage: cl [sub-command]
+
+COMMANDS:
+DOC
+
+#
+# Run
+#
+
+subcommand = ARGV.shift
+command_tree = get_command_tree()
+if subcommand.nil?
+  print_help(banner, command_tree)
+else
+  execute_subcommand(subcommand, command_tree)
+end

data/lib/cl/magic/cl-auth

@@ -0,0 +1,109 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'optparse/subcommand'
+require 'tty-command'
+require 'tty-prompt'
+
+require 'cl/magic/common/common_options.rb'
+require 'cl/magic/common/logging.rb'
+require 'cl/magic/common/gcloud.rb'
+require 'cl/magic/common/kubectl.rb'
+
+@logger = get_logger()
+@cl_cmd_name = "cl aws okta-auth"
+
+#
+# Features
+#
+
+def auth_gcp_docker(options)
+  write_history("""#{@cl_cmd_name}""")
+  cmd = "gcloud auth configure-docker"
+  @logger.puts
+  @logger.wait cmd
+  exec(cmd)
+end
+
+def github_cli(options)
+  write_history("""#{@cl_cmd_name}""")
+  cmd = "gh auth login"
+  @logger.puts
+  @logger.wait cmd
+  exec(cmd)
+end
+
+#
+# Options
+#
+
+
+options = {}
+global_banner = <<DOC
+
+ Authenticate things from the command line
+
+ Usage: #{@cl_cmd_name} [options]
+
+DOC
+
+gcp_docker_banner = <<DOC
+
+ Authenticate with google cloud docker
+
+ Usage: #{@cl_cmd_name} gcp-docker [options]
+
+DOC
+
+github_cli_banner = <<DOC
+
+ Authenticate with https://cli.github.com/
+
+ Usage: #{@cl_cmd_name} github-cli [options]
+
+DOC
+
+aws_okta_banner = <<DOC
+
+ Authenticate with https://github.com/segmentio/aws-okta
+
+ Usage: #{@cl_cmd_name} aws-okta [options]
+
+DOC
+
+global = OptionParser.new do |g|
+  g.banner = global_banner
+  add_help_and_verbose(g)
+
+  g.subcommand 'gcp-docker' do |s|
+    s.banner = gcp_docker_banner
+    options[:action] = :gcp_docker
+  end
+
+  g.subcommand 'github-cli' do |s|
+    s.banner = github_cli_banner
+    options[:action] = :github_cli
+  end
+
+  g.subcommand 'aws-okta' do |s|
+    s.banner = aws_okta_banner
+    options[:action] = :aws_okta
+  end
+
+end
+
+#
+# Run
+#
+
+global.parse(ARGV)
+
+case options[:action]
+when :gcp_docker
+  auth_gcp_docker(options)
+when :github_cli
+  github_cli(options)
+when :aws_okta
+  aws_okta(options)
+else
+  puts global.parse! %w[--help]
+end

data/lib/cl/magic/cl-aws-okta-auth

@@ -0,0 +1,52 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'optparse/subcommand'
+require 'tty-command'
+require 'tty-prompt'
+
+require 'cl/magic/common/common_options.rb'
+require 'cl/magic/common/logging.rb'
+require 'cl/magic/common/gcloud.rb'
+require 'cl/magic/common/kubectl.rb'
+
+@logger = get_logger()
+@cl_cmd_name = File.basename(__FILE__).split('-').join(' ')
+
+#
+# Features
+#
+
+def aws_okta(options)
+  write_history("""#{@cl_cmd_name}""")
+  cmd = "aws-okta add"
+  @logger.puts
+  @logger.wait cmd
+  exec(cmd)
+end
+
+#
+# Options
+#
+
+
+options = {}
+global_banner = <<DOC
+
+ Authenticate with https://github.com/segmentio/aws-okta
+
+ Usage: #{@cl_cmd_name} aws-okta auth [options]
+
+DOC
+
+global = OptionParser.new do |g|
+  g.banner = global_banner
+  add_help_and_verbose(g)
+end
+
+#
+# Run
+#
+
+global.parse(ARGV)
+
+aws_okta(options)

data/lib/cl/magic/cl-aws-okta-env

@@ -0,0 +1,79 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'optparse/subcommand'
+require 'tty-command'
+require 'tty-prompt'
+
+require 'cl/magic/common/common_options.rb'
+require 'cl/magic/common/logging.rb'
+require 'cl/magic/common/gcloud.rb'
+require 'cl/magic/common/kubectl.rb'
+
+@logger = get_logger()
+@cl_cmd_name = "cl aws okta-env"
+
+#
+# Features
+#
+
+def get_aws_profiles()
+  command = "cat ~/.aws/config | grep 'profile' | cut -d ' ' -f 2 | cut -d ']' -f 1"
+  return TTY::Command.new(:printer => :null).run(command).out.strip.chomp.split(' ').collect {|v|[v]}
+end
+
+def do_work(options)
+  is_tty = $stdout.isatty
+
+  # pick profile
+  profiles = get_aws_profiles()
+  profile = pick_single_result(profiles, "Pick aws profile", options[:aws_profile])
+  options[:aws_profile] = profile.first
+
+  # history
+  history_command = """#{@cl_cmd_name} \\
+  --aws-profile #{options[:aws_profile]}
+"""
+  write_history(history_command)
+
+  # do work
+  if is_tty
+    puts
+    @logger.info "export into your environment with"
+    puts
+    puts "export $(#{history_command})"
+  else
+    cmd = "aws-okta exec #{options[:aws_profile]} -- env | grep AWS_"
+    exec(cmd)
+  end
+end
+
+#
+# Options
+#
+
+
+options = {}
+global_banner = <<DOC
+
+ Fetch environment variables using https://github.com/segmentio/aws-okta
+
+ Usage: #{@cl_cmd_name} aws-okta env [options]
+
+DOC
+
+global = OptionParser.new do |g|
+  g.banner = global_banner
+  add_help_and_verbose(g)
+
+  g.on("-p", "--aws-profile PROFILE", "aws profile name in ~/.aws/config") do |v|
+    options[:aws_profile] = v
+  end
+end
+
+#
+# Run
+#
+
+global.parse(ARGV)
+
+do_work(options)