dumb_delimited 2.0.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '049c4e61de54be67ca44c3b01d7f97fd5f1972953415ed339a14c55ec0c6d0c4'
-  data.tar.gz: 38f8e15d6a44ab8af339cf4da8e8addb232c8118ba1b8603e31deb934ca95989
+  metadata.gz: 98873351e7fa4aeb8624f716a4de4c2090e066b8b14b138d69bd01a5c7d6f4c4
+  data.tar.gz: 50595400f33304f7244c850cd72750dcbc70be0caabcbf95cee61dd671167cd1
 SHA512:
-  metadata.gz: 47aea2da44d901f3606f9e997f6024dd0413f131bec2f7f53db73863c7975a4102996f45a6eef2ffecdbf97d12c2b27132b9689dbb51f1911b1fa4f3419d9c4f
-  data.tar.gz: a4e067dccc15b8588ab721da6e12e5175be63febce3b25198178324944e60b248a1e9927c23b738beba4df6752525c451a8eeaf65553bacf79a017a069a4dbb4
+  metadata.gz: 8797e92b1c578dfaa961b85d31eac7004539123fc3994f9b08ecbb05d7c6675ac01fa961e881795820b59218a27104f8ee60cd133a23a56364a77d77631bc5cc
+  data.tar.gz: 71795adf574729557f3524f4007c62baeee9bcb8953874362afbc5843a67c424c88dadf30531738ed57bcd56499ed5807e8fe230214bc9cee30910f0768ec514

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 3.0.0
+
+* [BREAKING] Drop support for Ruby < 3.4
+* Fix CSV keyword-argument compatibility
+
+
 ## 2.0.0
 
 * [BREAKING] Do not activate `options[:converters]` by default

data/Gemfile

@@ -2,3 +2,6 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in dumb_delimited.gemspec
 gemspec
+
+gem "rake", "~> 13.0"
+gem "minitest", "~> 6.0"

data/README.md

@@ -1,6 +1,6 @@
 # dumb_delimited
 
-A library for unsophisticated delimited flat file IO.  *dumb_delimited*
+A library for unsophisticated delimited flat file IO.  `dumb_delimited`
 mixes models and persistence in that "probably wrong but feels so right"
 kind of way.
 
@@ -55,7 +55,7 @@ Thus, the `Customer` class could alternatively be written as:
 Customer = DumbDelimited.psv(:name, :email, :address)
 ```
 
-Using our model classes, we can read each flat file, and recieve an
+Using our model classes, we can read each flat file, and receive an
 array of model objects:
 
 ```ruby
@@ -105,31 +105,20 @@ end
 Product.write("products.csv", products)
 ```
 
-For a more detailed explanation of the *dumb_delimited* API, browse the
-[API documentation](http://www.rubydoc.info/gems/dumb_delimited/).
+For a more detailed explanation of the `dumb_delimited` API, browse the
+[API documentation](https://www.rubydoc.info/gems/dumb_delimited/).
 
 
 ## Installation
 
-Install from [Ruby Gems](https://rubygems.org/gems/dumb_delimited):
-
-```bash
-$ gem install dumb_delimited
-```
-
-Then require in your Ruby script:
-
-```ruby
-require "dumb_delimited"
-```
+Install the [`dumb_delimited` gem](https://rubygems.org/gems/dumb_delimited).
 
 
 ## Contributing
 
-Run `rake test` to run the tests.  You can also run `rake irb` for an
-interactive prompt that pre-loads the project code.
+Run `rake test` to run the tests.
 
 
 ## License
 
-[MIT License](https://opensource.org/licenses/MIT)
+[MIT License](LICENSE.txt)

data/Rakefile

@@ -1,18 +1,5 @@
 require "bundler/gem_tasks"
 require "rake/testtask"
-require "yard"
-
-
-YARD::Rake::YardocTask.new(:doc) do |t|
-end
-
-desc "Launch IRB with this gem pre-loaded"
-task :irb do
-  require "dumb_delimited"
-  require "irb"
-  ARGV.clear
-  IRB.start
-end
 
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"

data/dumb_delimited.gemspec

@@ -1,27 +1,27 @@
-# coding: utf-8
-lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "dumb_delimited/version"
+require_relative "lib/dumb_delimited/version"
 
 Gem::Specification.new do |spec|
   spec.name          = "dumb_delimited"
   spec.version       = DumbDelimited::VERSION
   spec.authors       = ["Jonathan Hefner"]
-  spec.email         = ["jonathan.hefner@gmail.com"]
+  spec.email         = ["jonathan@hefner.pro"]
 
-  spec.summary       = %q{Library for unsophisticated delimited flat file IO}
+  spec.summary       = %q{Unsophisticated delimited flat file IO}
   spec.homepage      = "https://github.com/jonathanhefner/dumb_delimited"
   spec.license       = "MIT"
+  spec.required_ruby_version = ">= 3.4"
 
-  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|features)/})
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = spec.metadata["source_code_uri"] + "/blob/master/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject { |f| f.start_with?("test/", ".git") }
   end
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.15"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "minitest", "~> 5.0"
-  spec.add_development_dependency "yard", "~> 0.9"
+  spec.add_dependency "csv"
 end

data/lib/dumb_delimited/version.rb

@@ -1,3 +1,3 @@
 module DumbDelimited
-  VERSION = "2.0.0"
+  VERSION = "3.0.0"
 end

data/lib/dumb_delimited.rb

@@ -6,10 +6,10 @@ module DumbDelimited
 
   # Returns a model class for delimited data consisting of the specified
   # +columns+.  The returned class inherits from Ruby's
-  # {https://docs.ruby-lang.org/en/trunk/Struct.html +Struct+}, allowing
-  # data manipulation via accessor methods, via indexing by column name,
-  # and via indexing by column number.  See {ClassMethods} and
-  # {InstanceMethods} for the additional methods the returned class
+  # {https://docs.ruby-lang.org/en/master/Struct.html +Struct+},
+  # allowing data manipulation via accessor methods, via indexing by
+  # column name, and via indexing by column number.  See {ClassMethods}
+  # and {InstanceMethods} for the additional methods the returned class
   # provides.
   #
   # @example
@@ -97,15 +97,15 @@ end
 
 module DumbDelimited::ClassMethods
 
-  # Returns the CSV options Hash.  The Hash is not +dup+ed and can be
+  # Returns the CSV options Hash.  The Hash is not +dup+'d and can be
   # modified directly.  Any modifications will be applied to all future
   # IO operations for the model class.
   #
   # For detailed information about available options, see Ruby's
-  # {https://docs.ruby-lang.org/en/trunk/CSV.html#method-c-new CSV
+  # {https://docs.ruby-lang.org/en/master/CSV.html#method-c-new CSV
   # class}.
   #
-  # @return [Hash<Symbol, Object>]
+  # @return [Hash{Symbol => Object}]
   def options
     @options ||= if superclass == Struct
       CSV::DEFAULT_OPTIONS.merge(
@@ -122,11 +122,11 @@ module DumbDelimited::ClassMethods
   # class.  To set options individually, see {options}.
   #
   # For detailed information about available options, see Ruby's
-  # {https://docs.ruby-lang.org/en/trunk/CSV.html#method-c-new CSV
+  # {https://docs.ruby-lang.org/en/master/CSV.html#method-c-new CSV
   # class}.
   #
-  # @param opts [Hash<Symbol, Object>]
-  # @return [Hash<Symbol, Object>]
+  # @param opts [Hash{Symbol => Object}]
+  # @return [opts]
   def options=(opts)
     @options = opts
   end
@@ -156,7 +156,7 @@ module DumbDelimited::ClassMethods
   #   p.to_s  # == "1|2|3"
   #
   # @param delim [String]
-  # @return [String]
+  # @return [delim]
   def delimiter=(delim)
     self.options[:col_sep] = delim
   end
@@ -195,7 +195,7 @@ module DumbDelimited::ClassMethods
   # Parses a string or IO object one line at a time, yielding a model
   # object for each line.
   #
-  # An Enumerator is returned if no block is given.
+  # If no block is given, an Enumerator is returned instead.
   #
   # @overload parse_each(data, &block)
   #   @param data [String, IO]
@@ -208,7 +208,7 @@ module DumbDelimited::ClassMethods
   def parse_each(data, &block)
     return to_enum(__method__, data) unless block_given?
 
-    csv_each(CSV.new(data, self.options), &block)
+    csv_each(CSV.new(data, **self.options), &block)
   end
 
   # Parses a file into an array of model objects.  This will load the
@@ -242,9 +242,9 @@ module DumbDelimited::ClassMethods
   # line.  This avoids loading the entire contents of the file into
   # memory at once.
   #
-  # An Enumerator is returned if no block is given.  Note that some
-  # Enumerator methods, such as +Enumerator#to_a+, can cause the entire
-  # contents of the file to be loaded into memory.
+  # If no block is given, an Enumerator is returned instead.  Note that
+  # some Enumerator methods, such as +Enumerator#to_a+, can cause the
+  # entire contents of the file to be loaded into memory.
   #
   # @overload read_each(path, &block)
   #   @param path [String, Pathname]
@@ -257,7 +257,7 @@ module DumbDelimited::ClassMethods
   def read_each(path, &block)
     return to_enum(__method__, path) unless block_given?
 
-    CSV.open(path, self.options) do |csv|
+    CSV.open(path, **self.options) do |csv|
       csv_each(csv, &block)
     end
   end

metadata

@@ -1,80 +1,34 @@
 --- !ruby/object:Gem::Specification
 name: dumb_delimited
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Jonathan Hefner
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-07-03 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: csv
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.15'
-  type: :development
+        version: '0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.15'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-description: 
+        version: '0'
 email:
-- jonathan.hefner@gmail.com
+- jonathan@hefner.pro
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
@@ -86,8 +40,9 @@ files:
 homepage: https://github.com/jonathanhefner/dumb_delimited
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  source_code_uri: https://github.com/jonathanhefner/dumb_delimited
+  changelog_uri: https://github.com/jonathanhefner/dumb_delimited/blob/master/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib
@@ -95,15 +50,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
-signing_key: 
+rubygems_version: 4.0.10
 specification_version: 4
-summary: Library for unsophisticated delimited flat file IO
+summary: Unsophisticated delimited flat file IO
 test_files: []

data/.gitignore

@@ -1,9 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/

data/.travis.yml

@@ -1,5 +0,0 @@
-sudo: false
-language: ruby
-rvm:
-  - 2.2.5
-before_install: gem install bundler -v 1.15.1