newtex-cli 0.1.1.dev1__tar.gz

newtex_cli-0.1.1.dev1/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*.so
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Virtual environments
+.venv/
+venv/
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+
+# Local environment files
+.env.*
+!.env
+!.env.example
+
+# PyPI credentials (never commit real tokens)
+.pypirc
+.pypirc.*
+!.pypirc.example
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/
+
+# Personal
+note.txt

newtex_cli-0.1.1.dev1/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: newtex-cli
+Version: 0.1.1.dev1
+Summary: Local LaTeX project scaffolder
+Project-URL: Homepage, https://example.internal/newtex
+Project-URL: Repository, https://example.internal/newtex/repo
+License: Proprietary
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: publish
+Requires-Dist: build>=1.2; extra == 'publish'
+Requires-Dist: twine>=5.0; extra == 'publish'
+Description-Content-Type: text/markdown
+
+<h1 align="center">newtex-cli</h1>
+
+<p align="center">Scaffold local LaTeX projects from reusable templates.</p>
+
+## 1. Installation
+
+```bash
+pipx install newtex-scaffold
+```
+
+## 2. Configuration
+
+### 2.1 Local environment file
+
+Create `.env.local` in the project root:
+
+```bash
+NEWTEX_DEFAULT_TEMPLATE=acm
+NEWTEX_TEMPLATE_ACM_PATH=/path/to/your/acm-template
+```
+
+### 2.2 Global template config (recommended)
+
+Configure templates once and use `newtex` from anywhere:
+
+```bash
+newtex --template-set acm=/absolute/path/or/url/to/template
+newtex --set-default-template acm
+newtex --templates-list
+```
+
+This writes to `~/.config/newtex/templates.yml`.
+
+## 3. CLI Commands
+
+### 3.1 Command reference
+
+| Command | Description |
+| --- | --- |
+| `newtex --help` | Show CLI help |
+| `newtex --tests` | Run the full test suite |
+| `newtex --publish-check` | Validate build/upload prerequisites |
+| `newtex --template-set <alias>=<path-or-url>` | Add or update a global template alias |
+| `newtex --template-set <alias>=<path-or-url> --template-description "..."` | Add alias with description |
+| `newtex --set-default-template <alias>` | Set the global default template alias |
+| `newtex --templates-list` | Show configured global templates |
+| `newtex` | Start interactive project creation |
+| `newtex <project-name> <template>` | Create a project in non-interactive mode |
+| `newtex <project-name> <template> --no-git` | Skip `git init` |
+| `newtex <project-name> <template> --track-pdf` | Keep compiled PDFs tracked |
+| `newtex <project-name> <template> --no-vscode` | Exclude shared `.vscode/` settings |
+| `newtex <project-name> <template> --open` | Open generated project in VS Code |
+
+### 3.2 Quick examples
+
+```bash
+newtex --help
+newtex
+newtex exlang-paper acm
+newtex exlang-paper acm --no-git
+newtex exlang-paper acm --track-pdf
+newtex exlang-paper acm --no-vscode
+newtex exlang-paper acm --open
+```
+
+<details>
+<summary><strong>Advanced commands</strong></summary>
+
+```bash
+newtex --tests
+newtex --publish-check
+newtex --template-set acm=/absolute/path/to/template
+newtex --set-default-template acm
+newtex --templates-list
+```
+
+</details>
+
+## 4. Notes
+
+- Project names must be lowercase kebab-case (example: `exlang-paper`).
+- If a template path is invalid, the CLI exits with an error message.
+
+## 5. Build & Publish
+
+### 5.1 Build distributions
+
+```bash
+python -m pip install -e ".[publish]"
+newtex --publish-check
+python -m build
+```
+
+### 5.2 Upload to PyPI
+
+You need a PyPI account to publish public packages.
+
+Set token-based auth (recommended):
+
+```bash
+export TWINE_USERNAME=__token__
+export TWINE_PASSWORD=<your-pypi-api-token>
+```
+
+```bash
+python -m twine upload dist/*
+```
+
+### 5.3 Install on another Mac
+
+```bash
+pipx install newtex-scaffold
+```
+
+Then configure templates on that machine:
+
+```bash
+newtex --template-set acm=/absolute/path/or/url/to/template
+newtex --set-default-template acm
+```

newtex_cli-0.1.1.dev1/README.md

@@ -0,0 +1,120 @@
+<h1 align="center">newtex-cli</h1>
+
+<p align="center">Scaffold local LaTeX projects from reusable templates.</p>
+
+## 1. Installation
+
+```bash
+pipx install newtex-scaffold
+```
+
+## 2. Configuration
+
+### 2.1 Local environment file
+
+Create `.env.local` in the project root:
+
+```bash
+NEWTEX_DEFAULT_TEMPLATE=acm
+NEWTEX_TEMPLATE_ACM_PATH=/path/to/your/acm-template
+```
+
+### 2.2 Global template config (recommended)
+
+Configure templates once and use `newtex` from anywhere:
+
+```bash
+newtex --template-set acm=/absolute/path/or/url/to/template
+newtex --set-default-template acm
+newtex --templates-list
+```
+
+This writes to `~/.config/newtex/templates.yml`.
+
+## 3. CLI Commands
+
+### 3.1 Command reference
+
+| Command | Description |
+| --- | --- |
+| `newtex --help` | Show CLI help |
+| `newtex --tests` | Run the full test suite |
+| `newtex --publish-check` | Validate build/upload prerequisites |
+| `newtex --template-set <alias>=<path-or-url>` | Add or update a global template alias |
+| `newtex --template-set <alias>=<path-or-url> --template-description "..."` | Add alias with description |
+| `newtex --set-default-template <alias>` | Set the global default template alias |
+| `newtex --templates-list` | Show configured global templates |
+| `newtex` | Start interactive project creation |
+| `newtex <project-name> <template>` | Create a project in non-interactive mode |
+| `newtex <project-name> <template> --no-git` | Skip `git init` |
+| `newtex <project-name> <template> --track-pdf` | Keep compiled PDFs tracked |
+| `newtex <project-name> <template> --no-vscode` | Exclude shared `.vscode/` settings |
+| `newtex <project-name> <template> --open` | Open generated project in VS Code |
+
+### 3.2 Quick examples
+
+```bash
+newtex --help
+newtex
+newtex exlang-paper acm
+newtex exlang-paper acm --no-git
+newtex exlang-paper acm --track-pdf
+newtex exlang-paper acm --no-vscode
+newtex exlang-paper acm --open
+```
+
+<details>
+<summary><strong>Advanced commands</strong></summary>
+
+```bash
+newtex --tests
+newtex --publish-check
+newtex --template-set acm=/absolute/path/to/template
+newtex --set-default-template acm
+newtex --templates-list
+```
+
+</details>
+
+## 4. Notes
+
+- Project names must be lowercase kebab-case (example: `exlang-paper`).
+- If a template path is invalid, the CLI exits with an error message.
+
+## 5. Build & Publish
+
+### 5.1 Build distributions
+
+```bash
+python -m pip install -e ".[publish]"
+newtex --publish-check
+python -m build
+```
+
+### 5.2 Upload to PyPI
+
+You need a PyPI account to publish public packages.
+
+Set token-based auth (recommended):
+
+```bash
+export TWINE_USERNAME=__token__
+export TWINE_PASSWORD=<your-pypi-api-token>
+```
+
+```bash
+python -m twine upload dist/*
+```
+
+### 5.3 Install on another Mac
+
+```bash
+pipx install newtex-scaffold
+```
+
+Then configure templates on that machine:
+
+```bash
+newtex --template-set acm=/absolute/path/or/url/to/template
+newtex --set-default-template acm
+```

newtex_cli-0.1.1.dev1/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["hatchling>=1.27", "hatch-vcs>=0.4"]
+build-backend = "hatchling.build"
+
+[project]
+name = "newtex-cli"
+dynamic = ["version"]
+description = "Local LaTeX project scaffolder"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "Proprietary"}
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.11",
+  "Environment :: Console",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "typer>=0.12",
+  "questionary>=2.0",
+  "pyyaml>=6.0",
+  "python-dotenv>=1.0",
+  "rich>=13.7",
+]
+
+[project.scripts]
+newtex = "newtex.cli:app"
+
+[project.urls]
+Homepage = "https://example.internal/newtex"
+Repository = "https://example.internal/newtex/repo"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.version.raw-options]
+version_scheme = "python-simplified-semver"
+local_scheme = "no-local-version"
+fallback_version = "0.1.0"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/newtex"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src/newtex",
+  "/pyproject.toml",
+]
+
+[tool.hatch.build]
+include = [
+  "src/newtex/resources/gitignore/*.gitignore",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0",
+]
+publish = [
+  "build>=1.2",
+  "twine>=5.0",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

newtex_cli-0.1.1.dev1/src/newtex/__init__.py

@@ -0,0 +1 @@
+__all__ = []

newtex_cli-0.1.1.dev1/src/newtex/cli.py

@@ -0,0 +1,303 @@
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+import questionary
+import typer
+from questionary import Style
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+from .config import load_config, set_default_template, upsert_template
+from .scaffold import scaffold_project
+from .validators import is_kebab_case, suggest_kebab_case
+
+app = typer.Typer(help="Create local LaTeX projects from templates.")
+console = Console()
+PROMPT_STYLE = Style(
+    [
+        ("qmark", "fg:#8b5cf6 bold"),
+        ("question", "bold"),
+        ("answer", "fg:#22c55e bold"),
+        ("pointer", "fg:#06b6d4 bold"),
+        ("highlighted", "fg:#06b6d4 bold"),
+        ("selected", "fg:#22c55e"),
+    ]
+)
+
+
+def _show_banner() -> None:
+    title = Text("newtex", style="bold magenta")
+    subtitle = Text("Create local LaTeX projects from templates", style="cyan")
+    console.print(Panel.fit(Text.assemble(title, "\n", subtitle), border_style="magenta"))
+
+
+def _info(message: str) -> None:
+    console.print(f"[cyan]•[/cyan] {message}")
+
+
+def _success(message: str) -> None:
+    console.print(f"[green]✔[/green] {message}")
+
+
+def _error(message: str) -> None:
+    console.print(f"[bold red]✖ {message}[/bold red]")
+
+
+def _run_tests() -> int:
+    local_venv_python = Path(".venv/bin/python")
+    command = [str(local_venv_python), "-m", "pytest", "-q"] if local_venv_python.exists() else ["pytest", "-q"]
+
+    try:
+        result = subprocess.run(command, check=False)
+    except FileNotFoundError:
+        result = subprocess.run([sys.executable, "-m", "pytest", "-q"], check=False)
+
+    return result.returncode
+
+
+def _run_publish_check() -> int:
+    checks_ok = True
+
+    python_candidates = []
+    local_venv_python = Path(".venv/bin/python")
+    if local_venv_python.exists():
+        python_candidates.append(str(local_venv_python))
+    python_candidates.append(sys.executable)
+
+    if shutil.which("pipx"):
+        _success("pipx is available")
+    else:
+        _error("pipx is not available (recommended for global install)")
+        checks_ok = False
+
+    build_available = False
+    for python_exec in python_candidates:
+        try:
+            build_check = subprocess.run([python_exec, "-m", "build", "--version"], check=False)
+            if build_check.returncode == 0:
+                build_available = True
+                break
+        except Exception:
+            continue
+
+    if build_available:
+        _success("python -m build is available")
+    else:
+        _error("python -m build is not available (install with: python -m pip install -e '.[publish]')")
+        checks_ok = False
+
+    twine_available = False
+    for python_exec in python_candidates:
+        try:
+            twine_check = subprocess.run([python_exec, "-m", "twine", "--version"], check=False)
+            if twine_check.returncode == 0:
+                twine_available = True
+                break
+        except Exception:
+            continue
+
+    if twine_available:
+        _success("twine is available")
+    else:
+        _error("twine is not available (install with: python -m pip install -e '.[publish]')")
+        checks_ok = False
+
+    token_present = bool(os.getenv("TWINE_PASSWORD"))
+    username = os.getenv("TWINE_USERNAME", "")
+    trusted_publishing = bool(os.getenv("PYPI_API_TOKEN"))
+
+    if token_present and username == "__token__":
+        _success("Twine token credentials detected (TWINE_USERNAME/TWINE_PASSWORD)")
+    elif trusted_publishing:
+        _info("PYPI_API_TOKEN found (if your flow uses this env var)")
+    else:
+        _info("No publish token detected. Set TWINE_USERNAME=__token__ and TWINE_PASSWORD=<pypi-token> before upload")
+
+    if checks_ok:
+        _success("Publish check passed")
+        return 0
+
+    _error("Publish check failed")
+    return 1
+
+
+def _parse_template_set(value: str) -> tuple[str, str]:
+    if "=" not in value:
+        raise typer.BadParameter("--template-set must be in the form <alias>=<path-or-url>")
+
+    alias, template_value = value.split("=", 1)
+    alias = alias.strip()
+    template_value = template_value.strip()
+
+    if not alias:
+        raise typer.BadParameter("Template alias cannot be empty")
+    if not template_value:
+        raise typer.BadParameter("Template path/url cannot be empty")
+
+    return alias, template_value
+
+
+def _pick_template(cfg: dict, template_arg: str | None) -> str:
+    templates = cfg["templates"]
+
+    if template_arg:
+        if template_arg not in templates:
+            raise typer.BadParameter(f"Unknown template '{template_arg}'. Available: {', '.join(templates.keys())}")
+        return template_arg
+
+    choices = [
+        questionary.Choice(title=f"{alias} ({meta.get('description', '')})", value=alias)
+        for alias, meta in templates.items()
+    ]
+
+    selected = questionary.select(
+        "Which template should I use?",
+        choices=choices,
+        default=cfg.get("default_template", "acm"),
+        style=PROMPT_STYLE,
+    ).ask()
+
+    if not selected:
+        raise typer.Exit(code=1)
+
+    return selected
+
+
+def _get_project_name(name_arg: str | None) -> str:
+    if name_arg:
+        if not is_kebab_case(name_arg):
+            raise typer.BadParameter("Project name must be lowercase kebab-case (e.g. exlang-paper)")
+        return name_arg
+
+    while True:
+        raw = questionary.text("What is your project name?", style=PROMPT_STYLE).ask()
+        if not raw:
+            raise typer.Exit(code=1)
+
+        if is_kebab_case(raw):
+            return raw
+
+        suggested = suggest_kebab_case(raw)
+        use_suggested = questionary.confirm(f'Use "{suggested}" instead?', style=PROMPT_STYLE).ask()
+
+        if use_suggested:
+            return suggested
+
+
+@app.command()
+def main(
+    project_name: str | None = typer.Argument(None, help="Project folder name (kebab-case)"),
+    template: str | None = typer.Argument(None, help="Template alias, e.g. acm"),
+    tests: bool = typer.Option(False, "--tests", help="Run full test suite and exit"),
+    publish_check: bool = typer.Option(False, "--publish-check", help="Validate publishing prerequisites and exit"),
+    templates_list: bool = typer.Option(False, "--templates-list", help="List configured templates and exit"),
+    template_set: str | None = typer.Option(None, "--template-set", help="Set template alias/path using alias=path-or-url"),
+    set_default: str | None = typer.Option(None, "--set-default-template", help="Set default template alias and exit"),
+    template_desc: str | None = typer.Option(None, "--template-description", help="Description used with --template-set"),
+    no_git: bool = typer.Option(False, "--no-git", help="Do not run git init"),
+    track_pdf: bool = typer.Option(False, "--track-pdf", help="Track compiled PDFs in git"),
+    no_vscode: bool = typer.Option(False, "--no-vscode", help="Do not keep shared .vscode settings"),
+    open_code: bool = typer.Option(False, "--open", help="Open in VS Code after creation"),
+) -> None:
+    _show_banner()
+
+    if tests:
+        if project_name or template:
+            raise typer.BadParameter("Do not pass PROJECT_NAME or TEMPLATE with --tests")
+
+        _info("Running full test suite")
+        test_exit_code = _run_tests()
+        if test_exit_code == 0:
+            _success("All tests passed")
+            return
+
+        _error("Test run failed")
+        raise typer.Exit(code=test_exit_code)
+
+    if publish_check:
+        if project_name or template:
+            raise typer.BadParameter("Do not pass PROJECT_NAME or TEMPLATE with --publish-check")
+
+        _info("Running publish readiness checks")
+        publish_exit_code = _run_publish_check()
+        if publish_exit_code != 0:
+            raise typer.Exit(code=publish_exit_code)
+        return
+
+    if template_set:
+        if project_name or template:
+            raise typer.BadParameter("Do not pass PROJECT_NAME or TEMPLATE with --template-set")
+
+        alias, template_value = _parse_template_set(template_set)
+        upsert_template(alias=alias, template_path=template_value, description=template_desc)
+        _success(f"Saved template alias '{alias}'")
+        return
+
+    if set_default:
+        if project_name or template:
+            raise typer.BadParameter("Do not pass PROJECT_NAME or TEMPLATE with --set-default-template")
+
+        try:
+            set_default_template(set_default)
+        except KeyError as error:
+            _error(str(error))
+            raise typer.Exit(code=1)
+
+        _success(f"Default template set to '{set_default}'")
+        return
+
+    if templates_list:
+        if project_name or template:
+            raise typer.BadParameter("Do not pass PROJECT_NAME or TEMPLATE with --templates-list")
+
+        cfg = load_config()
+        templates = cfg.get("templates", {})
+        default_alias = cfg.get("default_template")
+
+        if not templates:
+            _info("No templates configured")
+            return
+
+        _info("Configured templates")
+        for alias, meta in templates.items():
+            marker = " (default)" if alias == default_alias else ""
+            path_value = meta.get("path", "")
+            description = meta.get("description", "")
+            _info(f"{alias}{marker} -> {path_value} ({description})")
+        return
+
+    cfg = load_config()
+
+    name = _get_project_name(project_name)
+    template_alias = _pick_template(cfg, template)
+    template_path = cfg["templates"][template_alias]["path"]
+    _info(f"Template: [bold]{template_alias}[/bold]")
+    _info(f"Target project: [bold]{name}[/bold]")
+
+    if not Path(template_path).exists():
+        _error(f"Template path not found: {template_path}")
+        raise typer.Exit(code=1)
+
+    try:
+        with console.status("[bold cyan]Scaffolding project...[/bold cyan]"):
+            scaffold_project(
+                template_path=template_path,
+                project_name=name,
+                init_git=not no_git,
+                track_pdf=track_pdf,
+                share_vscode=not no_vscode,
+                open_code=open_code,
+            )
+    except Exception as error:
+        _error(f"Error: {error}")
+        raise typer.Exit(code=1)
+
+    _success(f"Done. Created ./{name} using template '{template_alias}'")
+
+
+if __name__ == "__main__":
+    app()

newtex_cli-0.1.1.dev1/src/newtex/config.py

@@ -0,0 +1,104 @@
+import os
+from pathlib import Path
+
+import yaml
+from dotenv import load_dotenv
+
+CONFIG_DIR = Path.home() / ".config" / "newtex"
+CONFIG_FILE = CONFIG_DIR / "templates.yml"
+ACM_TEMPLATE_ENV = "NEWTEX_TEMPLATE_ACM_PATH"
+DEFAULT_TEMPLATE_ENV = "NEWTEX_DEFAULT_TEMPLATE"
+
+
+def _load_environment() -> None:
+    load_dotenv(override=False)
+    load_dotenv(Path.cwd() / ".env.local", override=True)
+
+
+def _default_config() -> dict:
+    return {
+        "default_template": os.getenv(DEFAULT_TEMPLATE_ENV, "acm"),
+        "templates": {
+            "acm": {
+                "path": os.getenv(ACM_TEMPLATE_ENV, ""),
+                "description": "ACM Conference Proceedings Primary Article",
+            }
+        },
+    }
+
+
+def _apply_env_overrides(config: dict) -> dict:
+    default_template = os.getenv(DEFAULT_TEMPLATE_ENV)
+    acm_path = os.getenv(ACM_TEMPLATE_ENV)
+
+    if default_template:
+        config["default_template"] = default_template
+
+    templates = config.setdefault("templates", {})
+    acm_template = templates.setdefault(
+        "acm",
+        {
+            "path": "",
+            "description": "ACM Conference Proceedings Primary Article",
+        },
+    )
+
+    if acm_path:
+        acm_template["path"] = acm_path
+
+    return config
+
+
+def ensure_config() -> None:
+    _load_environment()
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    if not CONFIG_FILE.exists():
+        with open(CONFIG_FILE, "w", encoding="utf-8") as file:
+            yaml.safe_dump(_default_config(), file, sort_keys=False)
+
+
+def load_persisted_config() -> dict:
+    ensure_config()
+    with open(CONFIG_FILE, "r", encoding="utf-8") as file:
+        return yaml.safe_load(file) or {}
+
+
+def save_config(config: dict) -> None:
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    with open(CONFIG_FILE, "w", encoding="utf-8") as file:
+        yaml.safe_dump(config, file, sort_keys=False)
+
+
+def upsert_template(alias: str, template_path: str, description: str | None = None) -> dict:
+    config = load_persisted_config()
+    templates = config.setdefault("templates", {})
+    existing = templates.get(alias, {})
+
+    templates[alias] = {
+        "path": template_path,
+        "description": description if description is not None else existing.get("description", ""),
+    }
+
+    if "default_template" not in config:
+        config["default_template"] = alias
+
+    save_config(config)
+    return config
+
+
+def set_default_template(alias: str) -> dict:
+    config = load_persisted_config()
+    templates = config.get("templates", {})
+    if alias not in templates:
+        raise KeyError(f"Unknown template alias: {alias}")
+
+    config["default_template"] = alias
+    save_config(config)
+    return config
+
+
+def load_config() -> dict:
+    _load_environment()
+    config = load_persisted_config()
+
+    return _apply_env_overrides(config)

newtex_cli-0.1.1.dev1/src/newtex/gitignore_utils.py

@@ -0,0 +1,31 @@
+from pathlib import Path
+import importlib.resources as pkg_resources
+
+
+def _read_base_gitignore() -> str:
+    from newtex import resources
+
+    return pkg_resources.files(resources).joinpath("gitignore/tex-base.gitignore").read_text(encoding="utf-8")
+
+
+def apply_gitignore(project_dir: Path, track_pdf: bool, share_vscode: bool) -> None:
+    gitignore_path = project_dir / ".gitignore"
+
+    base_content = _read_base_gitignore().strip() + "\n"
+
+    extras = []
+    if not track_pdf:
+        extras.append("*.pdf")
+    if not share_vscode:
+        extras.append(".vscode/")
+
+    extra_content = ""
+    if extras:
+        extra_content = "\n# newtex preferences\n" + "\n".join(extras) + "\n"
+
+    if gitignore_path.exists():
+        existing = gitignore_path.read_text(encoding="utf-8")
+        merged = existing.rstrip() + "\n\n# --- newtex additions ---\n" + base_content + extra_content
+        gitignore_path.write_text(merged, encoding="utf-8")
+    else:
+        gitignore_path.write_text(base_content + extra_content, encoding="utf-8")

newtex_cli-0.1.1.dev1/src/newtex/resources/__init__.py

@@ -0,0 +1 @@
+__all__ = []

newtex_cli-0.1.1.dev1/src/newtex/resources/gitignore/tex-base.gitignore

@@ -0,0 +1,47 @@
+# macOS
+.DS_Store
+
+# LaTeX intermediate files
+*.aux
+*.bbl
+*.bcf
+*.blg
+*.fdb_latexmk
+*.fls
+*.lof
+*.log
+*.lot
+*.out
+*.run.xml
+*.synctex.gz
+*.toc
+*.xdv
+
+# Bibliography / indexing extras
+*.acn
+*.acr
+*.alg
+*.glg
+*.glo
+*.gls
+*.idx
+*.ilg
+*.ind
+*.ist
+
+# Latexmk / temp
+_latexmk*
+latexmk*.log
+
+# Minted / pygments
+_minted*
+*.pyg
+
+# Build dirs (common)
+build/
+out/
+
+# Editor extras
+.idea/
+__pycache__/
+.venv/

newtex_cli-0.1.1.dev1/src/newtex/scaffold.py

@@ -0,0 +1,37 @@
+from pathlib import Path
+import subprocess
+
+from .gitignore_utils import apply_gitignore
+
+
+def run_cmd(cmd: list[str], cwd: Path | None = None) -> None:
+    result = subprocess.run(cmd, cwd=str(cwd) if cwd else None, check=False)
+    if result.returncode != 0:
+        raise RuntimeError(f"Command failed: {' '.join(cmd)}")
+
+
+def scaffold_project(
+    template_path: str,
+    project_name: str,
+    init_git: bool = True,
+    track_pdf: bool = False,
+    share_vscode: bool = True,
+    open_code: bool = False,
+) -> None:
+    project_dir = Path.cwd() / project_name
+
+    if project_dir.exists():
+        raise FileExistsError(f"Target folder already exists: {project_dir}")
+
+    run_cmd(["copier", "copy", template_path, project_name])
+
+    apply_gitignore(project_dir, track_pdf=track_pdf, share_vscode=share_vscode)
+
+    if init_git:
+        run_cmd(["git", "init"], cwd=project_dir)
+
+    if open_code:
+        try:
+            run_cmd(["code", "."], cwd=project_dir)
+        except (FileNotFoundError, RuntimeError):
+            pass

newtex_cli-0.1.1.dev1/src/newtex/validators.py

@@ -0,0 +1,14 @@
+import re
+
+KEBAB_CASE_PATTERN = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")
+
+
+def is_kebab_case(name: str) -> bool:
+    return bool(KEBAB_CASE_PATTERN.fullmatch(name))
+
+
+def suggest_kebab_case(name: str) -> str:
+    s = name.strip().lower()
+    s = re.sub(r"[^a-z0-9]+", "-", s)
+    s = re.sub(r"-+", "-", s).strip("-")
+    return s