hammer_cli_foreman_bootdisk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0602d92eda12db552f671b531a7a0b59ebbbb0a4
+  data.tar.gz: c135ff0152ff4de4fe36b792d55cc81d18e743b9
+SHA512:
+  metadata.gz: 8a332fb880b7a42c0f1d91d74fbef22626182184ebc725ded9eb26f154f6edacf51e59166e69a9039b4790b22b9e851b9fc4364f318eb1216bdca7c5a44f9511
+  data.tar.gz: 9d111df3681cf2f66d9cefc00ec10ea139ab0b2e4396c21640bbdc1a69d73e39814c24b65b2290df01106a483c30712961349613227738fce98b94a80a2cd20a

data/README.md

@@ -0,0 +1,60 @@
+Foreman boot disk commands for Hammer CLI
+=========================================
+
+This [Hammer CLI](https://github.com/theforeman/hammer-cli) plugin contains
+set of commands for [foreman_bootdisk](https://github.com/theforeman/foreman_bootdisk),
+a plugin to [Foreman](http://theforeman.org/) for ISO/USB booting support
+
+Documentation
+-------------
+
+Basic configuration of Hammer to communicate with Foreman is covered in the
+hammer-cli-foreman documentation:
+
+ - [Hammer CLI Foreman configuration](https://github.com/theforeman/hammer-cli-foreman/blob/master/doc/configuration.md)
+
+To download the generic disk (ISO/USB) image, run:
+
+    hammer bootdisk generic
+
+Or to download a per-host disk, run:
+
+    hammer bootdisk host --host client.example.com
+
+Files will be downloaded into the current directory unless `--file` is used to set the
+destination:
+
+    hammer bootdisk generic --file /tmp/generic.iso
+
+If a device is given to `--file`, you can write the image directly to it by adding the
+`--force` option.  Needless to say, but **double check** the device name is correct to
+avoid overwriting the wrong disk.
+
+    hammer bootdisk generic --file /dev/sdb --force
+
+When running hammer as an unprivileged user with no access to the device, add `--sudo`
+to execute `sudo dd` for the copy.  Password prompts may be shown if NOPASSWD is not
+configured.
+
+    hammer bootdisk generic --file /dev/sdb --force --sudo
+
+
+How to run
+----------
+
+We build rpms, debs and gems. Alternatively you can install hammer from a git checkout.
+See our [Hammer CLI installation and configuration instuctions](https://github.com/theforeman/hammer-cli/blob/master/doc/installation.md#installation).
+
+Having issues?
+--------------
+
+If one of hammer commands doesn't work as you would expect, you can run `hammer -d ...` to get
+full debug output from the loggers. It should give you an idea what went wrong.
+
+If you have questions, don't hesitate to contact us on `foreman-users@googlegroups.com` or
+`Freenode#theforeman` IRC channel.
+
+License
+-------
+
+This project is licensed under the GPLv3+.

data/lib/hammer_cli_foreman_bootdisk.rb

@@ -0,0 +1,20 @@
+require 'pry'
+require 'hammer_cli_foreman'
+
+module HammerCLIForemanBootdisk
+  def self.exception_handler_class
+    HammerCLIForeman::ExceptionHandler
+  end
+
+  begin
+    require 'hammer_cli_foreman_bootdisk/commands'
+
+    HammerCLI::MainCommand.lazy_subcommand('bootdisk', _("Download boot disks"),
+      'HammerCLIForemanBootdisk::Bootdisk', 'hammer_cli_foreman_bootdisk/bootdisk'
+    )
+  rescue => e
+    handler = HammerCLIForeman::ExceptionHandler.new(:context => {}, :adapter => :base)
+    handler.handle_exception(e)
+    raise HammerCLI::ModuleLoadingError.new(e)
+  end
+end

data/lib/hammer_cli_foreman_bootdisk/bootdisk.rb

@@ -0,0 +1,27 @@
+module HammerCLIForemanBootdisk
+  class Bootdisk < HammerCLIForeman::Command
+    resource :disks
+
+    class GenericCommand < HammerCLIForemanBootdisk::DownloadCommand
+      action :generic
+
+      command_name    'generic'
+      success_message _('Successfully downloaded generic disk image to %s')
+      failure_message _('Failed to download generic disk image')
+
+      build_options
+    end
+
+    class HostCommand < HammerCLIForemanBootdisk::DownloadCommand
+      action :host
+
+      command_name    'host'
+      success_message _('Successfully downloaded host disk image to %s')
+      failure_message _('Failed to download host disk image')
+
+      build_options
+    end
+
+    autoload_subcommands
+  end
+end

data/lib/hammer_cli_foreman_bootdisk/commands.rb

@@ -0,0 +1,36 @@
+require 'tempfile'
+require 'hammer_cli_foreman/commands'
+
+module HammerCLIForemanBootdisk
+  class DownloadCommand < HammerCLIForeman::Command
+    option "--file", "PATH", _("File or device to write image to")
+    option "--force", :flag, _("Force writing to existing destination (device etc.)")
+    option "--sudo", :flag, _("Use sudo to write to device")
+
+    def print_data(record)
+      server_filename = $1 if record.headers[:content_disposition] =~ /filename=["']?([^\s,;"']+)/
+      file = options[HammerCLI.option_accessor_name('file')] || server_filename || 'bootdisk.iso'
+      if !options[HammerCLI.option_accessor_name('force')] && File.exist?(file) && !File.file?(file)
+        raise(HammerCLIForeman::OperationNotSupportedError, _("Destination %s already exists and isn't a regular file, use '--force' if you are sure you wish to write to it") % file)
+      end
+
+      if options[HammerCLI.option_accessor_name('sudo')]
+        temp_file = Tempfile.new('bootdisk')
+        begin
+          File.write(temp_file, record)
+          system('sudo', 'dd', "if=#{temp_file.path}", "of=#{file}", 'bs=1024')
+        ensure
+          temp_file.close
+          temp_file.unlink
+        end
+      else
+        File.write(file, record)
+      end
+      print_message (success_message % file) if success_message
+    end
+
+    def request_options
+      {:response => :raw}
+    end
+  end
+end

data/lib/hammer_cli_foreman_bootdisk/i18n.rb

@@ -0,0 +1,24 @@
+require 'hammer_cli/i18n'
+
+module HammerCLIForemanBootdisk
+  module I18n
+
+    class LocaleDomain < HammerCLI::I18n::LocaleDomain
+
+      def translated_files
+        Dir.glob(File.join(File.dirname(__FILE__), '../**/*.rb'))
+      end
+
+      def locale_dir
+        File.join(File.dirname(__FILE__), '../../locale')
+      end
+
+      def domain_name
+        'hammer_cli_foreman_bootdisk'
+      end
+    end
+
+  end
+end
+
+HammerCLI::I18n.add_domain(HammerCLIForemanBootdisk::I18n::LocaleDomain.new)

data/lib/hammer_cli_foreman_bootdisk/version.rb

@@ -0,0 +1,5 @@
+module HammerCLIForemanBootdisk
+  def self.version
+    @version ||= Gem::Version.new '0.1.0'
+  end
+end

data/locale/Makefile

@@ -0,0 +1,65 @@
+#
+# Makefile for PO merging and MO generation. More info in the README.
+#
+# make all-mo (default) - generate MO files
+# make check - check translations using translate-tool
+# make tx-update - download and merge translations from Transifex
+# make clean - clean everything
+#
+DOMAIN = hammer_cli_foreman_bootdisk
+VERSION = $(shell ruby -e 'require "rubygems";spec = Gem::Specification::load("../hammer_cli_foreman_bootdisk.gemspec");puts spec.version')
+POTFILE = $(DOMAIN).pot
+MOFILE = $(DOMAIN).mo
+POFILES = $(shell find . -name '*.po')
+MOFILES = $(patsubst %.po,%.mo,$(POFILES))
+POXFILES = $(patsubst %.po,%.pox,$(POFILES))
+
+%.mo: %.po
+	mkdir -p $(shell dirname $@)/LC_MESSAGES
+	msgfmt -o $(shell dirname $@)/LC_MESSAGES/$(MOFILE) $<
+
+# Generate MO files from PO files
+all-mo: $(MOFILES)
+
+# Check for malformed strings
+%.pox: %.po
+	msgfmt -c $<
+	pofilter --nofuzzy -t variables -t blank -t urls -t emails -t long -t newlines \
+		-t endwhitespace -t endpunc -t puncspacing -t options -t printf -t validchars --gnome $< > $@
+	cat $@
+	! grep -q msgid $@
+
+check: $(POXFILES)
+	msgfmt -c ${POTFILE}
+
+# Merge PO files
+update-po:
+	for f in $(shell find ./ -name "*.po") ; do \
+		msgmerge -N --backup=none -U $$f ${POTFILE} ; \
+	done
+
+# Unify duplicate translations
+uniq-po:
+	for f in $(shell find ./ -name "*.po") ; do \
+		msguniq $$f -o $$f ; \
+	done
+
+tx-pull:
+	tx pull -f
+	for f in $(POFILES) ; do \
+		sed -i 's/^\("Project-Id-Version: \).*$$/\1$(DOMAIN) $(VERSION)\\n"/' $$f; \
+	done
+	-git commit -a -m "i18n - extracting new, pulling from tx"
+
+extract-strings:
+	bundle exec rake gettext:find
+
+reset-po:
+	# merging po files is unnecessary when using transifex.com
+	git checkout -- ../locale/*/*po
+
+tx-update: tx-pull extract-strings reset-po $(MOFILES)
+	# amend mo files
+	git add ../locale/*/LC_MESSAGES
+	git commit -a --amend -m "i18n - extracting new, pulling from tx"
+	-echo Changes commited!

data/locale/README.md

@@ -0,0 +1,18 @@
+Updating the translations
+-------------------------
+
+  1. Check if there are any new languages with progress more than 50% on [transifex](https://www.transifex.com/projects/p/foreman/resource/hammer_cli_foreman_bootdisk/). If so, do the following for each of the new languages:
+
+  ```
+    mkdir locale/<lang>
+    cp locale/hammer_cli_foreman_bootdisk.pot locale/<lang>/hammer_cli_foreman_bootdisk.po
+  ```
+  2. Make sure you have `transifex-client` installed
+
+  3. Update the translations. From GIT repo root directory run:
+
+  ```
+    make -C locale tx-update
+  ```
+
+  It will download translations from transifex, generates `mo` files, updates strings in `pot` file and wraps all the changes in a new commit. Transifex automatically updates its strings when the commit is pushed to Github.

data/locale/en/hammer_cli_foreman_bootdisk.po

@@ -0,0 +1,57 @@
+# Hammer CLI Foreman Bootdisk
+# Copyright (C) 2014
+# This file is distributed under the same license as the hammer_cli_foreman_bootdisk package.
+# Dominic Cleal <dcleal@redhat.com>, 2014
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: hammer_cli_foreman_bootdisk 0.1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2014-08-08 14:31+0100\n"
+"PO-Revision-Date: 2014-08-08 14:24+0100\n"
+"Last-Translator: Foreman Team <foreman-dev@googlegroups.com>\n"
+"Language-Team: Foreman Team <foreman-dev@googlegroups.com>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#: lib/hammer_cli_foreman_bootdisk/commands.rb:6
+msgid "File or device to write image to"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/commands.rb:7
+msgid "Force writing to existing destination (device etc.)"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/commands.rb:8
+msgid "Use sudo to write to device"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/commands.rb:14
+msgid ""
+"Destination %s already exists and isn't a regular file, use '--force' if you "
+"are sure you wish to write to it"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/bootdisk.rb:9
+msgid "Successfully downloaded generic disk image to %s"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/bootdisk.rb:10
+msgid "Failed to download generic disk image"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/bootdisk.rb:19
+msgid "Successfully downloaded host disk image to %s"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/bootdisk.rb:20
+msgid "Failed to download host disk image"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk.rb:12
+msgid "Download boot disks"
+msgstr ""

data/locale/hammer_cli_foreman_bootdisk.pot

@@ -0,0 +1,57 @@
+# Hammer CLI Foreman Bootdisk
+# Copyright (C) 2014
+# This file is distributed under the same license as the hammer_cli_foreman_bootdisk package.
+# Dominic Cleal <dcleal@redhat.com>, 2014
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: hammer_cli_foreman_bootdisk 0.1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2014-08-08 14:31+0100\n"
+"PO-Revision-Date: 2014-08-08 14:24+0100\n"
+"Last-Translator: Foreman Team <foreman-dev@googlegroups.com>\n"
+"Language-Team: Foreman Team <foreman-dev@googlegroups.com>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#: lib/hammer_cli_foreman_bootdisk/commands.rb:6
+msgid "File or device to write image to"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/commands.rb:7
+msgid "Force writing to existing destination (device etc.)"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/commands.rb:8
+msgid "Use sudo to write to device"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/commands.rb:14
+msgid ""
+"Destination %s already exists and isn't a regular file, use '--force' if you "
+"are sure you wish to write to it"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/bootdisk.rb:9
+msgid "Successfully downloaded generic disk image to %s"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/bootdisk.rb:10
+msgid "Failed to download generic disk image"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/bootdisk.rb:19
+msgid "Successfully downloaded host disk image to %s"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk/bootdisk.rb:20
+msgid "Failed to download host disk image"
+msgstr ""
+
+#: lib/hammer_cli_foreman_bootdisk.rb:12
+msgid "Download boot disks"
+msgstr ""

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: hammer_cli_foreman_bootdisk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Dominic Cleal
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hammer_cli_foreman
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+description: Foreman boot disk commands for Hammer CLI
+email: dcleal@redhat.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- lib/hammer_cli_foreman_bootdisk/version.rb
+- lib/hammer_cli_foreman_bootdisk/i18n.rb
+- lib/hammer_cli_foreman_bootdisk/commands.rb
+- lib/hammer_cli_foreman_bootdisk/bootdisk.rb
+- lib/hammer_cli_foreman_bootdisk.rb
+- locale/README.md
+- locale/Makefile
+- locale/en/hammer_cli_foreman_bootdisk.po
+- locale/en/LC_MESSAGES/hammer_cli_foreman_bootdisk.mo
+- locale/hammer_cli_foreman_bootdisk.pot
+- README.md
+homepage: http://github.com/theforeman/hammer_cli_foreman_bootdisk
+licenses:
+- GPL v3+
+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.0.6
+signing_key: 
+specification_version: 4
+summary: Foreman boot disk commands for Hammer
+test_files: []