monq 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '049e17df27a39b7710e1793ad8aa2bbceea1cac5781c952c604f05569e0c5e3a'
-  data.tar.gz: 2d1b3d71bfbf2f666116004d75cc96963576d10570926788672a8943774a814a
+  metadata.gz: 549e91e0850eef71c43ad692ffb4ad92c6c5bbb4b43a7d834bf2ee690a3384f4
+  data.tar.gz: 5e2c84dacf04271206add867dd75df819d2bc5ccfc37d429e991ad271e3f3487
 SHA512:
-  metadata.gz: b40814534a5516dd367c70a706500df2b3ca91a5313eb1544c94ddc05204e247ddc33ff54b8934731f748454dc149b4dacb924894eaf073e90684e49a9c5f86f
-  data.tar.gz: 7260f9a2eeb283c07a7bd4e19755897afbc44a4267896b1b58518256749bb0ffe5dd2479296cd20eef38e67b610f3304946fed4ddccb4cf7e96e7467e22721bb
+  metadata.gz: d762f5a51e8a52f47c2deb2ef4ef1d5f6b09d41f492f1c483aa8b73574fcf436603fa694ff68b791717c491a9a19689dd14cb288ca2f966aed714e23ea742464
+  data.tar.gz: f0dcabaa63dcdc853594b30312ae091e35a84af2c980a47840f2801882f266f04462b79b9c4fe31e22a47d813f9d2275b8d2e5404e7f37f12afd88f506583a11

data/AGENTS.md

@@ -0,0 +1,55 @@
+# AGENTS.md
+
+monq 是发布到 RubyGems（<https://rubygems.org>）的 Ruby gem，用 Bundler 管理。
+
+## 版本号
+
+唯一来源是 `lib/monq/version.rb` 中的 `Monq::VERSION`，`monq.gemspec` 从这里读取。
+不要在 gemspec 里写死版本号。
+
+## 升级版本号：`gem bump`
+
+`gem bump` 由 [gem-release](https://github.com/svenfuchs/gem-release) 提供：
+
+```bash
+gem bump                  # 默认升 patch：0.1.0 -> 0.1.1
+gem bump --version minor  # 升 minor：0.1.0 -> 0.2.0
+gem bump --version major  # 升 major：0.1.0 -> 1.0.0
+```
+
+注意：
+
+- 本机的 gem-release（2.2.x）中，`gem bump` **默认会自动创建 commit**
+  （提交消息为 `Bump monq to x.y.z`，仅含 `version.rb`），可用 `--no-commit` 关闭。
+- `Gemfile.lock` 里固定了 monq 自身版本，bump 后会过期。
+  运行一次 `bundle install`（或任意 `bundle exec` 命令）即可自动刷新，
+  之后把 `Gemfile.lock` 单独提交。
+
+## 发布到 RubyGems：`rake release`
+
+```bash
+rake release
+```
+
+`rake release` 由 Rakefile 中的 `bundler/gem_tasks` 提供，它会依次：
+
+1. 构建 gem 到 `pkg/monq-<version>.gem`；
+2. 创建 `v<version>` 标签（如 `v0.1.1`）并 push 到 git origin；
+3. 执行 `gem push` 把 `.gem` 推送到 <https://rubygems.org>。
+
+前置条件：
+
+- 工作区必须干净——包括 `gem bump` 的改动在内的所有变更都要先 commit，
+  否则 release 会中止；
+- 本机已配置 rubygems.org 的 `gem push` 凭据；
+- RubyGems 不允许重复推送同一版本号，重发前必须先 bump。
+
+## 完整流程示例
+
+```bash
+bundle exec rspec        # 发布前先跑测试
+gem bump                 # 升 patch 版本并自动提交 version.rb
+bundle install           # 刷新 Gemfile.lock 中 monq 自身版本
+git add Gemfile.lock && git commit -m "chore: update Gemfile.lock"
+rake release             # 构建、打 tag、推送到 RubyGems
+```

data/lib/monq/ext/array.rb

@@ -1,18 +1,18 @@
 # frozen_string_literal: true
 
 class Array
-  def t
-    puts Monq::Ext.table_for(hash_docs)
+  def t(*attrs, **options)
+    puts Monq::Ext.table_for(Monq::Ext.filter_docs(hash_docs, attrs, options))
     nil
   end
 
-  def v
-    Monq::Ext.vertical(hash_docs)
+  def v(*attrs, **options)
+    Monq::Ext.vertical(Monq::Ext.filter_docs(hash_docs, attrs, options))
   end
 
   # visidata comes later; always print the table so vd works without the binary.
-  def vd
-    t
+  def vd(*attrs, **options)
+    t(*attrs, **options)
   end
 
   def write_csv(filename)
@@ -22,7 +22,7 @@ class Array
       csv = CSV.new(file)
       return if docs.empty?
 
-      keys = docs.first.keys
+      keys = Monq::Presenter.column_names(docs)
       csv << keys.map(&:to_s)
       docs.each { |row| csv << keys.map { |k| row[k].to_s } }
     end
@@ -35,7 +35,7 @@ class Array
     package.workbook.add_worksheet(name: sheet_name) do |sheet|
       next if docs.empty?
 
-      keys = docs.first.keys
+      keys = Monq::Presenter.column_names(docs)
       sheet.add_row(keys.map(&:to_s))
       docs.each { |row| sheet.add_row(keys.map { |k| row[k].to_s }) }
     end

data/lib/monq/ext/criteria.rb

@@ -3,17 +3,17 @@
 module Monq
   module Ext
     module Criteria
-      def t
-        Monq::Ext.display_criteria(self)
+      def t(*attrs, **options)
+        Monq::Ext.display_criteria(self, attrs, options)
       end
 
-      def v
+      def v(*attrs, **options)
         docs, = Monq::Ext.materialize(self)
-        docs.v
+        docs.v(*attrs, **options)
       end
 
-      def vd
-        t
+      def vd(*attrs, **options)
+        t(*attrs, **options)
       end
 
       # Full result set. Display methods cap at 500; export must not.

data/lib/monq/ext/document.rb

@@ -3,16 +3,16 @@
 module Monq
   module Ext
     module Document
-      def t
-        [attributes].t
+      def t(*attrs, **options)
+        [attributes].t(*attrs, **options)
       end
 
-      def v
-        [attributes].v
+      def v(*attrs, **options)
+        [attributes].v(*attrs, **options)
       end
 
-      def vd
-        [attributes].vd
+      def vd(*attrs, **options)
+        [attributes].vd(*attrs, **options)
       end
 
       def write_csv(filename)

data/lib/monq/ext/view.rb

@@ -3,16 +3,16 @@
 module Monq
   module Ext
     module View
-      def t
-        materialized_docs.t
+      def t(*attrs, **options)
+        materialized_docs.t(*attrs, **options)
       end
 
-      def v
-        materialized_docs.v
+      def v(*attrs, **options)
+        materialized_docs.v(*attrs, **options)
       end
 
-      def vd
-        materialized_docs.vd
+      def vd(*attrs, **options)
+        materialized_docs.vd(*attrs, **options)
       end
 
       # Full result set. Display methods cap at 500; export must not.

data/lib/monq/ext.rb

@@ -10,9 +10,9 @@ module Monq
       [criteria.to_a, capped]
     end
 
-    def self.display_criteria(criteria)
+    def self.display_criteria(criteria, attrs = [], options = {})
       docs, capped = materialize(criteria)
-      puts table_for(docs)
+      puts table_for(filter_docs(docs, attrs, options))
       puts "showing #{docs.size} rows (capped at #{CAP})" if capped
       nil
     end
@@ -33,6 +33,30 @@ module Monq
       [keys, nil, *rows[1..]]
     end
 
+    def self.filter_docs(docs, attrs = [], options = {})
+      return docs if docs.empty?
+
+      column_names = Presenter.column_names(docs)
+      unless docs.first.is_a?(Hash) || !docs.first.respond_to?(:attributes)
+        docs = docs.map(&:attributes)
+      end
+      return docs if attrs.empty? && !options[:except]
+
+      selected = attrs.flat_map { |e| e.is_a?(Regexp) ? column_names.grep(e) : e }.uniq
+
+      if options[:except]
+        selected = column_names if selected.empty?
+        except = options[:except]
+        if except.is_a?(Regexp)
+          selected.reject! { |e| e =~ except }
+        else
+          selected -= [except].flatten
+        end
+      end
+
+      docs.map { |doc| doc.slice(*selected) }
+    end
+
     def self.limit_unset?(options)
       return true if options.nil?
 

data/lib/monq/presenter.rb

@@ -28,11 +28,19 @@ module Monq
     def rows(docs)
       return [] if docs.nil? || docs.empty?
 
-      keys = docs.first.keys
+      docs = docs.map { |doc| doc.is_a?(Hash) || !doc.respond_to?(:attributes) ? doc : doc.attributes }
+      keys = column_names(docs)
       body = docs.map { |doc| keys.map { |key| scalar(doc[key]) } }
       [keys, *body]
     end
 
+    # Union of keys across all docs: Mongoid documents only carry the fields
+    # actually stored on each one, so any single doc (e.g. the oldest row in a
+    # natural-order cursor) can miss fields present in the rest.
+    def column_names(docs)
+      docs.flat_map { |doc| doc.is_a?(Hash) || !doc.respond_to?(:attributes) ? doc.keys : doc.attributes.keys }.uniq
+    end
+
     def as_json_tree(value)
       case value
       when BSON::ObjectId, BSON::Decimal128

data/lib/monq/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Monq
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: monq
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Liu Xiang
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-25 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mongoid
@@ -24,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -130,6 +143,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- AGENTS.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
@@ -171,7 +185,6 @@ metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/lululau/monq
   source_code_uri: https://github.com/lululau/monq
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -186,8 +199,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: Mongoid + Pry MongoDB query workbench
 test_files: []