RubyGems - autoc - Versions diffs - 0.8 → 1.0 - Mend

autoc 0.8 → 1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (49) hide show

checksums.yaml +7 -0
data/README +15 -4
data/doc/AutoC.html +245 -0
data/doc/AutoC/Code.html +520 -0
data/doc/AutoC/Collection.html +923 -0
data/doc/AutoC/HashMap.html +1161 -0
data/doc/AutoC/HashSet.html +1122 -0
data/doc/AutoC/List.html +1002 -0
data/doc/AutoC/Module.html +951 -0
data/doc/AutoC/Module/File.html +412 -0
data/doc/AutoC/Module/Header.html +432 -0
data/doc/AutoC/Module/Source.html +704 -0
data/doc/AutoC/Priority.html +138 -0
data/doc/AutoC/Queue.html +1167 -0
data/doc/AutoC/Type.html +1152 -0
data/doc/AutoC/UserDefinedType.html +655 -0
data/doc/AutoC/Vector.html +856 -0
data/doc/_index.html +299 -0
data/doc/class_list.html +54 -0
data/doc/css/common.css +1 -0
data/doc/css/full_list.css +57 -0
data/doc/css/style.css +339 -0
data/doc/file.README.html +112 -0
data/doc/file_list.html +56 -0
data/doc/frames.html +26 -0
data/doc/index.html +112 -0
data/doc/js/app.js +219 -0
data/doc/js/full_list.js +178 -0
data/doc/js/jquery.js +4 -0
data/doc/method_list.html +605 -0
data/doc/top-level-namespace.html +112 -0
data/lib/autoc.rb +35 -12
data/lib/autoc/{code_builder.rb → code.rb} +230 -247
data/lib/autoc/collection.rb +137 -0
data/lib/autoc/collection/hash_map.rb +388 -0
data/lib/autoc/collection/hash_set.rb +433 -0
data/lib/autoc/collection/list.rb +410 -0
data/lib/autoc/collection/queue.rb +514 -0
data/lib/autoc/collection/vector.rb +295 -0
data/lib/autoc/type.rb +198 -0
data/test/test.c +921 -396
data/test/test.h +41 -0
data/test/test.rb +21 -26
data/test/test_auto.c +2630 -3961
data/test/test_auto.h +449 -560
metadata +50 -17
data/lib/autoc/data_struct_builder.rb +0 -1794
data/lib/autoc/type_builder.rb +0 -24
data/manual/manual.pdf +0 -0

data/doc/top-level-namespace.html ADDED Viewed

@@ -0,0 +1,112 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>
+  Top Level Namespace
+    &mdash; Documentation by YARD 0.8.7.4
+</title>
+  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  hasFrames = window.top.frames.main ? true : false;
+  relpath = '';
+  framesUrl = "frames.html#!top-level-namespace.html";
+</script>
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+    <a href="_index.html">Index</a> &raquo;
+    <span class="title">Top Level Namespace</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+      Class List
+    </a>
+    <a class="full_list_link" id="method_list_link"
+        href="method_list.html">
+      Method List
+    </a>
+    <a class="full_list_link" id="file_list_link"
+        href="file_list.html">
+      File List
+    </a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><h1>Top Level Namespace
+</h1>
+<dl class="box">
+</dl>
+<div class="clear"></div>
+<h2>Defined Under Namespace</h2>
+<p class="children">
+      <strong class="modules">Modules:</strong> <span class='object_link'><a href="AutoC.html" title="AutoC (module)">AutoC</a></span>
+</p>
+</div>
+    <div id="footer">
+  Generated on Fri Jun  6 18:05:34 2014 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.8.7.4 (ruby-2.0.0).
+</div>
+  </body>
+</html>

data/lib/autoc.rb CHANGED Viewed

@@ -1,12 +1,35 @@
-=begin rdoc
-= AutoC documentation home
-*AutoC* is a host of Ruby modules related to automatic C source code generation.
-[CodeBuilder] Generic C multi-source module generator.
-[DataStructBuilder] Strongly-typed data structure generators akin the C++ STL container classes.
-=end
-require "autoc/code_builder"
-require "autoc/data_struct_builder"
+=begin rdoc
+*AutoC* is a host of Ruby modules related to automatic C source code generation.
+. {AutoC::Code} - generic C multi-source module generator.
+. {AutoC::Collection} - strongly-typed data structure generators similar
+to the C++ STL container classes.
+== Versioning scheme
+AutoC adheres to simple major.minor versioning scheme.
+Change in major number states incompatible changes in the code
+while change in minor number states (rather) small incremental changes that
+should not normally break things.
+That said, release 1.0 is the _first_ release of version 1 which is considered beta, not stable.
+_Note that it is not necessary stable or feature complete._
+Releases 1.1+ will present incremental improvements, bugfixes, documentation updates etc. to version 1.
+Should the major incompatible changes be made, the new release 2.0 will be introduced and so forth.
+=end
+module AutoC
+  VERSION = "1.0"
+end # AutoC
+require "autoc/code"
+require "autoc/type"
+require "autoc/collection"
+require "autoc/collection/list"
+require "autoc/collection/queue"
+require "autoc/collection/vector"
+require "autoc/collection/hash_set"
+require "autoc/collection/hash_map"

data/lib/autoc/{code_builder.rb → code.rb} RENAMED Viewed

@@ -1,247 +1,230 @@
-require "set"
-module CodeBuilder
-# class Entity
-#   def entities()
-#   def priority()
-#   def source_size()
-#   def attach(source)
-#   def write_intf(stream)
-#   def write_defs(stream)
-#   def write_decls(stream)
-#   def hash()
-#   def eql?(other)
-# end
-# TODO min/max Fixnums
-module Priority
-  DEFAULT = 0
-  MIN = -1000
-  MAX = +1000
-end
-# A no-op entity implementation with reasonable defaults
-class Code
-  def entities; [] end
-  def priority
-    if entities.empty?
-      Priority::DEFAULT
-    else
-      result = Priority::DEFAULT
-      entities.each do |e|
-        ep = e.priority
-        result = ep if result > ep
-      end
-      result-1
-    end
-  end
-  def source_size
-    s = String.new
-    write_decls(s)
-    write_defs(s)
-    s.size
-  end
-  def attach(source) source << self if source.smallest? end
-  def write_intf(stream) end
-  def write_defs(stream) end
-  def write_decls(stream) end
-end # Code
-class Module
-  attr_reader :header, :smallest_source, :main_source
-  def initialize
-    @entities = Set.new
-    @source_size_threshold = 0
-  end
-  def <<(obj)
-    unless @entities.include?(obj)
-      @entities << obj
-      obj.entities.each {|e| self << e}
-    end
-    self
-  end
-  # def new_header()
-  # def new_source(index)
-  def source_count=(count)
-    @source_count = count
-  end
-  def generate!
-    @header = new_header
-    @sources = []
-    (1..source_count).each {|i| @sources << new_source(i)}
-    @main_source = @sources.first
-    @smallest_source = @main_source
-    # It appears that computing the size of a source might be a fairly expensive operation so do it only when neccessary
-    refresh_smallest_source = source_count > 1
-    @entities.each do |e|
-      @header << e
-      @smallest_source = @sources.sort_by {|s| s.size}.first if refresh_smallest_source
-      @sources.each {|s| e.attach(s)}
-    end
-    @header.generate
-    @sources.each {|s| s.generate}
-  end
-  def source_count
-    if @source_count.nil?
-      total = 0
-      @entities.each {|e| total += e.source_size}
-      count = @source_size_threshold > 0 ? (total/@source_size_threshold + 1) : 1
-      @source_count = count > 0 ? count : 1
-    else
-      @source_count
-    end
-  end
-end # Module
-def self.priority_sort(entities, reverse = false)
-  list = entities.to_a.sort_by!{|e| e.priority}
-  list.reverse! unless reverse
-  list
-end # priority_sort
-class File
-  attr_reader :entities
-  # def new_stream()
-  # def write(stream)
-  def initialize(m)
-    @entities = Set.new
-    @module = m
-  end
-  def generate
-    stream = new_stream
-    begin
-      write(stream)
-    ensure
-      stream.close
-    end
-  end
-  def <<(e)
-    @entities << e
-    self
-  end
-end # File
-class Header < File
-  def write(stream)
-    CodeBuilder.priority_sort(entities).each {|e| e.write_intf(stream)}
-  end
-end # Header
-class Source < File
-  attr_reader :index
-  def initialize(m, i)
-    super(m)
-    @index = i
-  end
-  def write(stream)
-    sorted = CodeBuilder.priority_sort(entities)
-    sorted.each {|e| e.write_decls(stream)}
-    sorted.each {|e| e.write_defs(stream)}
-  end
-  def main?
-    equal?(@module.main_source)
-  end
-  def smallest?
-    equal?(@module.smallest_source)
-  end
-  def size
-    size = 0
-    @entities.each {|e| size += e.source_size}
-    size
-  end
-end # Source
-class CModule < CodeBuilder::Module
-  def self.generate!(name, &block)
-    m = self.new(name)
-    block.call(m)
-    m.generate!
-  end
-  attr_reader :name
-  def initialize(name)
-    super()
-    @name = name.to_s # TODO validate
-  end
-  def new_header
-    Header.new(self)
-  end
-  def new_source(index)
-    Source.new(self, index)
-  end
-  class Header < CodeBuilder::Header
-    attr_reader :file_name
-    def initialize(*args)
-      super
-      @file_name = "#{@module.name.downcase}_auto.h"
-      @guard_macro = "#{@module.name.upcase}_AUTO_H"
-    end
-    def new_stream
-      ::File.new(@file_name, "wt")
-    end
-    def write(stream)
-      stream << %$
-        /* AUTOMATICALLY GENERATED HEADER FILE. DO NOT MODIFY. */
-        #ifndef #{@guard_macro}
-        #define #{@guard_macro}
-      $
-      super
-      stream << %$
-        #endif
-      $
-    end
-  end # Header
-  class Source < CodeBuilder::Source
-    attr_reader :file_name
-    def initialize(*args)
-      super
-      @file_name = @module.source_count > 1 ? "#{@module.name.downcase}_auto#{index}.c" : "#{@module.name.downcase}_auto.c"
-    end
-    def new_stream
-      ::File.new(@file_name, "wt")
-    end
-    def write(stream)
-      stream << %$
-        /* AUTOMATICALLY GENERATED SOURCE FILE. DO NOT MODIFY. */
-        #include "#{@module.header.file_name}"
-      $
-      super
-    end
-  end # Source
-end # Module
-end # CodeBuilder
+require "set"
+module AutoC
+# class Entity
+#   def entities()
+#   def priority()
+#   def source_size()
+#   def attach(source)
+#   def write_intf(stream)
+#   def write_defs(stream)
+#   def write_decls(stream)
+#   def hash()
+#   def eql?(other)
+# end
+# TODO min/max Fixnums
+module Priority
+  DEFAULT = 0
+  MIN = -1000
+  MAX = +1000
+end
+# A no-op entity implementation with reasonable defaults
+class Code
+  def entities; [] end
+  def priority
+    if entities.empty?
+      Priority::DEFAULT
+    else
+      result = Priority::DEFAULT
+      entities.each do |e|
+        ep = e.priority
+        result = ep if result > ep
+      end
+      result-1
+    end
+  end
+  def source_size
+    s = String.new
+    write_decls(s)
+    write_defs(s)
+    s.size
+  end
+  def attach(source) source << self if source.smallest? end
+  def write_intf(stream) end
+  def write_defs(stream) end
+  def write_decls(stream) end
+end # Code
+class Module
+  def self.generate!(name, &block)
+    m = self.new(name)
+    block.call(m)
+    m.generate!
+  end
+  attr_reader :name, :header, :smallest_source, :main_source
+  def initialize(name)
+    @entities = Set.new
+    @source_size_threshold = 0
+    @name = name.to_s # TODO validate
+  end
+  def <<(obj)
+    unless @entities.include?(obj)
+      @entities << obj
+      obj.entities.each {|e| self << e}
+    end
+    self
+  end
+  def new_header
+    Header.new(self)
+  end
+  def new_source(index)
+    Source.new(self, index)
+  end
+  def source_count=(count)
+    @source_count = count
+  end
+  def generate!
+    @header = new_header
+    @sources = []
+    (1..source_count).each {|i| @sources << new_source(i)}
+    @main_source = @sources.first
+    @smallest_source = @main_source
+    # It appears that computing the size of a source might be a fairly expensive operation so do it only when neccessary
+    refresh_smallest_source = source_count > 1
+    @entities.each do |e|
+      @header << e
+      @smallest_source = @sources.sort_by {|s| s.size}.first if refresh_smallest_source
+      @sources.each {|s| e.attach(s)}
+    end
+    @header.generate
+    @sources.each {|s| s.generate}
+  end
+  def source_count
+    if @source_count.nil?
+      total = 0
+      @entities.each {|e| total += e.source_size}
+      count = @source_size_threshold > 0 ? (total/@source_size_threshold + 1) : 1
+      @source_count = count > 0 ? count : 1
+    else
+      @source_count
+    end
+  end
+end # Module
+def self.priority_sort(entities, reverse = false)
+  list = entities.to_a.sort! {|a,b| a.priority <=> b.priority}
+  list.reverse! unless reverse
+  list
+end # priority_sort
+class Module::File
+  attr_reader :entities
+  # def new_stream()
+  # def write(stream)
+  def initialize(m)
+    @entities = Set.new
+    @module = m
+  end
+  def generate
+    stream = new_stream
+    begin
+      write(stream)
+    ensure
+      stream.close
+    end
+  end
+  def <<(e)
+    @entities << e
+    self
+  end
+end # File
+class Module::Header < Module::File
+  attr_reader :file_name
+  def initialize(*args)
+    super
+    @file_name = "#{@module.name.downcase}_auto.h"
+    @guard_macro = "#{@module.name.upcase}_AUTO_H"
+  end
+  def new_stream
+    ::File.new(@file_name, "w")
+  end
+  def write(stream)
+    stream << %$
+      /* AUTOMATICALLY GENERATED HEADER FILE. DO NOT MODIFY. */
+      #ifndef #{@guard_macro}
+      #define #{@guard_macro}
+    $
+    AutoC.priority_sort(entities).each {|e| e.write_intf(stream)}
+    stream << %$
+      #endif
+    $
+  end
+end # Header
+class Module::Source < Module::File
+  attr_reader :index, :file_name
+  def initialize(m, i)
+    super(m)
+    @index = i
+    @file_name = @module.source_count > 1 ? "#{@module.name.downcase}_auto#{index}.c" : "#{@module.name.downcase}_auto.c"
+  end
+  def main?
+    equal?(@module.main_source)
+  end
+  def smallest?
+    equal?(@module.smallest_source)
+  end
+  def size
+    size = 0
+    @entities.each {|e| size += e.source_size}
+    size
+  end
+  def new_stream
+    ::File.new(@file_name, "w")
+  end
+  def write(stream)
+    stream << %$
+      /* AUTOMATICALLY GENERATED SOURCE FILE. DO NOT MODIFY. */
+      #include "#{@module.header.file_name}"
+    $
+    sorted = AutoC.priority_sort(entities)
+    sorted.each {|e| e.write_decls(stream)}
+    sorted.each {|e| e.write_defs(stream)}
+  end
+end # Source
+end # AutoC