ruby-amt 0.1.0

data/Rakefile

@@ -0,0 +1,292 @@
+# -*- ruby -*-
+
+# load all optional developer libraries
+begin
+  require 'rubygems'
+  require 'rake/gempackagetask'
+rescue LoadError
+end
+
+begin
+  require 'webgen/webgentask'
+  require 'webgen/page'
+rescue LoadError
+end
+
+require 'rdoc/task'
+require 'rdoc/rdoc'
+
+class RDoc::RDoc
+
+  alias :old_parse_files :parse_files
+
+  def parse_files(options)
+    file_info = old_parse_files(options)
+    require 'amt/service'
+    require 'amt/utility'
+
+    # Add documentation to AMT::Utility::Enum classes
+    RDoc::TopLevel.all_classes_and_modules.select do |tl|
+      use_it = false
+      while !use_it && !tl.module? && (tl = tl.superclass) && tl.kind_of?(RDoc::NormalClass) && tl.full_name != 'Object'
+        use_it = (tl.full_name == 'AMT::Utility::Enum')
+      end
+      use_it
+    end.each do |tl|
+      klass = tl.full_name.split(/::/).inject(Object){ |mod, name| mod.const_get(name) }
+      docs = "<p>Available enumeration values:</p>\n<ul>\n"
+      klass.values.sort {|a,b| a.value <=> b.value }.each do |val|
+        docs += "<li>"
+        docs += val.value.to_s
+        docs += " (#{val.name.to_s})" if val.name && val.name.to_s != val.value.to_s && val.name.to_s != val.description.to_s
+        docs += ": #{val.description}" if val.description && val.description != val.value.to_s
+        docs += "</li>"
+      end
+      docs += "</ul>\n"
+      tl.comment += docs.gsub(/^/, '# ')
+    end
+
+    # Add documentation to AMT::Utility::BitStruct classes
+    RDoc::TopLevel.all_classes_and_modules.select do |tl|
+      use_it = false
+      while !use_it && !tl.module? && (tl = tl.superclass) && tl.kind_of?(RDoc::NormalClass) && tl.full_name != 'Object'
+        use_it = (tl.full_name == 'AMT::Utility::BitStruct')
+      end
+      use_it
+    end.each do |tl|
+      klass = tl.full_name.split(/::/).inject(Object){ |mod, name| mod.const_get(name) }
+      klass.fields[:boolean].each do |name, desc|
+        meth = RDoc::AnyMethod.new("", "#{name}?")
+        meth.comment = "Getter for boolean field <i>#{name}</i>\n\n#{desc}"
+        tl.add_method(meth)
+        meth = RDoc::AnyMethod.new('', "#{name}!")
+        meth.comment = "Setter for boolean field <i>#{name}</i>\n\n#{desc}"
+        tl.add_method(meth)
+      end
+      klass.fields[:unsigned].each do |name, desc|
+        attr = RDoc::Attr.new("", name.to_s, 'RW', desc)
+        tl.add_attribute(attr)
+      end
+      klass.fields[:enum].each do |name, values, desc|
+        docs = desc + "\n\nAvailable enumeration values:\n"
+        values.sort.each {|k,v| docs += "[<tt>#{k}</tt>] #{v}\n"}
+        attr = RDoc::Attr.new("", name.to_s, 'RW', docs)
+        tl.add_attribute(attr)
+      end
+    end
+
+    file_info
+  end
+
+end
+
+
+begin
+  require 'rubyforge'
+rescue LoadError
+end
+
+begin
+  require 'rcov/rcovtask'
+rescue LoadError
+end
+
+require 'fileutils'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/packagetask'
+
+$:.unshift('lib')
+require 'amt/version'
+
+# End user tasks ################################################################
+
+task :default => :test
+
+desc "Install using setup.rb"
+task :install do
+  ruby "setup.rb config"
+  ruby "setup.rb setup"
+  ruby "setup.rb install"
+end
+
+task :clobber do
+  ruby "setup.rb clean"
+end
+
+desc "Build the whole user documentation"
+task :doc => :rdoc
+
+if defined? Webgen
+  desc "Generate the HTML documentation"
+  Webgen::WebgenTask.new('htmldoc') do |site|
+    site.clobber_outdir = true
+    site.config_block = lambda do |config|
+      config['sources'] = [['/', "Webgen::Source::FileSystem", 'doc']]
+      config['output'] = ['Webgen::Output::FileSystem', 'htmldoc']
+    end
+  end
+  task :doc => :htmldoc
+end
+
+rd = RDoc::Task.new do |rdoc|
+  rdoc.rdoc_dir = 'htmldoc/rdoc'
+  rdoc.title = 'ruby-amt'
+  rdoc.main = 'lib/amt/system.rb'
+  rdoc.options << '--line-numbers' << '--all'
+  rdoc.rdoc_files.include('lib')
+end
+
+tt = Rake::TestTask.new do |test|
+  test.libs << 'test'
+end
+
+# Release tasks and development tasks ############################################
+
+namespace :dev do
+
+  SUMMARY = 'ruby-amt is a library for controlling Intel AMT devies via SOAP'
+  DESCRIPTION = <<EOF
+Intel AMT (Active Management Technology) is available on every computer having
+the Intel vPro moniker and allows one to get and set various information about
+the computer as well as to control it remotely.
+EOF
+
+  begin
+    REL_PAGE = Webgen::Page.from_data(File.read('doc/news/release_' + AMT::VERSION.split('.').join('_') + '.page'))
+  rescue
+    puts 'NO RELEASE NOTES/CHANGES FILE'
+  end
+
+  PKG_FILES = FileList.new([
+                            'Rakefile',
+                            'setup.rb',
+                            'VERSION', 'AUTHORS', 'ChangeLog',
+                            'COPYING', 'GPL',
+                            'doc/**/*',
+                            'lib/**/*.rb',
+                            'test/test_*.rb'
+                           ]) do |fl|
+    fl.exclude('**/.gitignore')
+  end
+
+  CLOBBER << "VERSION"
+  file 'VERSION' do
+    puts "Generating VERSION file"
+    File.open('VERSION', 'w+') {|file| file.write(AMT::VERSION + "\n")}
+  end
+
+  CLOBBER << 'ChangeLog'
+  file 'ChangeLog' do
+    puts "Generating ChangeLog file"
+    `git log --name-only > ChangeLog`
+  end
+
+  Rake::PackageTask.new('ruby-amt', AMT::VERSION) do |pkg|
+    pkg.need_tar = true
+    pkg.need_zip = true
+    pkg.package_files = PKG_FILES
+  end
+
+  if defined? Gem
+    spec = Gem::Specification.new do |s|
+
+      #### Basic information
+      s.name = 'ruby-amt'
+      s.version = AMT::VERSION
+      s.summary = SUMMARY
+      s.description = DESCRIPTION
+
+      #### Dependencies, requirements and files
+
+      s.files = PKG_FILES.to_a
+      s.add_dependency('handsoap', '>= 1.1.1')
+      s.add_dependency('httpclient', '>= 2.1.5.2')
+      s.require_path = 'lib'
+
+      #### Documentation
+
+      s.has_rdoc = true
+      s.rdoc_options = ['--line-numbers', '--all', '-m', 'lib/amt/system.rb']
+
+      #### Author and project details
+
+      s.author = 'Thomas Leitner'
+      s.email = 't_leitner@gmx.at'
+      s.homepage = "http://ruby-amt.rubyforge.org"
+      s.rubyforge_project = 'ruby-amt'
+    end
+
+    Rake::GemPackageTask.new(spec) do |pkg|
+      pkg.need_zip = true
+      pkg.need_tar = true
+    end
+
+  end
+
+  desc 'Release ruby-amt version ' + AMT::VERSION
+  task :release => [:clobber, :package, :publish_files, :publish_doc, :post_news]
+
+  if defined? RubyForge
+    desc "Upload the release to Rubyforge"
+    task :publish_files => [:package] do
+      print 'Uploading files to Rubyforge...'
+      $stdout.flush
+
+      rf = RubyForge.new
+      rf.configure
+      rf.login
+
+      rf.userconfig["release_notes"] = REL_PAGE.blocks['content'].content
+      rf.userconfig["preformatted"] = false
+
+      files = %w[.gem .tgz .zip].collect {|ext| "pkg/ruby-amt-#{AMT::VERSION}" + ext}
+
+      rf.add_release('ruby-amt', 'ruby-amt', AMT::VERSION, *files)
+      puts 'done'
+    end
+
+    desc 'Post announcement to rubyforge.'
+    task :post_news do
+      print 'Posting announcement to Rubyforge ...'
+      $stdout.flush
+      rf = RubyForge.new
+      rf.configure
+      rf.login
+
+      content = REL_PAGE.blocks['content'].content
+      content += "\n\n\nAbout ruby-amt\n\n#{AMT::SUMMARY}\n\n#{AMT::DESCRIPTION}"
+      rf.post_news('ruby-amt', "ruby-amt #{AMT::VERSION} released", content)
+      puts "done"
+    end
+  end
+
+  desc "Upload the ruby-amt website to Rubyforge"
+  task :publish_doc => ['rdoc', 'htmldoc'] do
+    sh "rsync -avc --delete --exclude 'wiki' --exclude 'robots.txt'  htmldoc/ gettalong@rubyforge.org:/var/www/gforge-projects/ruby-amt/"
+  end
+
+  desc "Run the tests one by one to check for missing deps"
+  task :test_isolated do
+    files = Dir['test/test_*']
+    puts "Checking #{files.length} tests"
+    failed = files.select do |file|
+      okay = system("ruby -Ilib:test #{file} -vs &> /dev/null")
+      print(okay ? '.' : 'E')
+      !okay
+    end
+    puts
+    failed.each {|file| puts "Problem with" + file.rjust(40) }
+  end
+
+  if defined? Rcov
+    Rcov::RcovTask.new do |rcov|
+      rcov.libs << 'test'
+    end
+  end
+
+end
+
+task :clobber => ['dev:clobber']
+
+# Helper methods ###################################################################

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/doc/default.css

@@ -0,0 +1,211 @@
+* { margin:0; padding:0; }
+body, div, span, p, a, img, ul, ol, li, table, th, tr, td, form, fieldset, legend, dl, dt, dd, blockquote, applet, object { border:0; }
+body {
+    padding: 0;
+    background: #fff url("img/bg.jpg") repeat-x;
+    font: 0.8em/1.5 "arial",sans-serif;
+    color: #354146;
+    text-align: center;
+}
+
+/* links --------------------------------------------------------------- */
+a {color:#1666a3;}
+a:link {color:#1666a3;}
+a:hover {color:#0b4775;}
+
+/* header tags --------------------------------------------------------------------- */
+h1, h2, h3, h4, h5, h6 { margin:15px 0 10px 0; }
+h1 { font-size:200%; font-family: Georgia;}
+h1#logo a{color: #ced1d2; text-decoration: none; display: block;padding: 18px 0 17px; font-weight: normal;}
+h1#logo a:hover{color: #fff;}
+h1#logo span.slogan {font-size: 60%; padding-left: 1.5em;}
+h2 { font-size:130%; color: #354146;font-weight: bold; padding: 0; }
+h3 { font-size:120%; }
+h4 { font-size:120%; }
+h5 { font-size:100%; }
+
+/* layout ---------------------------------------------------------------------- */
+#layout {
+    text-align:left;
+}
+#container {
+    clear: both;
+}
+#intro{
+    background: #e6e8e9; height: auto;
+}
+#intro-in{
+    width:891px;
+    margin: 0 auto;
+    padding: 20px 0;
+}
+
+#header {
+    width:891px;
+    margin:0 auto;
+}
+
+
+/* horizontal navigation --------------------------------------------------- */
+#nav {
+    width:891px;
+    margin:0 auto;
+}
+#nav ul {
+    margin:0;
+    padding:0;
+    list-style:none;
+    height: 35px;
+}
+#nav ul li {
+    float:left;
+    display:block;
+    margin:0;
+    padding:0;}
+#nav ul li a, #nav ul li span {
+    display: block;
+    float: left;
+    font-size: 90%;
+    color: #fff;
+    text-decoration: none;
+    padding: 12px 20px 8px;
+    text-align: center;
+}
+#nav ul li a:hover, #nav ul li span:hover {
+    color: #ced1d2;
+    text-decoration: underline;
+}
+#nav ul li#active a, #nav ul li.webgen-menu-item-selected span {
+    color: #101517;
+    border: 1px solid #fff;
+    border-bottom:1px solid #e6e8e9;
+    background:#e6e8e9; text-decoration:none;}
+
+/* main content ---------------------------------------------------------------- */
+
+.content {
+    padding: 0 0 0 0;
+    z-index: 10;
+    width:891px;
+    margin:0 auto;
+}
+.content .in{
+    padding: 20px 0 30px;
+}
+p.intro{
+    background: url("img/line.jpg");
+    line-height: 23px;
+    margin:0 0 0;
+}
+.shadow{
+    border-top: 1px solid #dddddd;
+    padding: 10px 0;
+    background: url("img/shadow.jpg") no-repeat;
+}
+
+img.thumb{padding: 3px; background: #fff; border: 1px solid #d1d1d1;}
+
+.columns {list-style: none;margin:10px 0 0 0;padding:0; font-size: 90%;}
+.columns li{float: left; width: 32%;}
+.columns li.col2{border-left: 1px solid #d7d7d7;border-right: 1px solid #d7d7d7;}
+.columns li h3{padding: 0 10px;color: #2e4650; margin: 0 0 5px;}
+.columns li.col2 h3{padding-left: 20px;}
+.columns li.col3 h3{padding-left: 20px;}
+.columns li p{line-height: 22px;padding: 0 20px 0 10px; margin: 0; color: #3f4345;}
+.columns li.col2 p{padding: 0 20px 0 20px;}
+.columns li.col3 p{padding: 0 10px 0 20px;}
+.columns li a.more{display: block;color: #1666a3;padding: 5px 0;}
+.columns li a.more:hover{color: #0b4775; text-decoration: none;}
+
+
+
+/* footer ----------------------------------------------------------------- */
+#footer {
+    width:891px;
+    margin:0 auto;
+    clear:both;
+    font-size: 85%;
+    padding-bottom: 70px;
+    color: #898989;
+}
+#footer a{color: #898989;}
+#footer a:hover{color: #666666; text-decoration: none;}
+#footer .f-left, #footer .f-right { padding: 0 10px; }
+
+
+
+
+/* paragraphs -------------------------------------------------------------------- */
+p { margin:15px 0; }
+
+/* tables --------------------------------------------------------------------- */
+table { margin:15px 0; border-collapse:collapse; border-spacing:0; font-size:100%; }
+th { text-align:center; font-weight:bold; }
+th, td { padding:3px 5px; }
+
+/* lists --------------------------------------------------------------------- */
+ul, ol { display:block; margin:15px 0 15px 40px; }
+ul ul, ul ul ul, ol ol, ol ol ol { margin:0; margin-left:20px; }
+ol { list-style-type:decimal; }
+ol ol { list-style-type:upper-alpha; }
+ol ol ol {list-style-type:lower-alpha; }
+li { display:list-item; }
+ul li a { text-decoration:underline; }
+
+/* definitions -------------------------------------------------------------------- */
+dl { margin:15px 0; }
+dt { font-weight:bold; }
+dd { margin-left:30px; }
+
+/* other HTML tags --------------------------------------------------------------------- */
+fieldset { margin:15px 0; padding:10px; border:1px solid #CCC; }
+legend { margin-left:10px; font-size:100%; font-weight:bold; color:#000; }
+abbr, acronym, .help { border-bottom:1px dotted #CCC; cursor:help; }
+blockquote { margin:15px 20px; font-style:italic; }
+del, .del { text-decoration:line-through; }
+strong, .strong { font-weight:bold; }
+cite, em, q, var { font-style:italic; }
+code, kbd, samp  {font-family:monospace; font-size:110%; }
+hr { display:block; height:1px; margin:10px 0; padding:0; border:0 solid #CCC; background:#CCC; color:#CCC;}
+.f-left {float:left;}
+.f-right {float:right;}
+.a-left, tr.a-left td {text-align:left;}
+.a-center, tr.a-center td {text-align:center;}
+.a-right, tr.a-right td {text-align:right;}
+.a-justify {text-align:justify;}
+.va-top {vertical-align:top;}
+.va-middle {vertical-align:middle;}
+.va-bottom {vertical-align:bottom;}
+.clear { clear:both; }
+.box { min-height:1px; }
+.box:after { display:block; visibility:hidden; clear:both; line-height:0; font-size:0; content:"."; }
+.noscreen { display:none; }
+.mleft10 { margin-left: 10px; }
+.mright10 { margin-right: 10px; }
+.mtop10 { margin-top: 10px; }
+.mbottom10 { margin-bottom: 10px; }
+
+
+
+input.small{
+    width: 50px;
+}
+input.normal{
+    width: 146px;
+}
+.bigger {font-size:115%;}
+.smaller {font-size:85%;}
+
+.high {color:#00F;}
+.nonhigh {color:#777;}
+
+.foto{  display: block; border: 3px solid #ddd;}
+
+
+/* added definitions ------------------------------------------------------------ */
+.news-item + .news-item {
+    border-top: 1px solid #dddddd;
+}
+.news-date {
+    margin-top: 5px;
+}