treeing 1.0.1__tar.gz

treeing-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MING
+
+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.

treeing-1.0.1/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: treeing
+Version: 1.0.1
+Summary: ASCII tree → directory/file generator
+Author: MING
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/xiao-ming-b65536/treeing
+Project-URL: Source, https://github.com/xiao-ming-b65536/treeing
+Project-URL: Issue Tracker, https://github.com/xiao-ming-b65536/treeing/issues
+Project-URL: Changelog, https://github.com/xiao-ming-b65536/treeing/blob/main/CHANGELOG.md
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Treeing — ASCII tree → directory/file generator
+
+Turn directory-tree text (e.g. output from the `tree` command) into real folders and empty files.
+
+## Features
+
+- Common `tree` output formats: Unicode box-drawing, pipe style, Windows `tree`, space-indented trees.
+- Automatic indent repair (disable with `--no-fix` or the GUI checkbox).
+- Both a GUI and a CLI.
+- Cross-platform: Windows, macOS, Linux.
+- User-visible strings live in `treeing/strings.json` (bootstrap errors in `treeing/strings.bootstrap.json`).
+
+## Preview
+
+![Treeing GUI](docs/screenshots/gui_en.png)
+
+> Screenshot: Windows, English UI, parsing a sample project tree.
+
+## Quick start
+
+### Install from PyPI
+
+```bash
+pip install treeing
+treeing -i tree.txt -o ./out   # CLI
+treeing-gui                    # GUI
+```
+
+The CLI needs only the Python standard library. The GUI uses `tkinter`; on Linux install it with `sudo apt-get install python3-tk` (it ships with Python on Windows and macOS).
+
+### Run from source
+
+```bash
+python -m venv .venv
+# Windows: .\.venv\Scripts\pip install -r requirements-build.txt
+# Unix:    .venv/bin/pip install -r requirements-build.txt
+
+python -m treeing.main                       # GUI
+python -m treeing.main -i tree.txt -o ./out  # CLI
+python -m treeing.main --help                # CLI help
+```
+
+### Run a prebuilt executable
+
+Prebuilt binaries are attached to each [release](https://github.com/xiao-ming-b65536/treeing/releases) (Windows, Linux, macOS ARM, macOS x86). Pick the archive for your platform (replace `vX.Y.Z` with the actual version):
+
+| Platform | Archives |
+|---|---|
+| Windows | `treeing-cli-windows-vX.Y.Z.zip`, `treeing-gui-windows-vX.Y.Z.zip` |
+| Linux | `treeing-cli-linux-vX.Y.Z.tar.gz`, `treeing-gui-linux-vX.Y.Z.tar.gz` |
+| macOS (Apple Silicon) | `treeing-cli-macos-arm64-vX.Y.Z.tar.gz`, `treeing-gui-macos-arm64-vX.Y.Z.tar.gz` |
+| macOS (Intel) | `treeing-cli-macos-x86_64-vX.Y.Z.tar.gz`, `treeing-gui-macos-x86_64-vX.Y.Z.tar.gz` |
+
+CLI and GUI are packaged separately; download whichever you need. Verify against `SHA256SUMS.txt` in the same release.
+
+```bash
+treeing-gui                           # GUI — Linux / macOS
+treeing-gui.exe                       # GUI — Windows
+
+treeing-cli -i tree.txt -o ./out      # CLI — Linux / macOS
+treeing-cli.exe -i tree.txt -o ./out  # CLI — Windows
+treeing-cli --help                    # CLI help — Linux / macOS
+treeing-cli.exe --help                # CLI help — Windows
+```
+
+### Build executables yourself
+
+```bash
+pip install -r requirements-build.txt
+python build.py --target all          # outputs to dist/<platform>/
+```
+
+## Documentation
+
+See [docs/USER_GUIDE.md](docs/USER_GUIDE.md) for a unified guide covering source runs and prebuilt executables on Windows, macOS ARM, macOS x86, and Linux.
+
+## Legal
+
+- **Licence** — MIT; see [LICENSE](LICENSE).
+- **Privacy Policy** — see [PRIVACY.md](PRIVACY.md).
+- **Terms of Use** — see [TERMS.md](TERMS.md).
+
+## AI Disclosure
+
+Parts of this source code were written with assistance from AI coding tools.

treeing-1.0.1/README.md

@@ -0,0 +1,85 @@
+# Treeing — ASCII tree → directory/file generator
+
+Turn directory-tree text (e.g. output from the `tree` command) into real folders and empty files.
+
+## Features
+
+- Common `tree` output formats: Unicode box-drawing, pipe style, Windows `tree`, space-indented trees.
+- Automatic indent repair (disable with `--no-fix` or the GUI checkbox).
+- Both a GUI and a CLI.
+- Cross-platform: Windows, macOS, Linux.
+- User-visible strings live in `treeing/strings.json` (bootstrap errors in `treeing/strings.bootstrap.json`).
+
+## Preview
+
+![Treeing GUI](docs/screenshots/gui_en.png)
+
+> Screenshot: Windows, English UI, parsing a sample project tree.
+
+## Quick start
+
+### Install from PyPI
+
+```bash
+pip install treeing
+treeing -i tree.txt -o ./out   # CLI
+treeing-gui                    # GUI
+```
+
+The CLI needs only the Python standard library. The GUI uses `tkinter`; on Linux install it with `sudo apt-get install python3-tk` (it ships with Python on Windows and macOS).
+
+### Run from source
+
+```bash
+python -m venv .venv
+# Windows: .\.venv\Scripts\pip install -r requirements-build.txt
+# Unix:    .venv/bin/pip install -r requirements-build.txt
+
+python -m treeing.main                       # GUI
+python -m treeing.main -i tree.txt -o ./out  # CLI
+python -m treeing.main --help                # CLI help
+```
+
+### Run a prebuilt executable
+
+Prebuilt binaries are attached to each [release](https://github.com/xiao-ming-b65536/treeing/releases) (Windows, Linux, macOS ARM, macOS x86). Pick the archive for your platform (replace `vX.Y.Z` with the actual version):
+
+| Platform | Archives |
+|---|---|
+| Windows | `treeing-cli-windows-vX.Y.Z.zip`, `treeing-gui-windows-vX.Y.Z.zip` |
+| Linux | `treeing-cli-linux-vX.Y.Z.tar.gz`, `treeing-gui-linux-vX.Y.Z.tar.gz` |
+| macOS (Apple Silicon) | `treeing-cli-macos-arm64-vX.Y.Z.tar.gz`, `treeing-gui-macos-arm64-vX.Y.Z.tar.gz` |
+| macOS (Intel) | `treeing-cli-macos-x86_64-vX.Y.Z.tar.gz`, `treeing-gui-macos-x86_64-vX.Y.Z.tar.gz` |
+
+CLI and GUI are packaged separately; download whichever you need. Verify against `SHA256SUMS.txt` in the same release.
+
+```bash
+treeing-gui                           # GUI — Linux / macOS
+treeing-gui.exe                       # GUI — Windows
+
+treeing-cli -i tree.txt -o ./out      # CLI — Linux / macOS
+treeing-cli.exe -i tree.txt -o ./out  # CLI — Windows
+treeing-cli --help                    # CLI help — Linux / macOS
+treeing-cli.exe --help                # CLI help — Windows
+```
+
+### Build executables yourself
+
+```bash
+pip install -r requirements-build.txt
+python build.py --target all          # outputs to dist/<platform>/
+```
+
+## Documentation
+
+See [docs/USER_GUIDE.md](docs/USER_GUIDE.md) for a unified guide covering source runs and prebuilt executables on Windows, macOS ARM, macOS x86, and Linux.
+
+## Legal
+
+- **Licence** — MIT; see [LICENSE](LICENSE).
+- **Privacy Policy** — see [PRIVACY.md](PRIVACY.md).
+- **Terms of Use** — see [TERMS.md](TERMS.md).
+
+## AI Disclosure
+
+Parts of this source code were written with assistance from AI coding tools.

treeing-1.0.1/pyproject.toml

@@ -0,0 +1,46 @@
+[project]
+name = "treeing"
+version = "1.0.1"
+description = "ASCII tree → directory/file generator"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [
+    {name = "MING"},
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Environment :: X11 Applications",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Utilities",
+]
+dependencies = []
+
+[project.scripts]
+treeing = "treeing.cli.main:cli_main"
+treeing-gui = "treeing.gui_entry:run_gui"
+
+[project.urls]
+Homepage = "https://github.com/xiao-ming-b65536/treeing"
+Source = "https://github.com/xiao-ming-b65536/treeing"
+"Issue Tracker" = "https://github.com/xiao-ming-b65536/treeing/issues"
+Changelog = "https://github.com/xiao-ming-b65536/treeing/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["setuptools>=64"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["treeing", "treeing.cli", "treeing.core", "treeing.gui", "treeing.assets"]
+include-package-data = true
+
+[tool.setuptools.package-data]
+treeing = ["strings.json", "strings.bootstrap.json", "assets/*"]

treeing-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

treeing-1.0.1/treeing/__init__.py

@@ -0,0 +1,7 @@
+"""treeing
+
+Top-level package entry point for the Treeing project.
+Exposes the version string and core submodules (core, cli, gui) for external imports.
+"""
+
+__version__ = "1.0.1"

treeing-1.0.1/treeing/_release_defaults.py

@@ -0,0 +1,3 @@
+# Default locale for this release tree.
+# Set during release preparation; do not edit in the release repository.
+DEFAULT_LOCALE = 'en'

treeing-1.0.1/treeing/cli/__init__.py

@@ -0,0 +1,5 @@
+"""treeing/cli
+
+Command-line interface layer.
+Provides argument parsing, the help system, path validation, confirmation prompts, result reporting and the main entry point.
+"""

treeing-1.0.1/treeing/cli/confirm.py

@@ -0,0 +1,197 @@
+"""
+treeing/cli/confirm.py
+
+Defines the pre-write confirmation logic: interactive --confirm, headless
+--yes, and the TREEING_YES environment variable. Provides
+`gate_before_write` as the unified entry point, handling TTY detection,
+confirmation prompts and mode resolution.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from ..config import get_string
+from .io import cli_err, cli_out, cli_warn
+
+ENV_ASSUME_YES = 'TREEING_YES'
+
+
+def assume_yes_from_env() -> bool:
+    """
+    Check whether the TREEING_YES environment variable is truthy (1/true/yes/on).
+
+    Used by gate_before_write to auto-confirm in non-interactive or CI
+    environments; the check is case-insensitive.
+    """
+    val = os.environ.get(ENV_ASSUME_YES, '').strip().lower()
+    if not val:
+        return False
+    return val in ('1', 'true', 'yes', 'on')
+
+
+def is_interactive_tty() -> bool:
+    """
+    Return whether the current session is an interactive TTY (both stdin and stderr are ttys).
+
+    Only treats the session as interactive when both are ttys; returns False
+    under pipes or redirection.
+    """
+    return bool(sys.stdin.isatty() and sys.stderr.isatty())
+
+
+def read_yes_no(*, default: bool = False) -> bool:
+    """
+    Read a y/n answer from the user; the default is controlled by `default`.
+
+    Windows uses msvcrt; Unix uses /dev/tty.
+    """
+    suffix = '[Y/n] ' if default else '[y/N] '
+    cli_err(get_string('cli_confirm_prompt', suffix=suffix), end='')
+    if sys.platform == 'win32':
+        return _read_yes_no_windows(default=default)
+    return _read_yes_no_unix(default=default)
+
+
+def _read_yes_no_windows(*, default: bool) -> bool:
+    """
+    Read a single y/n character on Windows (no Enter needed).
+
+    Accepts only y/n; Enter falls back to the default; other keys keep waiting.
+    """
+    import msvcrt
+
+    while True:
+        ch = msvcrt.getwch()
+        if ch in '\r\n':
+            cli_err('')
+            return default
+        lower = ch.lower()
+        if lower in ('y', 'n'):
+            cli_err(ch)
+            return lower == 'y'
+
+
+def _read_yes_no_unix(*, default: bool) -> bool:
+    """
+    Read a line on Unix (via /dev/tty to avoid pipe interference).
+
+    Returns the default on a blank line or read failure; only the first
+    character is consulted.
+    """
+    try:
+        with open('/dev/tty', encoding='utf-8', errors='replace') as tty:
+            line = tty.readline()
+    except OSError:
+        return default
+    answer = line.strip().lower()
+    if not answer:
+        return default
+    return answer in ('y', 'yes')
+
+
+def warn_confirm_ignored_on_dry_run() -> None:
+    """
+    Warn that --confirm is ignored under --dry-run.
+
+    Because dry-run writes nothing, asking the user to confirm is pointless.
+    """
+    cli_warn(get_string('cli_confirm_dry_run_ignored'))
+
+
+def audit_yes_confirmed(*, path: str, node_count: int, quiet: bool) -> None:
+    """
+    In headless mode (--yes / env), print a confirmation summary.
+
+    Even though the interactive prompt is skipped, the log still shows
+    "confirmed: N nodes will be created".
+    """
+    if quiet:
+        return
+    cli_out(get_string('cli_confirm_yes_audit', count=node_count, path=path))
+
+
+def prompt_generate_confirm(
+    *,
+    path: str,
+    node_count: int,
+    fail_on_conflict: bool,
+    warn_count: int,
+) -> bool:
+    """
+    In interactive mode, print the generation confirmation prompt and read the user's answer.
+
+    Returns True if the user confirms, False if cancelled.
+    """
+    cli_err(get_string(
+        'cli_msg_generate_confirm',
+        path=path,
+        count=node_count,
+        conflict_hint=get_string(
+            'cli_confirm_conflict_enabled' if fail_on_conflict
+            else 'cli_confirm_conflict_disabled',
+        ),
+        warn_hint=get_string(
+            'cli_confirm_warn_count', count=warn_count,
+        ) if warn_count else get_string('cli_confirm_no_warnings'),
+    ))
+    return read_yes_no(default=False)
+
+
+def resolve_confirm_mode(args) -> str | None:
+    """
+    Resolve the confirmation mode from the arguments: yes / env / interactive / None.
+
+    Priority: --yes > TREEING_YES > --confirm.
+    """
+    if getattr(args, 'yes', False):
+        return 'yes'
+    if assume_yes_from_env():
+        return 'env'
+    if getattr(args, 'confirm', False):
+        return 'interactive'
+    return None
+
+
+def gate_before_write(
+    args,
+    *,
+    path: str,
+    node_count: int,
+    fail_on_conflict: bool,
+    warn_count: int,
+) -> tuple[int | None, str | None]:
+    """
+    Pre-write confirmation entry point.
+
+    Returns (early_exit_code, confirm_mode). A non-None early_exit_code means
+    the run should exit early and skip writing.
+    """
+    if args.dry_run:
+        if args.confirm:
+            warn_confirm_ignored_on_dry_run()
+        return None, None
+
+    mode = resolve_confirm_mode(args)
+    if mode in ('yes', 'env'):
+        audit_yes_confirmed(path=path, node_count=node_count, quiet=args.quiet)
+        return None, mode
+
+    if not args.confirm:
+        return None, None
+
+    if not is_interactive_tty():
+        cli_err(get_string('cli_error_confirm_not_tty'))
+        return 1, None
+
+    if not prompt_generate_confirm(
+        path=path,
+        node_count=node_count,
+        fail_on_conflict=fail_on_conflict,
+        warn_count=warn_count,
+    ):
+        cli_err(get_string('cli_confirm_cancelled'))
+        return 0, None
+
+    return None, 'interactive'