Skip to main content

Molo is a set of tools for publishing mobi sites with a community focus.

Project description

Molo

Continuous Integration Code Coverage Molo Documentation Pypi Package

Installation

Molo requires Python (version 2.6 or 2.7) to be installed. This installation method also requires pip. Both of these must be installed before following the installation steps below.

Installing Molo

Molo can be then installed using:

$ virtualenv ve
$ source ve/bin/activate
(ve)$ pip install molo.core

Getting Started

Molo scaffolds a Django application for you with sensible defaults, packages and configuration to help you get going as soon as possible.

Scaffold a site using Molo

The goal of Molo is to provide a solid base of proven, stable packages that help Praekelt Foundation and partners to deliver on project scope:

$ molo scaffold myapp
$ cd myapp/
$ ./manage.py migrate
$ ./manage.py createsuperuser
$ ./manage.py runserver

Open the sample site in your browser at http://localhost:8000/ and the CMS at http://localhost:8000/admin/.

Scaffolding a site in an existing repository

It’s not always desirable to create a new directory for an application, especially when scaffolding an application for a repository that’s already been created. Specifically for that Molo allows a second argument for the directory.

To scaffold an application called myapp in the current directory do:

$ molo scaffold myapp .

Specifying extra requires

Molo in itself is not expected to be enough to deliver on a client request. During scaffolding use the --require commandline parameter to include more libraries that are required for installation:

$ molo scaffold myapp --require=django-contrib-comments

Adds the django-contrib-comments to the generated requirements file which is read by the generated package’s setup.py file.

Multiple requires can be specified on the command line:

$ molo scaffold myapp --require=django-contrib-comments \
>   --require=molo.profiles

Automatically adding installed apps

If you’re including a Django app chances are you’re going to want to add it to your INSTALLED_APPS settings as well as adding an entry to the generated urls.py file:

$ molo scaffold myapp --include=django_comments ^comments/

This results in the following urls.py entry:

url(r'^comments/',
    include('django_comments.urls',
            namespace='django_comments',
            app_name='django_comments')),

For convenience, here’s the full scaffold command for the current plugins:

$ molo scaffold myapp \
    --require=molo.profiles --include=molo.profiles ^profiles/ \
    --require=django-contrib-comments --include=django_comments ^comments/ \
    --require=molo.commenting --include=molo.commenting ^commenting/ \
    --require=molo.yourwords --include=molo.yourwords ^yourwords/

Molo, Django & settings files

What you have now is a standard Django application set up for normal development like outlined in the Django documentation. The only main difference is that your settings are Python modules found in the settings/dev.py and settings/production.py files in your applications folder. Both of these inherit settings from settings/base.py.

To create your own custom settings add a local.py file in the settings folder. The settings/dev.py will automatically include those settings for your local development environment.

Unpacking Templates from Packages

Sometimes a package’s existing templates simply are not enough and need some amount of customization. Use the unpack-templates command in the scaffolded application to unpack a package’s templates in your application’s templates directory:

$ molo scaffold testapp \
>   --require=molo.profiles \
>   --include=molo.profiles ^profiles/
$ pip install -e testapp
...

You’ll see the default templates that molo.core ships with available in the templates directory:

$ ls testapp/testapp/templates
404.html  500.html  base.html core

Now we unpack the profiles templates directory from the molo.profiles package into the testapp package template directory:

$ molo unpack-templates molo.profiles testapp
$ ls testapp/testapp/templates
404.html  500.html  base.html core profiles

The format is:

$ molo unpack-templates <source package> <target package>

Writing tests

Now develop your application and write tests for the features you add. Running your tests for Django works as you would expect:

$ ./manage.py test

What is bundled with Molo?

  1. Wagtail CMS

  2. Basic feature phone template set.

  3. Basic models for the following tree structure:

    1. A site has languages

    2. A language has a homepage

    3. Articles are organised into sections.

    4. Articles are composed from one or more blocks.

    5. Blocks can be headings, paragraphs, images, lists or links to other pages.

  4. Molo Profiles: Provides code to help with User profiles in a project using the Molo code base.

Testing the Molo scaffolding tool

If you’re interested in working on or contributing to the code that does the scaffolding then clone this repository from the GitHub repository at http://github.com/praekelt/molo.

Install the requirement development & testing dependencies:

$ pip install -r requirements-dev.txt

And then run the full test suite with:

$ py.test

Pull requests are expected to follow Praekelt’s Ways Of Working.

Documentation

Documentation is available online at http://molo.readthedocs.org/ and in the docs directory of the repository.

To build the docs locally:

$ virtualenv ve
$ source ve/bin/activate
(ve)$ pip install -r requirements-docs.txt
(ve)$ cd docs
(ve)$ make html

You’ll find the docs in docs/_build/index.html

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

molo.core-6.7.1.tar.gz (6.4 MB view details)

Uploaded Source

Built Distributions

molo.core-6.7.1-py3-none-any.whl (4.7 MB view details)

Uploaded Python 3

molo.core-6.7.1-py2-none-any.whl (4.7 MB view details)

Uploaded Python 2

File details

Details for the file molo.core-6.7.1.tar.gz.

File metadata

  • Download URL: molo.core-6.7.1.tar.gz
  • Upload date:
  • Size: 6.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for molo.core-6.7.1.tar.gz
Algorithm Hash digest
SHA256 e5a1ea7d62ac776df32d9bf635c1871412465b3ab6072f557072b42fb1ab67a2
MD5 a1f97f2aa77faa2d352063d61e1cc189
BLAKE2b-256 dae3befc0b69428d85d2657d022f9c6de4bb479079eb9a8a0c8fe8a552e5440a

See more details on using hashes here.

Provenance

File details

Details for the file molo.core-6.7.1-py3-none-any.whl.

File metadata

File hashes

Hashes for molo.core-6.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2e4a4ac049f661b7f0a29258606ee1b6e903cb30cf86180137c3a3624119f8ea
MD5 4c493faee2fb02087ebef1bf9c73f443
BLAKE2b-256 903b9ad341fe7823b716a6b158afad0fa6f8858d75dfe8da5094c4a08438a771

See more details on using hashes here.

Provenance

File details

Details for the file molo.core-6.7.1-py2-none-any.whl.

File metadata

File hashes

Hashes for molo.core-6.7.1-py2-none-any.whl
Algorithm Hash digest
SHA256 043bc3b299e7a88eee10164a3c63d269c855006021e810bfbacf1526b2c390cd
MD5 94fec52e81e5962fd6d3f5d8743aeda4
BLAKE2b-256 c0cc5307e43b725de76d59bcce450ca3fa8ff46bac23e605f758f02b231eed13

See more details on using hashes here.

Provenance

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