Metadata-Version: 2.4
Name: django-full-kit
Version: 0.3.0
Summary: A reusable Django package providing ready-to-use models, admin configurations, and utilities.
Author: aboalfazlH
License: MIT
Project-URL: Homepage, https://github.com/aboalfazlH/django-full-kit
Project-URL: Repository, https://github.com/aboalfazlH/django-full-kit
Project-URL: Issues, https://github.com/aboalfazlH/django-full-kit/issues
Keywords: django,django-package,django-reusable-app,backend,full-kit,django-full-kit
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: <3.13,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Django<5.0,>=4.2
Requires-Dist: Pillow<11.0,>=10.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-django>=4.5; extra == "dev"
Dynamic: license-file

# Django Full Kit

A reusable Django package providing ready-to-use models, admin configurations, and utilities for common project needs such as users and articles.Powered by developlab

---

## Features

* **UserProfile**: Optional extension for Django's `AUTH_USER_MODEL`.
* **Article model**: Generic content model for blogs, news, or docs.
* **Admin ready**: Preconfigured admin for users and articles.
* **Utilities**: Helper functions for safer attribute access and common tasks.
* **TimeStampedModel**: Base abstract model with `created_at` and `updated_at`.

---

## Installation

```bash
pip install django-full-kit
```

---

## Usage

Add the app to your `INSTALLED_APPS`:

```python
INSTALLED_APPS = [
    ...
    "full_kit",
]
```

Run migrations for the included models:

```bash
python manage.py makemigrations
python manage.py migrate
```

Import models where needed:

```python
from django_full_kit.models import Article, UserProfile
```

Register in admin (optional if using default registration):

```python
from django.contrib import admin
import django_full_kit.admin
```

---

## Testing

Install test dependencies:

```bash
pip install .[dev]
```

Run tests with pytest:

```bash
pytest
```

---

## License

[MIT](LICENSE)
