https://github.com/TriOptima/iommi

Your first pick for a django power cord
https://github.com/TriOptima/iommi

django python

Last synced: 3 months ago
JSON representation

Your first pick for a django power cord

• Host: GitHub
• URL: https://github.com/TriOptima/iommi
• Owner: iommirocks
• License: bsd-3-clause
• Created: 2020-01-30T09:51:26.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-07-29T07:22:57.000Z (7 months ago)
• Last Synced: 2024-08-05T01:07:28.586Z (6 months ago)
• Topics: django, python
• Language: Python
• Homepage: http://iommi.rocks
• Size: 11.1 MB
• Stars: 666
• Watchers: 22
• Forks: 45
• Open Issues: 47
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Authors: AUTHORS.rst

Awesome Lists containing this project

• awesome-django - iommi - Toolkit for development of CRUD applications without writing HTML or JavaScript. (Third-Party Packages / Full-stack frameworks)

README

        
.. raw:: html

    


    
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 `_: that feel familiar, but can handle growing complexity better than Django's forms

- `tables `_: that are powerful out of the box and scale up to arbitrary complexity

- a system to `compose parts `_:, 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 `_.

Getting started

---------------

See `getting started `_.

Running tests

-------------

You need to have tox installed, then:

.. code-block::

    make venv

    source venv/bin/activate

    make test

    make test-docs

License

-------

BSD

Documentation

-------------

https://docs.iommi.rocks