Metadata-Version: 2.1
Name: django-entries
Version: 0.1.8
Summary: Entries is a helper Django app with CRUD functions based on htmx.
Home-page: https://github.com/justmars/django-entries
License: MIT
Author: Marcelino G. Veloso III
Author-email: mars@veloso.one
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: Django (>=4.0,<5.0)
Requires-Dist: Markdown (>=3.3.6,<4.0.0)
Requires-Dist: bleach (>=4.1.0,<5.0.0)
Requires-Dist: django-crispy-forms (>=1.13.0,<2.0.0)
Requires-Dist: django-extensions (>=3.1.5,<4.0.0)
Requires-Dist: markdownify (>=0.10.0,<0.11.0)
Requires-Dist: types-Markdown (>=3.3.8,<4.0.0)
Requires-Dist: types-bleach (>=4.1.1,<5.0.0)
Project-URL: Repository, https://github.com/justmars/django-entries
Description-Content-Type: text/markdown

# Entries

## Overview

Entries is a Django app that has basic create-read-update-delete (CRUD) functionality for an `Entry` model with `title`, `excerpt`,`content` and `author` fields. The base [template](./entries/templates/base.html) makes use of light css and javascript.

## CSS

1. `starter.css` [stylesheet](./entries/static/css/starter.css)
2. `pylon` 0.1.1 for `<hstack>` and `<vstack>` layouts

## JS

1. `htmx` 1.6.1 for html-over-the-wire functionality
2. `hyperscript` 0.9 for client-side reactivity
3. `simplemde` a simple markdown editor

## Quickstart

Install in your virtual environment:

```zsh
.venv> pip3 install django-entries # poetry add django-entries
```

Include package in main project settings file:

```python
# in project_folder/settings.py
INSTALLED_APPS = [
    ...,
    'crispy_forms',  # add crispy_forms at least > v1.13, if not yet added
    'entries' # this is the new django-entries folder
]

# in project_folder/urls.py
from django.urls import path, include # new
urlpatterns = [
    ...,
    path('entry/', include('entries.urls')) # new
]
```

Add to database:

```zsh
.venv> python manage.py migrate # adds the `Entry` model to the database.
```

