mfd 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c7b34e31f4606e0a0fa10a4f18d38762b33b38167f0bec54ef4aa5ea8243295
-  data.tar.gz: d0d5613a4a4b771de2d75fbe6e6c1149661b20b31a2b2398bbbcbfd63e0a4553
+  metadata.gz: bc99323cbbaf40588d62f0e6a64558f1fd8b440c655fbfc7bfded97da6b03264
+  data.tar.gz: 0b9c5b2023c48dff023c07e3474d0b2d6f997c2de61bcc63b02b7d91a9f3617f
 SHA512:
-  metadata.gz: d8ea175b49e34dabe032ddf79284d9b7390455fa7b527113d3cf0add59635a603718aa2fee59e5b23e3770f7fd4ea0affe1009d89e041cb88d981a31f43380b3
-  data.tar.gz: 54faaac4ca6d86143b4a11162e847de6251043f14d62f63b4487a7be4b1abdc2a53b9c1dd26497edf03730b17e56992317ad8d48b42c4a72654e93110c0b10f2
+  metadata.gz: 27e7b9975939f86b5f6588f48ebe2366449286439f638e655896a2b612c374db50e0e9c473501febb277709ed0be01d23795bb9b21c468018d483f50a1625af8
+  data.tar.gz: 4b3ca6a54d81e5ebb602522e2aa836bca9dd160660208b1dbf1d953c01e2ade068623fdad7b639514aae47d66708a924d4560e125d641d508ba0e1e3df6bbf0f

data/Gemfile.lock

@@ -1,45 +1,45 @@
 PATH
   remote: .
   specs:
-    mfd (0.1.0)
+    mfd (0.2.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    byebug (11.0.1)
-    coderay (1.1.2)
-    diff-lcs (1.3)
-    method_source (0.9.2)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    pry-byebug (3.7.0)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    diff-lcs (1.5.0)
+    method_source (1.0.0)
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.10.1)
       byebug (~> 11.0)
-      pry (~> 0.10)
-    rake (10.5.0)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.0)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.3)
+      pry (>= 0.13, < 0.15)
+    rake (13.4.2)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.1)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.5)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.17)
+  bundler (>= 1.17)
   mfd!
   pry-byebug (>= 3.6.0)
-  rake (~> 10.0)
-  rspec (~> 3.0)
+  rake (>= 13.2.0)
+  rspec (>= 3.0)
 
 BUNDLED WITH
-   2.4.12
+  4.0.18

data/README.md

@@ -59,26 +59,30 @@ options:
 
     -q, --query query                e.g. --query "关键字"
 
-    -c, --content-type contenttype   e.g. --contenttype com.omnigroup.omnigraffle.graffle
+    -c, --content-type [contenttype] e.g. --contenttype com.omnigroup.omnigraffle.graffle
                                            搜索 "kMDItemContentType" 属性等于指定值的文件，可以不
                                            指定完整的 Content Type，例如 Ruby 脚本的 Content Type
                                            为 "public.ruby-script"，但是可以使用下面的命令所有所有
                                            Ruby 脚本文件：mdfind4 -c ruby
+                                           搜索文件夹（目录）而非普通文件: -c public.folder  或  -c folder
+                                           也可从样例目录提取: -c @~/Documents
+                                           若不指定选项值（mfd -c），则列出搜索范围内所有
+                                           kMDItemContentType 取值，便于确认可用的 Content Type。
+                                           限定目录时请写成: mfd -c -- ~/Documents
 
     -e, --type file-ext-name         .e.g  -e 'mp3'
-                                           ContentType 字符串不便记忆，为了方便使用，本程序将常用的
-                                           文件类型的后缀名和 kMDItemKind 字符串建立关联，可以使用本选项
-                                           来指定要搜索的文件的后缀名, 可以使用"-l"选项查看所有支持的后
-                                           缀名以及关联
+                                            搜索文件扩展名等于指定值的文件
 
-    -l, --list-types                 kMDItemKind 字符串不便记忆，为了方便使用，本程序将常用的
-                                           文件类型的后缀名和 kMDItemKind 字符串建立关联，使用本选项
-                                           看所有支持的后缀名以及关联
-
-    -k, --kind kind                  e.g. --kind "HTML Document"
+    -k, --kind [kind]                e.g. --kind "HTML Document"
                                            "-k"选项是另外一个用来指定文件类型的选项，它使用
                                            "kMDItemKind"属性来搜索文件. 例如, 搜索邮件: "-k 邮件信息"
                                            搜索 Safari 历史记录: "-k 'Safari 历史记录项目'"
+                                           搜索文件夹（目录）: -k 文件夹  （英文系统下为 -k Folder）
+                                           也可从样例目录提取: -k @~/Documents
+                                           若不指定选项值（mfd -k 或 mfd -l），则列出内置 KIND_MAP
+                                           （扩展名及其对应的 kMDItemKind），不扫描磁盘。
+
+    -l, --list-kinds                 列出内置 KIND_MAP（扩展名 → kMDItemKind），等价于不带选项值的 -k
 
     -b, --bigger-than size           e.g. --bigger-than 100000
                                            搜索文件大小大于或等于给定值的文件，可以使用 t, g, m, k 等单位,
@@ -108,6 +112,7 @@ options:
 
     -d, --downloadfrom url           搜索从URL下载的文件
     -n, --name name                  按文件名称搜索, 自动支持模糊匹配, 无需指定通配符
+    -N, --name-exact name            按文件名称精确匹配（区分大小写，需包含扩展名）
     -0, --null                       Prints an ASCII NUL character after each result path.
                                            This is useful when used in conjunction with
                                            xargs -0.

data/lib/mfd/cli.rb

@@ -4,12 +4,16 @@ require 'mfd/asset'
 module Mfd
   class Cli
 
+    NOW = Time.now
+
     def initialize
       @predicates = ['(true)']
       @print_command = false
       @ascii_null = false
       @live = false
       @count = false
+      @list_kinds = false
+      @list_content_types = false
 
       @opt = OptionParser.new
       declare_options!
@@ -23,6 +27,11 @@ module Mfd
 
       @opt.parse!(args)
 
+      if @list_kinds
+        print_kind_map
+        return unless @list_content_types
+      end
+
       if args.size == 1
         dir = args.first
         dir = File.expand_path dir unless dir =~ /^\//
@@ -33,6 +42,11 @@ module Mfd
 
       query_string = @predicates.join(' && ')
 
+      if @list_content_types
+        list_content_types(scope, query_string)
+        return
+      end
+
       cmd = "mdfind #{scope} \
   #{@ascii_null ? '-0' : ''} \
   #{@live ? '-live' : ''} \
@@ -113,21 +127,27 @@ module Mfd
         @predicates << 'kMDItemTextContent == "%s"cdw' % escape(query)
       end
 
-      @opt.on('-c contenttype', '--content-type contenttype', "e.g. --contenttype com.omnigroup.omnigraffle.graffle
+      @opt.on('-c [contenttype]', '--content-type [contenttype]', "e.g. --contenttype com.omnigroup.omnigraffle.graffle
         #{' ' * 35}搜索 \"kMDItemContentType\" 属性等于指定值的文件，可以不
         #{' ' * 35}指定完整的 Content Type，例如 Ruby 脚本的 Content Type
         #{' ' * 35}为 \"public.ruby-script\"，但是可以使用下面的命令所有所有
         #{' ' * 35}Ruby 脚本文件：mdfind4 -c ruby
+        #{' ' * 35}搜索文件夹（目录）而非普通文件: -c public.folder  或  -c folder
+        #{' ' * 35}也可从样例目录提取: -c @~/Documents
+        #{' ' * 35}若不指定选项值（mfd -c），则列出搜索范围内所有
+        #{' ' * 35}kMDItemContentType 取值，便于确认可用的 Content Type。
+        #{' ' * 35}限定目录时请写成: mfd -c -- ~/Documents
         ") do |contenttype|
-        @predicates << 'kMDItemContentType == "%s"cdw' % (contenttype.start_with?('@') ?
-          prop_value_from_file(contenttype, 'kMDItemContentType') : escape(contenttype))
+        if contenttype.nil?
+          @list_content_types = true
+        else
+          @predicates << 'kMDItemContentType == "%s"cdw' % (contenttype.start_with?('@') ?
+            prop_value_from_file(contenttype, 'kMDItemContentType') : escape(contenttype))
+        end
       end
 
       @opt.on('-e file-ext-name', '--type file-ext-name', ".e.g  -e 'mp3'
-        #{' ' * 35}ContentType 字符串不便记忆，为了方便使用，本程序将常用的
-        #{' ' * 35}文件类型的后缀名和 kMDItemKind 字符串建立关联，可以使用本选项
-        #{' ' * 35}来指定要搜索的文件的后缀名, 可以使用\"-l\"选项查看所有支持的后
-        #{' ' * 35}缀名以及关联
+        #{' ' * 35}搜索文件扩展名等于指定值的文件
         ") do |type|
         if Mfd::Asset::KIND_MAP[type]
           @predicates << '(kMDItemFSName == "*.%s" || kMDItemKind == "%s"cdw)' % [type, escape(Mfd::Asset::KIND_MAP[type])]
@@ -136,13 +156,26 @@ module Mfd
         end
       end
 
-      @opt.on('-k kind', '--kind kind', "e.g. --kind \"HTML Document\"
+      @opt.on('-k [kind]', '--kind [kind]', "e.g. --kind \"HTML Document\"
         #{' ' * 35}\"-k\"选项是另外一个用来指定文件类型的选项，它使用
         #{' ' * 35}\"kMDItemKind\"属性来搜索文件. 例如, 搜索邮件: \"-k 邮件信息\"
         #{' ' * 35}搜索 Safari 历史记录: \"-k 'Safari 历史记录项目'\"
+        #{' ' * 35}搜索文件夹（目录）: -k 文件夹  （英文系统下为 -k Folder）
+        #{' ' * 35}也可从样例目录提取: -k @~/Documents
+        #{' ' * 35}若不指定选项值（mfd -k 或 mfd -l），则列出内置 KIND_MAP
+        #{' ' * 35}（扩展名及其对应的 kMDItemKind），不扫描磁盘。
         ") do |kind|
-        @predicates << 'kMDItemKind == "*%s*"cdw' % (kind.start_with?('@') ?
-          prop_value_from_file(kind, 'kMDItemKind') : escape(kind))
+        if kind.nil?
+          @list_kinds = true
+        else
+          @predicates << 'kMDItemKind == "*%s*"cdw' % (kind.start_with?('@') ?
+            prop_value_from_file(kind, 'kMDItemKind') : escape(kind))
+        end
+      end
+
+      @opt.on('-l', '--list-kinds', "列出内置 KIND_MAP（扩展名 → kMDItemKind），等价于不带选项值的 -k
+        ") do
+        @list_kinds = true
       end
 
       @opt.on('-b size', '--bigger-than size', "e.g. --bigger-than 100000
@@ -207,6 +240,10 @@ module Mfd
         @predicates << 'kMDItemFSName == "%s"cdw' % escape(name)
       end
 
+      @opt.on('-N name', '--name-exact name', '按文件名称精确匹配（区分大小写，需包含扩展名）') do |name|
+        @predicates << 'kMDItemFSName == "%s"' % escape_literal(name)
+      end
+
       @opt.on('-0', '--null', "Prints an ASCII NUL character after each result path.
         #{' ' * 35}This is useful when used in conjunction with
         #{' ' * 35}xargs -0.") do
@@ -240,6 +277,77 @@ module Mfd
       str.gsub(/"/, '\\"')
     end
 
+    def escape_literal(str)
+      str.gsub(/[\\*?"]/) { |char| '\\' + char }
+    end
+
+    def print_kind_map
+      width = Mfd::Asset::KIND_MAP.keys.map(&:size).max
+      Mfd::Asset::KIND_MAP.sort.each do |ext, kind|
+        printf "%-*s  %s\n", width, ext, kind
+      end
+    end
+
+    def list_content_types(scope, query_string)
+      if scope.empty?
+        $stderr.puts '未指定搜索目录，将遍历整个 Spotlight 索引（可能非常慢）。建议加上目录，例如: mfd -c -- ~/Documents'
+      end
+
+      emit_unique_md_values('kMDItemContentType', scope, query_string)
+    end
+
+    def emit_unique_md_values(attr, scope, query_string)
+      unique = {}
+      batch = []
+
+      flush = lambda do
+        unless batch.empty?
+          md_values_for_paths(attr, batch).each do |value|
+            next if value.empty? || unique[value]
+            unique[value] = true
+            puts value
+            $stdout.flush
+          end
+          batch.clear
+        end
+      end
+
+      each_mdfind_path(scope, query_string) do |path|
+        next unless usable_fs_path?(path)
+        batch << path
+        flush.call if batch.size >= 100
+      end
+      flush.call
+    end
+
+    def md_values_for_paths(attr, paths)
+      IO.popen(['mdls', '-name', attr, '-raw', '-nullMarker', '', *paths], 'r', err: File::NULL) do |io|
+        io.read.split("\0")
+      end
+    end
+
+    def usable_fs_path?(path)
+      path.start_with?('/') && File.exist?(path)
+    end
+
+    def each_mdfind_path(scope, query_string)
+      cmd = "mdfind #{scope} -literal -0 '#{query_string}'"
+      puts cmd if @print_command
+
+      IO.popen(cmd, 'r') do |io|
+        buf = ''
+        while (chunk = io.read(65_536))
+          buf << chunk
+          while (idx = buf.index("\0"))
+            path = buf.slice!(0, idx)
+            buf.slice!(0)
+            yield path unless path.empty?
+          end
+        end
+        yield buf unless buf.empty?
+      end
+    end
+
     def calculate_size(size_str)
       case size_str
       when /(\d+)t$/i

data/lib/mfd/version.rb

@@ -1,3 +1,3 @@
 module Mfd
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

data/mfd.gemspec

@@ -24,8 +24,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.17"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "bundler", ">= 1.17"
+  spec.add_development_dependency "rake", ">= 13.2.0"
+  spec.add_development_dependency "rspec", ">= 3.0"
   spec.add_development_dependency "pry-byebug", ">= 3.6.0"
 end

metadata

@@ -1,55 +1,54 @@
 --- !ruby/object:Gem::Specification
 name: mfd
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Liu Xiang
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-04-18 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.17'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.17'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 13.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 13.2.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
@@ -95,7 +94,6 @@ homepage: https://github.com/lululau/mfd
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -110,8 +108,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: ''
 test_files: []