hammer_cli_import 0.10.21

data/README.md

@@ -0,0 +1,115 @@
+# hammer-cli-import
+
+Tool for importing data from an existing Spacewalk/Satellite system.
+
+THIS TOOL IS WORK IN PROGRESS.
+
+## Setup info
+
+To enable modules do the following:
+
+~~~~ { .bash }
+mkdir -p ~/.hammer
+cat >> ~/.hammer/cli_config.yml << EOF
+:modules:
+  - hammer_cli_import
+EOF
+~~~~
+
+And running with
+
+~~~ { .bash }
+env RUBYOPT=-Ilib hammer import
+~~~
+
+To build/install as a gem:
+
+~~~ { .bash }
+gem build hammer_cli_import.gemspec
+gem install hammer_cli_import-0.0.1.gem
+hammer import
+~~~
+
+## RuboCop
+
+[RuboCop][rubocop] requires at least Ruby 1.9.2. That is available in SCL.
+
+~~~ { .bash }
+yum install -y ruby193-ruby-devel
+scl enable ruby193 "gem install rubocop"
+~~~
+
+It needs to be run with newer Ruby too (it will pick up its configuration
+automatically when run from the root of repository).
+
+~~~ { .bash }
+scl enable ruby193 "/opt/rh/ruby193/root/usr/local/share/gems/gems/*/bin/rubocop"
+~~~
+
+## Development
+
+You can add to your `~/.irbrc`:
+
+~~~ { .ruby }
+class Object
+  def imethods
+    methods - Object.instance_methods
+  end
+
+  def methods_re(re)
+    methods.select do |m|
+      re.match m.to_s
+    end
+  end
+end
+~~~
+
+### Reproducers
+
+You can play with apipie-bindings on command line. For that you need bundler. Example session:
+
+~~~
+[hammer-cli-import]$ gem install bundler
+[hammer-cli-import]$ bundle exec irb
+
+require 'apipie-bindings'
+api = ApipieBindings::API.new({:uri => 'http://localhost/', :username => 'admin', :password => :changeme, :api_version => '2', :aggressive_cache_checking => true})
+user_hash = {
+:login => "newuser",
+:firstname => "user",
+:lastname => "new",
+:mail => "root@localhost",
+:auth_source_id => 1,
+:password => "password",
+:organization_ids => [13],
+:default_organization_id => 13,
+:location_ids => [],
+:role_ids => [],
+}
+api.resource(:users).call(:create, user_hash)
+~~~
+
+or create `reproducer.rb` and then run it via `bundle exec ruby reproducer.rb`.
+
+~~~ { .ruby }
+require 'apipie-bindings'
+
+api = ApipieBindings::API.new({:uri => 'http://localhost/', :username => 'admin',
+                               :password => 'changeme', :api_version => '2',
+                               :aggressive_cache_checking => true})
+user_hash = {
+  :login => 'newuser',
+  :firstname => 'user',
+  :lastname => 'new',
+  :mail => 'root@localhost',
+  :auth_source_id => 1,
+  :password => 'password',
+  :organization_ids => [13],
+  :default_organization_id => 13,
+  :location_ids => [],
+  :role_ids => []
+}
+api.resource(:users).call(:create, user_hash)
+~~~
+
+[rubocop]: http://batsov.com/rubocop/ "Ruby code analyzer"