dotsync 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 446e27ae6f0c5fdf0e7404ef6c3af8469099f31f052f2b20fe6fc2a9e1d473d1
-  data.tar.gz: 2d3f33174880e70147d73dea1eb61451bada64f368c3df41d7ac671b6f3759d2
+  metadata.gz: 0da622d8ef82d600401b7464c4ad28be7872fa942c252d00273378bcbdab2788
+  data.tar.gz: db97edbc75bb40ddd8353d97d2b3d255da9caa298dde368a58963e1f000bbc2d
 SHA512:
-  metadata.gz: d0d9f9ade95a25d75762cb8e4531aa5cc68d23d6ea199cf3f57968c59c369dae54e34bf9c0b8c0b34da8e403df9ea400f580af2c7903f5c8927e43fa77b38f55
-  data.tar.gz: 8a8ea902f8e1dd09c3c60895a9144761aa4e893e2411b5ee545088f011269fc9230e5ad5eb7d5a18c0438550adddfe979b9a93a534da6cac35c9ff58fcb61bfe
+  metadata.gz: f1f7fd2a2bb4d39df4c8a4286fb4ce750b55f5e3d4b0fb1a1bfa6a7902f5e6106919bb4dd1981057c583931fd4bf6534c64dc8161175caf38159bcb9dd5f93d5
+  data.tar.gz: a79078d32865500b76f5a27959bc426523a73ea31ec966aee7085b4786e024f9b7716dce1cb014323848228c64706618b91a9dfcd1a8ff5913817f165996c426

data/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [0.2.2] - 2025-02-07
+
+**New Features:**
+- Add glob pattern support to `only` filter (#15)
+  - `*` matches any sequence of characters (e.g., `local.*.plist`)
+  - `?` matches any single character (e.g., `config.?`)
+  - `[charset]` matches any character in the set (e.g., `log.[0-9]`)
+  - Glob and exact paths can be mixed in the same `only` array
+  - Non-glob entries retain existing exact path matching behavior
+
+**Documentation:**
+- Document glob pattern support in README with examples
+- Add "Glob patterns" to the `only` option important behaviors section
+
+**Testing:**
+- Add unit tests for glob matching in `include?`, `bidirectional_include?`, `skip?`, `should_prune_directory?`
+- Add integration tests for glob patterns in FileTransfer (including force mode)
+- Add integration tests for glob patterns in DirectoryDiffer
+- All 432 tests pass with 96.29% line coverage
+
 ## [0.2.1] - 2025-02-06
 
 **Performance Optimizations:**

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dotsync (0.2.1)
+    dotsync (0.2.2)
       fileutils (~> 1.7.3)
       find (~> 0.2.0)
       listen (~> 3.9.0)

data/README.md

@@ -401,11 +401,11 @@ ignore = ["lazy-lock.json"]
 
 ##### `only` Option
 
-An array of relative paths (files or directories) to selectively transfer from the source. This option provides precise control over which files get synchronized.
+An array of relative paths (files or directories) or glob patterns to selectively transfer from the source. This option provides precise control over which files get synchronized.
 
 **How it works:**
 - Paths are relative to the `src` directory
-- You can specify entire directories or individual files
+- You can specify entire directories, individual files, or glob patterns (`*`, `?`, `[charset]`)
 - Parent directories are automatically created as needed
 - Other files in the source are ignored
 - With `force = true`, only files matching the `only` filter are cleaned up in the destination
@@ -437,7 +437,27 @@ This transfers only specific configuration files from different subdirectories:
 
 The parent directories (`bundle/`, `ghc/`, `cabal/`) are created automatically in the destination, but other files in those directories are not transferred.
 
-**Example 4: Deeply nested paths**
+**Example 4: Glob patterns**
+```toml
+[[sync.home]]
+path = "Library/LaunchAgents"
+only = ["local.*.plist"]
+```
+This transfers only files matching the glob pattern — e.g., `local.brew.upgrade.plist`, `local.ollama.plist` — while ignoring system-generated plists like `com.apple.*.plist`.
+
+Supported glob characters:
+- `*` — matches any sequence of characters (e.g., `local.*.plist`)
+- `?` — matches any single character (e.g., `config.?`)
+- `[charset]` — matches any character in the set (e.g., `log.[0-9]`)
+
+Glob patterns can be mixed with exact paths in the same `only` array:
+```toml
+[[sync.home]]
+path = "Library/LaunchAgents"
+only = ["local.*.plist", "README.md"]
+```
+
+**Example 5: Deeply nested paths**
 ```toml
 [[sync.xdg_config]]
 only = ["nvim/lua/plugins/init.lua", "nvim/lua/config/settings.lua"]
@@ -447,7 +467,8 @@ This transfers only specific Lua files from deeply nested paths within the nvim
 **Important behaviors:**
 - **File-specific paths**: When specifying individual files (e.g., `"bundle/config"`), only that file is managed. Sibling files in the same directory are not affected, even with `force = true`.
 - **Directory paths**: When specifying directories (e.g., `"nvim"`), all contents of that directory are managed, including subdirectories.
-- **Combining with `force`**: With `force = true` and directory paths, files in the destination directory that don't exist in the source are removed. With file-specific paths, only that specific file is managed.
+- **Glob patterns**: When using patterns (e.g., `"local.*.plist"`), only files whose names match the pattern are managed. Non-matching files in the same directory are untouched.
+- **Combining with `force`**: With `force = true` and directory paths, files in the destination directory that don't exist in the source are removed. With file-specific paths or glob patterns, only matching files are managed.
 
 ##### `ignore` Option
 

data/lib/dotsync/models/mapping.rb

@@ -140,13 +140,13 @@ module Dotsync
     def include?(path)
       return true unless has_inclusions?
       return true if path == src
-      inclusions.any? { |inclusion| path_is_parent_or_same?(inclusion, path) }
+      inclusions.any? { |inclusion| inclusion_matches?(inclusion, path) }
     end
 
     def bidirectional_include?(path)
       return true unless has_inclusions?
       return true if path == src
-      inclusions.any? { |inclusion| path_is_parent_or_same?(inclusion, path) || path_is_parent_or_same?(path, inclusion) }
+      inclusions.any? { |inclusion| inclusion_matches?(inclusion, path) || inclusion_is_ancestor?(path, inclusion) }
     end
 
     def ignore?(path)
@@ -179,6 +179,26 @@ module Dotsync
     end
 
     private
+      def glob_pattern?(path)
+        path.match?(/[*?\[]/)
+      end
+
+      def inclusion_matches?(inclusion, path)
+        if glob_pattern?(inclusion)
+          File.fnmatch(inclusion, path)
+        else
+          path_is_parent_or_same?(inclusion, path)
+        end
+      end
+
+      def inclusion_is_ancestor?(path, inclusion)
+        if glob_pattern?(inclusion)
+          path_is_parent_or_same?(path, File.dirname(inclusion))
+        else
+          path_is_parent_or_same?(path, inclusion)
+        end
+      end
+
       def has_ignores?
         @original_ignores.any?
       end

data/lib/dotsync/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dotsync
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dotsync
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - David Sáenz