Metadata-Version: 2.4
Name: appdevcommons
Version: 0.1.1
Summary: A collection of common utilities and functionalities for Python applications
Author-email: Your Name <your.email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/yourusername/appdevcommons
Project-URL: Documentation, https://github.com/yourusername/appdevcommons#readme
Project-URL: Repository, https://github.com/yourusername/appdevcommons
Project-URL: Issues, https://github.com/yourusername/appdevcommons/issues
Keywords: utilities,common,helpers,tools
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Dynamic: license-file

# AppDevCommons

A collection of common utilities and functionalities for Python applications.

## Installation

### From Source

```bash
# Clone the repository
git clone https://github.com/yourusername/appdevcommons.git
cd appdevcommons

# Install in editable mode for development
pip install -e .

# Or install with development dependencies
pip install -e ".[dev]"
```

### Using pip

```bash
pip install appdevcommons
```

## Development Setup

1. **Create a virtual environment:**
   ```bash
   python3 -m venv venv
   source venv/bin/activate
   ```

2. **Install development dependencies:**
   ```bash
   pip install -r requirements-dev.txt
   ```

3. **Run tests:**
   ```bash
   pytest
   ```

4. **Format code:**
   ```bash
   black src/ tests/
   ```

5. **Lint code:**
   ```bash
   ruff check src/ tests/
   ```

6. **Type checking:**
   ```bash
   mypy src/
   ```

## Usage

```python
import appdevcommons

# Your code here
```

## Building and Distributing

To build the package:

```bash
# Clean previous builds (important to avoid uploading old versions)
rm -rf dist/ build/
find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true

# Build the package
python -m build
```

To upload to PyPI (after configuring credentials):

```bash
twine upload dist/*
```

## Project Structure

```
AppDevCommons/
├── src/
│   └── appdevcommons/
│       ├── __init__.py
│       └── ...  # Your modules here
├── tests/
│   ├── __init__.py
│   └── test_*.py
├── pyproject.toml
├── requirements.txt
├── requirements-dev.txt
├── README.md
└── LICENSE
```

## License

This project is licensed under the MIT License - see the LICENSE file for details.
