dirlens 1.0.2 → 1.0.4

package/README.md

@@ -21,6 +21,7 @@ Desktop/ (2 dirs, 2 files, 3.74 MB)
 └── readme.txt (50 KB)
 
   5 ディレクトリ,  5 ファイル
+  .py ×2  .txt ×1  .zip ×1  .png ×1
 ```
 
 ---
@@ -32,7 +33,12 @@ Desktop/ (2 dirs, 2 files, 3.74 MB)
 - **自動サイズ変換** — bytes / KB / MB / GB / TB
 - **ディレクトリサイズ** — サブディレクトリの合計サイズを自動計算
 - **アイテム数表示** — 各ディレクトリの直下にある dirs / files 数を表示
-- **隠しファイル対応** — `-a` で表示切り替え（アイテム数にも反映）
+- **拡張子統計** — ツリー全体のファイル種別を集計してサマリーに表示
+- **`.gitignore` 対応** — `-g` で `node_modules/` などを自動除外
+- **最終更新日時** — `--date` で各ファイル・ディレクトリの更新日時を相対表示
+- **拡張子フィルタ** — `-t py` など指定した拡張子のみ表示
+- **Markdown出力** — `-m` でコードブロック形式に出力、AIチャットにそのままペースト可
+- **隠しファイル対応** — `-a` で表示切り替え（アイテム数・統計にも反映）
 - **サイズ順ソート** — `-s` で大きいものから表示
 
 ---
@@ -137,27 +143,47 @@ dirlens -a
 # サイズの大きい順に並べる
 dirlens -s
 
+# .gitignore に記載されたファイル・ディレクトリを除外
+dirlens -g
+
+# 最終更新日時を相対表示（例: 3日前、2時間前）
+dirlens --date
+
+# 指定した拡張子のファイルのみ表示
+dirlens -t py
+dirlens -t md
+
+# Markdown コードブロック形式で出力（AI チャットへのペースト用）
+dirlens -m
+
 # カラーなし（パイプ・ファイル書き出し向け）
 dirlens --no-color
 
-# 組み合わせ例：Desktop を深さ 3・サイズ順で表示
-dirlens ~/Desktop -d 3 -s
+# 組み合わせ例：gitignore 除外 + Python のみ + 日付表示
+dirlens -g -t py --date
+
+# AI に貼り付けやすい形式で出力
+dirlens -g -m
 
 # テキストファイルに書き出す
-dirlens --no-color > tree.txt
+dirlens --no-color > dirlens.txt
 ```
 
 ---
 
 ## オプション一覧
 
-| オプション        | 省略形 | 説明                                     |
-|------------------|--------|------------------------------------------|
-| `path`           | —      | 対象ディレクトリ（省略時はカレント）         |
-| `--depth N`      | `-d N` | 表示する最大の深さ                         |
-| `--all`          | `-a`   | 隠しファイル・ディレクトリも表示            |
-| `--sort-size`    | `-s`   | サイズが大きい順に並べる                    |
-| `--no-color`     | —      | カラー表示を無効化（リダイレクト時に推奨）   |
+| オプション        | 省略形   | 説明                                            |
+|------------------|----------|-------------------------------------------------|
+| `path`           | —        | 対象ディレクトリ（省略時はカレント）               |
+| `--depth N`      | `-d N`   | 表示する最大の深さ                                |
+| `--all`          | `-a`     | 隠しファイル・ディレクトリも表示                   |
+| `--sort-size`    | `-s`     | サイズが大きい順に並べる                           |
+| `--gitignore`    | `-g`     | `.gitignore` に記載されたファイルを除外（サブディレクトリも対応） |
+| `--date`         | —        | 最終更新日時を相対表示（例: 3日前）                |
+| `--type EXT`     | `-t EXT` | 指定した拡張子のファイルのみ表示（例: `-t py`）    |
+| `--markdown`     | `-m`     | Markdown コードブロック形式で出力（カラー自動無効） |
+| `--no-color`     | —        | カラー表示を無効化（リダイレクト時に推奨）          |
 
 ---
 
@@ -175,8 +201,9 @@ dirlens --no-color > tree.txt
 
 ## 仕様・注意事項
 
-- ディレクトリのサイズは **全サブファイルの合計**（隠しファイルを含む）
+- ディレクトリのサイズは **全サブファイルの合計**（隠しファイルを含む、`.gitignore` 対象も含む）
 - **シンボリックリンク先のディレクトリ**は展開せず `→` マークで表示
 - 権限がないディレクトリは `[アクセス拒否]` と表示してスキップ
 - 非常に深いディレクトリ（1万階層以上）は `-d` で深さを制限してください
 - **ホームフォルダ（`~/`）やルート（`/`）で実行すると固まる場合があります** — サイズ計算は `-d` の表示制限に関わらず底まで全再帰するため、`~/Library` や iCloud Drive など大容量・ネットワークマウントのディレクトリで時間がかかります。プロジェクトフォルダなど範囲を絞って実行してください
+- **`-g` の否定パターン（`!` から始まる行）は現時点で非対応**です

package/dirlens.py

@@ -1,12 +1,14 @@
 #!/usr/bin/env python3
 """
-dirlens – ファイルサイズ＋アイテム数付きディレクトリツリー表示ツール
+dirlens – ファイルサイズ付きディレクトリツリー表示ツール
 対応環境: macOS / Linux / Windows  (Python 3.8+)
 """
 
 import os
 import sys
 import argparse
+import fnmatch
+import datetime
 from pathlib import Path
 
 # ─── カラー設定 ──────────────────────────────────────────────
@@ -41,6 +43,7 @@ MAGENTA = "\033[35m"
 def c(text, *codes):
     return ("".join(codes) + text + RESET) if USE_COLOR else text
 
+
 # ─── サイズ表示 ───────────────────────────────────────────────
 def fmt_size(n):
     if n == 0:
@@ -51,6 +54,68 @@ def fmt_size(n):
             return f"{s} {unit}"
     return f"{n} {'byte' if n == 1 else 'bytes'}"
 
+
+# ─── アイテム数表示 ────────────────────────────────────────────
+def fmt_count(nd, nf):
+    d     = f"{nd} {'dir'  if nd == 1 else 'dirs'}"
+    f_str = f"{nf} {'file' if nf == 1 else 'files'}"
+    return f"{d}, {f_str}"
+
+
+# ─── 日時表示 ─────────────────────────────────────────────────
+def fmt_date(mtime):
+    sec = int((datetime.datetime.now() -
+               datetime.datetime.fromtimestamp(mtime)).total_seconds())
+    if sec <    60: return "今"
+    if sec <  3600: return f"{sec // 60}分前"
+    if sec < 86400: return f"{sec // 3600}時間前"
+    days = sec // 86400
+    if days ==  1: return "昨日"
+    if days <   7: return f"{days}日前"
+    if days <  30: return f"{days // 7}週間前"
+    if days < 365: return f"{days // 30}ヶ月前"
+    return f"{days // 365}年前"
+
+
+# ─── .gitignore サポート ──────────────────────────────────────
+def load_gitignore(directory):
+    """指定ディレクトリの .gitignore パターンを読み込む。"""
+    patterns = []
+    path = os.path.join(directory, ".gitignore")
+    if os.path.isfile(path):
+        try:
+            with open(path, encoding="utf-8", errors="ignore") as f:
+                for line in f:
+                    line = line.strip()
+                    if line and not line.startswith("#"):
+                        patterns.append(line)
+        except OSError:
+            pass
+    return patterns
+
+def is_ignored(name, rel_path, is_dir, patterns):
+    """gitignore パターンにマッチするか判定する（簡易実装）。"""
+    rel = rel_path.replace("\\", "/")
+    for pat in patterns:
+        if pat.startswith("!"):
+            continue
+        dir_only = pat.endswith("/")
+        p = pat.rstrip("/")
+        if dir_only and not is_dir:
+            continue
+        if p.startswith("/"):
+            if fnmatch.fnmatch(rel, p.lstrip("/")):
+                return True
+        else:
+            if fnmatch.fnmatch(name, p):
+                return True
+            if fnmatch.fnmatch(rel, p):
+                return True
+            if fnmatch.fnmatch(rel, "*/" + p):
+                return True
+    return False
+
+
 # ─── ディレクトリサイズ（キャッシュ付き） ─────────────────────
 _cache = {}
 
@@ -73,24 +138,42 @@ def dir_size(path):
     _cache[path] = total
     return total
 
+
 # ─── アイテム数カウント ────────────────────────────────────────
-def count_items(path, show_all):
-    """ディレクトリ直下のアイテム数 (num_dirs, num_files) を返す。"""
+def count_entries(path, show_all, active_pats, root, type_ext, use_gitignore=False):
     try:
-        entries = list(os.scandir(path))
+        raw = list(os.scandir(path))
     except OSError:
-        return (0, 0)
-    if not show_all:
-        entries = [e for e in entries if not e.name.startswith(".")]
-    nd = sum(1 for e in entries if e.is_dir(follow_symlinks=False))
-    nf = sum(1 for e in entries if not e.is_dir(follow_symlinks=False))
-    return (nd, nf)
-
-def fmt_meta(nd, nf, sz):
-    """アイテム数＋サイズをまとめて文字列化する。"""
-    d_str = f"{nd} {'dir' if nd == 1 else 'dirs'}"
-    f_str = f"{nf} {'file' if nf == 1 else 'files'}"
-    return f"({d_str}, {f_str}, {fmt_size(sz)})"
+        return 0, 0
+    entries = [e for e in raw if show_all or not e.name.startswith(".")]
+
+    # count_entries の対象ディレクトリ自身の .gitignore も反映する
+    local_pats = active_pats
+    if use_gitignore:
+        local = load_gitignore(path)
+        if local:
+            rel_dir = os.path.relpath(path, root).replace("\\", "/")
+            adjusted = []
+            for pat in local:
+                if not pat.startswith("!") and pat.startswith("/"):
+                    adjusted.append("/" + rel_dir + pat)
+                else:
+                    adjusted.append(pat)
+            local_pats = active_pats + adjusted
+
+    if local_pats:
+        entries = [e for e in entries
+                   if not is_ignored(e.name,
+                                     os.path.relpath(e.path, root),
+                                     e.is_dir(follow_symlinks=False),
+                                     local_pats)]
+    nd    = sum(1 for e in entries if e.is_dir(follow_symlinks=False))
+    files = [e for e in entries if not e.is_dir(follow_symlinks=False)]
+    if type_ext:
+        files = [f for f in files
+                 if os.path.splitext(f.name)[1].lower() == type_ext]
+    return nd, len(files)
+
 
 # ─── ツリー描画 ───────────────────────────────────────────────
 PIPE  = "│   "
@@ -98,10 +181,32 @@ FORK  = "├── "
 LAST  = "└── "
 BLANK = "    "
 
-def render(path, prefix, depth, max_depth, show_all, by_size, stats):
+def render(path, prefix, depth, opts, stats, active_pats):
+    """
+    active_pats: 現在の階層で有効な gitignore パターンの累積リスト。
+    サブディレクトリに入るたびにローカルの .gitignore を読み込んで追記する。
+    リストは新規作成して渡すため、兄弟ディレクトリには影響しない。
+    """
+    max_depth, show_all, by_size, show_date, use_gitignore, root, type_ext = opts
+
     if max_depth is not None and depth >= max_depth:
         return
 
+    # このディレクトリの .gitignore を読んでパターンを積み重ねる（ルートは main で読み済み）
+    if use_gitignore and depth > 0:
+        local = load_gitignore(path)
+        if local:
+            # アンカーパターン（/xxx）をルートからの相対パスに変換する
+            # 例: src/.gitignore の /build → /src/build
+            rel_dir = os.path.relpath(path, root).replace("\\", "/")
+            adjusted = []
+            for pat in local:
+                if not pat.startswith("!") and pat.startswith("/"):
+                    adjusted.append("/" + rel_dir + pat)
+                else:
+                    adjusted.append(pat)
+            active_pats = active_pats + adjusted  # 新しいリストを作成（親に影響しない）
+
     try:
         raw = list(os.scandir(path))
     except PermissionError:
@@ -109,18 +214,32 @@ def render(path, prefix, depth, max_depth, show_all, by_size, stats):
         return
 
     entries = [e for e in raw if show_all or not e.name.startswith(".")]
+
+    if active_pats:
+        entries = [e for e in entries
+                   if not is_ignored(e.name,
+                                     os.path.relpath(e.path, root),
+                                     e.is_dir(follow_symlinks=False),
+                                     active_pats)]
+
     dirs  = [e for e in entries if     e.is_dir(follow_symlinks=False)]
     files = [e for e in entries if not e.is_dir(follow_symlinks=False)]
 
-    def entry_size(e):
-        try:
-            return e.stat(follow_symlinks=True).st_size
-        except OSError:
-            return 0
+    if type_ext:
+        files = [f for f in files
+                 if os.path.splitext(f.name)[1].lower() == type_ext]
+
+    def esz(e):
+        try:   return e.stat(follow_symlinks=True).st_size
+        except OSError: return 0
+
+    def emtime(e):
+        try:   return e.stat(follow_symlinks=True).st_mtime
+        except OSError: return 0
 
     if by_size:
         dirs.sort(key=lambda e: dir_size(e.path), reverse=True)
-        files.sort(key=lambda e: entry_size(e), reverse=True)
+        files.sort(key=lambda e: esz(e), reverse=True)
     else:
         dirs.sort(key=lambda e: e.name.casefold())
         files.sort(key=lambda e: e.name.casefold())
@@ -133,20 +252,41 @@ def render(path, prefix, depth, max_depth, show_all, by_size, stats):
         cont    = BLANK if is_last else PIPE
 
         if entry.is_dir(follow_symlinks=False):
-            sz       = dir_size(entry.path)
-            nd, nf   = count_items(entry.path, show_all)
+            sz     = dir_size(entry.path)
+            nd, nf = count_entries(entry.path, show_all, active_pats, root, type_ext, use_gitignore)
             stats["dirs"] += 1
+
+            parts = [fmt_count(nd, nf), fmt_size(sz)]
+            if show_date:
+                try:
+                    parts.append(fmt_date(entry.stat(follow_symlinks=False).st_mtime))
+                except OSError:
+                    pass
+
             name = c(f"{entry.name}/", BOLD, CYAN)
-            meta = c(fmt_meta(nd, nf, sz), DIM)
+            meta = c(f"({', '.join(parts)})", DIM)
             print(f"{prefix}{branch}{name} {meta}")
-            render(entry.path, prefix + cont, depth + 1, max_depth, show_all, by_size, stats)
+            render(entry.path, prefix + cont, depth + 1, opts, stats, active_pats)
+
         else:
-            sz  = entry_size(entry)
+            sz  = esz(entry)
             sym = " →" if entry.is_symlink() else ""
             stats["files"] += 1
+
+            ext = os.path.splitext(entry.name)[1].lower()
+            key = ext if ext else "(no ext)"
+            stats["extensions"][key] = stats["extensions"].get(key, 0) + 1
+
+            parts = [fmt_size(sz)]
+            if show_date:
+                mt = emtime(entry)
+                if mt:
+                    parts.append(fmt_date(mt))
+
             name = c(f"{entry.name}{sym}", MAGENTA if entry.is_symlink() else GREEN)
-            size = c(f"({fmt_size(sz)})", DIM)
-            print(f"{prefix}{branch}{name} {size}")
+            meta = c(f"({', '.join(parts)})", DIM)
+            print(f"{prefix}{branch}{name} {meta}")
+
 
 # ─── エントリポイント ─────────────────────────────────────────
 def main():
@@ -155,7 +295,7 @@ def main():
 
     ap = argparse.ArgumentParser(
         prog="dirlens",
-        description="ファイルサイズ＋アイテム数付きのディレクトリツリーを表示します",
+        description="ファイルサイズ付きのディレクトリツリーを表示します",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog=(
             "使用例:\n"
@@ -164,17 +304,26 @@ def main():
             "  dirlens -d 2             深さ 2 階層まで表示\n"
             "  dirlens -a               隠しファイル (.xxx) も表示\n"
             "  dirlens -s               サイズの大きい順に表示\n"
+            "  dirlens -g               .gitignore のファイルを除外\n"
+            "  dirlens --date           最終更新日時を表示\n"
+            "  dirlens -t py            .py ファイルのみ表示\n"
+            "  dirlens -m               Markdown コードブロックで出力\n"
             "  dirlens --no-color       カラーなしで表示"
+            "  dirlens > dirlens.txt    dirlens.txtに書き出す"
         ),
     )
     ap.add_argument("path",              nargs="?", default=".", help="対象ディレクトリ（省略時はカレント）")
     ap.add_argument("-d", "--depth",     type=int,  metavar="N", help="表示する最大の深さ")
     ap.add_argument("-a", "--all",       action="store_true",    help="隠しファイルも表示する")
     ap.add_argument("-s", "--sort-size", action="store_true",    help="サイズが大きい順に並べる")
+    ap.add_argument("-g", "--gitignore", action="store_true",    help=".gitignore のファイルを除外する（サブディレクトリも対応）")
+    ap.add_argument("--date",            action="store_true",    help="最終更新日時を表示する")
+    ap.add_argument("-t", "--type",      metavar="EXT",          help="指定した拡張子のみ表示 (例: py, md)")
+    ap.add_argument("-m", "--markdown",  action="store_true",    help="Markdown コードブロックで出力")
     ap.add_argument("--no-color",        action="store_true",    help="カラー表示を無効化する")
     args = ap.parse_args()
 
-    if args.no_color:
+    if args.no_color or args.markdown:
         USE_COLOR = False
 
     target = Path(args.path).resolve()
@@ -185,19 +334,51 @@ def main():
         print(f"エラー: '{args.path}' はディレクトリではありません", file=sys.stderr)
         sys.exit(1)
 
-    root_label = target.name if target.name else str(target)
-    root_sz    = dir_size(str(target))
-    nd, nf     = count_items(str(target), args.all)
+    # ルートの .gitignore を起点として読み込む
+    active_pats = load_gitignore(str(target)) if args.gitignore else []
+    type_ext    = ("." + args.type.lstrip(".")).lower() if args.type else None
+    opts        = (args.depth, args.all, args.sort_size, args.date,
+                   args.gitignore, str(target), type_ext)
+
+    if args.markdown:
+        print("```")
+
+    # ルートを表示
+    root_sz          = dir_size(str(target))
+    root_nd, root_nf = count_entries(str(target), args.all, active_pats, str(target), type_ext, args.gitignore)
+    root_label       = target.name if target.name else str(target)
+
+    parts = [fmt_count(root_nd, root_nf), fmt_size(root_sz)]
+    if args.date:
+        try:
+            parts.append(fmt_date(target.stat().st_mtime))
+        except OSError:
+            pass
 
     root_name = c(f"{root_label}/", BOLD, BLUE)
-    root_meta = c(fmt_meta(nd, nf, root_sz), DIM)
+    root_meta = c(f"({', '.join(parts)})", DIM)
     print(f"{root_name} {root_meta}")
 
-    stats = {"files": 0, "dirs": 0}
-    render(str(target), "", 0, args.depth, args.all, args.sort_size, stats)
+    stats = {"files": 0, "dirs": 0, "extensions": {}}
+    render(str(target), "", 0, opts, stats, active_pats)
 
+    # ─ サマリー ──────────────────────────────────────────────
     print()
-    print(c(f"  {stats['dirs']} ディレクトリ,  {stats['files']} ファイル", DIM))
+    summary = f"  {stats['dirs']} ディレクトリ,  {stats['files']} ファイル"
+    if args.gitignore:
+        summary += "  (.gitignore 適用済み)"
+    if type_ext:
+        summary += f"  (フィルタ: {type_ext})"
+    print(c(summary, DIM))
+
+    if stats["extensions"]:
+        sorted_exts = sorted(stats["extensions"].items(), key=lambda x: -x[1])
+        ext_line = "  " + "  ".join(f"{ext} ×{n}" for ext, n in sorted_exts[:8])
+        print(c(ext_line, DIM))
+
+    if args.markdown:
+        print("```")
+
 
 if __name__ == "__main__":
     main()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirlens",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Directory tree viewer with file sizes / ファイルサイズ付きディレクトリツリー表示ツール",
   "bin": {
     "dirlens": "./bin/dirlens"