Metadata-Version: 1.1
Name: humanbingo
Version: 3.0.1
Summary: Create cards for the "Human Bingo" icebreaker game, with customizable properties and templating
Home-page: https://github.com/leingang/humanbingo
Author: Matthew Leingang
Author-email: mleingang@gmail.com
License: MIT license
Description: ===========
        Human Bingo
        ===========
        
        
        .. image:: https://img.shields.io/pypi/v/humanbingo.svg
                :target: https://pypi.python.org/pypi/humanbingo
        
        .. image:: https://img.shields.io/travis/leingang/humanbingo.svg
                :target: https://travis-ci.org/leingang/humanbingo
        
        .. image:: https://readthedocs.org/projects/humanbingo/badge/?version=latest
                :target: https://human-bingo.readthedocs.io/en/latest/?badge=latest
                :alt: Documentation Status
        
        .. image:: https://pyup.io/repos/github/leingang/humanbingo/shield.svg
             :target: https://pyup.io/repos/github/leingang/humanbingo/
             :alt: Updates
        
        
        Create cards for the "Human Bingo" icebreaker game, with customizable 
        properties and templating.
        
        Synopsis
        --------
        
        This is an icebreaker game to play on the first day of class.  See 
        `About.com`_ or `WikiHow`_ for references.
        
        .. _`About.com`: http://adulted.about.com/od/icebreakers/qt/peoplebingo.htm
        .. _`WikiHow`: http://www.wikihow.com/Play-Human-Bingo
        
        Features
        --------
        
        * Read cardset specifications as XML and YAML files.  The YAML specification is
          newer, more flexible, and easier to write.  The XML specification is older,
          and seemed like a good idea at the time.
        
        * Write HTML and PDF files.  Since it's more likely the cards will be printed
          onto paper, the default is writing PDF.  Originally, only HTML files were 
          created, and PDF conversion was done by a third-party utility (wkhtmltopdf_).
          In version 3 the PDF writer was baked in. Since the PDF writer internally
          creates HTML first, the HTML feature is still maintained.
        
          .. _wkhtmltopdf: https://wkhtmltopdf.org/ 
        
        Usage
        -----
        
        Installing the package exposes a script :code:`humanbingo`.  Call it like this::
        
            $ humanbingo [-n|--number NUM]
                [-v|--verbose]
                [-d|--debug]
                [-o|--output] OUTPUTFILE        
                [-f|--input-format] (yaml|xml) 
                [-F|--output-format] (pdf|html)
                INPUTFILE
        
        Read properties file as its sole argument.  If neither :code:`-n` or 
        :code:`--number` option is not specified, write one bingo card to stdout.  
        If :code:`-n NUMBER` or :code:`--number=NUMBER` is 
        specified, writes NUMBER cards to separate files.
        
        .. warning::
        
            At this time writing PDF to stdout is not supported.  But you probably
            don't want to do that anyway.
        
        
        
        To easily print the PDF cards, they can be concatenated with `pdftk`_::
        
            $ /path/to/pdftk card*.pdf cat output allcards.pdf
        
        .. _`pdftk`: http://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/
        
        Documentation
        -------------
        
        See https://human-bingo.readthedocs.io.
        
        License
        -------
        
        Free software: MIT license
        
        Credits
        -------
        
        Human bingo relies on a lot of big python packages, heartily endorsed.
        
        * Jinja2_ for templating
        * Click_ for publishing command-line applications
        * WeasyPrint_ for converting HTML to PDF
        
        .. _Jinja2: http://jinja.pocoo.org/
        .. _Click: http://click.pocoo.org/
        .. _WeasyPrint: http://weasyprint.org/
        
        We also use ruamel.yaml_ over PyYaml since it supports a few more features (notably,
        the :code:`!!omap` sequence declaration).
        
        .. _ruamel.yaml: https://yaml.readthedocs.io/en/latest/
        
        This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
        
        .. _Cookiecutter: https://github.com/audreyr/cookiecutter
        .. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
        
        
        
        =======
        History
        =======
        
        Version 3.0.1 (August 24, 2017)
        -------------------------------
        
        Updated history file for version 3.0.0.
        
        Version 3.0.0 (August 24, 2017)
        -------------------------------
        
        Added the PDF writer.  Pass :code:`-F pdf` to explicitly write PDF files.
        
        Backwards-incompatible changes: YAML input and PDF output are now default.
        
        Improved refactoring and documentation.
        
        Version 2.1.0 (August 4, 2017)
        ------------------------------
        
        Added the ability to specify card sets with a YAML file instead of the
        old XML format.  Pass :code:`-f yaml` to :code:`humanbingo`.
        
        Lots of improvements to documentation.
        
        Version 2.0.2 (August 3, 2017)
        ------------------------------
        
        Pretty big refactoring into separate modules, in order to facilitate 
        extensibility, practice dependency injections, etc.  But no functional
        change yet.
        
        Version 2.0.1 (July 28, 2017)
        -----------------------------
        
        Flesh out history file.
        
        Version 2.0.0 (July 28, 2017)
        -----------------------------
        
        Name change: "Name Bingo" to "Human Bingo".  The latter sounds
        more interesting and seems to be the more popular term.
        
        Morphing this script into a bona fide python package to upload to PyPI.
        Using the pypackage_ cookiecutter, add a :code:`setup.py` script so 
        that it can be installed with pip_.
        
        .. _pypackage: https://github.com/audreyr/cookiecutter-pypackage
        .. _pip: https://pypi.python.org/pypi/pip
        
        Now :code:`pip install` will install an executable file :code:`humanbingo`,
        and the original :code:`bingo.py` module/script is gone.  So this is a
        backwards-incompatible change.
        
        Version 1.1.0 (July 26, 2017)
        -----------------------------
        
        * Port from Python 2.7 to 3.5
        * Use the shell environment's python instead of a hardcoded one
        
        
        Version 1.0.0 (January 27, 2013)
        --------------------------------
        
        * parse script arguments with argparse_
        * get closer to POSIX compliant interface (print to stdout when only
          one card is needed)
        * add a README
        * upload to github
        
        .. _argparse: https://docs.python.org/2/library/argparse.html#module-argparse
        
        2007
        ----
        
        MPL converted the ColdFusion script to python as an exercise.
        
        2006
        ----
        
        Derek Bruff wrote the original "Name Bingo" script in ColdFusion.
        
Keywords: humanbingo
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
