Metadata-Version: 2.4
Name: gtasks-cli
Version: 0.1.2
Summary: A powerful command-line interface for managing Google Tasks with enhanced features and functionality which is secure and easy to use with advanced features.
Project-URL: Homepage, https://github.com/example/gtasks-cli
Project-URL: Bug Reports, https://github.com/example/gtasks-cli/issues
Project-URL: Source, https://github.com/example/gtasks-cli
Author-email: Google Tasks CLI Team <example@example.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.7
Requires-Dist: appdirs>=1.4.4
Requires-Dist: click>=8.1.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: cryptography>=41.0.0
Requires-Dist: google-api-python-client>=2.0
Requires-Dist: google-auth-oauthlib>=1.0.0
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dateutil>=2.8.0
Requires-Dist: pytz>=2023.3
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: tabulate>=0.9.0
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: pytest>=6.0; extra == 'dev'
Description-Content-Type: text/markdown

# Google Tasks CLI Development

This directory contains the source code for the Google Tasks CLI application. 

For general usage, we recommend installing the package from PyPI:
```bash
pip install gtasks-cli
```

See the main project [README.md](../README.md) for more information on installation and usage.

## Features

- Full Google Tasks API integration with OAuth2 authentication
- Advanced filtering and search capabilities
- Context management for different task views
- Reporting and analytics
- Time tracking and Pomodoro technique integration
- Recurring tasks and dependencies
- Offline mode with synchronization
- Import/export functionality
- [Optimized Advanced Sync](https://github.com/sirusdas/gtasks-terminal/blob/main/ADVANCED_SYNC_OPTIMIZATION.md) for improved performance
- Multi-account support
- Interactive mode with keyboard navigation
- Task deduplication
- Rich terminal UI with color coding

## Installation for Development

To set up the development environment:

```bash
# Clone the repository
git clone <repository-url>
cd gtasks_automation/gtasks_cli

# Create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .
```

## Running Tests

Various test scripts are available in the root directory:

```bash
# Run a simple sync test
python simple_sync_test.py

# Run comprehensive duplication tests
python comprehensive_dup_test.py
```

## Usage During Development

During development, you can run the CLI directly:

```bash
python -m gtasks_cli.main --help
```

Common development commands:

```bash
# Enter interactive mode for a rich, keyboard-driven interface
python -m gtasks_cli.main interactive

# List tasks
python -m gtasks_cli.main list

# Add a new task
python -m gtasks_cli.main add "Buy groceries" --due "tomorrow"

# Mark task as done
python -m gtasks_cli.main done <task-id>

# Sync with Google Tasks
python -m gtasks_cli.main sync
```

## Production Installation

For production use, install the package from PyPI:

```bash
pip install gtasks-cli
```

Then use the `gtasks` command directly:

```bash
gtasks --help
```

## Development

This project follows a modular architecture with clear separation of concerns:
- **CLI Layer**: Command-line interface using Click framework
- **Core Layer**: Business logic for task and tasklist management
- **Integration Layer**: Google Tasks API integration and authentication
- **Storage Layer**: Local caching and configuration management
- **Reporting Layer**: Analytics and reporting functionality

## License

MIT