mfd 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8965ee1090d0d44e11e41a7ff131010878ec484968eba9ca432489ffba3e5efe
-  data.tar.gz: c17bedc8637b53817675c0d66596bbbe67560eb8ec7aa6f5db054fe8a4ac5851
+  metadata.gz: bc99323cbbaf40588d62f0e6a64558f1fd8b440c655fbfc7bfded97da6b03264
+  data.tar.gz: 0b9c5b2023c48dff023c07e3474d0b2d6f997c2de61bcc63b02b7d91a9f3617f
 SHA512:
-  metadata.gz: 41ab4396391573e3f6e4d322f80a66ea85232fca850671c096fa364a7d4863b0ef844c6442775b33ca7cfc652d92f59d1eed8c912fd156792b58fd4361d39f69
-  data.tar.gz: 5d69482c8bd7cabda89bc24551b2f1318a9b359b9115a7d62dc67925082ecd246ff7355682074b86b2c70c20f76d934ef9d0b2cc31f1985b58c15d13dd2b3630
+  metadata.gz: 27e7b9975939f86b5f6588f48ebe2366449286439f638e655896a2b612c374db50e0e9c473501febb277709ed0be01d23795bb9b21c468018d483f50a1625af8
+  data.tar.gz: 4b3ca6a54d81e5ebb602522e2aa836bca9dd160660208b1dbf1d953c01e2ade068623fdad7b639514aae47d66708a924d4560e125d641d508ba0e1e3df6bbf0f

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mfd (0.2.1)
+    mfd (0.2.2)
 
 GEM
   remote: https://rubygems.org/
@@ -16,7 +16,7 @@ GEM
     pry-byebug (3.10.1)
       byebug (~> 11.0)
       pry (>= 0.13, < 0.15)
-    rake (13.0.6)
+    rake (13.4.2)
     rspec (3.12.0)
       rspec-core (~> 3.12.0)
       rspec-expectations (~> 3.12.0)
@@ -38,8 +38,8 @@ DEPENDENCIES
   bundler (>= 1.17)
   mfd!
   pry-byebug (>= 3.6.0)
-  rake (>= 10.0)
+  rake (>= 13.2.0)
   rspec (>= 3.0)
 
 BUNDLED WITH
-   2.4.12
+  4.0.18

data/README.md

@@ -59,19 +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'
                                             搜索文件扩展名等于指定值的文件
 
-    -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 等单位,
@@ -101,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

@@ -12,6 +12,8 @@ module Mfd
       @ascii_null = false
       @live = false
       @count = false
+      @list_kinds = false
+      @list_content_types = false
 
       @opt = OptionParser.new
       declare_options!
@@ -25,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 =~ /^\//
@@ -35,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' : ''} \
@@ -115,14 +127,23 @@ 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'
@@ -135,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
@@ -206,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
@@ -239,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.1"
+  VERSION = "0.2.2"
 end

data/mfd.gemspec

@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_development_dependency "bundler", ">= 1.17"
-  spec.add_development_dependency "rake", ">= 10.0"
+  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,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: mfd
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  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
@@ -30,14 +29,14 @@ dependencies:
     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
@@ -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: []