wikiwiki 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c94061d746d2242a2a78e735c43fa5fba37888231ba3a92e959aeafa5afaec3a
-  data.tar.gz: c9c3f4c74090aa044e10e48b72b03ad2a7b1b58713fec6e0447a871439153c05
+  metadata.gz: 9cd510fe9ee02e6521a325c51ed5e586a41a904ea0758fc78b16ad66159c40d9
+  data.tar.gz: e3e57832169db7d9644cdcbd2d8c3495576e8ff221338f107b99cb7fde161991
 SHA512:
-  metadata.gz: 9bae7372d114df3f32f4f60d3ae1b4664ff3581c30ba0215e5d705de733063b2d12faaa92c557439f29b1e9b9707e9c3993400e738b672125365b7be24d401c1
-  data.tar.gz: f6e397e07040ba97328609f437a30a29be059c2df7c7051d78def34c204f6d5bf6005e618014893ffddcb36e20cc41db414eb1187435776a60217b2177c960ee
+  metadata.gz: d3e67b565e5d9414a111dea276ea16f23bffe307c5c02b9de97062ce24a2e926304929bf975d5144cc359190680748cf224aae6f0819c96a21924b076152ca99
+  data.tar.gz: 3bfa6e34164386c86b19912170bb450da3dd50b2e610e8d722a3568d433d2877185fec64011cc7f68e283c4f1523286311e832b4c64ffa2102473b37083d2243

data/CHANGELOG.md

@@ -1,5 +1,41 @@
 ## [Unreleased]
 
+## [0.7.0] - 2025-11-03
+
+### Added
+
+- Page deletion support
+  - `Wiki#delete_page` method to delete pages
+  - `wikiwiki page delete` command in CLI
+  - Validation in `Wiki#update_page` and `wikiwiki page put` to prevent accidental deletion with empty content
+- `ConflictError` exception class for HTTP 409 Conflict responses
+
+### Changed
+
+- `attachment put --force` behavior: attempts upload first, then deletes and retries on conflict (409 error)
+  - Previously: checked existence first, then deleted and uploaded
+  - Now: optimistic upload pattern eliminates Time-of-Check-Time-of-Use (TOCTOU) race conditions
+
+## [0.6.0] - 2025-11-02
+
+### Added
+
+- Pre-obtained token reuse support
+  - `Auth.token(token:)` for authentication with pre-obtained JWT tokens
+  - `wikiwiki auth` command to obtain authentication tokens
+  - `Wiki#token` method to retrieve the current authentication token
+  - `--token` option and `WIKIWIKI_TOKEN` environment variable support for all commands
+  - JWT token expiration validation with AuthenticationError for expired tokens
+- Command-line interface (`wikiwiki` command) for all API operations
+  - Page commands: `list`, `show`, `get`, `put`
+  - Attachment commands: `list`, `show`, `get`, `put`, `delete`
+  - Authentication command: `auth`
+  - Environment variable support for credentials (WIKIWIKI_WIKI_ID, WIKIWIKI_TOKEN, WIKIWIKI_PASSWORD, WIKIWIKI_API_KEY_ID, WIKIWIKI_SECRET)
+  - JSON output option (`--json`) for automation
+  - Verbose (`--verbose`) and debug (`--debug`) modes
+  - File overwrite protection with `--force` flag
+  - Attachment size limit validation (512 KiB) for uploads
+
 ## [0.5.0] - 2025-10-31
 
 ### Added

data/README.ja.md

@@ -2,11 +2,11 @@
 
 {file:README.md English version}
 
-[Wikiwiki](https://wikiwiki.jp/) REST API用のRubyクライアントライブラリです。
+[Wikiwiki](https://wikiwiki.jp/) REST API用のRubyクライアントライブラリおよびコマンドラインツールです。
 
 ## 概要
 
-このgemは、Wikiwikiのwikiをプログラムから操作するためのシンプルなインターフェースを提供します。ページ操作（一覧取得、読み取り、書き込み）と添付ファイル管理（一覧取得、アップロード、ダウンロード、削除）をサポートしています。
+このgemは、Wikiwikiのwikiを操作するためのRubyライブラリとCLIツールの両方を提供します。
 
 ## インストール
 
@@ -44,9 +44,95 @@ auth = Wikiwiki::Auth.password(password: "your_admin_password")
 auth = Wikiwiki::Auth.api_key(api_key_id: "your_api_key_id", secret: "your_secret")
 ```
 
+### トークン認証
+
+事前に認証して得られたJWTトークンは、有効期限以内なら再利用できます：
+
+```ruby
+auth = Wikiwiki::Auth.token(token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...")
+```
+
 ## 使い方
 
-### 基本的な使用例
+### コマンドラインインターフェース
+
+`wikiwiki`コマンドで、すべてのAPI操作にアクセスできます：
+
+```bash
+# 環境変数で認証情報を設定（オプション）
+export WIKIWIKI_WIKI_ID=your-wiki-id
+export WIKIWIKI_PASSWORD=your-password
+# または
+export WIKIWIKI_API_KEY_ID=your-api-key-id
+export WIKIWIKI_SECRET=your-secret
+# または事前に取得したトークンを使用
+export WIKIWIKI_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+
+# 後で使用するためにトークンを取得
+wikiwiki auth --wiki-id=your-wiki-id --password=your-password
+# またはexportと組み合わせて使用
+export WIKIWIKI_TOKEN=$(wikiwiki auth --wiki-id=your-wiki-id --password=your-password)
+
+# ページ一覧
+wikiwiki page list
+
+# ページのメタデータ表示
+wikiwiki page show FrontPage
+
+# ページのコンテンツをダウンロード
+wikiwiki page get FrontPage
+wikiwiki page get FrontPage frontpage.txt
+
+# ページをアップロード/更新（標準入力またはファイルから）
+wikiwiki page put TestPage < content.txt
+wikiwiki page put TestPage content.txt
+
+# ページを削除
+wikiwiki page delete TestPage
+
+# 添付ファイル一覧
+wikiwiki attachment list FrontPage
+
+# 添付ファイルのメタデータ表示
+wikiwiki attachment show FrontPage logo.png
+
+# 添付ファイルをダウンロード
+wikiwiki attachment get FrontPage logo.png
+wikiwiki attachment get FrontPage logo.png --directory downloads/
+
+# 添付ファイルをアップロード（最大512 KiB）
+wikiwiki attachment put FrontPage image.png
+wikiwiki attachment put FrontPage local.png --name remote.png
+
+# 添付ファイルを削除
+wikiwiki attachment delete FrontPage logo.png
+
+# 既存のファイル/添付ファイルを上書きするには --force を使用
+wikiwiki page get FrontPage existing.txt --force
+wikiwiki attachment put FrontPage logo.png --force
+
+# 注意: --force による添付ファイルの上書きはアトミックではありません。
+# まずアップロードを試み、競合エラー（ファイルが既に存在）が発生した場合、
+# 既存ファイルを削除してアップロードをリトライします。
+# リトライに失敗した場合、添付ファイルは失われます。
+
+# コマンドラインで認証情報を指定（環境変数より優先）
+wikiwiki --wiki-id=your-wiki-id --password=your-password page list
+wikiwiki --wiki-id=your-wiki-id --api-key-id=id --secret=secret page list
+wikiwiki --wiki-id=your-wiki-id --token=eyJ... page list
+
+# 自動化のためのJSON出力
+wikiwiki page list --json
+wikiwiki attachment show FrontPage logo.png --json
+
+# 詳細モードとデバッグモード
+wikiwiki page list --verbose
+wikiwiki page list --debug
+```
+
+### Rubyライブラリ
+
+ライブラリを使用する基本的な例：
 
 ```ruby
 require "wikiwiki"
@@ -55,6 +141,14 @@ require "wikiwiki"
 auth = Wikiwiki::Auth.password(password: "admin_password")
 wiki = Wikiwiki::Wiki.new(wiki_id: "your-wiki-id", auth:)
 
+# 認証トークンを取得して再利用
+token = wiki.token
+# トークンを保存して後で使用...
+
+# 後で保存したトークンを使用
+auth = Wikiwiki::Auth.token(token: token)
+wiki = Wikiwiki::Wiki.new(wiki_id: "your-wiki-id", auth:)
+
 # すべてのページ名の一覧を取得
 page_names = wiki.page_names
 # => ["FrontPage", "SideBar", ...]
@@ -70,6 +164,9 @@ wiki.update_page(page_name: "TestPage", source: <<~SOURCE)
   # Hello World
 SOURCE
 
+# ページを削除
+wiki.delete_page(page_name: "TestPage")
+
 # 添付ファイル名の一覧を取得
 attachment_names = wiki.attachment_names(page_name: "FrontPage")
 

data/README.md

@@ -2,11 +2,11 @@
 
 {file:README.ja.md 日本語版}
 
-A Ruby client library for the [Wikiwiki](https://wikiwiki.jp/) REST API.
+A Ruby client library and command-line interface for the [Wikiwiki](https://wikiwiki.jp/) REST API.
 
 ## Overview
 
-This gem provides a simple interface to interact with Wikiwiki wikis programmatically. It supports page operations (list, read, write) and attachment management (list, upload, download, delete).
+This gem provides both a Ruby library and CLI tool to interact with Wikiwiki wikis.
 
 ## Installation
 
@@ -44,9 +44,95 @@ auth = Wikiwiki::Auth.password(password: "your_admin_password")
 auth = Wikiwiki::Auth.api_key(api_key_id: "your_api_key_id", secret: "your_secret")
 ```
 
+### Token Authentication
+
+A JWT token obtained from a previous authentication can be reused within its validity period:
+
+```ruby
+auth = Wikiwiki::Auth.token(token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...")
+```
+
 ## Usage
 
-### Basic Example
+### Command Line Interface
+
+The `wikiwiki` command provides access to all API operations:
+
+```bash
+# Set credentials via environment variables (optional)
+export WIKIWIKI_WIKI_ID=your-wiki-id
+export WIKIWIKI_PASSWORD=your-password
+# or
+export WIKIWIKI_API_KEY_ID=your-api-key-id
+export WIKIWIKI_SECRET=your-secret
+# or use a pre-obtained token
+export WIKIWIKI_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+
+# Obtain a token for later use
+wikiwiki auth --wiki-id=your-wiki-id --password=your-password
+# or combine with export
+export WIKIWIKI_TOKEN=$(wikiwiki auth --wiki-id=your-wiki-id --password=your-password)
+
+# List pages
+wikiwiki page list
+
+# Show page metadata
+wikiwiki page show FrontPage
+
+# Download page content
+wikiwiki page get FrontPage
+wikiwiki page get FrontPage frontpage.txt
+
+# Upload/update page (from stdin or file)
+wikiwiki page put TestPage < content.txt
+wikiwiki page put TestPage content.txt
+
+# Delete page
+wikiwiki page delete TestPage
+
+# List attachments
+wikiwiki attachment list FrontPage
+
+# Show attachment metadata
+wikiwiki attachment show FrontPage logo.png
+
+# Download attachment
+wikiwiki attachment get FrontPage logo.png
+wikiwiki attachment get FrontPage logo.png --directory downloads/
+
+# Upload attachment (max 512 KiB)
+wikiwiki attachment put FrontPage image.png
+wikiwiki attachment put FrontPage local.png --name remote.png
+
+# Delete attachment
+wikiwiki attachment delete FrontPage logo.png
+
+# Use --force to overwrite existing files/attachments
+wikiwiki page get FrontPage existing.txt --force
+wikiwiki attachment put FrontPage logo.png --force
+
+# Note: Attachment overwrite with --force is not atomic.
+# First attempts to upload; if it fails due to conflict (file exists),
+# deletes the existing file and retries the upload.
+# If retry fails, the attachment will be lost.
+
+# Authentication via command line (overrides environment variables)
+wikiwiki --wiki-id=your-wiki-id --password=your-password page list
+wikiwiki --wiki-id=your-wiki-id --api-key-id=id --secret=secret page list
+wikiwiki --wiki-id=your-wiki-id --token=eyJ... page list
+
+# JSON output for automation
+wikiwiki page list --json
+wikiwiki attachment show FrontPage logo.png --json
+
+# Verbose and debug modes
+wikiwiki page list --verbose
+wikiwiki page list --debug
+```
+
+### Ruby Library
+
+Basic example using the library:
 
 ```ruby
 require "wikiwiki"
@@ -55,6 +141,14 @@ require "wikiwiki"
 auth = Wikiwiki::Auth.password(password: "admin_password")
 wiki = Wikiwiki::Wiki.new(wiki_id: "your-wiki-id", auth:)
 
+# Obtain and reuse authentication token
+token = wiki.token
+# Save token for later use...
+
+# Later, use the saved token
+auth = Wikiwiki::Auth.token(token: token)
+wiki = Wikiwiki::Wiki.new(wiki_id: "your-wiki-id", auth:)
+
 # List all page names
 page_names = wiki.page_names
 # => ["FrontPage", "SideBar", ...]
@@ -70,6 +164,9 @@ wiki.update_page(page_name: "TestPage", source: <<~SOURCE)
   # Hello World
 SOURCE
 
+# Delete a page
+wiki.delete_page(page_name: "TestPage")
+
 # List attachment names
 attachment_names = wiki.attachment_names(page_name: "FrontPage")
 

data/exe/wikiwiki

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "wikiwiki"
+
+cli = Wikiwiki::CLI.new
+exit_code = cli.run(ARGV)
+exit(exit_code)

data/lib/wikiwiki/api.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
+require "jwt"
 require "net/http"
 require "uri"
 
@@ -13,6 +14,7 @@ module Wikiwiki
   #   pages = api.get_pages
   class API
     attr_reader :logger
+    attr_reader :token
 
     BASE_URL = URI.parse("https://api.wikiwiki.jp").freeze
     private_constant :BASE_URL
@@ -60,6 +62,7 @@ module Wikiwiki
     # @param source [String] the page source content
     # @return [void]
     # @raise [Error] if request fails
+    # @note Passing an empty string as source will delete the page
     def put_page(encoded_page_name:, source:)
       uri = BASE_URL + "/#{wiki_id}/page/#{encoded_page_name}"
       response = request(:put, uri, body: {"source" => source})
@@ -123,14 +126,44 @@ module Wikiwiki
 
     # Authenticate with the Wikiwiki API
     #
-    # @param auth [Auth::Password, Auth::ApiKey] authentication credentials
+    # @param auth [Auth::Password, Auth::ApiKey, Auth::Token] authentication credentials
     # @return [String] JWT token
     # @raise [Error] if authentication fails
     private def authenticate(auth)
-      uri = BASE_URL + "/#{wiki_id}/auth"
-      response = request(:post, uri, body: auth.to_h, authenticate: false)
-      data = parse_json_response(response)
-      data["token"]
+      token = if auth.is_a?(Auth::Token)
+                auth.token
+              else
+                uri = BASE_URL + "/#{wiki_id}/auth"
+                response = request(:post, uri, body: auth.to_h, authenticate: false)
+                data = parse_json_response(response)
+                data["token"]
+              end
+
+      validate_token_expiry(token) if auth.is_a?(Auth::Token)
+      token
+    end
+
+    # Validate JWT token expiry
+    #
+    # @param token [String] JWT token
+    # @return [void]
+    # @raise [AuthenticationError] if token has expired
+    private def validate_token_expiry(token)
+      payload, = JWT.decode(token, nil, false)
+      exp = payload["exp"]
+
+      if exp
+        exp_time = Time.at(exp)
+        if Time.now >= exp_time
+          raise AuthenticationError, "Token has expired at #{exp_time.iso8601}"
+        end
+
+        logger.debug("[#{wiki_id}] Token expires at: #{exp_time.iso8601}")
+      else
+        logger.debug("[#{wiki_id}] Token has no expiration")
+      end
+    rescue JWT::DecodeError => e
+      logger.debug("[#{wiki_id}] Failed to decode token: #{e.message}")
     end
 
     # Parse JSON response
@@ -139,6 +172,7 @@ module Wikiwiki
     # @return [Hash] parsed response body
     # @raise [AuthenticationError] if authentication fails (401)
     # @raise [ResourceNotFoundError] if resource not found (404)
+    # @raise [ConflictError] if conflict occurs (409)
     # @raise [ServerError] if server error (5xx)
     # @raise [APIError] if other API request fails
     private def parse_json_response(response)
@@ -149,6 +183,8 @@ module Wikiwiki
           raise AuthenticationError, message
         when 404
           raise ResourceNotFoundError, message
+        when 409
+          raise ConflictError, message
         when 500..599
           raise ServerError, message
         else
@@ -217,6 +253,6 @@ module Wikiwiki
       end
     end
 
-    private attr_reader :wiki_id, :token
+    private attr_reader :wiki_id
   end
 end

data/lib/wikiwiki/auth/token.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Wikiwiki
+  module Auth
+    # Token-based authentication using a pre-obtained JWT token
+    #
+    # This allows using a previously obtained authentication token without
+    # re-authenticating with password or API key credentials.
+    #
+    # @example
+    #   token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+    #   auth = Wikiwiki::Auth.token(token: token)
+    #   wiki = Wikiwiki::Wiki.new(wiki_id: "my-wiki", auth: auth)
+    Token = Data.define(:token)
+
+    class Token
+      # Reopen the class to add YARD documentation for attributes
+
+      # @!attribute [r] token
+      #   @return [String] the JWT token
+    end
+  end
+end

data/lib/wikiwiki/auth.rb

@@ -17,5 +17,11 @@ module Wikiwiki
     # @param secret [String] secret key
     # @return [ApiKey] API key authentication object
     def self.api_key(api_key_id:, secret:) = ApiKey.new(api_key_id:, secret:)
+
+    # Create token-based authentication credentials
+    #
+    # @param token [String] JWT authentication token
+    # @return [Token] token authentication object
+    def self.token(token:) = Token.new(token:)
   end
 end

data/lib/wikiwiki/cli/commands/attachment/delete.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Wikiwiki
+  class CLI
+    module Commands
+      module Attachment
+        # Delete attachment from a page
+        class Delete < Base
+          desc "Delete attachment from a page"
+
+          argument :page_name, required: true, desc: "Page name"
+          argument :file_name, required: true, desc: "Attachment file name"
+
+          # Execute the delete command
+          #
+          # @param page_name [String] name of the page
+          # @param file_name [String] name of the attachment file to delete
+          # @param out [IO] output stream
+          # @param err [IO] error stream
+          # @return [void]
+          def call(page_name:, file_name:, out: $stdout, err: $stderr, **)
+            wiki = create_wiki(out:, err:, **)
+
+            wiki.delete_attachment(page_name:, attachment_name: file_name)
+
+            say("Attachment '#{file_name}' deleted from page '#{page_name}'", out:, **)
+          end
+        end
+      end
+
+      register "attachment delete", Attachment::Delete
+    end
+  end
+end

data/lib/wikiwiki/cli/commands/attachment/get.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Wikiwiki
+  class CLI
+    module Commands
+      module Attachment
+        # Download attachment from a page
+        class Get < Base
+          desc "Download attachment from a page"
+
+          argument :page_name, required: true, desc: "Page name"
+          argument :file_name, required: true, desc: "Attachment file name"
+          option :directory, aliases: ["-d"], desc: "Download directory (current directory if omitted)"
+          option :force, aliases: ["-f"], type: :boolean, default: false, desc: "Overwrite existing file"
+
+          # Execute the get command
+          #
+          # @param page_name [String] name of the page
+          # @param file_name [String] name of the attachment file
+          # @param directory [String, nil] optional download directory
+          # @param force [Boolean] whether to overwrite existing file
+          # @param out [IO] output stream
+          # @param err [IO] error stream
+          # @return [void]
+          def call(page_name:, file_name:, directory: nil, force: false, out: $stdout, err: $stderr, **)
+            wiki = create_wiki(out:, err:, **)
+
+            output_path = directory ? File.join(directory, file_name) : file_name
+
+            if File.exist?(output_path) && !force
+              raise ArgumentError, "File '#{output_path}' already exists. Use --force to overwrite."
+            end
+
+            attachment = wiki.attachment(page_name:, attachment_name: file_name)
+            File.binwrite(output_path, attachment.content)
+
+            say("Attachment '#{file_name}' (#{attachment.content.bytesize} bytes) saved to #{output_path}", out:, **)
+          end
+        end
+      end
+
+      register "attachment get", Attachment::Get
+    end
+  end
+end

data/lib/wikiwiki/cli/commands/attachment/list.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Wikiwiki
+  class CLI
+    module Commands
+      # Attachment-related commands
+      module Attachment
+        # List attachments on a page
+        class List < Base
+          desc "List attachments on a page"
+
+          argument :page_name, required: true, desc: "Page name"
+          option :json, aliases: ["-j"], type: :boolean, default: false, desc: "Output as JSON"
+
+          # Execute the list command
+          #
+          # @param page_name [String] name of the page
+          # @param options [Hash] command options including wiki_id, auth, json, verbose, out, err
+          # @return [void]
+          def call(page_name:, out: $stdout, err: $stderr, **options)
+            wiki = create_wiki(out:, err:, **options)
+            attachment_names = wiki.attachment_names(page_name:)
+
+            if options[:json]
+              out.puts Formatter::JSON.new.format(attachment_names)
+            else
+              attachment_names.each {|name| out.puts name }
+              say("#{attachment_names.size} attachments found", out:, **options)
+            end
+          end
+        end
+      end
+
+      register "attachment list", Attachment::List
+    end
+  end
+end

data/lib/wikiwiki/cli/commands/attachment/put.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Wikiwiki
+  class CLI
+    module Commands
+      module Attachment
+        # Upload attachment to a page
+        class Put < Base
+          desc "Upload attachment to a page"
+
+          MAX_ATTACHMENT_SIZE = 512 * 1024 # 512 KiB
+          private_constant :MAX_ATTACHMENT_SIZE
+
+          argument :page_name, required: true, desc: "Page name"
+          argument :file_path, required: true, desc: "Local file path"
+          option :name, aliases: ["-n"], desc: "Attachment name (inferred from file path if omitted)"
+          option :force, aliases: ["-f"], type: :boolean, default: false, desc: "Overwrite existing attachment (non-atomic: deletes then uploads)"
+
+          # Execute the put command
+          #
+          # @param page_name [String] name of the page
+          # @param file_path [String] local file path to upload
+          # @param name [String, nil] optional attachment name (inferred from file_path if nil)
+          # @param force [Boolean] whether to overwrite existing attachment
+          # @param out [IO] output stream
+          # @param err [IO] error stream
+          # @return [void]
+          def call(page_name:, file_path:, name: nil, force: false, out: $stdout, err: $stderr, **)
+            wiki = create_wiki(out:, err:, **)
+
+            attachment_name = name || File.basename(file_path)
+            content = File.binread(file_path)
+
+            if content.bytesize > MAX_ATTACHMENT_SIZE
+              raise ArgumentError, "File size (#{content.bytesize} bytes) exceeds maximum allowed size (#{MAX_ATTACHMENT_SIZE} bytes / 512 KiB)"
+            end
+
+            begin
+              wiki.add_attachment(page_name:, attachment_name:, content:)
+            rescue ConflictError
+              raise ArgumentError, "Attachment '#{attachment_name}' already exists. Use --force to overwrite." unless force
+
+              wiki.delete_attachment(page_name:, attachment_name:)
+              retry
+            end
+
+            say("Attachment '#{attachment_name}' uploaded to page '#{page_name}'", out:, **)
+          end
+        end
+      end
+
+      register "attachment put", Attachment::Put
+    end
+  end
+end

data/lib/wikiwiki/cli/commands/attachment/show.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Wikiwiki
+  class CLI
+    module Commands
+      module Attachment
+        # Show attachment metadata
+        class Show < Base
+          desc "Show attachment metadata"
+
+          argument :page_name, required: true, desc: "Page name"
+          argument :file_name, required: true, desc: "Attachment file name"
+          option :json, aliases: ["-j"], type: :boolean, default: false, desc: "Output as JSON"
+
+          # Execute the show command
+          #
+          # @param page_name [String] name of the page
+          # @param file_name [String] name of the attachment file
+          # @param options [Hash] command options including wiki_id, auth, json, verbose, out, err
+          # @return [void]
+          def call(page_name:, file_name:, out: $stdout, err: $stderr, **options)
+            wiki = create_wiki(out:, err:, **options)
+            attachment = wiki.attachment(page_name:, attachment_name: file_name)
+
+            metadata = attachment.to_h.except(:content).transform_values {|v| v.is_a?(Time) ? v.iso8601 : v }
+
+            if options[:json]
+              out.puts Formatter::JSON.new.format(metadata)
+            else
+              out.puts "Page: #{metadata[:page_name]}"
+              out.puts "Name: #{metadata[:name]}"
+              out.puts "Size: #{metadata[:size]} bytes"
+              out.puts "Time: #{metadata[:time]}"
+              out.puts "Type: #{metadata[:type]}"
+              say("Attachment metadata retrieved", out:, **options)
+            end
+          end
+        end
+      end
+
+      register "attachment show", Attachment::Show
+    end
+  end
+end