gapinc-cobbler 2.0.0

data/ChangeLog

@@ -0,0 +1,40 @@
+* Thu Jan 05 2012 duritong <peter.meier@immerda.ch> - 2.0.0-1
+- Fix all issues when API returns ~ on a nonexisting system
+- Add some missing fields to the System model
+- Remove unnecessary object abstraction for interfaces
+- Fix storing of interfaces
+- Rework connection handling
+- Rewrite to enable capabilities for all items and to work against 2.0  
+
+* Fri Oct 10 2008 Darryl Pierce <dpierce@redhat.com> - 0.1.1-1
+- Added support for image-based systems.
+
+* Mon Sep 08 2008 Darryl Pierce <dpierce@redhat.com> - 0.1.0-1
+- First official build for Fedora.
+
+* Wed Sep 03 2008 Darryl Pierce <dpierce@redhat.com> - 0.0.2-3
+- Added a build requirement for rubygem-rake.
+
+* Tue Aug 26 2008 Darryl Pierce <dpierce@redhat.com> - 0.0.2-2
+- Fixed the licensing in each source module to show the code is released under
+  LGPLv2.1.
+- Added %check to the spec file to run tests prior to creating the RPM.
+
+* Thu Aug 21 2008 Darryl Pierce <dpierce@redhat.com> - 0.0.2-1
+- Added a call to update prior to saving or updating a system. If the update
+  fails, then an Exception is raised.
+
+* Wed Aug 13 2008 Darryl Pierce <dpierce@redhat.com> - 0.0.1-3
+- Added caching for the auth_token to prevent extraneous calls to login.
+- Reworked and refined how cobbler_collection fields are processed, adding 
+  support for both array and has properties.
+- Rewrote the documentation for Cobbler::Base to make it easier to understand
+  how to extend it to support other Cobbler types.
+- Refactored the examples to clean up the code.
+
+* Wed Aug 13 2008 Darryl Pierce <dpierce@redhat.com> - 0.0.1-2
+- Removed markup of cobbler.yml and a config file. Fixed a few small bugs 
+  in the code for using it as a gem.
+
+* Mon Aug 04 2008 Darryl Pierce <dpierce@redhat.com> - 0.0.1-1
+- Initial package

data/Gemfile

@@ -0,0 +1,14 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+gem 'activesupport'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", "~> 2.5.0"
+  gem "rdoc", "~> 3.8"
+  gem "jeweler", "~> 1.6.4"
+end

data/Gemfile.lock

@@ -0,0 +1,41 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (4.1.0)
+      i18n (~> 0.6, >= 0.6.9)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.1)
+      tzinfo (~> 1.1)
+    diff-lcs (1.1.3)
+    git (1.2.6)
+    i18n (0.6.9)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    json (1.8.1)
+    minitest (5.3.2)
+    rake (10.2.2)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.2)
+    rspec-expectations (2.5.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.5.0)
+    thread_safe (0.3.3)
+    tzinfo (1.1.0)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  jeweler (~> 1.6.4)
+  rdoc (~> 3.8)
+  rspec (~> 2.5.0)

data/NEWS

@@ -0,0 +1,5 @@
+2012-01-05 2.0
+* Rewrite to be compatible with 2.0
+
+2008-08-01 0.0.1
+ * Initial release.

data/README.rdoc

@@ -0,0 +1,87 @@
+= ruby-cobbler
+
+Ruby bindings for interacting with Cobbler.
+
+These bindings were once part of the official cobbler repository. They were
+written by Darryl L. Pierce <dpierce@redhat.com>. However, they got stalled to
+work for cobbler 1.x and no further development was done. Also
+this version was missing a lot of features, like creating various objects etc.
+
+So I took over the development and while the work was done to get it working
+with a more recent cobbler version, but also to add the various missing
+features, the development of cobbler by RedHat stopped and the people continuing
+the work on cobbler decided to drop the ruby gem.
+So I decided to publish that gem on its own, but still keep it under the same
+License as Darryl L. Pierce <dpierce@redhat.com> published it originally.
+
+It is used to talk to a cobbler installation that ships with the latest RedHat
+Satellite and have tested with that.
+It is still a work in progress, but it is used, to create systems, delete systems,
+create and/or import repositories, sync repositories, work with the task engine,
+and so on.
+
+WARNING: It is possible that it does not work with a current cobbler version as
+the author does currently not have access to such an installation nor is any
+work planned to do so.
+Just give it a shot with a newer cobbler and if things don't work: pull requests
+are welcomed! See below.
+
+== USAGE
+
+To use the code, you must install the ruby gem named "cobbler" and then
+require 'cobbler' in your application. 
+
+Minimally you need to provide a server name for your Cobbler machine using:
+
+Cobbler::Base.hostname = my.cobbler.server
+
+If you intend to modify data on the Cobbler server, you'll need to also provide
+a username and password that has authorization:
+
+Cobbler::Base.username = username
+Cobbler::Base.password = password
+
+== Examples
+
+You'll find a few working examples in `examples/`
+
+An example on how to import a distribution is:
+
+    Cobbler::Base.hostname = localhost
+    Cobbler::Base.username = cobbler
+    Cobbler::Base.password = cobbler     
+    log_id = Cobbler::Base.import("/mnt/centos6.iso",'centos6','x86_64', 'breed' => 'redhat')
+    while (event = Cobbler::Base.events[log_id])[2] == 'running' do
+      puts "Current state is: #{event[2]} - #{event.inspect}"
+      sleep 60
+    end
+    puts "Import event: #{event.inspect}"
+    puts "All distros:"
+    Cobbler::Distro.find { |distro| puts "\"#{distro.name}\" is a breed of \"#{distro.breed}\"."}
+
+
+== CONFIGURATION
+
+By default, Cobbler::Base will load the file $SEARCHPATH/config/cobbler.yml,
+if it exists, and use that information for talking to Cobbler. To override 
+where this file lives, set the COBBLER_ENV environment variable *before* 
+requiring the 'cobbler' file. 
+
+However, these values can be overridden afterward by changing the fields in 
+Cobbler::Base directly.
+
+== Contributing to cobbler
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2012 duritong. See COPYING for
+further details.
+

data/Rakefile

@@ -0,0 +1,75 @@
+# Copyright (C) 2008 Red Hat, Inc.
+# Written by Darryl L. Pierce <dpierce@redhat.com>
+# Extended 2012 by duritong <peter.meier@immerda.ch>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; version 2 of the License.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+# MA  02110-1301, USA.  A copy of the GNU General Public License is
+# also available at http://www.gnu.org/copyleft/gpl.html.
+
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+
+require 'jeweler'
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+require 'cobbler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docgem.rubygems.org/read/chapter/20 for more options
+  gem.name = 'cobbler'
+  gem.version = "2.0.0"
+  gem.author = 'duritong'
+  gem.email = 'peter.meier@immerda.ch'
+  gem.homepage = 'http://github.com/duritong/ruby-cobbler/'
+  gem.platform = Gem::Platform::RUBY
+  gem.summary = 'An interface for interacting with a Cobbler server.'
+  gem.license = 'GPLv2'
+  gem.description = <<EOF
+  Provides Ruby bindings to interact with a Cobbler server.
+EOF
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+gem 'rdoc'
+require 'rdoc/task'
+RDoc::Task.new do |rdoc|
+  version = '2.0.0'
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "iuid #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/TODO

@@ -0,0 +1,6 @@
+This is a list of features to be developed in future.
+
+* Rewrite examples to fit the new style
+
+* Add hierarchical relationships, so that a Profile will load it's 
+  Distro, a System will load it's Profile, etc.

data/config/cobbler.yml

@@ -0,0 +1,5 @@
+# Cobbler connection details
+
+hostname: localhost
+username: cobbler
+password: cobbler

data/examples/example_distros.rb

@@ -0,0 +1,119 @@
+#
+# example_version.rb
+#
+# Copyright (C) 2008,2009 Red Hat, Inc.
+# Written by Darryl L. Pierce <dpierce@redhat.com>
+# Extended 2012 by duritong <peter.meier@immerda.ch>
+#
+# This file is part of rubygem-cobbler.
+#
+# rubygem-cobbler is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 2.1 of the License, or
+# (at your option) any later version.
+#
+# rubygem-cobbler is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with rubygem-cobbler.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+base = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+$LOAD_PATH << File.join(base, "lib")
+$LOAD_PATH << File.join(base, "examples")
+
+require 'utils'
+Cobbler::Examples::Utils.enhance(Cobbler::Distro)
+
+require 'getoptlong'
+
+opts = GetoptLong.new(
+  ['--show',    '-s', GetoptLong::REQUIRED_ARGUMENT ],
+  ['--list',    '-l', GetoptLong::NO_ARGUMENT],
+  ['--create',  '-c', GetoptLong::REQUIRED_ARGUMENT ],
+  ['--remove',  '-r', GetoptLong::REQUIRED_ARGUMENT ],
+  ['--testrun', '-t', GetoptLong::REQUIRED_ARGUMENT ]
+)
+
+def list
+    puts "All distros:"
+    Cobbler::Distro.find { |distro| puts "\"#{distro.name}\" is a breed of \"#{distro.breed}\"."}
+end
+
+def show(name)
+  puts "Finding the distro named \"#{name}\""
+    
+  if (distro = Cobbler::Distro.find_one(name))
+    puts "#{distro.name} exists, and is a breed of #{distro.breed}."
+    puts "Kernel: #{distro.kernel} - Initrd: #{distro.initrd}"
+  else
+    puts "No such distro"
+  end
+end
+
+def create(name)
+    existing_distro = Cobbler::Distro.find.first
+    unless existing_distro
+        puts "No existing distro found to copy data from... -> abort!"
+        exit 1
+    end
+    distro = Cobbler::Distro.new
+    distro.name = name
+    distro.breed = existing_distro.breed
+    distro.kernel = existing_distro.kernel
+    distro.initrd = existing_distro.initrd
+    distro.arch = existing_distro.arch
+    distro.save
+    
+    puts "Distro #{name} saved!"
+end
+
+def remove(name)
+    if (distro=Cobbler::Distro.find_one(name))
+        distro.remove
+        puts "Distro #{name} successfully removed!"
+    else
+        puts "No such distro named #{name} found! -> abort!"
+        exit 1
+    end
+end
+
+def testrun(name)
+    puts "Distros at the beginning"
+    puts "------------------------"
+    list
+    puts
+    puts "Create distro #{name}"
+    puts "---------------------"
+    create(name)
+    puts
+    puts "All distros after creating #{name}"
+    puts "----------------------------------"
+    list
+    puts
+    puts "Display distro #{name}"
+    puts "----------------------"
+    show(name)
+    puts
+    puts "Remove distro #{name}"
+    puts "---------------------"
+    remove(name)
+    puts
+    puts "Distros at the end"
+    puts "------------------"
+    list
+end
+
+opts.each do |opt, arg|
+  case opt
+    when '--show' then show(arg)
+    when '--list' then list
+    when '--create' then create(arg)
+    when '--remove' then remove(arg)
+    when '--testrun' then testrun(arg)
+  end
+  exit 0
+end

data/examples/example_version.rb

@@ -0,0 +1,31 @@
+#
+# example_distros.rb
+#
+# Copyright (C) 2008,2009 Red Hat, Inc.
+# Written by Darryl L. Pierce <dpierce@redhat.com>
+# Extended 2012 by duritong <peter.meier@immerda.ch>
+#
+# This file is part of rubygem-cobbler.
+#
+# rubygem-cobbler is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 2.1 of the License, or
+# (at your option) any later version.
+#
+# rubygem-cobbler is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with rubygem-cobbler.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+base = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+$LOAD_PATH << File.join(base, "lib")
+$LOAD_PATH << File.join(base, "examples")
+
+require 'utils'
+Cobbler::Examples::Utils.enhance
+
+puts "Cobbler version: #{Cobbler::Base.remote_version}"

data/examples/utils.rb

@@ -0,0 +1,44 @@
+#
+# cli.rb
+#
+# Copyright (C) 2008,2009 Red Hat, Inc.
+# Written by Darryl L. Pierce <dpierce@redhat.com>
+# Extended 2012 by duritong <peter.meier@immerda.ch>
+#
+# This file is part of rubygem-cobbler.
+#
+# rubygem-cobbler is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 2.1 of the License, or
+# (at your option) any later version.
+#
+# rubygem-cobbler is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with rubygem-cobbler.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+require 'cobbler'
+require 'yaml'
+
+module Cobbler
+    module Examples
+        module Utils
+            def self.enhance(clazz=Cobbler::Base)
+                config = (ENV['COBBLER_YML'] || File.expand_path(File.join(File.dirname(__FILE__),'..','config','cobbler.yml')))
+                if File.exist?(config) && (yml = YAML::load(File.open(config))) && (yml['hostname'] && yml['username'] && yml['password'])
+                    clazz.hostname = yml['hostname']
+                    clazz.username = yml['username']
+                    clazz.password = yml['password']
+                    clazz.debug_enabled = yml['debug']||false
+                else
+                    puts "Can't load configuration file (#{config}) with all necessary parameters. Either fix the yaml file or point COBBLER_YML to an appropriate file."
+                    exit 1
+                end
+            end
+        end
+    end
+end