Metadata-Version: 2.5
Name: GJDutils
Version: 0.6.3
Summary: A collection of useful utility functions (basics, data science/AI, web development, etc)
Project-URL: Homepage, https://github.com/gregdetre/gjdutils
Project-URL: Repository, https://github.com/gregdetre/gjdutils
Author-email: Greg Detre <greg@gregdetre.com>
License-File: LICENSE
Keywords: ai,data science,dates,llm,strings,utilities,web development
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: ipython
Requires-Dist: jinja2
Requires-Dist: pydantic
Requires-Dist: python-dotenv
Requires-Dist: rich
Requires-Dist: six
Requires-Dist: typer
Provides-Extra: all-no-dev
Requires-Dist: anthropic; extra == 'all-no-dev'
Requires-Dist: azure-cognitiveservices-speech; extra == 'all-no-dev'
Requires-Dist: bs4; extra == 'all-no-dev'
Requires-Dist: elevenlabs>=2.1.0; extra == 'all-no-dev'
Requires-Dist: google-cloud-texttospeech; extra == 'all-no-dev'
Requires-Dist: google-cloud-translate; extra == 'all-no-dev'
Requires-Dist: humanize; extra == 'all-no-dev'
Requires-Dist: lxml; extra == 'all-no-dev'
Requires-Dist: numpy; extra == 'all-no-dev'
Requires-Dist: openai; extra == 'all-no-dev'
Requires-Dist: openai-whisper; extra == 'all-no-dev'
Requires-Dist: pandas; extra == 'all-no-dev'
Requires-Dist: pendulum; extra == 'all-no-dev'
Requires-Dist: pillow; extra == 'all-no-dev'
Requires-Dist: playsound; extra == 'all-no-dev'
Requires-Dist: pyaudio; extra == 'all-no-dev'
Requires-Dist: pygame; extra == 'all-no-dev'
Requires-Dist: python-vlc; extra == 'all-no-dev'
Requires-Dist: speechrecognition; extra == 'all-no-dev'
Provides-Extra: audio-lang
Requires-Dist: azure-cognitiveservices-speech; extra == 'audio-lang'
Requires-Dist: elevenlabs>=2.1.0; extra == 'audio-lang'
Requires-Dist: google-cloud-texttospeech; extra == 'audio-lang'
Requires-Dist: google-cloud-translate; extra == 'audio-lang'
Requires-Dist: openai-whisper; extra == 'audio-lang'
Requires-Dist: playsound; extra == 'audio-lang'
Requires-Dist: pyaudio; extra == 'audio-lang'
Requires-Dist: pygame; extra == 'audio-lang'
Requires-Dist: python-vlc; extra == 'audio-lang'
Requires-Dist: speechrecognition; extra == 'audio-lang'
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: build; extra == 'dev'
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: rich; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Requires-Dist: typer; extra == 'dev'
Requires-Dist: wheel; extra == 'dev'
Provides-Extra: dsci
Requires-Dist: numpy; extra == 'dsci'
Requires-Dist: pandas; extra == 'dsci'
Provides-Extra: dt
Requires-Dist: humanize; extra == 'dt'
Requires-Dist: pendulum; extra == 'dt'
Provides-Extra: html-web
Requires-Dist: bs4; extra == 'html-web'
Requires-Dist: lxml; extra == 'html-web'
Provides-Extra: llm
Requires-Dist: anthropic; extra == 'llm'
Requires-Dist: openai; extra == 'llm'
Requires-Dist: pillow; extra == 'llm'
Description-Content-Type: text/markdown

# gjdutils

A comprehensive toolkit for highly effective AI-assisted programming, containing three complementary resource sets:

## 🤖 AI-Assisted Programming Templates

**[docs/](docs/)** - Battle-tested workflows and instructions for AI development

A complete collection of templates, modes, and processes for working effectively with AI coding assistants like Claude Code and Cursor. These have been refined through real-world usage and provide:

- **Structured workflows** for planning, implementing, and maintaining code
- **Specialized modes** for different types of development work (sounding board, detective, surgeon)
- **Documentation practices** that scale with your project
- **Git workflows** optimized for AI collaboration

**Quick start**: See [docs/WORKFLOW.md](docs/WORKFLOW.md) for the complete development workflow.

## 🐍 Python Utilities

**[src/gjdutils/](src/gjdutils/)** - Production-ready Python utilities and tools

A curated collection of Python utilities for common development tasks including:

- Data science helpers and collection utilities
- LLM integration tools (Claude, OpenAI)
- File processing and automation scripts
- Development workflow tools

**Quick start**: `pip install gjdutils` (see [src/gjdutils/README.md](src/gjdutils/README.md))

## ⚒️ TypeScript Utilities

**[src/ts/](src/ts/)** - Cross-platform TypeScript tools and CLI utilities

A collection of battle-tested TypeScript utilities ported from real-world development workflows:

- **CLI tools** for date generation, conversation extraction, and code analysis
- **Git worktree sync** scripts for managing parallel development branches
- **LLM critique tools** for automated planning document review
- **Development utilities** like line counting and file processing

**Quick start**: See [src/ts/README.md](src/ts/README.md) for installation and usage examples

## Why gjdutils?

All components are designed around the principle of **making AI-assisted development more effective**:

- The **templates** provide the structure and process for working with AI assistants
- The **Python utilities** handle data science and LLM integration tasks
- The **TypeScript utilities** provide cross-platform development workflow tools

Whether you're building prototypes or production systems, gjdutils helps you work faster and more reliably with AI assistance.

## License

MIT License - see [LICENSE](LICENSE) for details.