RubyGems - MuranoCLI - Versions diffs - 3.2.1.pre.beta.6 → 3.2.1.pre.beta.7 - Mend

MuranoCLI 3.2.1.pre.beta.6 → 3.2.1.pre.beta.7

Files changed (228) hide show

data/docs/release.rst DELETED Viewed

@@ -1,295 +0,0 @@
-@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
-Murano CLI Ruby Gem Release Guide
-@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
-####################
-Gem Release Overview
-####################
-There are currently 3 Gems that Exosite publishes to support Murano CLI.
-[Current as of 2018-08-07.]
-- Murano CLI (``MuranoCLI``)
-- Ruby Commander (``murano-cli-rb-commander``)
-- Whirly (``murano-cli-whirly``)
-You will need XXX access to each gem at http://rubygems.org to be able
-to publish new versions (using ``gem push``, e.g., via ``rake release``).
-##############
-Ruby Gem Links
-##############
-==========
-Murano CLI
-==========
-http://rubygems.org/gems/MuranoCLI
-===========
-Hacked Gems
-===========
-(lb): FIXME/2018-08-07: It's entirely possible that we could get these
-changes incorporated upstream by opening Pull Requests, but I haven't
-wanted to manage those conversations yet. (It's too easy to fork and publish!)
-- Ruby Commander fork
-  http://rubygems.org/gems/murano-cli-commander
-  - Adds support for empty string option values,
-    e.g., ``--option ""``.
-- Whirly fork
-  http://rubygems.org/gems/murano-cli-whirly
-  - Fixes width calculation to not count ANSI color codes. Otherwise,
-    too many spaces might be printed to clear the line, erroneously
-    creating a line break (and pushing the progress up a line, when
-    it should instead remain on its current line).
-########################
-Gem Release Instructions
-########################
-===================================
-Murano CLI Gem Release Instructions
-===================================
-- Ensure tests pass.
-- Bump the version, if not already done.
-   Manually: Open ``lib/MrMurano/version.rb``, edit, commit, push, etc.
-   Automated: Use a rake task to bump the version, discussed below.
-  - a). If you're working on a feature and want to release a pre-release
-    gem, you can just change the version in your branch.
-    Choose one of the following rake tasks to run:
-    .. code-block:: sh
-      # Increment just the beta number:
-      rake bump:beta
-      # Or, increment the patch number, and start a fresh beta version:
-      rake bump:patch
-      # Or, increment the minor number, and start a fresh patch.beta version:
-      rake bump:minor
-      # Or, increment the major number, and start a fresh minor.patch.beta version:
-      rake bump:major
-    - Incorporate the version bump in the PR for the feature on which
-      you're working. Once the feature in merged to develop, you can
-      move to step #3 and make the pre-release.
-  - b). If you're instead ready to prepare a real release, bump the version
-    on the develop branch:
-    .. code-block:: sh
-      # Or, drop the beta version, and prepare an official release:
-      rake bump:release
-    - Follow the URL printed by the rake task and open a PR for
-      the version bump. Approve it, merge the change, and delete
-      the release branch.
-- Kick off the Gem release builder.
-  - a.) To prepare a pre-release Gem from the ``develop`` branch, run:
-    .. code-block:: sh
-      rake package:develop
-  - b.) To prepare an official release Gem from the ``master`` branch, run:
-    .. code-block:: sh
-      rake package:master
-  You'll be directed
-- Copy the Gem locally, and upload it to the official Gem repository.
-    .. code-block:: sh
-      rake package:publish
-Deprecated Resources
---------------------
-Build project on old Jenkins server (2018-08-07: no longer used, but still alive):
-  https://build.exosite.com/view/MuranoCLI/job/MrMurano%20Gem%20Release/
-Old Travic-CI project, from when project was public:
-  https://travis-ci.org/exosite/MuranoCLI
-==============================================
-Forked Ruby Commander Gem Release Instructions
-==============================================
-First, set the current version, and the version about to be released.
-.. code-block:: sh
-  WAS_VERS='4.4.6'
-  CUR_VERS='4.4.10'
-Next, prepare the branch, and then test, build and publish.
-.. code-block:: sh
-  cd /exo/clients/exosite/MuranoCLIs/murano-cli-commander
-  git co feature/empty_arg_support
-  git fetch commander-rb
-  git rebase commander-rb/master
-  /bin/sed -i -r \
-    "s/^  VERSION = '${WAS_VERS}'.freeze$/  VERSION = '${CUR_VERS}'.freeze/" \
-    lib/murano-cli-commander/version.rb
-  git diff lib/murano-cli-commander/version.rb
-  git add lib/murano-cli-commander/version.rb
-  git ci -m "Version ${CUR_VERS}"
-  # If you need to delete an existing tag of the same name, try:
-  #   git tag -d "v${CUR_VERS}"
-  # Tag the version. `rake release` also does this.
-  git tag -a "v${CUR_VERS}" -m "Version ${CUR_VERS}" feature/empty_arg_support
-  git push origin "v${CUR_VERS}"
-  # Test it.
-  rake spec
-  # Build it.
-  rake build
-  # Publish it (to Rubygems).
-  rake release
-If you need to pull a bad release, yank it.
-WARNING: You will never again be able to publish another release using the same version.
-.. code-block:: sh
-  $ gem yank murano-cli-commander -v ${CUR_VERS}
-======================================
-Forked Whirly Gem Release Instructions
-======================================
-::
-  CUR_VERS='0.2.7'
-  git tag -a "v${CUR_VERS}" -m "Version ${CUR_VERS}" develop
-  git push origin "v${CUR_VERS}"
-  # Test it.
-  rake spec
-  # Build it.
-  rake gem
-  # Publish it (to Rubygems).
-  rake release
-##########################################
-Troubleshooting Gem Release/Publish Issues
-##########################################
-===================================================================
-Gem Remove / Gem Purge / Remove Release / Kill Release Instructions
-===================================================================
-Yank/Remove/Unpublish Gem Version
----------------------------------
-You can ``gem yank <gem-name> -v <gem-vers>`` to remove a published gem.
-- Delete the gem from Rubygems.org using ``gem yank``.
-  See below for installation instructions.
-- You should also delete any corresponding archive managed by the repo,
-  i.e., at ``https://github.com/exosite/<gem-name>/releases``.
-  https://github.com/exosite/MuranoCLI/releases
-  https://github.com/exosite/murano-cli-commander/releases
-  https://github.com/exosite/murano-cli-whirly/releases
-  - Click the **release name** (*not the Edit button*)
-    and there you'll find the Delete option.
-- Caveat/Beware!: You cannot republish a yanked Gem!
-E.g.,
-  .. code-block:: sh
-    $ gem yank my-gem -v 1.0.0
-    $ rake release
-    # my-gem 1.0.0 built to pkg/my-gem-1.0.0.gem.
-    # Tag v1.1.0 has already been created.
-    # rake aborted!
-    # Pushing gem to https://rubygems.org...
-    # Repushing of gem versions is not allowed.
-    # Please use `gem yank` to remove bad gem releases.
-    # /home/user/.gem/ruby/2.3.3/gems/rake-12.3.1/exe/rake:27:in `<top (required)>'
-    # Tasks: TOP => release => release:rubygem_push
-    # (See full trace by running task with --trace)
-Install ``gemcutter`` (``gem yank``)
-------------------------------------
-Prerequisites::
-  gem update --system
-  gem install gemcutter
-OUTPUT::
-  Fetching: gemcutter-0.7.1.gem (100%)
-  ********************************************************************************
-             Thanks for installing Gemcutter! You can now run:
-    gem push        merged into RubyGems 1.3.6
-    gem owner       merged into RubyGems 1.3.6
-    gem webhook     register urls to be pinged when gems are pushed
-    gem yank        remove a specific version of a gem from RubyGemgem.org
-  ********************************************************************************
-  Successfully installed gemcutter-0.7.1
-  Parsing documentation for gemcutter-0.7.1
-  Installing ri documentation for gemcutter-0.7.1
-  Done installing documentation for gemcutter after 0 seconds
-  1 gem installed
-Delete/Remove/Revoke Published Ruby Gem, e.g.,::
-  gem yank MuranoCLI -v 3.2.0
-OUTPUT::
-  Yanking gem from https://rubygems.org...
-  Successfully deleted gem: MuranoCLI (3.2.0)

data/spec/Account-Passwords_spec.rb DELETED Viewed

@@ -1,245 +0,0 @@
-# Copyright © 2016-2017 Exosite LLC. All Rights Reserved
-# License: PROPRIETARY. See LICENSE.txt.
-# frozen_string_literal: true
-# vim:tw=0:ts=2:sw=2:et:ai
-# Unauthorized copying of this file is strictly prohibited.
-require 'tempfile'
-require 'MrMurano/version'
-require 'MrMurano/Account'
-require '_workspace'
-RSpec.describe MrMurano::Passwords, '#pwd' do
-  # Weird: This tests works on its own without the 'WORKSPACE',
-  # but when run with other tests, it fails. (2017-07-05: I think
-  # I just added the $cfg lines, because MrMurano::Passwords
-  # expects $cfg to be loaded... [lb].)
-  include_context 'WORKSPACE'
-  before(:example) do
-    @saved_cfg = ENV['MURANO_CONFIGFILE']
-    ENV['MURANO_CONFIGFILE'] = nil
-    $cfg = MrMurano::Config.new
-    $cfg.load
-    @saved_pwd = ENV['MURANO_PASSWORD']
-    ENV['MURANO_PASSWORD'] = nil
-  end
-  after(:example) do
-    ENV['MURANO_PASSWORD'] = @saved_pwd
-    ENV['MURANO_CONFIGFILE'] = @saved_cfg
-  end
-  it 'Creates a file ' do
-    tmpfile = Dir.tmpdir + '/pwtest' # This way because Tempfile.new creates.
-    begin
-      pwd = MrMurano::Passwords.new(tmpfile)
-      pwd.save
-      expect(FileTest.exist?(tmpfile))
-    ensure
-      File.unlink(tmpfile) if File.exist? tmpfile
-    end
-  end
-  it "Creates a file in a directory that doesn't exist." do
-    tmpfile = Dir.tmpdir + '/deeper/pwtest' # This way because Tempfile.new creates.
-    begin
-      pwd = MrMurano::Passwords.new(tmpfile)
-      pwd.save
-      expect(FileTest.exist?(tmpfile))
-    ensure
-      File.unlink(tmpfile) if File.exist? tmpfile
-    end
-  end
-  it 'Loads a file' do
-    Tempfile.open('test') do |tf|
-      tf << %(---
-this.is.a.host:
-  user: password
-)
-      tf.close
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      ps = pwd.get('this.is.a.host', 'user')
-      expect(ps).to eq('password')
-    end
-  end
-  it 'Saves a file' do
-    Tempfile.open('pstest') do |tf|
-      tf.close
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.set('this.is.a.host', 'user3', 'passwords4')
-      pwd.save
-      File.open(tf.path) do |io|
-        data = io.read
-        expect(data).to eq(%(---
-this.is.a.host:
-  user3: passwords4
-))
-      end
-    end
-  end
-  it 'Writes multiple hosts' do
-    Tempfile.open('pwtest') do |tf|
-      tf.close
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.set('this.is.a.host', 'user3', 'passwords4')
-      pwd.save
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      ps = pwd.get('this.is.a.host', 'user3')
-      expect(ps).to eq('passwords4')
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      pwd.set('another.host', 'user9', 'passwords2')
-      pwd.save
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      ps = pwd.get('this.is.a.host', 'user3')
-      expect(ps).to eq('passwords4')
-      ps = pwd.get('another.host', 'user9')
-      expect(ps).to eq('passwords2')
-    end
-  end
-  it 'Write multiple users to same host' do
-    Tempfile.open('pwstest') do |tf|
-      tf.close
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.set('this.is.a.host', 'user3', 'passwords4')
-      pwd.save
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      pwd.set('this.is.a.host', 'user9', 'passwords2')
-      pwd.save
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      ps = pwd.get('this.is.a.host', 'user3')
-      expect(ps).to eq('passwords4')
-      ps = pwd.get('this.is.a.host', 'user9')
-      expect(ps).to eq('passwords2')
-    end
-  end
-  it 'lists usernames' do
-    Tempfile.open('pwstest') do |tf|
-      tf.close
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.set('this.is.a.host', 'user3', 'passwords4')
-      pwd.save
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      pwd.set('this.is.a.host', 'user9', 'passwords2')
-      pwd.save
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      ret = pwd.list
-      expect(ret).to match(
-        'this.is.a.host' => a_collection_containing_exactly('user9', 'user3')
-      )
-    end
-  end
-  it 'removes username' do
-    Tempfile.open('pwstest') do |tf|
-      tf.close
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.set('this.is.a.host', 'user3', 'passwords4')
-      pwd.save
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      pwd.set('this.is.a.host', 'user9', 'passwords2')
-      pwd.save
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      pwd.remove('this.is.a.host', 'user3')
-      pwd.save
-      pwd = MrMurano::Passwords.new(tf.path)
-      pwd.load
-      ret = pwd.list
-      expect(ret).to match('this.is.a.host' => ['user9'])
-    end
-  end
-  context 'Uses ENV' do
-    before(:example) do
-      ENV['MR_PASSWORD'] = nil
-    end
-    after(:example) do
-      ENV['MR_PASSWORD'] = nil
-    end
-    it 'Uses ENV instead' do
-      Tempfile.open('test') do |tf|
-        tf << %(---
-this.is.a.host:
-  user: password
-        )
-        tf.close
-        ENV['MURANO_PASSWORD'] = 'a test!'
-        pwd = MrMurano::Passwords.new(tf.path)
-        pwd.load
-        expect(pwd).not_to receive(:warning)
-        ps = pwd.get('this.is.a.host', 'user')
-        expect(ps).to eq('a test!')
-        ENV['MURANO_PASSWORD'] = nil
-      end
-    end
-    it 'Uses ENV instead, even with empty file' do
-      Tempfile.open('test') do |tf|
-        tf.close
-        ENV['MURANO_PASSWORD'] = 'a test!'
-        pwd = MrMurano::Passwords.new(tf.path)
-        pwd.load
-        expect(pwd).not_to receive(:warning)
-        ps = pwd.get('this.is.a.host', 'user')
-        expect(ps).to eq('a test!')
-        ENV['MURANO_PASSWORD'] = nil
-        data = IO.read(tf.path)
-        expect(data).to eq('')
-      end
-    end
-    it 'Warns about migrating' do
-      Tempfile.open('test') do |tf|
-        tf.close
-        ENV['MR_PASSWORD'] = 'a test!'
-        pwd = MrMurano::Passwords.new(tf.path)
-        pwd.load
-        expect(pwd).to receive(:warning).once
-        ps = pwd.get('this.is.a.host', 'user')
-        expect(ps).to eq('a test!')
-      end
-    end
-  end
-end