add -c to clipboard

Author: Water-Run

README.md

@@ -6,7 +6,7 @@ Download the version for your operating system from the [Releases](https://githu
 
 > To use the default behavior of `pmc`, your device needs a `git` environment.
 
-After installation, you can run `pmc -v` to verify it.  
+After installation, you can run `pmc -v` to verify it.
 If installed correctly, it will output: `pmc -- pack-my-code. version <your version number>`.
 
 ## Usage
@@ -22,7 +22,7 @@ pmc .
 pmc ./src
 ```
 
-`pmc .` can be shortened to `pmc`.  
+`pmc .` can be shortened to `pmc`.
 `pmc` also has the following default behaviors:
 
 - Follows `.gitignore`
@@ -59,12 +59,12 @@ pmc . -m "*.lua"
 pmc . -m "src/,README.md"
 ```
 
-> `-m` has lower priority than `-x`.  
+> `-m` has lower priority than `-x`.
 > Even if a file matches `-m`, it will still be excluded if it also matches `-x`.
 
 ### `-r`: Ignore `.gitignore`
 
-By default, `pmc` follows `.gitignore` through `git`.  
+By default, `pmc` follows `.gitignore` through `git`.
 With `-r`, it performs a direct filesystem scan and ignores `.gitignore`.
 
 This option is useful when:
@@ -82,13 +82,13 @@ Appends statistical information at the end of the output.
 
 ### `-w`: Wrapping Mode
 
-Specifies how each file’s content is wrapped in output.
+Specifies how each file's content is wrapped in output.
 
 `-w` supports the following modes:
 
 - `md` (default): wrapped as Markdown code blocks
 - `nil`: no wrapping
-- `block`: wrapped in a “block” format
+- `block`: wrapped in a "block" format
 
 ### `-p`: Path Mode
 
@@ -104,7 +104,7 @@ Specifies how paths are displayed before each file block.
 
 Enables YAML-mode output.
 
-In YAML mode, output no longer follows normal plain-text concatenation.  
+In YAML mode, output no longer follows normal plain-text concatenation.
 Instead, it uses its own tree hierarchy structure to organize content.
 
 Therefore, in `-y` mode, the following options cannot be used together:
@@ -116,6 +116,22 @@ Therefore, in `-y` mode, the following options cannot be used together:
 
 That is, YAML mode handles structure, paths, and content organization by itself.
 
+In YAML mode, output must be directed somewhere other than stdout: use `-o` to write to a `.yaml`/`.yml` file, or `-c` to copy to clipboard, or both.
+
+### `-c`: Copy to Clipboard
+
+Copies the output directly to the system clipboard instead of printing to terminal.
+
+Platform support:
+
+- **Windows**: uses the built-in `clip` command (no extra installation needed)
+- **Linux**: requires one of the following clipboard tools to be installed:
+  - `xclip` (X11)
+  - `xsel` (X11)
+  - `wl-copy` (Wayland, part of `wl-clipboard`)
+
+`-c` and `-o` can be used together — the output will be written to the file **and** copied to the clipboard simultaneously. When `-c` or `-o` is specified, stdout is silent.
+
 ### `-o`: Output Redirection
 
 Write results directly to a specified file instead of printing to terminal.
@@ -161,10 +177,35 @@ Export in YAML mode:
 pmc . -y -o context.yaml
 ```
 
+Copy output to clipboard:
+
+```bash
+pmc . -c
+```
+
+Copy to clipboard with tree and stats:
+
+```bash
+pmc . -t -s -c
+```
+
+Write to file and clipboard at the same time:
+
+```bash
+pmc . -o context.md -c
+```
+
+Export YAML to clipboard:
+
+```bash
+pmc . -y -c
+```
+
 ## Notice
 
 - Files larger than **1 MB** are automatically skipped.
 - Known binary formats and files containing null bytes are skipped.
 - Files are assumed to be **UTF‑8 compatible text**.
 - Very large repositories may produce large outputs; consider using `-x` or `-m` to limit scope.
 - Pattern syntax supports `*`, `**`, and `?`, but not advanced glob expressions such as `{}` or `[]`.
+- On Linux, clipboard support requires `xclip`, `xsel`, or `wl-copy` to be installed. If none is found, `pmc` will report an error when `-c` is used.

pmc.lua

@@ -2,7 +2,7 @@
 --@author: WaterRun
 --@file: pmc.lua
 --@date: 2026-03-08
---@updated: 2026-03-09
+--@updated: 2026-03-23
 
 -- =============================================================================
 -- Type annotations
@@ -19,6 +19,7 @@
 ---@field path_mode "relative"|"name"|"absolute"
 ---@field yaml_mode boolean
 ---@field output_file string|nil
+---@field clipboard boolean
 ---@field show_version boolean
 ---@field show_help boolean
 ---@field user_set_t boolean
@@ -47,7 +48,7 @@
 -- Constants
 -- =============================================================================
 
-local VERSION = "1"
+local VERSION = "2"
 
 local MAX_FILE_SIZE = 1024 * 1024 -- 1 MB
 
@@ -414,6 +415,47 @@ local function runCommand(cmd)
     return true, data, 0
 end
 
+-- =============================================================================
+-- Clipboard utilities
+-- =============================================================================
+
+--@description: detect clipboard command for the current platform
+local function getClipboardCommand()
+    if IS_WINDOWS then
+        return "clip"
+    end
+    -- Linux: try common clipboard tools in order
+    local tools = {
+        { cmd = "xclip -selection clipboard", bin = "xclip" },
+        { cmd = "xsel --clipboard --input",   bin = "xsel" },
+        { cmd = "wl-copy",                    bin = "wl-copy" },
+    }
+    for _, t in ipairs(tools) do
+        local ok = runCommand("which " .. t.bin .. " >/dev/null 2>&1")
+        if ok then
+            return t.cmd
+        end
+    end
+    return nil
+end
+
+--@description: write text to system clipboard
+local function writeToClipboard(text)
+    local cmd = getClipboardCommand()
+    if not cmd then
+        fail("no clipboard tool found (need clip on Windows, or xclip / xsel / wl-copy on Linux)")
+    end
+    local pipe = io.popen(cmd, "w")
+    if not pipe then
+        fail("cannot open clipboard command: " .. cmd)
+    end
+    pipe:write(text)
+    local close_ok = pipe:close()
+    if not close_ok then
+        fail("clipboard write failed")
+    end
+end
+
 -- =============================================================================
 -- Path utilities
 -- =============================================================================
@@ -1178,40 +1220,48 @@ local function renderYaml(root, items, target_abs)
 end
 
 -- =============================================================================
--- Output emission
+-- Output assembly and emission
 -- =============================================================================
 
---@description: write sections to output, each section is a list of string entries.
---  Between sections a blank line is inserted.
---  Each entry is written via safeWrite followed by a newline.
---  File content entries may contain embedded newlines — that is fine.
-local function emitOutput(sections, output_file)
-    local handle
-    if output_file then
-        local f, err = io.open(output_file, "wb")
-        if not f then
-            fail("cannot open output file: " .. output_file .. " (" .. tostring(err) .. ")")
-        end
-        handle = f
-    else
-        handle = io.stdout
-    end
-
+--@description: assemble all sections into a single output string
+local function buildOutputString(sections)
+    local parts = {}
     for sect_idx, lines in ipairs(sections) do
         if sect_idx > 1 then
-            -- blank line between sections
-            handle:write("\n")
+            parts[#parts + 1] = "\n"
         end
         for _, entry in ipairs(lines) do
-            safeWrite(handle, entry)
-            handle:write("\n")
+            parts[#parts + 1] = entry
+            parts[#parts + 1] = "\n"
         end
     end
+    return table.concat(parts)
+end
 
-    handle:flush()
+--@description: emit output to file, clipboard, or stdout based on options
+--  When -o or -c is specified, stdout is silent.
+--  -o and -c can be used together.
+local function emitOutput(sections, output_file, clipboard)
+    local text = buildOutputString(sections)
 
     if output_file then
-        handle:close()
+        local f, err = io.open(output_file, "wb")
+        if not f then
+            fail("cannot open output file: " .. output_file .. " (" .. tostring(err) .. ")")
+        end
+        safeWrite(f, text)
+        f:flush()
+        f:close()
+    end
+
+    if clipboard then
+        writeToClipboard(text)
+    end
+
+    -- if neither -o nor -c, write to stdout
+    if not output_file and not clipboard then
+        safeWrite(io.stdout, text)
+        io.stdout:flush()
     end
 end
 
@@ -1232,6 +1282,7 @@ local function makeDefaultOptions()
         path_mode = "relative",
         yaml_mode = false,
         output_file = nil,
+        clipboard = false,
         show_version = false,
         show_help = false,
         user_set_t = false,
@@ -1314,6 +1365,9 @@ local function parseArgs(argv)
         elseif a == "-y" then
             opt.yaml_mode = true
             i = i + 1
+        elseif a == "-c" then
+            opt.clipboard = true
+            i = i + 1
         elseif a == "-o" then
             local val = argv[i + 1]
             if not val or trim(val) == "" then
@@ -1338,12 +1392,14 @@ local function parseArgs(argv)
         if opt.user_set_t or opt.user_set_s or opt.user_set_w or opt.user_set_p then
             fail("-y cannot be used with -t, -s, -w, or -p")
         end
-        if not opt.output_file then
-            fail("yaml mode requires -o with .yaml or .yml file")
+        if not opt.output_file and not opt.clipboard then
+            fail("yaml mode requires -o with .yaml or .yml file, or -c for clipboard")
         end
-        local lower = opt.output_file:lower()
-        if not (endsWith(lower, ".yaml") or endsWith(lower, ".yml")) then
-            fail("yaml output file must end with .yaml or .yml")
+        if opt.output_file then
+            local lower = opt.output_file:lower()
+            if not (endsWith(lower, ".yaml") or endsWith(lower, ".yml")) then
+                fail("yaml output file must end with .yaml or .yml")
+            end
         end
     end
 
@@ -1372,9 +1428,17 @@ Options:
   -w <mode>        Wrap mode: md | nil | block
   -p <mode>        Path mode: relative | name | absolute
   -y               YAML mode (cannot combine with -t -s -w -p)
+  -c               Copy output to clipboard
   -o <file>        Redirect output to file
   -h, --help       Show help
 
+Clipboard support:
+  Windows:  uses built-in 'clip' command
+  Linux:    uses xclip, xsel, or wl-copy (install one)
+
+  -c and -o can be used together (write to file AND clipboard).
+  When -c or -o is used, stdout is silent.
+
 Pattern syntax:
   *.lua            Match by extension
   .lua             Extension shorthand
@@ -1395,6 +1459,9 @@ Examples:
   pmc . -m "*.lua" -x "test/"
   pmc . -r -w block
   pmc . -y -o context.yaml
+  pmc . -c
+  pmc . -t -s -c
+  pmc . -o context.md -c
 ]]
     io.write(msg)
     io.stdout:flush()
@@ -1434,7 +1501,7 @@ local function main(argv)
     -- yaml mode: dedicated output path
     if opt.yaml_mode then
         local yaml_lines = renderYaml(root, items, target_abs)
-        emitOutput({ yaml_lines }, opt.output_file)
+        emitOutput({ yaml_lines }, opt.output_file, opt.clipboard)
         return
     end
 
@@ -1451,7 +1518,7 @@ local function main(argv)
         table.insert(sections, renderStats(items))
     end
 
-    emitOutput(sections, opt.output_file)
+    emitOutput(sections, opt.output_file, opt.clipboard)
 end
 
 main(arg)