dcm_dict 0.29.0

data/spec/dcm_dict/source_data/data_elements_data_spec.rb

@@ -0,0 +1,40 @@
+#
+#  Copyright (C) 2014-2020  Enrico Rivarola
+#
+#  This file is part of DcmDict gem (dcm_dict).
+#
+#  DcmDict 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, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  DcmDict 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 DcmDict.  If not, see <http://www.gnu.org/licenses/>.
+#
+#  This software has neither been tested nor approved for clinical use
+#  or for incorporation in a medical device.
+#  It is the redistributor's or user's responsibility to comply with any
+#  applicable local, state, national or international regulations.
+#
+require 'spec_helper'
+require 'set'
+
+describe "DcmDict::SourceData::DataElementsData" do
+  it "All record must have valid field" do
+    supported_keys = [:tag_ps, :tag_name, :tag_key, :tag_vr, :tag_vm, :tag_str, :tag_sym, :tag_ndm, :tag_ary, :tag_multiple, :tag_note].to_set
+    not_empty_keys = supported_keys-[:tag_multiple, :tag_note]
+    DcmDict::SourceData::DataElementsData.each do |record|
+      supported_keys.each do |key|
+        expect(record).to have_key(key)
+      end
+      not_empty_keys.each do |key|
+        expect(record[key].empty?).to be_falsy, "Error on check #{key} not empty for #{record[:tag_ps]} - '#{record[key].inspect}'"
+      end
+    end
+  end
+end

data/spec/dcm_dict/source_data/detached_data_spec.rb

@@ -0,0 +1,55 @@
+#
+#  Copyright (C) 2014-2020  Enrico Rivarola
+#
+#  This file is part of DcmDict gem (dcm_dict).
+#
+#  DcmDict 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, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  DcmDict 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 DcmDict.  If not, see <http://www.gnu.org/licenses/>.
+#
+#  This software has neither been tested nor approved for clinical use
+#  or for incorporation in a medical device.
+#  It is the redistributor's or user's responsibility to comply with any
+#  applicable local, state, national or international regulations.
+#
+require 'spec_helper'
+require 'data_element_sample_spec_helper'
+
+describe "DcmDict::SourceData::DetachedData" do
+
+  DataElementSampleSpecHelper.unknown_group_length_sample.each do |tag, expected_data|
+    it "create data for 'group length' record for tag=#{tag.inspect}" do
+      data = DcmDict::SourceData::DetachedData.make_group_length_data(tag)
+      expected_data.each do |key, val|
+        expect(data[key]).to eq(val)
+      end
+    end
+  end
+
+  DataElementSampleSpecHelper.private_creator_sample.each do |tag, expected_data|
+    it "create data for 'private creator' record for tag=#{tag.inspect}" do
+      data = DcmDict::SourceData::DetachedData.make_private_creator_data(tag)
+      expected_data.each do |key, val|
+        expect(data[key]).to eq(val)
+      end
+    end
+  end
+
+  DataElementSampleSpecHelper.unknown_sample.each do |tag, expected_data|
+    it "create data for 'unknown tag' record for tag=#{tag.inspect}" do
+      data = DcmDict::SourceData::DetachedData.make_unknown_data(tag)
+      expected_data.each do |key, val|
+        expect(data[key]).to eq(val)
+      end
+    end
+  end
+end

data/spec/dcm_dict/source_data/uid_values_data_spec.rb

@@ -0,0 +1,37 @@
+#
+#  Copyright (C) 2014-2020  Enrico Rivarola
+#
+#  This file is part of DcmDict gem (dcm_dict).
+#
+#  DcmDict 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, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  DcmDict 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 DcmDict.  If not, see <http://www.gnu.org/licenses/>.
+#
+#  This software has neither been tested nor approved for clinical use
+#  or for incorporation in a medical device.
+#  It is the redistributor's or user's responsibility to comply with any
+#  applicable local, state, national or international regulations.
+#
+require 'spec_helper'
+
+describe "DcmDict::SourceData::UidValuesData" do
+  it "All record must have valid field" do
+    supported_keys = [:uid_value, :uid_name, :uid_type]
+    DcmDict::SourceData::UidValuesData.each do |record|
+      supported_keys.each do |key|
+        expect(record).to have_key(key)
+        expect(record.nil_or_empty?).to be_falsy
+      end
+    end
+  end
+
+end

data/spec/dcm_dict/version_spec.rb

@@ -0,0 +1,30 @@
+#
+#  Copyright (C) 2014-2020  Enrico Rivarola
+#
+#  This file is part of DcmDict gem (dcm_dict).
+#
+#  DcmDict 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, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  DcmDict 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 DcmDict.  If not, see <http://www.gnu.org/licenses/>.
+#
+#  This software has neither been tested nor approved for clinical use
+#  or for incorporation in a medical device.
+#  It is the redistributor's or user's responsibility to comply with any
+#  applicable local, state, national or international regulations.
+#
+require 'spec_helper'
+
+describe "DcmDict version" do
+  it "may be defined" do
+    expect(DcmDict::VERSION).not_to be_nil
+  end
+end

data/spec/dcm_dict/xml/tag_field_data_spec.rb

@@ -0,0 +1,62 @@
+#
+#  Copyright (C) 2014-2020  Enrico Rivarola
+#
+#  This file is part of DcmDict gem (dcm_dict).
+#
+#  DcmDict 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, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  DcmDict 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 DcmDict.  If not, see <http://www.gnu.org/licenses/>.
+#
+#  This software has neither been tested nor approved for clinical use
+#  or for incorporation in a medical device.
+#  It is the redistributor's or user's responsibility to comply with any
+#  applicable local, state, national or international regulations.
+#
+require 'spec_helper'
+require 'xml_sample_spec_helper'
+
+
+
+describe "XML management for Data Element" do
+
+  RSpec.shared_examples "XML management for Data Element" do |xml_mod, desc|
+    describe "should extract data from single node set data (#{desc})" do
+      XmlSampleSpecHelper.xml_tag_single_set.each do |xml_string, expected_data|
+        xml_data = xml_mod.extract_data_element_field_from_xml_tr(xml_string)
+        describe "for '#{expected_data[:tag_name]}'" do
+          expected_data.each do |key, expected_value|
+            it "with key #{key.inspect}" do
+              expect(xml_data[key]).to eq(expected_value)
+            end
+          end
+          it "from XML doc" do
+            doc = xml_mod.create_xml_doc(xml_string)
+            data = {}
+            xml_mod.each_tr_set(doc, '//xmlns:tr') do |trset|
+              data = xml_mod.extract_data_element_field_from_tr_set(trset)
+            end
+            expect(data).to eq(expected_data)
+          end
+        end
+      end
+    end
+  end
+
+  if DcmDict::XML.nokogiri_enable?
+    include_examples "XML management for Data Element", DcmDict::XML::NokogiriTool, "with Nokogiri"
+  end
+
+  include_examples "XML management for Data Element", DcmDict::XML::RexmlTool, "with REXML"
+
+  include_examples "XML management for Data Element", DcmDict::XML::XmlTool, "with general XML module"
+
+end

data/spec/dcm_dict/xml/uid_field_data_spec.rb

@@ -0,0 +1,60 @@
+#
+#  Copyright (C) 2014-2020  Enrico Rivarola
+#
+#  This file is part of DcmDict gem (dcm_dict).
+#
+#  DcmDict 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, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  DcmDict 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 DcmDict.  If not, see <http://www.gnu.org/licenses/>.
+#
+#  This software has neither been tested nor approved for clinical use
+#  or for incorporation in a medical device.
+#  It is the redistributor's or user's responsibility to comply with any
+#  applicable local, state, national or international regulations.
+#
+require 'spec_helper'
+require 'xml_sample_spec_helper'
+
+describe "XML management for UID" do
+
+  RSpec.shared_examples "XML management for UID" do |xml_mod, desc|
+    describe "should extract data from single node set data (#{desc})" do
+      XmlSampleSpecHelper.xml_uid_set.each do |xml_string, expected_data|
+        xml_data = xml_mod.extract_uid_field_from_xml_tr(xml_string)
+        describe "for '#{expected_data[:uid_name]}'" do
+          expected_data.each do |key, expected_value|
+            it "with key #{key.inspect}" do
+              expect(xml_data[key]).to eq(expected_value)
+            end
+          end
+          it "from XML doc" do
+            doc = xml_mod.create_xml_doc(xml_string)
+            data = {}
+            xml_mod.each_tr_set(doc, '//xmlns:tr') do |trset|
+              data = xml_mod.extract_uid_field_from_tr_set(trset)
+            end
+            expect(data).to eq(expected_data)
+          end
+        end
+      end
+    end
+  end
+
+  if DcmDict::XML.nokogiri_enable?
+    include_examples "XML management for UID", DcmDict::XML::NokogiriTool, "with Nokogiri"
+  end
+
+  include_examples "XML management for UID", DcmDict::XML::RexmlTool, "with REXML"
+
+  include_examples "XML management for UID", DcmDict::XML::XmlTool, "with general XML module"
+
+end

data/spec/dictionary_shared_example_spec_helper.rb

@@ -0,0 +1,118 @@
+#
+#  Copyright (C) 2014-2020  Enrico Rivarola
+#
+#  This file is part of DcmDict gem (dcm_dict).
+#
+#  DcmDict 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, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  DcmDict 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 DcmDict.  If not, see <http://www.gnu.org/licenses/>.
+#
+#  This software has neither been tested nor approved for clinical use
+#  or for incorporation in a medical device.
+#  It is the redistributor's or user's responsibility to comply with any
+#  applicable local, state, national or international regulations.
+#
+
+FrozenStringExMessage = (RUBY_ENGINE == 'rbx') ? "can't modify frozen instance of String" : "can't modify frozen String"
+
+RSpec.shared_examples "Record handle methods correctly" do |obj, data|
+  it "Handle methods correctly" do
+    data.each do |key, expected_val|
+      expect(obj.respond_to?(key.to_sym)).to be true
+      expect(obj.respond_to?(key.to_s)).to be true
+    end
+
+    expect(obj.respond_to?(:undefined_method_for_record)).to be false
+    expect(obj.respond_to?(:undefined_method_for_record.to_s)).to be false
+    expect{ obj.undefined_method_for_record }.to raise_error(NoMethodError)
+    expect{ obj.send("undefined_method_for_record") }.to raise_error(NoMethodError)
+  end
+end
+
+RSpec.shared_examples "Concurrency support" do |key, dictionary, expected_values|
+  it "should support concurrency" do
+    #start = Time.now
+    max_threads = 128
+    times_for_threads = 1_024
+    idx = Random.rand(0...expected_values.size)
+    rnd_key = expected_values.keys[idx]
+    rnd_val = expected_values[rnd_key]
+    Thread.abort_on_exception = true
+    th = (1..max_threads).map do |n|
+      Thread.new do
+        Thread.stop
+        times_for_threads.times do |t|
+          Thread.current[:obj] = dictionary.record_at(key)
+          expect( Thread.current[:obj].send(rnd_key) ).to eq(rnd_val)
+          expect( dictionary.feature_at(key, rnd_key) ).to eq(rnd_val)
+          Thread.pass
+        end
+      end
+    end
+    sleep 0.01 while th[max_threads-1].status!='sleep'
+    th.map(&:run).map(&:join)
+    #warn "Example 'should support concurrency' finish in #{Time.now-start}"
+  end
+end
+
+RSpec.shared_examples "Map all source data" do |index_keys, record_data, dictionary, record_type, field_list|
+  it "should map all source data" do
+    record_data.each do |record|
+      index_keys.each do |key|
+        obj = dictionary.record_at(record[key])
+        expect(obj).not_to be_nil, "#{key.inspect} > #{record[key].inspect}"
+        expect(obj).to be_a(record_type)
+        expect(obj).to be_frozen
+        field_list.each do |field|
+          feature = dictionary.feature_at(record[key], field)
+          expect(feature).to eq(record[field])
+        end
+      end
+    end
+  end
+end
+
+RSpec.shared_examples "Handle specific record" do |note, record_key, record_data, dictionary|
+  it "should handle specific record as #{record_key.inspect} (#{note})" do
+      obj = dictionary.record_at(record_key)
+      expect(obj).not_to be_nil, "#{record_key.inspect} not found into dictionary #{dictionary.class}"
+      record_data.each do |key, value|
+        field = obj.send(key)
+        expect(field).to eq(value)
+        feature = dictionary.feature_at(record_key, key)
+        expect(feature).to eq(value)
+      end
+    end
+end
+
+RSpec.shared_examples "Dictionary Data not modifiable" do |record_key, key, dictionary|
+  it "data should be not modifiable" do
+    expect(dictionary).to be_frozen
+    obj = dictionary.record_at(record_key)
+    expect(obj).to be_frozen
+    expect{ eval("obj.#{key} << 'aaa'") }.
+      to raise_error(FrozenError)
+    expect{ eval("dictionary.feature_at('#{record_key}', #{key.inspect}) << 'aaa'") }.
+      to raise_error(FrozenError)
+  end
+end
+
+RSpec.shared_examples "Dictionary with wrong key" do |record_key, field_list, dictionary|
+  it "should raise exception for wrong value as #{record_key.inspect}" do
+    expect{dictionary.record_at(record_key)}.
+      to raise_error(DcmDict::DictionaryError)
+    field_list.each do |field|
+      expect { dictionary.feature_at(record_key, field) }.
+        to raise_error(DcmDict::DictionaryError)
+    end
+  end
+end

data/spec/refine_shared_example_spec_helper.rb

@@ -0,0 +1,54 @@
+#
+#  Copyright (C) 2014-2020  Enrico Rivarola
+#
+#  This file is part of DcmDict gem (dcm_dict).
+#
+#  DcmDict 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, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  DcmDict 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 DcmDict.  If not, see <http://www.gnu.org/licenses/>.
+#
+#  This software has neither been tested nor approved for clinical use
+#  or for incorporation in a medical device.
+#  It is the redistributor's or user's responsibility to comply with any
+#  applicable local, state, national or international regulations.
+#
+using DcmDict::Refine::ArrayRefine
+using DcmDict::Refine::StringRefine
+using DcmDict::Refine::SymbolRefine
+
+RSpec.shared_examples "Raise exception for wrong input" do |tags, uids, tag_proc|
+  describe "should raise exception for wrong input" do
+    describe "for data element" do
+      tags.each do |tag|
+        DcmDict::Dictionary::DataElementMethod.each do |method|
+          expr = "#{tag_proc.call(tag)}.#{method.to_s}"
+          it "with #{expr}" do
+#            expect{eval(expr)}.to raise_error(DcmDict::DictionaryError, "Unable to find reference for tag '#{tag}' as #{tag.class}")
+            expect{eval(expr)}.to raise_error(DcmDict::DictionaryError)
+          end
+        end
+      end
+    end
+
+    describe "and for uid" do
+      uids.each do |uid|
+        DcmDict::Dictionary::UidMethod.each do |method|
+          expr = "#{uid.inspect}.#{method.to_s}"
+          it "with #{expr}" do
+#            expect{eval(expr)}.to raise_error(DcmDict::DictionaryError, "Unable to find reference for uid '#{uid}' as #{uid.class}")
+            expect{eval(expr)}.to raise_error(DcmDict::DictionaryError)
+          end
+        end
+      end
+    end
+  end
+end