Skip to main content

This package marries Django with CodeMirror

Project description

This package marries Django with CodeMirror. It provides (1) a customisable form widget, and (2) a shorthand way to use this widget in the admin. In both cases the relevant static files (including mode/theme/addon files) are automatically included as form assets.

installation

This is a Python 3 package with no other dependencies apart from Django and it is offered at the Cheese Shop:

# usually inside a virtual environment
pip install django-mirror

The CodeMirror files (version 5.63.3) are included in the package. The supported Django versions are 2.2, 3.0, 3.1, and 3.2.

settings

# add 'django_mirror' to your INSTALLED_APPS if you want the package to be
# handled by Django's collectstatic command
INSTALLED_APPS += ['django_mirror']

# use DJANGO_MIRROR_DEFAULTS to specify default options for your widgets
# see the next section for more info about the options
DJANGO_MIRROR_DEFAULTS = {
    'mode': 'rst',
    'addons': ['mode/overlay'],
    'line_wrapping': True,
}

widget

Bascially this package provides a form widget called MirrorArea that extends Django’s Textarea widget.

from django import forms
from django_mirror.widgets import MirrorArea

class CommentForm(forms.Form):
    text = forms.CharField(
        widget=MirrorArea(
            attrs={'rows': 20},  # the parent class' attrs still works
            mode='markdown',  # the other kwargs are forwarded to CodeMirror
        )
    )

The MirrorArea widget can be initialised with the following arguments:

  • Any of CodeMirror’s config options. These can be specified in either camelCase or snake_case (e.g. both tabSize and tab_size would work). The css/js files associated with the mode, if provided, are included as form assets.

  • addons, a list of CodeMirror addons, e.g. dialog/dialog. The css/js files associated with the addons are recursively included as form assets.

  • attrs, just as Django’s form widgets.

The addons and config options are merged with and override DJANGO_MIRROR_DEFAULTS if the setting has been defined.

admin

If you want to use the widget in the admin panel, you can subclass the MirrorAdmin mixin, which provides the mirror_fields model admin option:

from django.contrib import admin
from django_mirror.admin import MirrorAdmin

from weblog.models import Comment


@admin.register(Comment)
class CommentAdmin(MirrorAdmin, admin.ModelAdmin):
    mirror_fields = ('comment',)  # default options
    mirror_fields = (  # with custom options
        ('comment', {
            'mode': 'markdown',
            'line_wrapping': True,
        }),
    )

The mixin also includes a bit of css to make CodeMirror look more like regular admin textarea fields.

similar projects

There are several other packages that provide customisable CodeMirror widgets:

licence

GNU LGPLv3. Please refer to COPYING for the base GPLv3 licence and to COPYING.LESSER for the additional permissions on top that constitute LGPLv3.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-mirror-0.1.13.tar.gz (607.8 kB view details)

Uploaded Source

Built Distribution

django_mirror-0.1.13-py3-none-any.whl (773.2 kB view details)

Uploaded Python 3

File details

Details for the file django-mirror-0.1.13.tar.gz.

File metadata

  • Download URL: django-mirror-0.1.13.tar.gz
  • Upload date:
  • Size: 607.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10

File hashes

Hashes for django-mirror-0.1.13.tar.gz
Algorithm Hash digest
SHA256 bd72333c7b5e4223601b66b3a44a34588fc9bb349e8ce09548d42aa3affe1454
MD5 c56401b239b75b9ab53d70433447ea7c
BLAKE2b-256 91fc6b91b46fb59e58f96dc78e242194095d7443e1401c9974bd36032d09921a

See more details on using hashes here.

File details

Details for the file django_mirror-0.1.13-py3-none-any.whl.

File metadata

  • Download URL: django_mirror-0.1.13-py3-none-any.whl
  • Upload date:
  • Size: 773.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10

File hashes

Hashes for django_mirror-0.1.13-py3-none-any.whl
Algorithm Hash digest
SHA256 014d49976326b3b3c2ef1804891ad52899c73a6fdcfc46e1296d24ea9b9ae6c8
MD5 d3c67d878556dc35236d1c7667055b82
BLAKE2b-256 b1bf79cfc8addae7bb9b48fbe5717d207152c63822282e16b2b5f01172ec9da2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page