Metadata-Version: 1.1
Name: python-pptx
Version: 0.5.4
Summary: Generate and manipulate Open XML PowerPoint (.pptx) files
Home-page: http://github.com/scanny/python-pptx
Author: Steve Canny
Author-email: python-pptx@googlegroups.com
License: The MIT License (MIT)
Copyright © 2013 Steve Canny, https://github.com/scanny

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the “Software”), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

Description: .. raw:: html
        
           <p>
             <a href="https://travis-ci.org/scanny/python-pptx" >
               <img style="margin: 0 0 0 0"
                    src="https://travis-ci.org/scanny/python-pptx.svg?branch=master"/>
             </a>
           </p>
        
        *python-pptx* is a Python library for creating and updating PowerPoint (.pptx)
        files.
        
        A typical use would be generating a customized PowerPoint presentation from
        database content, downloadble by clicking a link in a web application. Several
        developers have used it to automate production of presentation-ready
        engineering status reports based on information held in their work management
        system. It could also be used for making bulk updates to a library of
        presentations or simply to automate the production of a slide or two that would
        be tedious to get right by hand.
        
        More information is available in the `python-pptx documentation`_.
        
        Browse `examples with screenshots`_ to get a quick idea what you can do with
        python-pptx.
        
        .. _`python-pptx documentation`:
           https://python-pptx.readthedocs.org/en/latest/
        
        .. _`examples with screenshots`:
           https://python-pptx.readthedocs.org/en/latest/user/quickstart.html
        
        
        .. :changelog:
        
        Release History
        ---------------
        
        0.5.4 (2014-11-15)
        ++++++++++++++++++
        
        - feature #43 - image native size in shapes.add_picture() is now calculated
          based on DPI attribute in image file, if present, defaulting to 72 dpi.
        - feature #113 - Add Paragraph.space_before, Paragraph.space_after, and
          Paragraph.line_spacing
        
        
        0.5.3 (2014-11-09)
        ++++++++++++++++++
        
        - add experimental feature TextFrame.fit_text()
        
        
        0.5.2 (2014-10-26)
        ++++++++++++++++++
        
        - fix #127 - Shape.text_frame fails on shape having no txBody
        
        
        0.5.1 (2014-09-22)
        ++++++++++++++++++
        
        - feature #120 - add Shape.rotation
        - feature #97 - add Font.underline
        - issue #117 - add BMP image support
        - issue #95 - add BaseShape.name setter
        - issue #107 - all .text properties should return unicode, not str
        - feature #106 - add .text getters to Shape, TextFrame, and Paragraph
        
        - Rename Shape.textframe to Shape.text_frame.
          **Shape.textframe property (by that name) is deprecated.**
        
        
        0.5.0 (2014-09-13)
        ++++++++++++++++++
        
        - Add support for creating and manipulating bar, column, line, and pie charts
        - Major refactoring of XML layer (oxml)
        - Rationalized graphical object shape access
          **Note backward incompatibilities below**
        
        **BACKWARD INCOMPATIBILITIES:**
        
        A table is no longer treated as a shape. Rather it is a graphical object
        contained in a GraphicFrame shape, as are Chart and SmartArt objects.
        
        Example::
        
            table = shapes.add_table(...)
        
            # becomes
        
            graphic_frame = shapes.add_table(...)
            table = graphic_frame.table
        
            # or
        
            table = shapes.add_table(...).table
        
        As the enclosing shape, the id, name, shape type, position, and size are
        attributes of the enclosing GraphicFrame object.
        
        The contents of a GraphicFrame shape can be identified using three available
        properties on a shape: has_table, has_chart, and has_smart_art. The enclosed
        graphical object is obtained using the properties GraphicFrame.table and
        GraphicFrame.chart. SmartArt is not yet supported. Accessing one of these
        properties on a GraphicFrame not containing the corresponding object raises
        an exception.
        
        
        0.4.2 (2014-04-29)
        ++++++++++++++++++
        
        - fix: issue #88 -- raises on supported image file having uppercase extension
        - fix: issue #89 -- raises on add_slide() where non-contiguous existing ids
        
        
        0.4.1 (2014-04-29)
        ++++++++++++++++++
        
        - Rename Presentation.slidemasters to Presentation.slide_masters.
          Presentation.slidemasters property is deprecated.
        - Rename Presentation.slidelayouts to Presentation.slide_layouts.
          Presentation.slidelayouts property is deprecated.
        - Rename SlideMaster.slidelayouts to SlideMaster.slide_layouts.
          SlideMaster.slidelayouts property is deprecated.
        - Rename SlideLayout.slidemaster to SlideLayout.slide_master.
          SlideLayout.slidemaster property is deprecated.
        - Rename Slide.slidelayout to Slide.slide_layout. Slide.slidelayout property
          is deprecated.
        - Add SlideMaster.shapes to access shapes on slide master.
        - Add SlideMaster.placeholders to access placeholder shapes on slide master.
        - Add _MasterPlaceholder class.
        - Add _LayoutPlaceholder class with position and size inheritable from master
          placeholder.
        - Add _SlidePlaceholder class with position and size inheritable from layout
          placeholder.
        - Add Table.left, top, width, and height read/write properties.
        - Add rudimentary GroupShape with left, top, width, and height properties.
        - Add rudimentary Connector with left, top, width, and height properties.
        - Add TextFrame.auto_size property.
        - Add Presentation.slide_width and .slide_height read/write properties.
        - Add LineFormat class providing access to read and change line color and
          width.
        - Add AutoShape.line
        - Add Picture.line
        
        - Rationalize enumerations. **Note backward incompatibilities below**
        
        **BACKWARD INCOMPATIBILITIES:**
        
        The following enumerations were moved/renamed during the rationalization of
        enumerations:
        
        - ``pptx.enum.MSO_COLOR_TYPE`` --> ``pptx.enum.dml.MSO_COLOR_TYPE``
        - ``pptx.enum.MSO_FILL`` --> ``pptx.enum.dml.MSO_FILL``
        - ``pptx.enum.MSO_THEME_COLOR`` --> ``pptx.enum.dml.MSO_THEME_COLOR``
        - ``pptx.constants.MSO.ANCHOR_*`` --> ``pptx.enum.text.MSO_ANCHOR.*``
        - ``pptx.constants.MSO_SHAPE`` --> ``pptx.enum.shapes.MSO_SHAPE``
        - ``pptx.constants.PP.ALIGN_*`` --> ``pptx.enum.text.PP_ALIGN.*``
        - ``pptx.constants.MSO.{SHAPE_TYPES}`` -->
          ``pptx.enum.shapes.MSO_SHAPE_TYPE.*``
        
        Documentation for all enumerations is available in the Enumerations section
        of the User Guide.
        
        
        0.3.2 (2014-02-07)
        ++++++++++++++++++
        
        - Hotfix: issue #80 generated presentations fail to load in Keynote and other
          Apple applications
        
        
        0.3.1 (2014-01-10)
        ++++++++++++++++++
        
        - Hotfix: failed to load certain presentations containing images with
          uppercase extension
        
        
        0.3.0 (2013-12-12)
        ++++++++++++++++++
        
        - Add read/write font color property supporting RGB, theme color, and inherit
          color types
        - Add font typeface and italic support
        - Add text frame margins and word-wrap
        - Add support for external relationships, e.g. linked spreadsheet
        - Add hyperlink support for text run in shape and table cell
        - Add fill color and brightness for shape and table cell, fill can also be set
          to transparent (no fill)
        - Add read/write position and size properties to shape and picture
        - Replace PIL dependency with Pillow
        - Restructure modules to better suit size of library
        
        
        0.2.6 (2013-06-22)
        ++++++++++++++++++
        
        - Add read/write access to core document properties
        - Hotfix to accomodate connector shapes in _AutoShapeType
        - Hotfix to allow customXml parts to load when present
        
        
        0.2.5 (2013-06-11)
        ++++++++++++++++++
        
        - Add paragraph alignment property (left, right, centered, etc.)
        - Add vertical alignment within table cell (top, middle, bottom)
        - Add table cell margin properties
        - Add table boolean properties: first column (row header), first row (column
          headings), last row (for e.g. totals row), last column (for e.g. row
          totals), horizontal banding, and vertical banding.
        - Add support for auto shape adjustment values, e.g. change radius of corner
          rounding on rounded rectangle, position of callout arrow, etc.
        
        
        0.2.4 (2013-05-16)
        ++++++++++++++++++
        
        - Add support for auto shapes (e.g. polygons, flowchart symbols, etc.)
        
        
        0.2.3 (2013-05-05)
        ++++++++++++++++++
        
        - Add support for table shapes
        - Add indentation support to textbox shapes, enabling multi-level bullets on
          bullet slides.
        
        
        0.2.2 (2013-03-25)
        ++++++++++++++++++
        
        - Add support for opening and saving a presentation from/to a file-like
          object.
        - Refactor XML handling to use lxml objectify
        
        
        0.2.1 (2013-02-25)
        ++++++++++++++++++
        
        - Add support for Python 2.6
        - Add images from a stream (e.g. StringIO) in addition to a path, allowing
          images retrieved from a database or network resource to be inserted without
          saving first.
        - Expand text methods to accept unicode and UTF-8 encoded 8-bit strings.
        - Fix potential install bug triggered by importing ``__version__`` from
          package ``__init__.py`` file.
        
        
        0.2.0 (2013-02-10)
        ++++++++++++++++++
        
        First non-alpha release with basic capabilities:
        
        - open presentation/template or use built-in default template
        - add slide
        - set placeholder text (e.g. bullet slides)
        - add picture
        - add text box
        
Keywords: powerpoint ppt pptx office open xml
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Office/Business :: Office Suites
Classifier: Topic :: Software Development :: Libraries
