Metadata-Version: 2.4
Name: iommi
Version: 7.25.1
Summary: iommi is a high level framework built on django
Author-email: Anders Hovmöller <boxed@killingar.net>, Johan Lübcke <johan@lubcke.se>
License-Expression: BSD-2-Clause
Project-URL: Homepage, https://github.com/iommirocks/iommi
Keywords: iommi
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: pyparsing
Requires-Dist: Django>=3.2
Dynamic: license-file

.. image:: https://raw.githubusercontent.com/iommirocks/iommi/master/logo_with_outline.svg
    :height: 320
    :align: center


iommi
=====

Your first pick for a django power chord
----------------------------------------

.. image:: https://img.shields.io/badge/Code_on-GitHub-black
    :target: https://github.com/iommirocks/iommi

.. image:: https://img.shields.io/discord/773470009795018763?logo=discord&logoColor=fff?label=Discord&color=7389d8
    :target: https://discord.gg/ZyYRYhf7Pd

.. image:: https://github.com/iommirocks/iommi/workflows/tests/badge.svg
    :target: https://github.com/iommirocks/iommi/actions?query=workflow%3Atests+branch%3Amaster

.. image:: https://codecov.io/gh/iommirocks/iommi/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/iommirocks/iommi

.. image:: https://readthedocs.org/projects/iommi/badge/?version=latest
    :target: https://docs.iommi.rocks
    :alt: Documentation Status

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black

iommi is a toolkit to build web apps faster. It's built on Django but goes a lot further.

It has:

- `forms <https://docs.iommi.rocks//forms.html>`_: that feel familiar, but can handle growing complexity better than Django's forms
- `tables <https://docs.iommi.rocks//tables.html>`_: that are powerful out of the box and scale up to arbitrary complexity
- a system to `compose parts <https://docs.iommi.rocks//pages.html>`_:, like forms, menus, and tables, into bigger pages
- tools that will speed up your development like live edit, jump to code, great feedback for missing select/prefetch related, a profiler, and more.
- great error messages when you make a mistake

.. image:: docs/README-demo.gif


Example:


.. code-block:: python

    class IndexPage(Page):
        title = html.h1('Supernaut')
        welcome_text = 'This is a discography of the best acts in music!'

        artists = Table(auto__model=Artist, page_size=5)
        albums = Table(
            auto__model=Album,
            page_size=5,
        )
        tracks = Table(auto__model=Album, page_size=5)


    urlpatterns = [
        path('', IndexPage().as_view()),
    ]


This creates a page with three separate tables, a header and some text:

.. image:: docs/README-screenshot.png

For more examples, see the `examples project <https://github.com/iommirocks/iommi/tree/master/examples/examples>`_.


Getting started
---------------

See `getting started <https://docs.iommi.rocks//getting_started.html>`_.


Running tests
-------------

.. code-block::

    make test
    make test-docs


License
-------

BSD


Documentation
-------------

https://docs.iommi.rocks
