qdumpfs 1.10.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ace57748311474078255f93323c921f04c1d63ce40f04bb12ec15d0e48a38e8
-  data.tar.gz: 7c214b8b293a6f5feee3573d3d87d09be7fb18f43d1db6376b2c521081025bd5
+  metadata.gz: 60995f56e6f0f6bb889d010c905717c1ba0a1d635ac57694d59d4b67d05959e4
+  data.tar.gz: a099f94ae4b88194872e5932f3223916c9c3f50ccc1aec558b03d72d92030107
 SHA512:
-  metadata.gz: 10107064217f62fb81170d3d6a01d8de7e18ec2953aed30c3d6fe0d68d0f0a8b157745b7277b9b92e8a61aa6bf49d7c8f9b42144cc3724f6279d7719caf316ee
-  data.tar.gz: d82bc50988880296280b4cf7c6fd47669288ffefa72049829ea9e3219ea2ab2769e33b6dda41f8f847c620f5d1b6e053f9aeb47bb2bbe07b105d21f12945d3a0
+  metadata.gz: c07cbd31079b3df414dcee306f6ff5e216c851c5df462242cee1a0e4711dce053f8073d70ee43e2d4a4ab43392061068b6d2c66148942c3084e82709ed732a0d
+  data.tar.gz: f3cdd3683ca7b8db8089fc645ce1b2b4163e6983e5b3a00cc1f0c246c9305eca429ce619f2f0561351abc57ef3da31869013062d6d90b3623f9c69bb3e43c9c3

data/.gitignore

@@ -20,5 +20,4 @@ test*.sh
 .idea/dataSources.xml
 .idea/dataSources.local.xml
 /sync_d.cmd
-/test
-*.txt
+*.txt

data/.idea/copilot.data.migration.agent.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AgentMigrationStateService">
+    <option name="migrationStatus" value="COMPLETED" />
+  </component>
+</project>

data/.idea/qdumpfs.iml

@@ -10,10 +10,10 @@
       <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
       <excludeFolder url="file://$MODULE_DIR$/.idea/copilot/chatSessions" />
     </content>
-    <orderEntry type="jdk" jdkName="rbenv: 3.1.6" jdkType="RUBY_SDK" />
+    <orderEntry type="jdk" jdkName="rbenv: 3.2.6" jdkType="RUBY_SDK" />
     <orderEntry type="sourceFolder" forTests="false" />
     <orderEntry type="module-library">
-      <library name="minitest (v5.25.1) [path][gem]" type="rubylib">
+      <library name="minitest (v5.25.4) [path][gem]" type="rubylib">
         <properties>
           <option name="additionalInfo">
             <AdditionalInfo>
@@ -30,20 +30,20 @@
               <option value="lib" />
             </list>
           </option>
-          <option name="url" value="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/minitest-5.25.1" />
-          <option name="version" value="5.25.1" />
+          <option name="url" value="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/minitest-5.25.4" />
+          <option name="version" value="5.25.4" />
         </properties>
         <CLASSES>
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/minitest-5.25.1/lib" />
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/minitest-5.25.1/test" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/minitest-5.25.4/lib" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/minitest-5.25.4/test" />
         </CLASSES>
         <JAVADOC />
         <SOURCES>
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/minitest-5.25.1/lib" />
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/minitest-5.25.1/test" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/minitest-5.25.4/lib" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/minitest-5.25.4/test" />
         </SOURCES>
         <excluded>
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/minitest-5.25.1/test" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/minitest-5.25.4/test" />
         </excluded>
       </library>
     </orderEntry>
@@ -65,27 +65,27 @@
               <option value="lib" />
             </list>
           </option>
-          <option name="url" value="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/rake-13.2.1" />
+          <option name="url" value="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/rake-13.2.1" />
           <option name="version" value="13.2.1" />
         </properties>
         <CLASSES>
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/rake-13.2.1/doc" />
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/rake-13.2.1/exe" />
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/rake-13.2.1/lib" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/rake-13.2.1/doc" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/rake-13.2.1/exe" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/rake-13.2.1/lib" />
         </CLASSES>
         <JAVADOC />
         <SOURCES>
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/rake-13.2.1/doc" />
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/rake-13.2.1/exe" />
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/rake-13.2.1/lib" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/rake-13.2.1/doc" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/rake-13.2.1/exe" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/rake-13.2.1/lib" />
         </SOURCES>
         <excluded>
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/rake-13.2.1/doc" />
-          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.1.0/gems/rake-13.2.1/exe" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/rake-13.2.1/doc" />
+          <root url="file://$MODULE_DIR$/vendor/bundle/ruby/3.2.0/gems/rake-13.2.1/exe" />
         </excluded>
       </library>
     </orderEntry>
-    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.3.27, rbenv: 3.1.6) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.4.19, rbenv: 3.2.6) [gem]" level="application" />
   </component>
   <component name="RakeTasksCache-v2">
     <option name="myRootTask">

data/CLAUDE.md

@@ -0,0 +1,71 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## プロジェクト概要
+
+QdumpfsはpdumpfsのRuby Gem改良版で、差分バックアップツールです。指定されたディレクトリを日付ベース（YYYY/MM/DD形式）でバックアップし、変更されたファイルのみをコピーする効率的なバックアップシステムを提供します。
+
+## 開発コマンド
+
+### テスト実行
+```bash
+# 全テスト実行
+./test.sh
+# または
+bundle exec rake test
+
+# 特定のテストファイル実行
+./test.sh test/qdumpfs_test.rb
+```
+
+### Gem関連
+```bash
+# 依存関係インストール
+bundle install
+
+# Gemビルド
+bundle exec rake build
+
+# Gem公開（注意: メタデータで制限されている場合あり）
+bundle exec rake release
+```
+
+## コード構造
+
+### メインコンポーネント
+
+- **exe/qdumpfs**: エントリーポイント実行ファイル
+- **lib/qdumpfs.rb**: メインモジュールとCommandクラス
+- **lib/qdumpfs/option.rb**: オプション解析とBackupDirクラス
+- **lib/qdumpfs/util.rb**: ユーティリティ関数群
+- **lib/qdumpfs/win32.rb**: Windows固有の機能
+- **lib/qdumpfs/version.rb**: バージョン情報
+
+### 主要機能
+
+1. **backup**: 差分バックアップ作成（デフォルト）
+2. **sync**: バックアップフォルダ間の同期
+3. **list**: バックアップ内容の一覧表示
+4. **verify**: バックアップの検証
+5. **expire**: 保持ポリシーに基づく古いバックアップの削除
+6. **delete**: 指定パターンの削除
+
+### バックアップの仕組み
+
+- 日付ベースディレクトリ構造: `dest/YYYY/MM/DD/`
+- 差分バックアップ: 変更されたファイルのみコピー、未変更ファイルはハードリンク
+- `latest`シンボリックリンクで最新バックアップを指示
+- Windows/Unix両対応
+
+### 除外機能
+
+- `--exclude=PATTERN`: 正規表現パターンで除外
+- `--exclude-by-size=SIZE`: ファイルサイズで除外  
+- `--exclude-by-glob=GLOB`: Globパターンで除外
+
+## 注意点
+
+- Ruby 3.2系対応済み（taint/untaintメソッド削除対応済み）
+- クロスプラットフォーム対応（Windows/Unix）
+- ファイルシステムの容量不足時の不完全バックアップ処理対応

data/Gemfile.lock

@@ -1,18 +1,17 @@
 PATH
   remote: .
   specs:
-    qdumpfs (1.10.0)
+    qdumpfs (1.12.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    minitest (5.25.2)
+    minitest (5.25.4)
     rake (13.2.1)
 
 PLATFORMS
-  x64-mingw32
-  x86_64-darwin-22
-  x86_64-darwin-23
+  arm64-darwin-24
+  arm64-darwin-25
   x86_64-darwin-24
 
 DEPENDENCIES
@@ -22,4 +21,4 @@ DEPENDENCIES
   rake (>= 12.3.3)
 
 BUNDLED WITH
-   2.3.27
+   2.4.19

data/README.html

@@ -0,0 +1,54 @@
+<h1 id="qdumpfs">Qdumpfs</h1>
+<p>pdumpfsの個人的改良版です。</p>
+<p>Gem化して最近のバージョンのバージョンのRubyに対応。コマンドの拡張などを行っています。</p>
+<h2 id="インストール">インストール</h2>
+<p>gem install qdumpfs</p>
+<h2 id="使用方法">使用方法</h2>
+<pre><code>Usage: qdumpfs [options] &lt;source&gt; &lt;dest&gt;
+    -h, --help                       show this message
+Options
+    -v, --verbose                    verbose message
+    -r, --report                     report message
+    -n, --dry-run                    don&#39;t actually run any commands
+    -e, --exclude=PATTERN            exclude files/directories matching PATTERN
+    -s, --exclude-by-size=SIZE       exclude files larger than SIZE
+    -w, --exclude-by-glob=GLOB       exclude files matching GLOB
+    -c, --command=COMMAND            backup|sync|list|expire|verify|delete
+    -l, --limit=HOURS                limit hours
+    -k, --keep=KEEPARG               ex: --keep 100Y12M12W30D (100years, 12months, 12weeks, 30days, default)</code></pre>
+<h2 id="実行例">実行例</h2>
+<h3 id="バックアップ">バックアップ</h3>
+<p>バックアップを実行する場合。</p>
+<p><code>qdumpfs コピー元 コピー先</code>でバックアップを作成することができます。コピー先が存在する場合差分バックアップとなります。</p>
+<pre><code>qdumpfs /home/foo /backup</code></pre>
+<p><code>--command backup</code>オプションを明示することもできます。</p>
+<pre><code>qdumpfs --command=backup /home/foo /backup</code></pre>
+<h3 id="バックアップフォルダの同期">バックアップフォルダの同期</h3>
+<p>バックアップフォルダを同期することもできます。バックアップディスクが手狭になり、新しいディスクに移行したい場合に便利です。</p>
+<p><code>--command sync</code>オプションを指定することでバックアップフォルダを同期できます。</p>
+<pre><code>qdumpfs --command=sync /backup1 /backup2</code></pre>
+<p>バックアップフォルダの同期には膨大な時間が必要な場合があるため、実行時間を制限できます。以下は例えば1時間に制限する場合です。</p>
+<p>実行時間が1時間を超えるとそこで処理が終了しますそこから次回継続することができます。</p>
+<pre><code>qdumpfs --command=sync --limit=1 /backup1 /backup2</code></pre>
+<p>バックアップフォルダを間引きたい場合、<code>--keep=</code>オプションを指定することができます。“100Y12M12W30D”を指定すると、100年間は年に1つ、12ヶ月間は月に1つ、12週間は週に1つ、直近30日間のバックアップを保持します。条件に該当しないバックアップは同期されません。</p>
+<pre><code>qdumpfs --command=sync --limit=1 --keep=5Y6M7W10D backup1 /backup2</code></pre>
+<p>バックアップの同期は、コピー先の最新の日付より新しいコピー元を選択して実行されます。これはバックアップの同期が途中で中断された場合、再開することができるようにするためです。</p>
+<p>例えばコピー先に2024/11/01のバックアップが存在する場合、コピー元の2024/11/01より後のバックアップデータ(例えば2024/11/02)があれば、それが同期されます(同じ日付は同期されません)。</p>
+<h3 id="バックアップフォルダの削除">バックアップフォルダの削除</h3>
+<p><code>--command expire</code>で、<code>--keep=パターン</code>に該当しないバックアップを削除できます。</p>
+<pre><code>qdumpfs --command=expire --limit=1 --keep=5Y6M7W10D backup1 /backup2</code></pre>
+<h3 id="バックアップフォルダから指定パターンを削除">バックアップフォルダから指定パターンを削除</h3>
+<p><code>--command delete</code>で、バックアップに存在する指定したパスを削除できます(間違えてバックアップした内容を削除したい場合などに使用)。</p>
+<pre><code>qdumpfs --command=delete --delete-dir=backup1 --limit=1  r:/backup2</code></pre>
+<h3 id="バックアップの比較">バックアップの比較</h3>
+<p><code>--command verify</code>でバックアップを比較することができます。</p>
+<pre><code>qdumpfs  --command=verify j:/backup/2024/11/01 k:/backup/2024/11/01</code></pre>
+<h3 id="バックアップファイルの一覧">バックアップファイルの一覧</h3>
+<p><code>--command list</code>でバックアップファイルを一覧表示することができます。</p>
+<pre><code>qdumpfs  --command=list j:/backup/2024/11/01 </code></pre>
+<p>例えばverifyで異なる結果が表示された場合、listした結果をdiffすることができます。</p>
+<pre><code>qdumpfs  --command=list j:/backup/2024/11/01 
+qdumpfs  --command=list k:/backup/2024/11/01 
+diff list_j__backup_2024_11_01.txt list_k__backup_2024_11_01.txt</code></pre>
+<h2 id="license">License</h2>
+<p>qdumpfs is a free software with ABSOLUTELY NO WARRANTY under the terms of the GNU General Public License version 2.</p>

data/README.md

@@ -1,14 +1,33 @@
 # Qdumpfs
 
-pdumpfsの個人的改良版です。
+**Language**: [English](#) | [日本語](README_ja.md)
 
-Gem化して最近のバージョンのバージョンのRubyに対応。コマンドの拡張などを行っています。
+Qdumpfs is an efficient incremental backup tool developed as a personal improvement of pdumpfs.
 
-## インストール
+This tool modernizes pdumpfs as a Ruby Gem, supporting recent Ruby versions (Ruby 3.2+ compatible). It creates incremental backups with date-based directory structure (YYYY/MM/DD format), copying only changed files and using hard links for unchanged files to maximize storage efficiency.
 
+## Features
+
+- **Efficient Incremental Backup**: Copies only changed files, saves space with hard links for unchanged files
+- **Date-based Management**: Organized backups in YYYY/MM/DD directory structure
+- **Cross-platform Support**: Works on Windows/Unix/macOS environments
+- **Ruby 3.2+ Compatible**: Supports latest Ruby versions (taint/untaint methods removed)
+- **Rich Exclusion Options**: Flexible exclusion settings with regex patterns, file size, and glob patterns
+- **Comprehensive Backup Management**: Sync, verify, delete, list and other management functions
+
+## Installation
+
+```bash
 gem install qdumpfs
+```
+
+## Requirements
 
-## 使用方法
+- **Ruby**: 3.0 or higher (Ruby 3.2+ compatible)
+- **OS**: Windows, Linux, macOS
+- **Dependencies**: Standard library only (no additional gems required)
+
+## Usage
 
 ```
 Usage: qdumpfs [options] <source> <dest>
@@ -20,106 +39,165 @@ Options
     -e, --exclude=PATTERN            exclude files/directories matching PATTERN
     -s, --exclude-by-size=SIZE       exclude files larger than SIZE
     -w, --exclude-by-glob=GLOB       exclude files matching GLOB
+    -x, --one-file-system            don't cross filesystem boundaries
     -c, --command=COMMAND            backup|sync|list|expire|verify|delete
     -l, --limit=HOURS                limit hours
     -k, --keep=KEEPARG               ex: --keep 100Y12M12W30D (100years, 12months, 12weeks, 30days, default)
 ```
 
-## 実行例
+## Examples
 
-### バックアップ
+### Backup
 
-バックアップを実行する場合。
+To perform a backup operation:
 
-「qdumpfs コピー元 コピー先」でバックアップを作成することができます。コピー先が存在する場合差分バックアップとなります。
+You can create a backup with `qdumpfs source destination`. If the destination exists, it becomes an incremental backup.
 
-```
+```bash
 qdumpfs /home/foo /backup
 ```
 
-"--command backup"オプションを明示することもできます。
+You can also explicitly specify the `--command backup` option:
 
-```
+```bash
 qdumpfs --command=backup /home/foo /backup
 ```
 
-### バックアップフォルダの同期
+### Backup Folder Synchronization
 
-バックアップフォルダを同期することもできます。バックアップディスクが手狭になり、新しいディスクに移行したい場合に便利です。
+You can also synchronize backup folders. This is useful when your backup disk becomes tight and you want to migrate to a new disk.
 
-"--command sync"オプションを指定することでバックアップフォルダを同期できます。
+You can synchronize backup folders by specifying the `--command sync` option:
 
-```
+```bash
 qdumpfs --command=sync /backup1 /backup2
 ```
 
-バックアップフォルダの同期には膨大な時間が必要な場合があるため、実行時間を制限できます。以下は例えば1時間に制限する場合です。
+Since synchronization of backup folders may require an enormous amount of time, you can limit the execution time. For example, to limit to 1 hour:
 
-実行時間が1時間を超えるとそこで処理が終了しますそこから次回継続することができます。
+When the execution time exceeds 1 hour, the process ends there and can be resumed from there next time.
 
-```
+```bash
 qdumpfs --command=sync --limit=1 /backup1 /backup2
 ```
 
-バックアップフォルダを間引きたい場合、"--keep="オプションを指定することができます。 "100Y12M12W30D"を指定すると、100年間は年に1つ、12ヶ月間は月に1つ、12週間は週に1つ、直近30日間のバックアップを保持します。
-条件に該当しないバックアップは同期されません。
+When you want to thin out backup folders, you can specify the `--keep=` option. Specifying "100Y12M12W30D" will keep one backup per year for 100 years, one per month for 12 months, one per week for 12 weeks, and all backups for the last 30 days. Backups that don't meet these conditions will not be synchronized.
 
-```
+```bash
 qdumpfs --command=sync --limit=1 --keep=5Y6M7W10D backup1 /backup2
 ```
 
-バックアップの同期は、コピー先の最新の日付より新しいコピー元を選択して実行されます。これはバックアップの同期が途中で中断された場合、再開することができるようにするためです。
-例えばコピー先に2024/11/01のバックアップが存在する場合、コピー元の2024/11/01より後のバックアップデータ(例えば2024/11/02)があれば、それが同期されます(同じ日付は同期されません)。
-
+To sync only the first backup of each year (e.g., for long-term archiving), set month, week, and day retention to 0:
 
+```bash
+qdumpfs --command=sync --keep=100Y0M0W0D /backup1 /backup2
 ```
 
+This keeps the first backup per year for the last 100 years, while skipping monthly, weekly, and daily backups. Only backups matching the `--keep` retention policy are selected for synchronization.
 
-### バックアップフォルダの削除
+Backup synchronization is performed by selecting source backups newer than the latest date in the destination. This allows backup synchronization to resume if interrupted midway.
 
-"--command expire"で、"--keep="パターンに該当しないバックアップを削除できます。
-```
+For example, if a backup from 2024/11/01 exists in the destination, and there is backup data after 2024/11/01 in the source (e.g., 2024/11/02), it will be synchronized (backups with the same date are not synchronized).
+
+### Backup Folder Deletion
+
+With `--command expire`, you can delete backups that don't match the `--keep=pattern`.
+
+```bash
 qdumpfs --command=expire --limit=1 --keep=5Y6M7W10D backup1 /backup2
 ```
 
+### Delete Specified Patterns from Backup Folders
 
-### バックアップフォルダから指定パターンを削除
+With `--command delete`, you can delete specified paths that exist in backups (useful for deleting content that was mistakenly backed up).
 
-"--command delete"で、バックアップに存在する指定したパスを削除できます(間違えてバックアップした内容を削除したい場合などに使用)。
-```
-qdumpfs --command=delete --delete-dir=backup1 --limit=1  r:/backup2
+```bash
+qdumpfs --command=delete --delete-dir=backup1 --limit=1 r:/backup2
 ```
 
-### バックアップの比較
+### Backup Comparison
 
-"--command verify"でバックアップを比較することができます。
+You can compare backups with `--command verify`:
 
-```
-qdumpfs  --command=verify j:/backup/2024/11/01 k:/backup/2024/11/01
+```bash
+qdumpfs --command=verify j:/backup/2024/11/01 k:/backup/2024/11/01
 ```
 
-### バックアップファイルの一覧
+### Backup File Listing
 
-"--command list"でバックアップファイルを一覧表示することができます。
+You can list backup files with `--command list`:
 
+```bash
+qdumpfs --command=list j:/backup/2024/11/01
 ```
-qdumpfs  --command=list j:/backup/2024/11/01 
+
+For example, if verify shows different results, you can diff the list results:
+
+```bash
+qdumpfs --command=list j:/backup/2024/11/01
+qdumpfs --command=list k:/backup/2024/11/01
+diff list_j__backup_2024_11_01.txt list_k__backup_2024_11_01.txt
 ```
 
-例えばverifyで異なる結果が表示された場合、listした結果をdiffすることができます。
+## How Backup Works
+
+Qdumpfs achieves efficient backup through the following mechanisms:
+
+### Directory Structure
 
 ```
-qdumpfs  --command=list j:/backup/2024/11/01 
-qdumpfs  --command=list k:/backup/2024/11/01 
-diff list_j__backup_2024_11_01.txt list_k__backup_2024_11_01.txt
+backup_destination/
+├── 2024/
+│   ├── 01/
+│   │   ├── 15/  # Backup from January 15, 2024
+│   │   └── 16/  # Backup from January 16, 2024
+│   └── 02/
+│       └── 01/  # Backup from February 1, 2024
+└── latest -> 2024/02/01  # Symbolic link to latest backup
 ```
 
+### Incremental Backup
 
+- **New files**: Full copy from source to destination
+- **Modified files**: Overwrite copy with latest content
+- **Unchanged files**: Create hard link from previous backup (saves space)
+- **Deleted files**: Not deleted from backup, preserved as history
 
+### Retention Policy
 
+The `--keep` option allows fine-grained control of backup retention periods:
 
-## License
+- `Y` (Years): Retention by year
+- `M` (Months): Retention by month
+- `W` (Weeks): Retention by week
+- `D` (Days): Retention by day
+
+Example: `--keep=5Y12M12W30D`
+- For 5 years: Keep one backup per year
+- For last 12 months: Keep one backup per month
+- For last 12 weeks: Keep one backup per week
+- For last 30 days: Keep all backups
 
-qdumpfs is a free software with ABSOLUTELY NO WARRANTY under the terms of the GNU General Public License version 2.
+## Development & Testing
 
+```bash
+# Run tests
+./test.sh
+
+# Run specific test file
+./test.sh test/qdumpfs_test.rb
+
+# Install dependencies
+bundle install
+
+# Build gem
+bundle exec rake build
+```
+
+## Contributing
+
+Bug reports and feature requests are welcome at [GitHub Issues](https://github.com/src256/qdumpfs/issues).
+
+## License
 
+qdumpfs is a free software with ABSOLUTELY NO WARRANTY under the terms of the GNU General Public License version 2.

data/README_ja.md

@@ -0,0 +1,210 @@
+# Qdumpfs
+
+**Language**: [English](README.md) | [日本語](#)
+
+Qdumpfsは、pdumpfsの個人的改良版として開発された効率的な差分バックアップツールです。
+
+pdumpfsをRuby Gemとして現代化し、最近のRubyバージョン（Ruby 3.2系対応）に対応しています。日付ベース（YYYY/MM/DD形式）のディレクトリ構造で差分バックアップを作成し、変更されたファイルのみをコピーして、未変更ファイルはハードリンクを利用することで、ストレージ効率を最大化します。
+
+## 特徴
+
+- **効率的な差分バックアップ**: 変更されたファイルのみをコピーし、未変更ファイルはハードリンクで容量を節約
+- **日付ベース管理**: YYYY/MM/DD形式のディレクトリ構造で整理されたバックアップ
+- **クロスプラットフォーム対応**: Windows/Unix/macOS環境での動作をサポート
+- **Ruby 3.2系対応**: 最新のRubyバージョンに対応（taint/untaintメソッド削除済み）
+- **豊富な除外オプション**: 正規表現、ファイルサイズ、Globパターンによる柔軟な除外設定
+- **バックアップ管理機能**: 同期、検証、削除、一覧表示など包括的な管理機能
+
+## インストール
+
+```bash
+gem install qdumpfs
+```
+
+## 動作環境
+
+- **Ruby**: 3.0以上（Ruby 3.2系対応済み）
+- **OS**: Windows、Linux、macOS
+- **依存関係**: 標準ライブラリのみ（追加のgemは不要）
+
+## 使用方法
+
+```
+Usage: qdumpfs [options] <source> <dest>
+    -h, --help                       show this message
+Options
+    -v, --verbose                    verbose message
+    -r, --report                     report message
+    -n, --dry-run                    don't actually run any commands
+    -e, --exclude=PATTERN            exclude files/directories matching PATTERN
+    -s, --exclude-by-size=SIZE       exclude files larger than SIZE
+    -w, --exclude-by-glob=GLOB       exclude files matching GLOB
+    -x, --one-file-system            don't cross filesystem boundaries
+    -c, --command=COMMAND            backup|sync|list|expire|verify|delete
+    -l, --limit=HOURS                limit hours
+    -k, --keep=KEEPARG               ex: --keep 100Y12M12W30D (100years, 12months, 12weeks, 30days, default)
+```
+
+## 実行例
+
+### バックアップ
+
+バックアップを実行する場合。
+
+`qdumpfs コピー元 コピー先`でバックアップを作成することができます。コピー先が存在する場合差分バックアップとなります。
+
+```
+qdumpfs /home/foo /backup
+```
+
+`--command backup`オプションを明示することもできます。
+
+```
+qdumpfs --command=backup /home/foo /backup
+```
+
+### バックアップフォルダの同期
+
+バックアップフォルダを同期することもできます。バックアップディスクが手狭になり、新しいディスクに移行したい場合に便利です。
+
+`--command sync`オプションを指定することでバックアップフォルダを同期できます。
+
+```
+qdumpfs --command=sync /backup1 /backup2
+```
+
+バックアップフォルダの同期には膨大な時間が必要な場合があるため、実行時間を制限できます。以下は例えば1時間に制限する場合です。
+
+実行時間が1時間を超えるとそこで処理が終了しますそこから次回継続することができます。
+
+```
+qdumpfs --command=sync --limit=1 /backup1 /backup2
+```
+
+バックアップフォルダを間引きたい場合、`--keep=`オプションを指定することができます。"100Y12M12W30D"を指定すると、100年間は年に1つ、12ヶ月間は月に1つ、12週間は週に1つ、直近30日間のバックアップを保持します。条件に該当しないバックアップは同期されません。
+
+```
+qdumpfs --command=sync --limit=1 --keep=5Y6M7W10D backup1 /backup2
+```
+
+各年の最初のバックアップのみを同期したい場合（長期アーカイブ用途など）、月・週・日の保持数を0に設定します：
+
+```
+qdumpfs --command=sync --keep=100Y0M0W0D /backup1 /backup2
+```
+
+この例では過去100年間の各年の最初のバックアップのみを保持し、月・週・日単位の保持は行いません。`--keep`の保持ポリシーに該当するバックアップのみが同期対象として選択されます。
+
+バックアップの同期は、コピー先の最新の日付より新しいコピー元を選択して実行されます。これはバックアップの同期が途中で中断された場合、再開することができるようにするためです。
+
+例えばコピー先に2024/11/01のバックアップが存在する場合、コピー元の2024/11/01より後のバックアップデータ(例えば2024/11/02)があれば、それが同期されます(同じ日付は同期されません)。
+
+
+
+
+### バックアップフォルダの削除
+
+`--command expire`で、`--keep=パターン`に該当しないバックアップを削除できます。
+
+
+```
+qdumpfs --command=expire --limit=1 --keep=5Y6M7W10D backup1 /backup2
+```
+
+### バックアップフォルダから指定パターンを削除
+
+`--command delete`で、バックアップに存在する指定したパスを削除できます(間違えてバックアップした内容を削除したい場合などに使用)。
+
+
+```
+qdumpfs --command=delete --delete-dir=backup1 --limit=1  r:/backup2
+```
+
+### バックアップの比較
+
+`--command verify`でバックアップを比較することができます。
+
+```
+qdumpfs  --command=verify j:/backup/2024/11/01 k:/backup/2024/11/01
+```
+
+### バックアップファイルの一覧
+
+`--command list`でバックアップファイルを一覧表示することができます。
+
+```
+qdumpfs  --command=list j:/backup/2024/11/01 
+```
+
+例えばverifyで異なる結果が表示された場合、listした結果をdiffすることができます。
+
+```
+qdumpfs  --command=list j:/backup/2024/11/01 
+qdumpfs  --command=list k:/backup/2024/11/01 
+diff list_j__backup_2024_11_01.txt list_k__backup_2024_11_01.txt
+```
+
+## バックアップの仕組み
+
+Qdumpfsは以下の仕組みで効率的なバックアップを実現しています：
+
+### ディレクトリ構造
+
+```
+バックアップ先/
+├── 2024/
+│   ├── 01/
+│   │   ├── 15/  # 2024年1月15日のバックアップ
+│   │   └── 16/  # 2024年1月16日のバックアップ
+│   └── 02/
+│       └── 01/  # 2024年2月1日のバックアップ
+└── latest -> 2024/02/01  # 最新バックアップへのシンボリックリンク
+```
+
+### 差分バックアップ
+
+- **新規ファイル**: コピー元からコピー先へ完全コピー
+- **変更されたファイル**: 最新の内容で上書きコピー
+- **未変更ファイル**: 前回のバックアップからハードリンクを作成（容量節約）
+- **削除されたファイル**: バックアップからは削除されず履歴として保持
+
+### 保持ポリシー
+
+`--keep`オプションでバックアップの保持期間を細かく制御できます：
+
+- `Y` (Years): 年単位での保持
+- `M` (Months): 月単位での保持  
+- `W` (Weeks): 週単位での保持
+- `D` (Days): 日単位での保持
+
+例: `--keep=5Y12M12W30D`
+- 5年間: 年に1つのバックアップを保持
+- 直近12ヶ月: 月に1つのバックアップを保持
+- 直近12週間: 週に1つのバックアップを保持
+- 直近30日間: 全てのバックアップを保持
+
+## 開発・テスト
+
+```bash
+# テスト実行
+./test.sh
+
+# 特定のテストファイル実行
+./test.sh test/qdumpfs_test.rb
+
+# 依存関係インストール
+bundle install
+
+# Gemビルド
+bundle exec rake build
+```
+
+## 貢献
+
+バグ報告や機能要望は[GitHub Issues](https://github.com/src256/qdumpfs/issues)まで。
+
+## License
+
+qdumpfs is a free software with ABSOLUTELY NO WARRANTY under the terms of the GNU General Public License version 2.
+
+

data/lib/qdumpfs/option.rb

@@ -116,22 +116,25 @@ module Qdumpfs
       @dst = dirs[1] if dirs.size > 1
       @cmd = @opts[:c] || 'backup'
       
-      #      @logger = NullLogger.new
-      if @opts[:logpath]
-        @logpath = @opts[:logpath]
-        @logdir = File.dirname(@logpath)
+      if @opts[:q]
+        @logger = NullLogger.new
       else
-        logname = @opts[:logname] || 'qdumpfs.log'
-        #ログディレクトリの作成
-        @logdir = @opts[:logdir] || Dir.pwd
-        @logpath = File.join(@logdir, logname)
+        if @opts[:logpath]
+          @logpath = @opts[:logpath]
+          @logdir = File.dirname(@logpath)
+        else
+          logname = @opts[:logname] || 'qdumpfs.log'
+          #ログディレクトリの作成
+          @logdir = @opts[:logdir] || Dir.pwd
+          @logpath = File.join(@logdir, logname)
+        end
+        Dir.mkdir(@logdir) unless FileTest.directory?(@logdir)
+        @logger = SimpleLogger.new(@logpath)
+
+        verifyfile = 'verify.txt'
+        @verifypath = File.join(@logdir, verifyfile)
       end
 
-      Dir.mkdir(@logdir) unless FileTest.directory?(@logdir)
-      @logger = SimpleLogger.new(@logpath)
-      
-      verifyfile = 'verify.txt'
-      @verifypath = File.join(@logdir, verifyfile)
 
       @matcher = NullMatcher.new
       
@@ -208,7 +211,7 @@ module Qdumpfs
     
     def log(msg, console = true)
       return if (msg.nil? || msg == '')
-      puts msg if console
+      puts msg if console && !@opts[:q]
       @logger.print(msg)
     end
     
@@ -219,6 +222,10 @@ module Qdumpfs
     def verbose
       @opts[:v]
     end
+
+    def one_file_system
+      @opts[:x]
+    end
     
     def limit_sec
       @limit.to_i * 3600

data/lib/qdumpfs/util.rb

@@ -67,21 +67,42 @@ end
 
 
 module QdumpfsFind
-  def find(logger, *paths)
-    block_given? or return enum_for(__method__, *paths)
-    paths.collect!{|d|
+  # one_file_system: trueの場合、起点と異なるファイルシステム(マウントポイント)には降りない
+  # falseの場合は降りるが、境界をまたいだことをnotifyで警告する
+  # notify: 境界に関するメッセージの出力先(省略時はloggerのみ)
+  def find(logger, *paths, one_file_system: false, notify: nil)
+    block_given? or return enum_for(__method__, *paths, one_file_system: one_file_system, notify: notify)
+    paths.each do |d|
       raise Errno::ENOENT unless File.exist?(d)
-      d.dup
-    }
-    while (file = paths.shift)
+    end
+    notify ||= lambda {|msg| logger.print(msg) }
+    # [パス, 親ディレクトリのデバイス番号]のキュー
+    queue = paths.map {|d| [d, File.stat(d).dev] }
+    while entry = queue.shift
+      file, dev = entry
       catch(:prune) do
-        yield file.dup.taint
+        # lstatに失敗した場合は判定せずyieldし、エラー処理は呼び出し側に任せる
+        s = File.lstat(file) rescue nil
+        if s && s.directory? && s.dev != dev
+          if one_file_system
+            # 別ファイルシステムは中身に一切触れずにスキップ
+            notify.call("skip other filesystem path=#{file}")
+            next
+          end
+          notify.call("warn: crossing filesystem boundary path=#{file} (use --one-file-system to skip)")
+          dev = s.dev
+        end
+
+        yield file.dup
+
+        # yield前に取得できていれば再利用し、lstatの回数を増やさない
         begin
-          s = File.lstat(file)
+          s ||= File.lstat(file)
         rescue => e
           logger.print("File.lstat path=#{file} error=#{e.message}")
           next
         end
+
         if s.directory?
           begin
             fs = Dir.entries(file, :encoding=>'UTF-8')
@@ -90,11 +111,11 @@ module QdumpfsFind
             next
           end
           fs.sort!
-          fs.reverse_each {|f|
+          fs.reverse_each do |f|
             next if f == "." or f == ".."
             f = File.join(file, f)
-            paths.unshift f.untaint
-          }
+            queue.unshift [f, dev]
+          end
         end
       end
     end

data/lib/qdumpfs/version.rb

@@ -1,4 +1,4 @@
 module Qdumpfs
-  VERSION = "1.10.0"
+  VERSION = "1.12.0"
 end  
   

data/lib/qdumpfs.rb

@@ -35,6 +35,7 @@ module Qdumpfs
       }
       opt.on('-s SIZE', '--exclude-by-size=SIZE', 'exclude files larger than SIZE') {|v| opts[:es] = v }
       opt.on('-w GLOB', '--exclude-by-glob=GLOB', 'exclude files matching GLOB') {|v| opts[:eg] = v }
+      opt.on('-x', '--one-file-system', "don't cross filesystem boundaries") {|v| opts[:x] = v }
       commands = ['backup', 'sync', 'list', 'expire', 'verify', 'delete']
       opt.on('-c COMMAND', '--command=COMMAND', commands, commands.join('|')) {|v| opts[:c] = v}
       opt.on('-l HOURS', '--limit=HOURS', 'limit hours') {|v| opts[:limit] = v}
@@ -55,6 +56,7 @@ module Qdumpfs
         opts[:backup_at] = Date.parse(v)
       }
       opt.on('-d', '--debug', 'debug mode') {|v| opts[:d] = v }
+      opt.on('-q', '--quiet', 'quiet mode') {|v| opts[:q] = v }
       opt.parse!(argv)
       option = Option.new(opts, argv)
       if opts[:v]
@@ -183,7 +185,7 @@ module Qdumpfs
       # latest: 最新のバックアップディレクトリ ex)j:/to/backup1/2019/05/09/home
       # today: 差分バックアップ先ディレクトリ ex)j:/to/backup1/2019/05/10/home
       dirs = {};
-      QdumpfsFind.find(@opt.logger, src) do |s|      # path of the source file
+      QdumpfsFind.find(@opt.logger, src, one_file_system: @opt.one_file_system, notify: method(:log)) do |s|      # path of the source file
         begin
           if @opt.matcher.exclude?(s)
             if File.lstat(s).directory? then Find.prune else next end
@@ -212,7 +214,7 @@ module Qdumpfs
 
     def recursive_copy(src, dst)
       dirs = {}
-      QdumpfsFind.find(@opt.logger, src) do |s|
+      QdumpfsFind.find(@opt.logger, src, one_file_system: @opt.one_file_system, notify: method(:log)) do |s|
         begin
           if @opt.matcher.exclude?(s)
             if File.lstat(s).directory? then Find.prune else next end
@@ -491,7 +493,7 @@ module Qdumpfs
       log("##### list start #{fmt(start_time)} #####")
       
       src = @opt.src
-      QdumpfsFind.find(@opt.logger, src) do |path|
+      QdumpfsFind.find(@opt.logger, src, one_file_system: @opt.one_file_system, notify: method(:log)) do |path|
         short_path = path.sub(/^#{src}/, '.')
         log("#{File.ftype(path)} #{path}")
         if FileTest.file?(path)

data/tag

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+
+def find_version
+  file = File.expand_path(File.dirname(__FILE__) + '/lib/qdumpfs/version.rb')
+  File.readlines(file).each do |line|
+    #  puts line
+    if line =~ /VERSION\s*=\s*['"]([^'"]+)['"]/
+      return $1
+    end
+  end
+  return nil
+end
+
+def run_cmd(cmd)
+  puts cmd
+  system(cmd)
+end
+
+version = find_version
+if version.nil?
+  puts "Version not found"
+  exit(1)
+end
+
+
+tagname = "v#{version}"
+cmd = "git tag #{tagname}"
+run_cmd(cmd)
+cmd = "git push origin #{tagname}"
+run_cmd(cmd)
+
+#

data/test.sh

@@ -0,0 +1,15 @@
+#!/bin/sh
+
+if [ "$1" = "" ]; then
+#  bundle exec rspec
+  bundle exec rake test
+else
+  # 以下のように実行  
+    # ./test.sh test/unit/checker_test.rb
+    #bundle exec rake test TEST=test/models/entry_test.rb TESTOPTS="--name=test_sample_2"    
+  bundle exec rake test "$1"       
+fi
+
+
+
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qdumpfs
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.12.0
 platform: ruby
 authors:
 - src
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-02 00:00:00.000000000 Z
+date: 2026-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -61,8 +61,10 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".DS_Store"
 - ".gitignore"
 - ".idea/.gitignore"
+- ".idea/copilot.data.migration.agent.xml"
 - ".idea/inspectionProfiles/Project_Default.xml"
 - ".idea/misc.xml"
 - ".idea/modules.xml"
@@ -70,11 +72,14 @@ files:
 - ".idea/vcs.xml"
 - ".travis.yml"
 - ".vscode/settings.json"
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
+- README.html
 - README.md
+- README_ja.md
 - Rakefile
 - TODO.txt
 - bin/console
@@ -85,6 +90,7 @@ files:
 - data/from/a/1.txt
 - exe/qdumpfs
 - exe/sample
+- lib/.DS_Store
 - lib/qdumpfs.rb
 - lib/qdumpfs/option.rb
 - lib/qdumpfs/util.rb
@@ -98,6 +104,10 @@ files:
 - run_qdumpfs.sh
 - run_sync.cmd
 - sample.sh
+- tag
+- test.sh
+- test_pdumpfs/.DS_Store
+- test_pdumpfs/data/.DS_Store
 - test_pdumpfs/data/bar
 - test_pdumpfs/data/baz/quux
 - test_pdumpfs/data/file
@@ -127,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: qdumpfs