Metadata-Version: 2.1
Name: colony-print
Version: 0.3.3
Summary: Colony Print Infra-structure
Home-page: http://colony-print.hive.pt
Author: Hive Solutions Lda.
Author-email: development@hive.pt
License: Apache License, Version 2.0
Description: # [Colony Print Infra-structure](http://colony-print.hive.pt)
        
        Small web app for printing Colony-based documents.
        
        This project includes two main components:
        
        * The Web App end-point that provides XML to Binie conversion `colony_print.controllers`
        * The structure conversion infra-structure (Visitors, AST, etc.) `colony_print.printing`
        
        ## Features
        
        * XMPL to Binie conversion
        * PDF generation with custom fonts and images
        * [GDI](https://en.wikipedia.org/wiki/Graphics_Device_Interface) printing (Windows) via [Colony NPAPI (npcolony)](https://github.com/hivesolutions/colony-npapi)
        * [CUPS](https://en.wikipedia.org/wiki/CUPS) printing (Linux) via [Colony NPAPI (npcolony)](https://github.com/hivesolutions/colony-npapi)
        
        ## Binie Specification
        
        For a detailed understanding of the Binie file format used in this project, refer to the [Binie File Format Specification](doc/binie.md). This document outlines the structure and organization of the Binie file format, which is essential for developing compatible applications and tools.
        
        ## XMPL Specification
        
        The XML Markup Language for Printing (XMPL) is integral to our document processing pipeline. For an in-depth understanding of the XMPL structure and its seamless convertibility to Binie, see the [XMPL File Format Specification](doc/xmpl.md).
        
        ## Installation
        
        ### Pre-requisites
        
        ```bash
        apt-get install gcc python-dev
        pip install --upgrade appier netius pillow reportlab
        ```
        
        ### Run Server
        
        ```bash
        pip install colony_print
        python -m colony_print.main
        ```
        
        ### Run Node
        
        ```bash
        pip install colony_print
        BASE_URL=$BASE_URL \
        SECRET_KEY=$SECRET_KEY \
        NODE_ID=$NODE_ID \
        NODE_NAME=$NODE_NAME \
        NODE_LOCATION=$NODE_LOCATION \
        python -m colony_print.node
        ```
        
        ### Fonts
        
        To be able to use new fonts (other than the ones provided by the system), one must install them
        into the `/usr/share/fonts/truetype` directory so they are exposed and ready to
        be used by the PDF generation infra-structure. For example, Calibri is one type of font that should
        be exported to a UNIX machine as many colony-generated documents use it.
        
        ## Development
        
        To run a localhost development server, use the following commands:
        
        ```bash
        PORT=8686 \
        PYTHONPATH=$BASE_PATH/colony_print/src python \
        $BASE_PATH/colony_print/src/colony_print/main.py
        ```
        
        ## License
        
        Colony Print Infra-structure is currently licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/).
        
        ## Build Automation
        
        [![Build Status](https://app.travis-ci.com/hivesolutions/colony-print.svg?branch=master)](https://travis-ci.com/github/hivesolutions/colony-print)
        [![Coverage Status](https://coveralls.io/repos/hivesolutions/colony-print/badge.svg?branch=master)](https://coveralls.io/r/hivesolutions/colony-print?branch=master)
        [![PyPi Status](https://img.shields.io/pypi/v/colony-print.svg)](https://pypi.python.org/pypi/colony-print)
        [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://www.apache.org/licenses/)
        
Keywords: colony print native
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.0
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
