Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Piano. Beginner friendly Plone development.

Project Description

piano

Piano. Beginner friendly Plone development.

Warning

This is very much ALPHA!. In the spirit of release early, here it is.

Installation

Prerequisites

You should have the build tools and Plone dependencies installed.

If you’re on Debian or Ubuntu with sudo privileges, We’ve simplified this for you. Just run one of the commands below:

For Debian:

wget -qO- for-beginner-piano.github.io/debian | bash

For Ubuntu:

wget -qO- for-beginner-piano.github.io/ubuntu | bash

Quick Install

To install piano quickly, run the following commands:

wget -qO- for-beginner-piano.github.io | bash
source ~/.bashrc

This will use pipsi to install the relevant packages in user space. It also ensures that piano is using the most up-to-date version of setuptools.

Longer Install

We prefer and recommend pipsi.

Once you have pipsi, run:

pipsi install for-beginner-piano
~/.local/venvs/for-beginner-piano/bin/pip install -U setuptools

Note

It is important to ensure that the latest version of setuptools is installed for this reason we run the second command above.

Usage

To create a new Plone buildout project

Use the subcommand newbuildout to create a buildout project.

For example, if your project will be called my-plone-site:

piano newbuildout my-plone-site

Note

A buildout is a folder which holds all the settings required to build and deploy a Plone site

You’ll see output similar to this:

Creating virtualenv... (my-plone-site)
Installing Buildout...
Downloading installer (https://launchpad.net/plone/4.3/4.3.3/+download/Plone-4.3.3-UnifiedInstaller.tgz)
Unpacking installer...
Unpacking cache...
Installing eggs...
Installing cmmi & dist...
Configuring cache...
Running Buildout...

Installing non default versions

For the latest Plone 5 site you could do the following:

wget for-beginner-piano.github.com/p5; source p5
piano newbuildout plone5-site

for the latest Plone 4 site:

wget for-beginner-piano.github.com/p4; source p4
piano newbuildout plone4-site

OR if you prefer the more manual approach, here’s an example of installing Plone 5 (note the use of the special PIANO environment variables:

export PIANO_EXTENDS=https://raw.github.com/plock/pins/master/plone-5-0
export PIANO_UNIFIEDINSTALLER_URL=https://launchpad.net/plone/5.0/5.0a2/+download/Plone-5.0a2-UnifiedInstaller.tgz
export PIANO_UNIFIEDINSTALLER_DIR=Plone-5.0a2-UnifiedInstaller

then run:

piano newbuildout myplone5

Creating a Plone add-on

This is not working yet, but:

piano newaddon myaddon

(coming soon, this command doesn’t work yet)

Credits

piano is created and managed by David Bain, it is built on top of plock which was created and maintained by Alex Clark.

Changelog

0.3.1 (2015-02-08)

  • fixed a bug where alternative plone installs were not cleaning up after themeselves properly

0.3.0 (2015-02-08)

  • added support for installation of alternative plone versions by setting special env variables

0.2.16 (2015-02-04)

  • updated the README
  • looks for unified installer in the ~/.buildout cache first. does not re-download unified installer

0.2.15 (2015-02-02)

  • fixed flake8 issues

0.2.12 (2015-02-02)

  • made adjustments to README

0.2.3 (2015-02-02)

  • added MANIFEST.in
  • added README and CHANGES to long description of setup.py

0.2.2 (2015-02-02)

  • now unpacks unified installer cache to ~/.buildout/
  • creates ~/.buildout/default.cfg file
  • keeps a cache based on settings in default.cfg, cache is, by default ~/.buildout/[eggs|downloads|extends-cache]

0.2.1 (2015-02-01)

  • fix broken release

0.2.0 (2015-02-01)

  • added and documented quick install script
  • added Change log

0.1.0 (2015-02-01)

  • Initial release
Release History

Release History

This version
History Node

0.3.1

History Node

0.3.0

History Node

0.2.16

History Node

0.2.15

History Node

0.2.13

History Node

0.2.12

History Node

0.2.11

History Node

0.2.9

History Node

0.2.8

History Node

0.2.7

History Node

0.2.6

History Node

0.2.5

History Node

0.2.4

History Node

0.2.3

History Node

0.2.1

History Node

0.2.0

History Node

0.1.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
for-beginner-piano-0.3.1.tar.gz (7.2 kB) Copy SHA256 Checksum SHA256 Source Feb 9, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting