textrepo 0.5.7 → 0.5.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b85b70f9d672503576cbce911f202dac9d00cf8af3915109f304c4c2745ce32f
-  data.tar.gz: 9ca1decf965281c4f1a34b908a919478aafc915293412b3a9fa6e4903f57de45
+  metadata.gz: bf69f1606a2c55098ab6b3b8ea063aa7ee45dc06917d230abd4a29cc7a119c71
+  data.tar.gz: a366497c8ff6b8e305780aab3c0ac8c6bdc315e175f39ceb95ea020a6df163a1
 SHA512:
-  metadata.gz: 6c24a75691c34d72dae4e33c13a22c7dc4a04539d29edcfafa31b93815b8fada5b0c7840f0c90b32b461eb925d28c32d0918dc65a5bda05592379d6f02ddd4bc
-  data.tar.gz: bc16b111bf4bc9cc7ca62942025961ac572ee892925bcce0f6a6b8c2e78ea664affbbcb18d79832cd4168fcaf62b57410f0c058c315e600750e6e348d5541153
+  metadata.gz: 93b08a70c122530e33f05d9581052cfd17dcb56a85e03281ba9405394f946771f1b17734c1b6fd1d2771423f08c384bf2a8c0c895c5f08ff0f9b65bea3e23ae3
+  data.tar.gz: b9f1ce017a0e4f1b0bb68d05c9a2211b8bda3a4d78c4440c08549001b538f38c701ed0e712b14f7de510321a66afd610fc2520180322eecb4bf089fa0fbd4d4b

data/CHANGELOG.md

@@ -5,7 +5,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
-Nothing to record here.
+- add a section to describe about **text** into `README.md`.
 
 ## [0.5.7] - 2020-11-16
 ### Fixed

data/README.md

@@ -61,6 +61,32 @@ stamps.each { |stamp|
 Also see `examples` directory.  There is a small tool to demonstrate
 how to use `textrepo`.
 
+## What is TEXT?
+
+In macOS (or similar unix OS), text is a date stored into a regular
+file.  Its characteristics are;
+
+- a character stream coded in some encoding system (such UTF-8),
+- divided into multiple physical lines with newline character (`\n`).
+
+In `textrepo` and its client program, a **text** is usually generated
+from a text file mentioned above.  It is;
+
+- a character stream coded in UTF-8,
+- consists of multiple logical lines (each of them does not contain a
+  newline character).
+
+That is, newline characters are removed when text is read from a file
+and added appropriately when it is written into a file.
+
+So, **text** is represented with Ruby objects as follows:
+
+- **Text** is represented with an `Array` object which contains
+  multiple `String` objects.
+- A `String` object represents a **logical line** of **text**.
+- Each `String` does not contain a newline character.
+- An empty string ("") represents a empty line.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/textrepo/timestamp.rb

@@ -329,11 +329,11 @@ module Textrepo
       # Raises InvalidTimestampStringError if nil was passed as an arguemnt.
 
       def split_stamp(stamp_str)
-        raise InvalidTimestampStringError, stamp_str if stamp_str.nil?
+        raise InvalidTimestampStringError, "(nil)" if stamp_str.nil?
         #    yyyy  mo    dd    hh    mi      ss      sfx
         a = [0..3, 4..5, 6..7, 8..9, 10..11, 12..13, 15..17].map {|r| stamp_str[r]}
         a.delete_at(-1) if a[-1].nil?
-        a
+        a.map{|e| e || "" }
       end
 
       ##
@@ -348,18 +348,15 @@ module Textrepo
       #     parse_s("20201028163529_034") -> Timestamp
 
       def parse_s(stamp_str)
+        raise InvalidTimestampStringError, "(nil)" if stamp_str.nil?
+        raise InvalidTimestampStringError, "(empty string)" if stamp_str.empty?
+        raise InvalidTimestampStringError, stamp_str if stamp_str.size < 14
+
         begin
           ye, mo, da, ho, mi, se, sfx = split_stamp(stamp_str).map(&:to_i)
           Timestamp.new(Time.new(ye, mo, da, ho, mi, se), sfx)
-        rescue InvalidTimestampStringError, ArgumentError => _
-          emsg = if stamp_str.nil?
-            "(nil)"
-          elsif stamp_str.empty?
-            "(empty string)"
-          else
-            stamp_str
-          end
-          raise InvalidTimestampStringError, emsg
+        rescue ArgumentRangeError, ArgumentError => _
+          raise InvalidTimestampStringError, stamp_str
         end
       end
     end

data/lib/textrepo/version.rb

@@ -1,3 +1,3 @@
 module Textrepo
-  VERSION = '0.5.7'
+  VERSION = '0.5.8'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: textrepo
 version: !ruby/object:Gem::Version
-  version: 0.5.7
+  version: 0.5.8
 platform: ruby
 authors:
 - mnbi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-11-16 00:00:00.000000000 Z
+date: 2021-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -77,7 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.3
 signing_key:
 specification_version: 4
 summary: A repository to store text with timestamp.