Skip to content

Simply enables VueJs, ReactJs, SCSS, LESS, Typescript etc on your Django project

License

Notifications You must be signed in to change notification settings

eadwinCode/django-compressor-parceljs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

https://static.pepy.tech/personalized-badge/django-compressor-parceljs?period=total&units=international_system&left_color=black&right_color=green&left_text=Downloads

Django Compressor Parceljs

django-compressor-parceljs is base on Django-Compressor. It provides additional support to bundles and minifies your typescript, vue, react, scss etc, in a Django template into cacheable static files using parceljs.

For more information on how django-compressor-parceljs really works visit Django-Compressor

Quickstart

Install django-compress:

pip install django-compressor-parceljs

Install parcel-bundler:

npm install -g parcel

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'compressor',
    ...
)

STATICFILES_FINDERS = (
    'django.contrib.staticfiles.finders.FileSystemFinder',
    'django.contrib.staticfiles.finders.AppDirectoriesFinder',
    # other finders..
    'compressor.finders.CompressorFinder',
)

Other Configurations

To minify your code for production, you need to set COMPRESS_ENABLED and COMPRESS_OFFLINE to true in settings.py.

From django-compressor settings, the value of COMPRESS_ENABLED = !DEBUG, in settings.py.

COMPRESS_ENABLED = True
COMPRESS_OFFLINE = True
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

Then run,

python manage.py compress --setting path-to-your-production-settings

For more information on django-compressor-settings

Usage

In your template, load compress {% load compress %} then use {% compress parcel %} <script> {% endcompress %} to load a script. for example:

{% load static %}
{% load compress %}
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Vue Django Testing</title>
  </head>
  <body>
    ....
   {% compress parcel file myts %}
    <script src="{% static 'js/index.ts' %}"></script>
   {% endcompress %}
  </body>
  ...

Private directories

You can use other directories in your project which are not marked as static files with django-compressor-parceljs.

This feature was added to avoid exposing your real code structure, like your front-end components source, to the real world via static urls.

Django-compressor-parceljs provides another tag {% private_static %} which works like the normal django static tag {% static %} to enable you work with a seperate directory registered in COMPRESS_PRIVATE_DIRS in settings.py. And they won't be accessed via any url.

Private directory setup

settings.py
COMPRESS_PRIVATE_DIRS = [
  os.path.join(BASE_DIR, 'my_dir'),
  ....
]
some_file.html
{% load static %}
{% load compress %}
{% load private_static %}
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Vue Django Testing</title>
  </head>
  <body>
    ....
   {% compress parcel file myts %}
    <script src="{% private_static 'js/index.js' %}"></script>
   {% endcompress %}
  </body>
  ...

Vue example

Create a vue project in your django project root. See the demo project django_vue or with react

npm init --yes
npm install -D vue-template-compiler @vue/component-compiler-utils
npm install vue

In your django project app create

static/components/test.vue
static/js/index.js

In static/components/test.vue,

<template>
  <div>
    <h1>{{ message }}</h1>
  </div>
</template>

<script>
    export default {
      name: "app",
      components: {},
      data: {
        message: "Hello Vue",
      },
      computed: {}
    };
    </script>

<style lang="scss">
</style>

In static/js/index.js,

import Vue from "vue";
import test  from "../components/test.vue";
new Vue(test).$mount("#components-demo");

In your django template,

{% load static %}
{% load compress %}
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Vue Django Testing</title>
  </head>
  <body>
    ....
   <div id="components-demo"></div>
   {% compress parcel file myjs %}
     <script src="{% static 'js/index.js' %}"></script>
   {% endcompress %}
  </body>
  ...

Run runserver

python manage.py runserver

You have successfully bundled your vue app into your django template.

Using Parceljs to bundle SASS, SCSS, LESS

Integrating compilers into django-compressor is quiet very easy. All you need is to provide a COMPRESS_PRECOMPILERS option in django settings.py. For more information visit django-compressor precompilers

COMPRESS_PRECOMPILERS = (
    ('text/coffeescript', 'coffee --compile --stdio'),
    ('text/less', 'lessc {infile} {outfile}'),
    ('text/x-sass', 'sass {infile} {outfile}'),
    ('text/x-scss', 'sass --scss {infile} {outfile}'),
    ('text/stylus', 'stylus < {infile} > {outfile}'),
    ('text/foobar', 'path.to.MyPrecompilerFilter'),
)

Use compressor.filters.parceljs.ParserFilterCSS on scss, sass or less in COMPRESS_PRECOMPILERS options as filter. For example:

COMPRESS_PRECOMPILERS = (
    # ('text/coffeescript', 'coffee --compile --stdio'),
    ('text/less', 'compressor.filters.parceljs.ParserFilterCSS'),
    # ('text/x-sass', 'sass {infile} {outfile}'),
    ('text/x-scss', 'compressor.filters.parceljs.ParserFilterCSS'),
    # ('text/stylus', 'stylus < {infile} > {outfile}'),
    # ('text/foobar', 'path.to.MyPrecompilerFilter'),
)

In your template,

{% load static %}
{% load compress %}
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Vue Django Testing</title>
    {% compress css file style %}
        <link rel="stylesheet" type="text/x-scss"  href="{% static 'css/style.scss'%}">
    {% endcompress %}
  </head>
  <body>
  .......

Add the type="text/x-scss" for django-compressor to use the precompiler options to compile the asset.

There is alittle drawback with parceljs css url resolver. There is no configuration for parceljs to ignore resolving css url since django will always resolve static urls automatically. Read more this issue

A solution is to use ///.. on the url path followed by /static/(path_to_file)

body{
    background-color: lightblue;
    background-image: url(///../static/img/ssd/avatar1.png);

    button{
        font-size: .8rem;
    }
}

Using typescript directly in django template

Add lang attribute to the script tag <script lang="ts"></script>

npm init --yes
npm install -D @babel/core, @babel/preset-env, typescript
{% load static %}
{% load compress %}
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Vue Django Testing</title>
  </head>
  <body>
    ....
   {% compress parcel file myts %}
     <script lang="ts">
        interface IUser {
            name: string,
            age: number
        }

        class User implements IUser{
            constructor(user:IUser){
                this.name = user.name
                this.age = user.age
            }
            name: string
            age: number

            get_name = () => {
                return this.name
            };
        }

        const Peter = new User({name:'Peter', age:32})
        console.log(Peter)
     </script>
   {% endcompress %}
  </body>
  ...