HDLRuby 2.4.28 → 2.6.3

data/lib/HDLRuby/std/hruby_unit.rb

@@ -0,0 +1,75 @@
+require "HDLRuby/hruby_high"
+
+
+
+##
+# Library for building unit test systems.
+#
+########################################################################
+module HDLRuby::Unit
+
+    ## The HDLRuby unit test error class.
+    class UnitError < ::StandardError
+    end
+
+    # The set of the unit systems by name.
+    @@unit_systems = {}
+
+
+    # Declares system +name+ for unit testing.
+    # The system is built by executing +ruby_block+.
+    #
+    # NOTE: the name of the system is not registered within the HDLRuby
+    #       namespace since it is not meant to be used directly.
+    def self.system(name,&ruby_block)
+        # Ensure name is a symbol.
+        name = name.to_s.to_sym unless name.is_a?(Symbol)
+        # Check if the name is already used or not.
+        if @@unit_systems.key?(name) then
+            raise UnitError, "Unit test system #{name} already declared."
+        end
+        # @@unit_systems[name] = HDLRuby::High.system(&ruby_block)
+        @@unit_systems[name] = ruby_block
+    end
+
+
+    # Create a system named +test_name+ executing the unit tests given from
+    # +names+.
+    def self.test(test_name = :test, *names)
+        # If there is no name given, use all the test systems.
+        names = @@unit_systems.each_key if names.empty?
+        # Declare the system.
+        HDLRuby::High.system test_name do
+
+            # The timed block that contains the bench execurtion code.
+            @@tester = timed {}
+
+            # Generate the test code for each selected test units.
+            names.each do |name|
+                name = name.to_s.to_sym unless name.is_a?(Symbol)
+                unless @@unit_systems.key?(name) then
+                    raise UnitError, "Unit test #{name} does not exist."
+                end
+                sub(name) do
+                    @@myself = self
+                    instance_exec do
+                        # Define the test command that insert code of
+                        # the current test unit to the tester timed block.
+                        def test(&ruby_block)
+                            @@tester.block.open do
+                                # Here the signals are to be taken from
+                                # the test unit and not the timed block.
+                                set_this(@@myself)
+                                ruby_block.call
+                                # Go back to the default current this.
+                                set_this
+                            end
+                        end
+                    end
+                    # Process the test unit.
+                    instance_exec(&@@unit_systems[name])
+                end
+            end
+        end
+    end
+end

data/lib/HDLRuby/template_expander.rb

@@ -0,0 +1,61 @@
+require 'strscan'
+
+##
+# Tool for expanding template files.
+#
+# Used for generating files like confugaration file for given HW target
+#
+########################################################################
+
+
+class TemplateExpander
+
+    ## Describes an expansion rule.
+    Rule = Struct.new(:match,:action)
+
+    # Creates a new template expander with potential list of +rules+.
+    def initialize(rules= [])
+        # Setup the rules.
+        @rules = rules.map do |match,action|
+            # Ensures action is a proc.
+            action = proc { |str| action.to_s } unless action.is_a?(Proc)
+            # Create the rule.
+            Rule.new(Regexp.new(match), action)
+        end
+        # The skip regexp is empty, it has to be built with finalize.
+        @skip = nil
+    end
+
+    # Adds a +rule+.
+    def add_rule(*rule)
+        @rules << Rule.new(Regexp.new(rule[0]), rule[1])
+    end
+
+    # Finalize the expander by building the default rule.
+    def finalize
+        # @skip = Regexp.union(*@rules.map { |rule| rule.match })
+        @skip = /(?=#{Regexp.union(*@rules.map { |rule| rule.match }).source})|\z/
+    end
+
+    # Apply the expander to +str+ and put the result in +res+.
+    def expand(str,res = "")
+        # Ensure the default rule is properly set up.
+        self.finalize
+        # Scan the string with each rule.
+        scanner = StringScanner.new(str)
+        until scanner.eos? do
+            @rules.find do |rule|
+                scanned = scanner.scan(rule.match)
+                if scanned then
+                    res << rule.action.call(scanned)
+                else
+                    false
+                end
+            end
+            res << scanner.scan_until(@skip)
+        end
+        return res
+    end
+    
+
+end

data/lib/HDLRuby/version.rb

@@ -1,3 +1,3 @@
 module HDLRuby
-  VERSION = "2.4.28"
+  VERSION = "2.6.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: HDLRuby
 version: !ruby/object:Gem::Version
-  version: 2.4.28
+  version: 2.6.3
 platform: ruby
 authors:
 - Lovic Gauthier
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-01-10 00:00:00.000000000 Z
+date: 2021-05-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,6 +66,8 @@ files:
 - lib/HDLRuby/alcc.rb
 - lib/HDLRuby/backend/hruby_allocator.rb
 - lib/HDLRuby/backend/hruby_c_allocator.rb
+- lib/HDLRuby/drivers/xcd.rb
+- lib/HDLRuby/drivers/xcd/dummy.xcd
 - lib/HDLRuby/hdr_samples/WithMultiChannelExpVerilog/with_multi_channels_hs_32.v
 - lib/HDLRuby/hdr_samples/WithMultiChannelExpVerilog/with_multi_channels_qu_213.v
 - lib/HDLRuby/hdr_samples/WithMultiChannelExpVerilog/with_multi_channels_qu_222.v
@@ -81,13 +83,18 @@ files:
 - lib/HDLRuby/hdr_samples/alu.rb
 - lib/HDLRuby/hdr_samples/bstr_bench.rb
 - lib/HDLRuby/hdr_samples/calculator.rb
+- lib/HDLRuby/hdr_samples/constant_in_function.rb
 - lib/HDLRuby/hdr_samples/counter_bench.rb
 - lib/HDLRuby/hdr_samples/dff.rb
 - lib/HDLRuby/hdr_samples/dff_bench.rb
 - lib/HDLRuby/hdr_samples/dff_counter.rb
+- lib/HDLRuby/hdr_samples/dff_properties.rb
+- lib/HDLRuby/hdr_samples/dff_unit.rb
+- lib/HDLRuby/hdr_samples/huge_rom.rb
 - lib/HDLRuby/hdr_samples/include.rb
 - lib/HDLRuby/hdr_samples/instance_open.rb
 - lib/HDLRuby/hdr_samples/linear_test.rb
+- lib/HDLRuby/hdr_samples/logic_bench.rb
 - lib/HDLRuby/hdr_samples/make_multi_channels_v.rb
 - lib/HDLRuby/hdr_samples/make_multi_channels_vcd.rb
 - lib/HDLRuby/hdr_samples/mei8.rb
@@ -95,6 +102,8 @@ files:
 - lib/HDLRuby/hdr_samples/memory_test.rb
 - lib/HDLRuby/hdr_samples/multer_gen.rb
 - lib/HDLRuby/hdr_samples/multer_seq.rb
+- lib/HDLRuby/hdr_samples/music.rb
+- lib/HDLRuby/hdr_samples/named_sub.rb
 - lib/HDLRuby/hdr_samples/neg_arith_bench.rb
 - lib/HDLRuby/hdr_samples/neural/a.rb
 - lib/HDLRuby/hdr_samples/neural/a_sub.rb
@@ -131,6 +140,7 @@ files:
 - lib/HDLRuby/hdr_samples/with_decoder.rb
 - lib/HDLRuby/hdr_samples/with_fixpoint.rb
 - lib/HDLRuby/hdr_samples/with_fsm.rb
+- lib/HDLRuby/hdr_samples/with_function_generator.rb
 - lib/HDLRuby/hdr_samples/with_linear.rb
 - lib/HDLRuby/hdr_samples/with_loop.rb
 - lib/HDLRuby/hdr_samples/with_memory.rb
@@ -199,10 +209,12 @@ files:
 - lib/HDLRuby/hruby_bstr.rb
 - lib/HDLRuby/hruby_check.rb
 - lib/HDLRuby/hruby_db.rb
+- lib/HDLRuby/hruby_decorator.rb
 - lib/HDLRuby/hruby_error.rb
 - lib/HDLRuby/hruby_high.rb
 - lib/HDLRuby/hruby_low.rb
 - lib/HDLRuby/hruby_low2c.rb
+- lib/HDLRuby/hruby_low2hdr.rb
 - lib/HDLRuby/hruby_low2high.rb
 - lib/HDLRuby/hruby_low2seq.rb
 - lib/HDLRuby/hruby_low2sym.rb
@@ -287,12 +299,15 @@ files:
 - lib/HDLRuby/std/decoder.rb
 - lib/HDLRuby/std/fixpoint.rb
 - lib/HDLRuby/std/fsm.rb
+- lib/HDLRuby/std/function_generator.rb
+- lib/HDLRuby/std/hruby_unit.rb
 - lib/HDLRuby/std/linear.rb
 - lib/HDLRuby/std/loop.rb
 - lib/HDLRuby/std/memory.rb
 - lib/HDLRuby/std/pipeline.rb
 - lib/HDLRuby/std/reconf.rb
 - lib/HDLRuby/std/task.rb
+- lib/HDLRuby/template_expander.rb
 - lib/HDLRuby/test_hruby_bstr.rb
 - lib/HDLRuby/test_hruby_high.rb
 - lib/HDLRuby/test_hruby_high_low.rb
@@ -308,7 +323,7 @@ homepage: https://github.com/civol/HDLRuby
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -325,7 +340,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.0.8
-signing_key: 
+signing_key:
 specification_version: 4
 summary: HDLRuby is a library for describing and simulating digital electronic systems.
 test_files: []