Initial commit — codechu-cli 0.1.0

Stdlib-only CLI primitives for consistent UX across Codechu tools.

Static helpers
- Color: ANSI palette with NO_COLOR + TTY detection
- banner(): single-line interactive header
- ascii_banner() + LOGOS: multi-line art banner with optional color,
  TTY-gated by default; ships a Codechu logo
- resolve_format(): TTY → table / pipe → json defaults
- format_examples(): argparse epilog formatter

Animated & input-accepting
- ProgressLine: single-line overwriting stderr progress
- ProgressBar: bracketed bar with totals
- Spinner: braille frames (ASCII fallback when LANG=C / TERM=dumb),
  thread-driven, context-manager friendly
- confirm(): yes/no with TTY + assume_yes short-circuit
- prompt(): text input with validation; password mode via getpass
- select() / multiselect(): arrow-key pickers via termios + tty;
  graceful numbered-prompt fallback on Windows or non-TTY

Emoji helpers
- capabilities(): detects unicode / color / emoji from LANG + TERM +
  NO_COLOR + CODECHU_CLI_EMOJI env override
- e(name, fallback=...): glyph lookup with ASCII fallback for ok/fail/
  warn/info/arrow/bullet/check_on/check_off/scan/trash/broom/disk/watch

61 tests pass with ≥88% coverage. Pure stdlib, no dependencies.
Python 3.10+. MIT. POSIX-first with Windows-degraded interactive
components.

Designed for extraction-readiness from disk_cleaner.cli_helpers; same
API + extended interactive surface.

Author: obarlik

.gitattributes

@@ -0,0 +1,14 @@
+# Otomatik LF normalize: tüm metin dosyaları depo'da LF, checkout'ta OS-default
+* text=auto eol=lf
+
+# Binary — diff/merge yapma
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.db binary
+*.sqlite binary
+
+# Python: linguist-language
+*.py linguist-language=Python

.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: ruff check src tests
+      - run: pytest -q --cov=codechu_cli --cov-report=term-missing --cov-fail-under=85

.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build + twine
+        run: pip install --upgrade build twine
+      - name: Build sdist + wheel
+        run: python -m build
+      - name: Validate metadata
+        run: python -m twine check dist/*
+      - name: Upload to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: python -m twine upload dist/*

.gitignore

@@ -0,0 +1,24 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.tox/
+.mypy_cache/
+
+# OS / IDE
+.DS_Store
+.vscode/
+.idea/
+.cursor/
+
+# Credentials safety net
+.env
+*.key
+*.pem
+*.token

CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) + [SemVer](https://semver.org/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-05-20
+
+### Added
+- Initial extraction from [codechu/disk-cleaner](https://github.com/codechu/disk-cleaner)
+- `Color` — ANSI palette with `NO_COLOR` + TTY detection
+- `ProgressLine` — single-line overwriting stderr progress
+- `ProgressBar(total, ...)` — bracketed progress bar with percent + counts
+- `Spinner(message, ...)` — threaded spinner, braille frames with ASCII fallback
+- `confirm()` — yes/no prompt with TTY / `assume_yes` short-circuit
+- `prompt()` — single-line input with optional validator + password mode
+- `select()` — single-choice picker (arrow keys on TTY, numbered fallback)
+- `multiselect()` — multi-choice picker (space toggle, `a` select-all)
+- `banner()` — single-line interactive header
+- `resolve_format()` — TTY vs pipe default format chooser
+- `format_examples()` — argparse epilog formatter
+- `emoji.capabilities()` + `emoji.e()` — locale + terminal-aware glyph lookup

CLAUDE.md

@@ -0,0 +1,28 @@
+# CLAUDE.md — codechu-cli
+
+Bootstrap per `codechu-org/ai/AGENTS.md` §0 before any work. Prefer
+the local clone at `$org_home/codechu-org/ai/AGENTS.md` (if
+`~/.config/codechu/config.toml` has `org_home` set); otherwise
+WebFetch the public raw URL
+<https://raw.githubusercontent.com/codechu/codechu-org/main/ai/AGENTS.md>.
+This file lists only product-local overrides.
+
+## Product-local notes
+
+- Pure-Python, stdlib-only. No GTK, no curses, no third-party
+  runtime dependencies. Tests in `tests/` must keep that invariant.
+- POSIX-first. Raw-mode features (`select`, `multiselect`) detect
+  non-TTY / Windows up front and fall back to numbered prompts —
+  do not add a hard `termios` import at module top.
+- Public API surface: see `codechu_cli.__all__`. Anything else
+  (private helpers, frame constants) is internal.
+- Coverage target: ≥85 %.
+- Emoji defaults are conservative ("temkinli") — when `LANG=C` or
+  `TERM=dumb`, fall back to ASCII glyphs. `CODECHU_CLI_EMOJI=always`
+  forces on, `never` forces off.
+
+## Discipline reminders (org rules apply)
+
+- Conventional Commits, no AI signature.
+- No `--no-verify`, no force push, no unapproved publish.
+- See `codechu-org/ai/AGENTS.md` for the full list.

CODE_OF_CONDUCT.md

@@ -0,0 +1,24 @@
+# Code of Conduct
+
+This project adopts the [Contributor Covenant v2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
+
+## Summary
+
+- Be respectful, inclusive, and patient.
+- Assume good faith; when giving criticism, focus on the work, not the person.
+- Harassment, personal attacks, and discriminatory language are not accepted in any form.
+- Repo maintainers have the authority to enforce these rules;
+  comments / PRs / issues that violate them may result in a warning, lock, or ban.
+
+## Enforcement
+
+If you believe the rules have been violated:
+
+- Write to `info@codechu.com`, or
+- Send a private mention to the `@codechu/maintainers` team in the repo
+
+All reports are handled confidentially. The maintainer team does its
+best to respond in a reasonable time (best-effort, open-source project —
+no fixed SLA).
+
+Full text: [Contributor Covenant v2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)

CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing to codechu-cli
+
+Thanks for thinking about contributing. `codechu-cli` is a small,
+focused CLI primitives library — pure stdlib, POSIX-first. Patches
+that keep that invariant intact are warmly received.
+
+This library was originally extracted from [Disk Cleaner](https://github.com/codechu/disk-cleaner),
+but is maintained independently with its own release cadence.
+
+## Development setup
+
+```bash
+git clone https://github.com/codechu/cli-py.git
+cd cli-py
+pip install -e ".[dev]"
+pytest -q
+ruff check src tests
+```
+
+## Workflow
+
+- Branch names: `feature/<short>`, `fix/<short>`, `refactor/<short>`,
+  `docs/<short>`, `test/<short>`.
+- Commit messages: [Conventional Commits](https://www.conventionalcommits.org/)
+  (`feat:`, `fix:`, `refactor:`, `docs:`, `test:`, `chore:`).
+- Open a PR using the template; describe the *why* in the body.
+- One change per PR — keep diffs reviewable.
+
+## Bug reports
+
+A useful bug report includes:
+
+- Python version + OS + terminal emulator (`$TERM`, `$LANG`).
+- A minimal reproducer (≤30 lines, stdlib-only if possible).
+- Expected vs observed behaviour. For TTY/non-TTY differences,
+  mention whether you ran under a pty, a CI runner, or a real shell.
+
+## Tests
+
+- `pytest -q` must pass; coverage stays at **≥85 %**.
+- New feature → new test. Interactive components (`select`,
+  `multiselect`, `Spinner`) need tests that bypass the raw-mode
+  path — use non-TTY streams + monkeypatched `time.sleep`.
+- Don't introduce real sleeps for synchronization — mock `time`.
+- Prefer `io.StringIO` for stream injection over touching real fds.
+
+## Public API discipline
+
+The public surface is what `codechu_cli.__all__` exports. Everything
+else is internal — please don't extend it without a discussion first.
+
+## Style
+
+- `ruff check` + `ruff format` clean.
+- Type hints on public APIs (`from __future__ import annotations`).
+- Use `logging.getLogger(__name__)`; avoid `print`.
+- Pure stdlib — no new third-party runtime dependencies.
+
+## Security
+
+If you find a security issue, see [SECURITY.md](SECURITY.md) — do not
+open a public issue for it.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codechu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.