Metadata-Version: 2.3
Name: django-my-lib
Version: 0.1.5
Summary: A handy collection of reusable Django UI components, allowing me to share and integrate elements efficiently across various projects.
License: MIT
Author: Gustavo Rizzo S M de Albuquerque
Author-email: grizzo.albu@gmail.com
Requires-Python: >=3.14,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Dist: django (>=5.2.7,<6.0.0)
Description-Content-Type: text/markdown


# django-my-lib 🚀

[![PyPI](https://img.shields.io/pypi/v/django-my-lib.svg)](https://pypi.org/project/django-my-lib/)


> This project is a test for creating a Django library. 🧩


## Installation 📦

You can install the library using pip or poetry:

```bash
pip install django-my-lib
```

or

```bash
poetry add django-my-lib
```


## Configuration ⚙️

Add `django_my_lib` to the `INSTALLED_APPS` list in your `settings.py`:

```python
INSTALLED_APPS = [
    # ... other apps ...
    'django_my_lib',
]
```


## Migrations 🗄️

After installing and configuring, run the following commands:

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


🎉 Done! Your Django library is installed and ready to use.


## Running locally as a developer 🖥️

To run the Django project locally during development, follow the steps below:

```bash
git clone https://github.com/GustavoRizzo/django-my-lib.git
cd django-my-lib
poetry install
cd demo_project
pip install -e ..
poetry run ./manage.py runserver
```

### Tests 🧪
To run the tests, use the command below inside the `demo_project` directory:

```bash
poetry run ./manage.py test
```



## Updating and publishing the library 🚢

To update the version, build, and publish your library, use the commands below:

```bash
poetry version patch  # to bump the version (e.g.: 0.1.0 → 0.1.1)
poetry build
tar -tzf dist/*.tar.gz | head -20  # to see the files inside the package
poetry publish
```

