Metadata-Version: 2.4
Name: jps-cookiecutter-utils
Version: 0.4.0
Summary: Bootstrap utility to create new Python projects with standardized structure, templates, and configuration.
Author-email: Jaideep Sundaram <jsundaram@baylorgenetics.com>
License: MIT
Project-URL: Homepage, https://github.com/jai-python3/jps-cookiecutter-utils
Project-URL: Repository, https://github.com/jai-python3/jps-cookiecutter-utils
Project-URL: Issues, https://github.com/jai-python3/jps-cookiecutter-utils/issues
Keywords: cookiecutter,bootstrap,project-generator,automation
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12.3
Provides-Extra: dev
Requires-Dist: flake8>=7.0.0; extra == "dev"
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: build>=1.2.1; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
Requires-Dist: isort>=5.13.0; extra == "dev"
Requires-Dist: codecov>=2.1.13; extra == "dev"
Requires-Dist: autoflake>=2.3.1; extra == "dev"
Requires-Dist: pre-commit>=3.8.0; extra == "dev"
Requires-Dist: bandit>=1.7.9; extra == "dev"
Requires-Dist: vulture>=2.11; extra == "dev"
Requires-Dist: flynt>=1.0.1; extra == "dev"
Requires-Dist: pydocstyle>=6.3.0; extra == "dev"
Requires-Dist: darglint>=1.8.1; extra == "dev"
Requires-Dist: mypy>=1.12.1; extra == "dev"
Requires-Dist: bump-my-version>=1.0.1; extra == "dev"
Requires-Dist: git-changelog>=2.7.0; extra == "dev"
Dynamic: license-file

# jps-cookiecutter-utils

![Build](https://github.com/jai-python3/jps-cookiecutter-utils/actions/workflows/test.yml/badge.svg)
![Publish to PyPI](https://github.com/jai-python3/jps-cookiecutter-utils/actions/workflows/publish-to-pypi.yml/badge.svg)
[![codecov](https://codecov.io/gh/jai-python3/jps-cookiecutter-utils/branch/main/graph/badge.svg)](https://codecov.io/gh/jai-python3/jps-cookiecutter-utils)

## 🚀 Overview

**jps-cookiecutter-utils** is a Python-based bootstrapping utility designed to create new code
repositories with a standardized structure, metadata, and configuration files.  
It automates directory creation, file copying, placeholder substitution, and logging,
ensuring uniformity across all your projects.

---

## ✨ Features

- 🚀 Bootstrap new projects from a unified `templates/` directory
- 📁 Create consistent directory layouts automatically
- 🧩 Replace placeholders in files using CLI or input file values
- 🧠 Interactive prompts for missing fields
- 🪵 Comprehensive logging with separated INFO/WARNING levels
- 🎨 Emoji-based verbose progress display
- ⚙️ Typer-powered CLI for intuitive commands

---

## 🧰 Example Usage

```bash
python src/scripts/bootstrap.py \
  --outdir . \
  --code-repository jps-azure-utils \
  --author "Jaideep Sundaram" \
  --author-email jai.python3@gmail.com \
  --code-repo-org jai-python3 \
  --code-repo-summary "Utilities for interacting with Microsoft Azure services." \
  --infile bootstrap.txt \
  --verbose
```

This command creates a new project under `./jps-azure-utils/` with all template files properly substituted.

---

## 📦 Installation

```bash
make install
```

---

## 🧪 Development

```bash
make install-build-tools
make fix && make format && make lint
make test
```

For detailed developer documentation, see [README_DEV.md](./README_DEV.md).

---

## 📜 License

MIT License © Jaideep Sundaram
