Metadata-Version: 2.4
Name: wagtail-sb-blocks
Version: 0.3.0
Summary: Tabbed interface for Wagtail's struct blocks with settings fields.
Keywords: cms,django,dynova,softbutterfly,blocks,wagtail
Author: Dynova Development Team, zodiacfireworks
Author-email: Dynova Development Team <dev@dynova.io>, zodiacfireworks <martin.vuelta@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django :: 4
Classifier: Framework :: Django :: 5
Classifier: Framework :: Django :: 6
Classifier: Framework :: Wagtail :: 5
Classifier: Framework :: Wagtail :: 6
Classifier: Framework :: Wagtail :: 7
Classifier: Framework :: Wagtail :: 8
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: django>=4.2,<7.0
Requires-Dist: djangorestframework>=3.14,<4.0
Requires-Dist: wagtail>=5.2,<9.0
Requires-Dist: wagtail-sb-imageserializer>=0.7.0
Requires-Dist: wagtail-sb-structblock>=0.6.0
Maintainer: zodiacfireworks
Maintainer-email: zodiacfireworks <martin.vuelta@gmail.com>
Requires-Python: >=3.11.0, <4.0.0
Project-URL: Bug Tracker, https://gitlab.com/softbutterfly/open-source/wagtail-sb-blocks/-/issues
Project-URL: Changelog, https://gitlab.com/softbutterfly/open-source/wagtail-sb-blocks/-/blob/v0.3.0/CHANGELOG.md
Project-URL: Documentation, https://softbutterfly.gitlab.io/open-source/wagtail-sb-blocks
Project-URL: Download, https://gitlab.com/softbutterfly/open-source/wagtail-sb-blocks/-/archive/v0.3.0/wagtail-sb-blocks-v0.3.0.tar.gz
Project-URL: Homepage, https://gitlab.com/softbutterfly/open-source/wagtail-sb-blocks
Project-URL: Issues, https://gitlab.com/softbutterfly/open-source/wagtail-sb-blocks/-/issues
Project-URL: Repository, https://gitlab.com/softbutterfly/open-source/wagtail-sb-blocks
Description-Content-Type: text/markdown

# Wagtail SB Blocks

**Package with basic, adaptable and reusable blocks to build awesome sites with wagtail.**

![Community-Project][repository:banner]

![PyPI - Supported versions][pypi:badge:python]
![PyPI - Package version][pypi:badge:version]
![PyPI - Downloads][pypi:badge:downloads]
![PyPI - License][pypi:badge:license]
[![Codacy Grade Badge][codacy:grade]][codacy:dashboard]
[![Codacy Coverage Badge][codacy:coverage]][codacy:dashboard]
[![Gitlab Pipeline Status][repository:pipeline]][repository:commits]

Package to render Wagtail `StructBlock` with basic, adaptable and reusable blocks to build awesome sites with wagtail.

## ✨ Features

- **Standard Blocks**: Out-of-the-box blocks like Headers, Paragraphs, Figures, Buttons, Embeds, and Lists.
- **Enhanced StreamBlock**: Removes unnecessary wrapper `div`s.
- **Modern Stack**: Built for modern Python (3.11+) and up to date Django/Wagtail versions.

## 📋 Requirements

- Python 3.11 or higher
- Wagtail 5.2 or higher
- Django 4.2 or higher

## 📦 Installation

### Using pip

```bash
pip install wagtail-sb-blocks
```

### Using uv

```bash
uv add wagtail-sb-blocks
```

## 🚀 Usage

Add `wagtail_sb_blocks` to your `INSTALLED_APPS` settings:

```python
INSTALLED_APPS = [
    # ...
    "wagtail_sb_blocks",
    # ...
]
```

In your stream blocks use blocks from this package to rapid development.

```python
from wagtail.blocks import StreamBlock

from wagtail_sb_blocks.blocks.legacy import H1, Paragraph, Figure, Button


class EnhancedHTMLBlock(StreamBlock):
    title = H1()
    paragraph = Paragraph()
    figure = Figure()
    button = Button()
```

## 🛠️ Development

Check out our [Contribution Guide](./CONTRIBUTING.md) for details on setting up
your development environment, running tests, and submitting pull requests.

The project uses `uv` for dependency management, `ruff` for linting, and `tox`
for multi-environment testing.

## 📜 Changelog

See the [CHANGELOG.md](./CHANGELOG.md) for a history of changes.

## 👥 Contributors

See our [list of contributors][repository:contributors].

## 📄 License

This project is licensed under the Apache License 2.0. See the
[LICENSE](./LICENSE) file for details.

[repository:banner]: https://gitlab.com/softbutterfly/open-source/open-source-office/-/raw/master/assets/dynova/dynova-open-source--banner--community-project.png
[repository:pipeline]: https://gitlab.com/softbutterfly/open-source/wagtail-sb-blocks/badges/master/pipeline.svg
[repository:commits]: https://gitlab.com/softbutterfly/open-source/wagtail-sb-blocks/-/commits/master
[repository:contributors]: https://gitlab.com/softbutterfly/open-source/wagtail-sb-blocks/-/graphs/develop

[pypi:badge:python]: https://img.shields.io/pypi/pyversions/wagtail-sb-blocks
[pypi:badge:version]: https://img.shields.io/pypi/v/wagtail-sb-blocks
[pypi:badge:downloads]: https://img.shields.io/pypi/dm/wagtail-sb-blocks
[pypi:badge:license]: https://img.shields.io/pypi/l/wagtail-sb-blocks

[codacy:grade]: https://app.codacy.com/project/badge/Grade/a7111b162e8749cab6d58f8b8724bac0
[codacy:coverage]: https://app.codacy.com/project/badge/Coverage/a7111b162e8749cab6d58f8b8724bac0
[codacy:dashboard]: https://app.codacy.com/gl/softbutterfly/wagtail-sb-blocks/dashboard
