muffin-admin 0.22.0

Admin interface for Muffin Framework

Muffin-Admin – an extension to Muffin that implements admin-interfaces

---

Features

• Support for Peewee ORM, Mongo, SQLAlchemy Core through Muffin-Rest;

• Automatic filtering and sorting for items;

Contents

• Features

  • Requirements

  • Installation

  • Usage

• Configuration options

  • Bug tracker

  • Contributing

  • Contributors

  • License

Requirements

• python >= 3.7

Installation

Muffin-Admin should be installed using pip:

pip install muffin-admin

With SQLAlchemy Core support:

pip install muffin-admin[sqlalchemy]

With Peewee ORM support:

pip install muffin-admin[peewee]

Usage

Initialize the admin:

from muffin_admin import Plugin

admin = Plugin(**options)

Initialize admin handlers (example for Peewee ORM):

from muffin_admin import PWAdminHandler

 @admin.route
 class UserResource(PWAdminHandler):

     """Create Admin Resource for the User model."""

     class Meta:

         """Tune the resource."""

         # Peewee Model for the admin resource
         model = User

         # Filters
         filters = 'email', 'created', 'is_active', 'role'

         # Tune serialization/deserialization schemas
         schema_meta = {
             'load_only': ('password',),
             'dump_only': ('created',),
         }

         # Columns to show
         columns = 'id', 'email', 'is_active', 'role', 'created'

         # Custom Material-UI icon
         icon = 'People'

Connect admin to an Muffin application:

admin.setup(app, **options)

For futher reference check https://github.com/klen/muffin-admin/tree/develop/examples <examples> in the repository.

Configuration options

Name	Default value	Description
prefix	"/admin"	Admin’s HTTP URL prefix
title	"Muffin Admin"	Admin’s title
custom_js_url	""	A link to custom JS file
custom_css_url	""	A link to custom CSS file
login_url	None	An HTTP URL for your custom authorization page
logout_url	None	An HTTP URL for your custom logout page
auth_storage	"localstorage"	Where to keep authorization information (localstorage|cookies)
auth_storage_name	muffin_admin_auth	Localstorage/Cookie name for authentication info

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/muffin-admin/issues

Contributing

Development of Muffin-Admin happens at: https://github.com/klen/muffin-admin

Contributors

• klen (Kirill Klenov)

License

Licensed under a MIT license.