chars 0.2.0 → 0.2.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6257e8d2fa2f62cc364fc2e0ba901d777963476968264dd7747bc4407e5ff54c
+  data.tar.gz: 16f5ecc2f44e8265869aac4946a64cacda2ae8dcdae3b669081a48d34f034f4e
+SHA512:
+  metadata.gz: ebaf16c18de6b000b6219bf4afe7142926e24293b6b1e62214f937c51c5bdf7f5ffa7f46eecb151e1da044f7b49e1479b7d2cc947a6e20fa2a586f28b4a8a525
+  data.tar.gz: 4c9c98dcbab77b201b86fc32a628575e4b0ebc03608c50c7591b51a70821127778ced5122f57de846c7c863440fa0e9555fe7bfd2940a913e494a929c74a513e

data/.document

@@ -1,4 +1,4 @@
 lib/**/*.rb
 - 
-ChangeLog.*
+ChangeLog.md
 LICENSE.txt

data/.github/workflows/ruby.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on: [ push, pull_request ]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby:
+          - 2.4
+          - 2.5
+          - 2.6
+          - 2.7
+          - 3.0
+          - jruby
+    name: Ruby ${{ matrix.ruby }}
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - name: Install dependencies
+        run: bundle install --jobs 4 --retry 3
+      - name: Run tests
+        run: bundle exec rake test

data/.gitignore

@@ -0,0 +1,8 @@
+/Gemfile.lock
+/doc/
+/pkg/
+/vendor/bundle
+.DS_Store
+.yardoc
+*.swp
+*~

data/.yardopts

@@ -1 +1 @@
---markup markdown --title 'Chars Documentation' --protected --files ChangeLog.md,LICENSE.txt
+--markup markdown --title 'Chars Documentation' --protected --quiet

data/ChangeLog.md

@@ -1,3 +1,32 @@
+### 0.2.4 / 2021-10-22
+
+* Require [ruby] >= 2.0.0.
+* Added {Chars::CharSet#initialize_copy} to prevent leaking characters
+  between copied {Chars::CharSet} objects.
+
+### 0.2.3 / 2020-12-25
+
+* Change {Chars::CharSet} to inherit from `Set`, instead of `SortedSet`.
+
+### 0.2.2 / 2012-05-28
+
+* {Chars::CharSet#initialize} now raises a TypeError when given arguments
+  that were neither a `String`, `Integer` or `Enumerable`.
+* Allow {Chars::CharSet#strings_in} to yield results as they are found.
+* Improved the performance of {Chars::CharSet#strings_in} when operating on
+  small Strings.
+* Replaced ore-tasks with
+  [rubygems-tasks](https://github.com/postmodern/rubygems-tasks#readme).
+
+### 0.2.1 / 2011-06-22
+
+* Added {Chars::CharSet.[]}
+* Added {Chars::CharSet#<<}.
+* Added {Chars::CharSet#byte_to_char}.
+* Added {Chars::CharSet#char_to_byte}.
+* Added a cache of characters of the bytes within {Chars::CharSet}.
+* Use `String#each_char` to distinguish Unicode from ASCII.
+
 ### 0.2.0 / 2010-10-27
 
 * Make sure all enumerable methods in {Chars::CharSet} return an
@@ -43,3 +72,4 @@
   belongs to a certain character set.
 * Supports random text generation using specific character sets.
 
+[ruby]: https://www.ruby-lang.org/

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development do
+  gem 'rake'
+  gem 'rubygems-tasks', '~> 0.2'
+  gem 'rspec',          '~> 3.0'
+  gem 'kramdown'
+  gem 'yard',           '~> 0.9'
+  gem 'yard-spellcheck', require: false
+end

data/LICENSE.txt

@@ -1,6 +1,6 @@
 (The MIT License)
 
-Copyright (c) 2009-2010 Hal Brodigan
+Copyright (c) 2009-2021 Hal Brodigan
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,8 +1,10 @@
 # Chars
 
-* http://chars.rubyforge.org/
-* http://github.com/postmodern/chars/
-* Postmodern (postmodern.mod3 at gmail.com)
+[![CI](https://github.com/postmodern/chars.rb/actions/workflows/ruby.yml/badge.svg)](https://github.com/postmodern/chars.rb/actions/workflows/ruby.yml)
+
+* [Source](https://github.com/postmodern/chars.rb#readme)
+* [Issues](https://github.com/postmodern/chars.rb/issues)
+* [Documentation](https://rubydoc.info/gems/chars)
 
 ## Description
 
@@ -12,80 +14,111 @@ recognizing text and generating random text from specific character sets.
 ## Features
 
 * Provides character sets for:
-  * Numeric ('0' - '9')
-  * Octal ('0' - '7')
-  * Uppercase Hexadecimal ('0' - '9', 'A' - 'F')
-  * Lowercase Hexadecimal ('0' - '9', 'a' - 'f')
-  * Hexadecimal ('0' - '9', 'a' - 'f', 'A' - 'F')
-  * Uppercase Alpha ('A' - 'Z')
-  * Lowercase Alpha ('a' - 'z')
-  * Alpha ('a' - 'z', 'A' - 'Z')
-  * Alpha-numeric ('0' - '9', 'a' - 'z', 'A' - 'Z')
-  * Punctuation (' ', '\'', '"', '`', ',', ';', ':', '~', '-', '(', ')',
-    '[', ']', '{', '}', '.', '?', '!')
-  * Symbols (' ', '\'', '"', '`', ',', ';', ':', '~', '-', '(', ')',
-    '[', ']', '{', '}', '.', '?', '!', '@', '#', '$', '%', '^', '&', '*',
-    '_', '+', '=', '|', '\\', '<', '>', '/')
-  * Space (' ', '\f', '\n', '\r', '\t', '\v')
-  * Visible ('0' - '9', 'a' - 'z', 'A' - 'Z', '\'', '"', '`', ',',
-    ';', ':', '~', '-', '(', ')', '[', ']', '{', '}', '.', '?', '!', '@',
-    '#', '$', '%', '^', '&', '*', '_', '+', '=', '|', '\\', '<', '>', '/',)
-  * Printable ('0' - '9', 'a' - 'z', 'A' - 'Z', ' ', '\'', '"', '`', ',',
-    ';', ':', '~', '-', '(', ')', '[', ']', '{', '}', '.', '?', '!', '@',
-    '#', '$', '%', '^', '&', '*', '_', '+', '=', '|', '\\', '<', '>', '/',
-    '\f', '\n', '\r', '\t', '\v')
-  * Control ('\x00' - '\x1f', '\x7f')
-  * Signed ASCII ('\x00' - '\x7f')
-  * ASCII ('\x00' - '\xff')
+  * Numeric: `0` - `9`
+  * Octal: `0` - `7`
+  * Uppercase Hexadecimal: `0` - `9`, `A` - `F`
+  * Lowercase Hexadecimal: `0` - `9`, `a` - `f`
+  * Hexadecimal: `0` - `9`, `a` - `f`, `A` - `F`
+  * Uppercase Alpha: `A` - `Z`
+  * Lowercase Alpha: `a` - `z`
+  * Alpha: `a` - `z`, `A` - `Z`
+  * Alpha-numeric: `0` - `9`, `a` - `z`, `A` - `Z`
+  * Punctuation: `' '`, `'`, `"`, `` ` ``, `,`, `;`, `:`, `~`, `-`, `(`, `)`, `[`, `]`, `{`, `}`, `.`, `?`, `!`
+  * Symbols: `' '`, `'`, `"`, `` ` ``, `,`, `;`, `:`, `~`, `-`, `(`, `)`, `[`, `]`, `{`, `}`, `.`, `?`, `!`, `@`, `#`, `$`, `%`, `^`, `&`, `*`, `_`, `+`, `=`, `|`, `\`, `<`, `>`, `/`
+  * Space: `' '`, `\f`, `\n`, `\r`, `\t`, `\v`
+  * Visible: `0` - `9`, `a` - `z`, `A` - `Z`, `'`, `"`, `` ` ``, `,`, `;`, `:`, `~`, `-`, `(`, `)`, `[`, `]`, `{`, `}`, `.`, `?`, `!`, `@`, `#`, `$`, `%`, `^`, `&`, `*`, `_`, `+`, `=`, `|`, `\`, `<`, `>`, `/`
+  * Printable: `0` - `9`, `a` - `z`, `A` - `Z`, `' '`, `'`, `"`, `` ` ``, `,`, `;`, `:`, `~`, `-`, `(`, `)`, `[`, `]`, `{`, `}`, `.`, `?`, `!`, `@`, `#`, `$`, `%`, `^`, `&`, <code>*</code>, <code>_</code>, `+`, `=`, `|`, `\`, `<`, `>`, `/`, `\f`, `\n`, `\r`, `\t`, `\v`
+  * Control: `\x00` - `\x1f`, `\x7f`
+  * Signed ASCII: `\x00` - `\x7f`
+  * ASCII: `\x00` - `\xff`
 
 ## Examples
 
 Determine whether a byte belongs to a character set:
 
-    0x41.alpha?
-    # => true
+```ruby
+0x41.alpha?
+# => true
+```
 
 Determine whether a String belongs to a character set:
 
-    "22e1c0".hex?
-    # => true
+```ruby
+"22e1c0".hex?
+# => true
+```
 
 Find all sub-strings that belong to a character set within a String:
 
-    ls = File.read('/bin/ls')
-    Chars.printable.strings_in(ls)
-    # => ["/lib64/ld-linux-x86-64.so.2", "KIq/", "5J~!", "%L~!", ...]
+```ruby
+ls = File.read('/bin/ls')
+Chars.printable.strings_in(ls)
+# => ["/lib64/ld-linux-x86-64.so.2", "KIq/", "5J~!", "%L~!", ...]
+```
 
 Return a random character from the set of all characters:
 
-    Chars.all.random_char
-    # => "\x94"
+```ruby
+Chars.all.random_char
+# => "\x94"
+```
 
 Return a random Array of characters from the alpha-numeric character set:
 
-    Chars.alpha_numeric.random_chars(10)
-    # => ["Q", "N", "S", "4", "x", "z", "3", "M", "F", "F"]
+```ruby
+Chars.alpha_numeric.random_chars(10)
+# => ["Q", "N", "S", "4", "x", "z", "3", "M", "F", "F"]
+```
 
 Return a random Array of a random length of unique characters from the
 visible character set:
 
-    Chars.visible.random_distinct_chars(1..10)
-    # => ["S", "l", "o", "8", "'", "q"]
+```ruby
+Chars.visible.random_distinct_chars(1..10)
+# => ["S", "l", "o", "8", "'", "q"]
+```
 
 Return a random String from the set of all characters:
 
-    Chars.all.random_string(10)
-    # => "\xc2h\xad\xccm7\x1e6J\x13"
+```ruby
+Chars.all.random_string(10)
+# => "\xc2h\xad\xccm7\x1e6J\x13"
+```
 
 Return a random String with a random length between 5 and 10, from the
 set of space characters:
 
-    Chars.space.random_string(5..10)
-    # => "\r\v\n\t\n\f"
+```ruby
+Chars.space.random_string(5..10)
+# => "\r\v\n\t\n\f"
+```
+
+## Requirements
+
+* [ruby](https://www.ruby-lang.org/) >= 2.0.0
 
 ## Install
 
-    $ sudo gem install chars
+    $ gem install chars
+
+### gemspec
+
+```ruby
+gem.add_dependency 'chars', '~> 0.2'
+```
+
+### Gemfile
+
+```ruby
+gem 'chars', '~> 0.2'
+```
+
+## Crystal
+
+[chars.cr] is a [Crystal] port of this library.
+
+[chars.cr]: https://github.com/postmodern/chars.cr
+[Crystal]: https://crystal-lang.org/
 
 ## License
 

data/Rakefile

@@ -1,35 +1,12 @@
 require 'rubygems'
-require 'rake'
 
-begin
-  gem 'ore-tasks', '~> 0.1.2'
-  require 'ore/tasks'
+require 'rubygems/tasks'
+Gem::Tasks.new
 
-  Ore::Tasks.new
-rescue LoadError => e
-  STDERR.puts e.message
-  STDERR.puts "Run `gem install ore-tasks` to install 'ore/tasks'."
-end
-
-begin
-  gem 'rspec', '~> 2.0.0'
-  require 'rspec/core/rake_task'
-
-  RSpec::Core::RakeTask.new
-rescue LoadError => e
-  task :spec do
-    abort "Please run `gem install rspec` to install RSpec."
-  end
-end
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+task :test => :spec
 task :default => :spec
 
-begin
-  gem 'yard', '~> 0.6.0'
-  require 'yard'
-
-  YARD::Rake::YardocTask.new  
-rescue LoadError => e
-  task :yard do
-    abort "Please run `gem install yard` to install YARD."
-  end
-end
+require 'yard'
+YARD::Rake::YardocTask.new

data/benchmarks/compare.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__),'..','lib'))
+
+require 'chars'
+require 'benchmark'
+
+CHARSET = Chars::ALPHA_NUMERIC
+N       = 1_000_000
+STRING  = ('A' * N) + '!'
+ENUM    = (['A', 0x42] * (N / 2)) << '!'
+
+Benchmark.bm(12) do |b|
+  b.report('String')     { CHARSET === STRING }
+  b.report('Enumerable') { CHARSET === ENUM }
+end

data/benchmarks/strings_in.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__),'..','lib'))
+
+require 'chars'
+require 'benchmark'
+
+CHARSET = Chars::ALPHA_NUMERIC
+STRING  = File.open('/usr/bin/openssl','rb') do |file|
+            file.read
+          end
+
+Benchmark.bm(24) do |b|
+  b.report('strings_in') do
+    CHARSET.strings_in(STRING) { |offset,string| }
+  end
+
+  (5..20).step(5) do |n|
+    b.report("strings_in (length=#{n})") do
+      CHARSET.strings_in(STRING, :length => n) { |offset,string| }
+    end
+  end
+end

data/chars.gemspec

@@ -1,10 +1,61 @@
-# -*- encoding: utf-8 -*-
+# encoding: utf-8
 
-begin
-  Ore::Specification.new do |gemspec|
-    # custom logic here
+require 'yaml'
+
+Gem::Specification.new do |gem|
+  gemspec = YAML.load_file('gemspec.yml')
+
+  gem.name    = gemspec.fetch('name')
+  gem.version = gemspec.fetch('version') do
+                  lib_dir = File.join(File.dirname(__FILE__),'lib')
+                  $LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
+                  require 'chars/version'
+                  Chars::VERSION
+                end
+
+  gem.summary     = gemspec['summary']
+  gem.description = gemspec['description']
+  gem.licenses    = Array(gemspec['license'])
+  gem.authors     = Array(gemspec['authors'])
+  gem.email       = gemspec['email']
+  gem.homepage    = gemspec['homepage']
+  gem.metadata    = gemspec['metadata'] if gemspec['metadata']
+
+  glob = lambda { |patterns| gem.files & Dir[*patterns] }
+
+  gem.files = `git ls-files`.split($/)
+  gem.files = glob[gemspec['files']] if gemspec['files']
+
+  gem.executables = gemspec.fetch('executables') do
+    glob['bin/*'].map { |path| File.basename(path) }
+  end
+  gem.default_executable = gem.executables.first if Gem::VERSION < '1.7.'
+
+  gem.extensions       = glob[gemspec['extensions'] || 'ext/**/extconf.rb']
+  gem.test_files       = glob[gemspec['test_files'] || '{test/{**/}*_test.rb']
+  gem.extra_rdoc_files = glob[gemspec['extra_doc_files'] || '*.{txt,md}']
+
+  gem.require_paths = Array(gemspec.fetch('require_paths') {
+    %w[ext lib].select { |dir| File.directory?(dir) }
+  })
+
+  gem.requirements              = gemspec['requirements']
+  gem.required_ruby_version     = gemspec['required_ruby_version']
+  gem.required_rubygems_version = gemspec['required_rubygems_version']
+  gem.post_install_message      = gemspec['post_install_message']
+
+  split = lambda { |string| string.split(/,\s*/) }
+
+  if gemspec['dependencies']
+    gemspec['dependencies'].each do |name,versions|
+      gem.add_dependency(name,split[versions])
+    end
+  end
+
+  if gemspec['development_dependencies']
+    gemspec['development_dependencies'].each do |name,versions|
+      gem.add_development_dependency(name,split[versions])
+    end
   end
-rescue NameError
-  STDERR.puts "The 'chars.gemspec' file requires Ore."
-  STDERR.puts "Run `gem install ore` to install Ore."
 end

data/gemspec.yml

@@ -5,12 +5,18 @@ description:
   recognizing text and generating random text from specific character sets.
 
 license: MIT
-homepage: http://github.com/postmodern/chars
+homepage: https://github.com/postmodern/chars.rb#readme
 authors: Postmodern
 email: postmodern.mod3@gmail.com
 has_yard: true
 
+metadata:
+  documentation_uri: https://rubydoc.info/gems/chars
+  source_code_uri:   https://github.com/postmodern/chars.rb
+  bug_tracker_uri:   https://github.com/postmodern/chars.rb/issues
+  changelog_uri:     https://github.com/postmodern/chars.rb/blob/master/ChangeLog.md
+
+required_ruby_version: ">= 2.0.0"
+
 development_dependencies:
-  ore: ~> 0.2.0
-  ore-tasks: ~> 0.1.2
-  rspec: ~> 2.0.0
+  bundler: ~> 2.0