Skip to main content

Utility for generating files and directories from templates.

Project description

Introduction

PopPage is a simple command-line utility originally intended as a static website generator but has since grown into a cookiecutter clone. The main features of PopPage are:

  • Uses Jinja2 templates to generate output.
  • Uses YAML to store default key/values for template variables.
  • Output can be single files or directories.
  • Key/values applied to the templates variables can specified on the command line.

Status

Currently, this project is in the development release stage. While this project is suitable for use, please note that there may be incompatibilities in new releases.

Release notes are maintained in the project changelog.

Requirements

PopPage should run on any Python 2.7/3.x interpreter without additional dependencies.

Usage

PopPage can be run from the command line using poppage. Type poppage --help for usage information.

Some Important Notes

Before showing any examples, keep these notes in mind:

  • Template file/directory names can contain template variables (e.g. {{foo}}.txt). The provided key/values will be used for the output file generation unless an explicit OUTPATH is provided.
  • The output will be passed to stdout if INPATH is a file (rather than a directory) and INPATH does not contain a template variable and no OUTPATH is specified.

CLI Key/Values

The following is a quick example of using PopPage from the CLI:

  • Template file (template.jinja2):

    Hello {{name}}!
    
  • PopPage command:

    poppage make template.jinja2 --string name world
    
  • Output to stdout:

    Hello world!
    

YAML Key/Values

Additionally, default key/values can be stored in a YAML file:

  • Template file (template.jinja2):

    Hello {{name}}!
    
  • Defaults file (defaults.yaml):

    name: sun
    
  • PopPage command:

    poppage make template.jinja2 --defaults defaults.yaml
    
  • Output to stdout:

    Hello sun!
    

Custom YAML Tags

The following custom YAML tags are provided:

  • !file - Reads value from a file.
  • !cmd - Reads value from a CLI command output.

Check out this example:

  • Template file (template.jinja2):

    Hello {{first}} {{last}}!
    
  • Defaults file (defaults.yaml):

    first: !file myfile.txt
    last: !cmd python -c "print('Skywalker')"
    
  • Content of myfile.txt:

    Anakin
    
  • PopPage command:

    poppage make template.jinja2 --defaults defaults.yaml
    
  • Output to stdout:

    Hello Anakin Skywalker!
    

Similar

The following projects are similar and may be worth checking out:

Project details


Download files

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

Files for poppage, version 0.3.3
Filename, size File type Python version Upload date Hashes
Filename, size poppage-0.3.3.tar.gz (6.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page