chars 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b408bb91d6c66422ccb57e66af6cdeceeb97d50c610628a9b99780319f4af57
-  data.tar.gz: '039bef18f59a8ea05fd2a259839432e9ad2eee15c692969bf611d11b15255b75'
+  metadata.gz: 33adb9b0d02cf5d9c694e80e824bb4835b1503769e00d7f62ab901b35a46df64
+  data.tar.gz: ab56f3ae9533e9e5903aee56c491f6b40760694e4adc3d6ec364725182ccaeed
 SHA512:
-  metadata.gz: 803264ba7bafc4546df334bd2a508389f525c9814ab0452ef7b2b7c9b75cc0fb952c729f0b5b093cbede36d60be5badeb29ada0e29ee5b12ae3d681878aeb163
-  data.tar.gz: 2e9f1c229d9987e5cb1dfc0caada8c71582e0c72e8c03e7b39313c4bc1e9e447bdbdfcf641009174de47b4e0e94384296dc26cf8a136f72881bfd664fa311720
+  metadata.gz: de94222563f4de2c9c68660d95af2d6d0cdc54ee53ac61b726022c02f064fbe493ec3a208937ec2dcb52593560ea4bf6e7935ad0e4ac8b7f7ecfa22afd55f3f4
+  data.tar.gz: 172429354850160c92ac11d563effa5c8379d062c8fd1615a9db567abf7f1548528847af12f084ce20b16e7e654854ddcd857e0082ea677f41356fcf2c33bb5d

data/ChangeLog.md

@@ -1,3 +1,11 @@
+### 0.3.2 / 2022-12-02
+
+* Ensure all character Strings within the {Chars} character sets are encoded as
+  ASCII-8bit. This prevents transcoding issues when calling
+  `Chars::ASCII.random_string(length)`.
+* Changed {Chars::CharSet#initialize} to encode bytes greater than 256 as UTF-8.
+  Otherwise, bytes less than 256 will be encoded as ASCII-8bit.
+
 ### 0.3.1 / 2022-12-01
 
 * Removed the space character from {Chars::PUNCTUATION}, as spaces are not

data/lib/chars/char_set.rb

@@ -17,7 +17,13 @@ module Chars
     def initialize(*arguments)
       super()
 
-      @chars = Hash.new { |hash,key| hash[key] = key.chr(Encoding::UTF_8) }
+      @chars = Hash.new do |hash,key|
+        hash[key] = if key > 0xff
+                      key.chr(Encoding::UTF_8)
+                    else
+                      key.chr(Encoding::ASCII_8BIT)
+                    end
+      end
 
       arguments.each do |subset|
         case subset

data/lib/chars/chars.rb

@@ -1,3 +1,4 @@
+# encoding: ASCII-8BIT
 # frozen_string_literal: true
 
 require 'chars/char_set'

data/lib/chars/version.rb

@@ -1,4 +1,4 @@
 module Chars
   # chars version
-  VERSION = '0.3.1'
+  VERSION = '0.3.2'
 end

data/spec/char_set_spec.rb

@@ -42,6 +42,18 @@ describe Chars::CharSet do
       it "must populate the char set using the Integers as bytes" do
         expect(integers.all? { |i| subject.include?(i) }).to be(true)
       end
+
+      it "must encode them as ASCII 8bit Strings" do
+        expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+      end
+
+      context "when one of the Integers is greater than 0xff" do
+        let(:integers) { [0x100, 0xffff] }
+
+        it "must encode the Integer as a UTF-8 String" do
+          expect(subject.chars.map(&:encoding)).to all(be(Encoding::UTF_8))
+        end
+      end
     end
 
     context "when given an Array of Integers" do
@@ -50,6 +62,18 @@ describe Chars::CharSet do
       it "must populate the char set using the Integers as bytes" do
         expect(integers.all? { |i| subject.include?(i) }).to be(true)
       end
+
+      it "must encode them as ASCII 8bit Strings" do
+        expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+      end
+
+      context "when one of the Integers is greater than 0xff" do
+        let(:integers) { [0x100, 0xffff] }
+
+        it "must encode the Integer as a UTF-8 String" do
+          expect(subject.chars.map(&:encoding)).to all(be(Encoding::UTF_8))
+        end
+      end
     end
 
     context "when given a Range of Integers" do
@@ -58,6 +82,18 @@ describe Chars::CharSet do
       it "must populate the char set by enumerating over the Integer's bytes" do
         expect(integers.all? { |i| subject.include?(i) }).to be(true)
       end
+
+      it "must encode them as ASCII 8bit Strings" do
+        expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+      end
+
+      context "when one of the Integers is greater than 0xff" do
+        let(:integer_range) { (0x100..0x200) }
+
+        it "must encode the Integer as a UTF-8 String" do
+          expect(subject.chars.map(&:encoding)).to all(be(Encoding::UTF_8))
+        end
+      end
     end
   end
 

data/spec/chars_spec.rb

@@ -10,6 +10,10 @@ describe Chars do
     it "must contain numeric characters" do
       expect(subject.chars).to match_array(numeric_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   describe "DIGITS" do
@@ -18,6 +22,10 @@ describe Chars do
     it "must equal NUMERIC" do
       expect(subject).to be(described_class::NUMERIC)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   describe "OCTAL" do
@@ -26,6 +34,10 @@ describe Chars do
     it "must contain all octal characters" do
       expect(subject.chars).to match_array("01234567".chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   let(:uppercase_hex_chars) { "0123456789ABCDEF".chars }
@@ -36,6 +48,10 @@ describe Chars do
     it "must contain all upper-case hexadecimal characters" do
       expect(subject.chars).to match_array(uppercase_hex_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   let(:lowercase_hex_chars) { "0123456789abcdef".chars }
@@ -46,6 +62,10 @@ describe Chars do
     it "must contain all lower-case hexadecimal characters" do
       expect(subject.chars).to match_array(lowercase_hex_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   describe "HEXADECIMAL" do
@@ -54,6 +74,10 @@ describe Chars do
     it "must contain both upper-case and lower-case hexadecimal characters" do
       expect(subject.chars).to match_array(uppercase_hex_chars | lowercase_hex_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   let(:uppercase_alpha_chars) { "ABCDEFGHIJKLMNOPQRSTUVWXYZ".chars }
@@ -64,6 +88,10 @@ describe Chars do
     it "must contain all upper-case alpha characters" do
       expect(subject.chars).to match_array(uppercase_alpha_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   let(:lowercase_alpha_chars) { "abcdefghijklmnopqrstuvwxyz".chars }
@@ -74,6 +102,10 @@ describe Chars do
     it "must contain all lower-case alpha characters" do
       expect(subject.chars).to match_array(lowercase_alpha_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   let(:alpha_chars) { uppercase_alpha_chars | lowercase_alpha_chars }
@@ -84,6 +116,10 @@ describe Chars do
     it "must contain all alpha characters" do
       expect(subject.chars).to match_array(alpha_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   let(:alpha_numeric_chars) { alpha_chars | numeric_chars }
@@ -94,6 +130,10 @@ describe Chars do
     it "must contain all alpha-numeric characters" do
       expect(subject.chars).to match_array(alpha_numeric_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   let(:punctuation_chars) { "!\"'(),-.:;?[]`{}~".chars }
@@ -104,6 +144,10 @@ describe Chars do
     it "must contain all punctuation characters" do
       expect(subject.chars).to match_array(punctuation_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   let(:symbolic_chars) { "!\"\#$%&'()*+,-./:;<=>?@[\\]^_`{|}~".chars }
@@ -114,6 +158,10 @@ describe Chars do
     it "must contain all symbolic characters" do
       expect(subject.chars).to match_array(symbolic_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   let(:whitespace_chars) { "\t\n\v\f\r ".chars }
@@ -124,6 +172,10 @@ describe Chars do
     it "must contain all white-space characters" do
       expect(subject.chars).to match_array(whitespace_chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   describe "SPACE" do
@@ -132,6 +184,10 @@ describe Chars do
     it "must equal WHITESPACE" do
       expect(subject).to be(described_class::WHITESPACE)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   describe "VISIBLE" do
@@ -140,6 +196,10 @@ describe Chars do
     it "must contain all all alpha-numeric, symbols, and some punctuation" do
       expect(subject.chars).to match_array(alpha_numeric_chars | "!\"\#$%&'()*+,-./:;<=>?@[\\]^_`{|}~".chars)
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   describe "PRINTABLE" do
@@ -153,6 +213,10 @@ describe Chars do
         [' ']
       )
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   describe "CONTROL" do
@@ -161,6 +225,10 @@ describe Chars do
     it "must contain ASCII bytes 0x00 - 0x1f and 0x7f" do
       expect(subject.bytes).to eq([*0x00..0x1f, 0x7f])
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   describe "SIGNED_ASCII" do
@@ -169,6 +237,10 @@ describe Chars do
     it "must contain ASCII bytes 0x00 - 0x7f" do
       expect(subject.bytes).to eq([*0x00..0x7f])
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   describe "ASCII" do
@@ -177,6 +249,10 @@ describe Chars do
     it "must contain ASCII bytes 0x00 - 0xff" do
       expect(subject.bytes).to eq([*0x00..0xff])
     end
+
+    it "must only contain ASCII-8bit encoded characters" do
+      expect(subject.chars.map(&:encoding)).to all(be(Encoding::ASCII_8BIT))
+    end
   end
 
   {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chars
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Postmodern
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-01 00:00:00.000000000 Z
+date: 2022-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -87,7 +87,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.3.26
 signing_key:
 specification_version: 4
 summary: A Ruby library for working with various character sets