zaru 1.0.1 → 1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3be0cb999f6287e9eb05028d4b1b67653d4b92ca4090e9ba02e0031e06150e3d
-  data.tar.gz: 4aadd8f48d3ec42b0c596a119728ca6ad32daf80c024deb692f1077704ebd0e3
+  metadata.gz: 563b71271ed8169cd299499ef243e937f5fd3a04055377db87c0d821973a839e
+  data.tar.gz: a8f51824ca7a18598770f9a2a63c254565fe47ed4f616f87bcdd8c9e6d5f0201
 SHA512:
-  metadata.gz: 3d6f69471eb7ce02f6e3e940784b7ccdaa479a3dd281e8259bf15a870a02c7473b77cbc24e0a1cba010ed1d0fe0b6b05c0d2d34761264a4ca55c944ce020f469
-  data.tar.gz: 4085067f0407cad9cefde91add08d1973fbb3b393b8d57efaea1cb23ab4fb17fc34a851fae18c188d145511e34e54e5c80a08f6dbb1058a9a7a461c5f3a20c32
+  metadata.gz: f4b51ce4dc951a7ecbf2867b2554505ca0837392cee8e1f8b0bc26fcfebdffb6d787006c9764bd2b1d1e8ca9dd71a8ce9114459ba2ea783b6e0ecd0e16c0aeac
+  data.tar.gz: 9470144c2ca5b9a5eb79b030bad989ee0fa3d638a1572e38a1e69799a1da1dac1e8daaa65b2fe97aebadb126e50c528dfcc7890d243afd0a73e146c441f4f24e

data/lib/zaru.rb

@@ -1,12 +1,14 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
+# Zaru normalizes, sanitizes, and truncates filenames so they can be
+# safely used across Linux, macOS, and Windows.
 class Zaru
-  CHARACTER_FILTER = /[\x00-\x1F\/\\:\*\?\"<>\|]/u
-  UNICODE_WHITESPACE = /[[:space:]]+/u
+  CHARACTER_FILTER = %r{[\x00-\x1F/\\:*?"<>|]}u.freeze
+  UNICODE_WHITESPACE = /[[:space:]]+/u.freeze
   WINDOWS_RESERVED_NAMES =
-    %w{CON PRN AUX NUL COM1 COM2 COM3 COM4 COM5
-       COM6 COM7 COM8 COM9 LPT1 LPT2 LPT3 LPT4
-       LPT5 LPT6 LPT7 LPT8 LPT9}
+    %w[CON PRN AUX NUL COM1 COM2 COM3 COM4 COM5 COM6 COM7 COM8 COM9
+       COM COM² COM³ LPT1 LPT2 LPT3 LPT4 LPT5 LPT6 LPT7 LPT8 LPT9 LPT¹
+       LPT² LPT³].freeze
   FALLBACK_FILENAME = 'file'
 
   def initialize(filename, options = {})
@@ -18,7 +20,7 @@ class Zaru
   # strip whitespace on beginning and end
   # collapse intra-string whitespace into single spaces
   def normalize
-    @normalized ||= @raw.strip.gsub(UNICODE_WHITESPACE,' ')
+    @normalize ||= @raw.strip.gsub(UNICODE_WHITESPACE, ' ')
   end
 
   # remove bad things!
@@ -29,15 +31,16 @@ class Zaru
   #
   # this renormalizes after filtering in order to collapse whitespace
   def sanitize
-    @sanitized ||=
-      filter(normalize.gsub(CHARACTER_FILTER,'')).gsub(UNICODE_WHITESPACE,' ')
+    @sanitize ||=
+      filter(normalize.gsub(CHARACTER_FILTER, '')).gsub(UNICODE_WHITESPACE, ' ')
   end
 
   # cut off at 255 characters
   # optionally provide a padding, which is useful to
   # make sure there is room to add a file extension later
   def truncate
-    @truncated ||= sanitize.chars.to_a.slice(0..254-@padding).join
+    max_length = [254 - @padding, 0].max + 1
+    @truncate ||= sanitize.chars.to_a.slice(0...max_length).join
   end
 
   def to_s
@@ -51,24 +54,32 @@ class Zaru
 
   private
 
-    attr_reader :fallback
+  attr_reader :fallback
 
-    def filter(filename)
-      filename = filter_windows_reserved_names(filename)
-      filename = filter_blank(filename)
-      filename = filter_dot(filename)
-    end
+  def filter(filename)
+    filename = filter_windows_reserved_names(filename)
+    filename = filter_blank(filename)
+    filter_dot(filename)
+  end
 
-    def filter_windows_reserved_names(filename)
-      WINDOWS_RESERVED_NAMES.include?(filename.upcase) ? fallback : filename
-    end
+  def filter_windows_reserved_names(filename)
+    return '' if filename.empty?
 
-    def filter_blank(filename)
-      filename.empty?? fallback : filename
-    end
+    parts = filename.split('.').reject(&:empty?)
+    return '' if parts.empty?
 
-    def filter_dot(filename)
-      filename.start_with?('.')? "#{fallback}#{filename}" : filename
+    if WINDOWS_RESERVED_NAMES.include?(parts[0].upcase)
+      parts.fill(fallback, 0, 1).join('.')
+    else
+      filename
     end
+  end
+
+  def filter_blank(filename)
+    filename.empty? ? fallback : filename
+  end
 
+  def filter_dot(filename)
+    filename.start_with?('.') ? "#{fallback}#{filename}" : filename
+  end
 end

metadata

@@ -1,56 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zaru
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: '1.1'
 platform: ruby
 authors:
 - Thomas Fuchs
 bindir: bin
 cert_chain: []
-date: 2025-10-06 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: test-unit
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
 description: Zaru takes a given filename (a string) and normalizes, filters and truncates
   it, so it can be safely used as a filename in modern operating systems. Zaru doesn't
   remove Unicode characters when not necessary.
@@ -71,7 +29,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '1.9'
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="