| Name | petpptx JSON |
| Version |
1.0.3
JSON |
| download |
| home_page | https://github.com/sedrew/petpptx |
| Summary | Generate and manipulate Open XML PowerPoint (.pptx) files |
| upload_time | 2023-08-01 06:54:34 |
| maintainer | |
| docs_url | None |
| author | Sergey Malygin |
| requires_python | |
| license | The MIT License (MIT) Copyright (c) 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. |
| keywords |
powerpoint
ppt
pptx
office
open
xml
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
behave
flake8
lxml
mock
Pillow
pyparsing
pytest
XlsxWriter
|
| Travis-CI |
|
| coveralls test coverage |
No coveralls.
|
.. image:: https://img.shields.io/pypi/pyversions/petpptx.svg
:target: https://github.com/sedrew/petpptx
.. image:: https://img.shields.io/github/license/sedrew/petpptx.svg
:target: https://github.com/sedrew/python-petpptx/blob/master/LICENSE
*petpptx* is a Python library for creating and updating PowerPoint (.pptx) files.
This is a fork of the `python-pptx`_ project, it has not been updated for a long time, a lot of bugs have been accumulated during this time, and for the use of new features I had to look in all forks of this project.
I've been using it a lot lately in my work, so I'm adding all the features I need here.
Feel free to open PR and ask your questions.
To explore the possibilities, you can use the old `python-pptx documentation`_.
Browse `examples with screenshots`_ to get a quick idea what you can do with
python-pptx.
============
Installation
============
Install the Python **petpptx** package in the terminal using ``pip`` with::
pip install petpptx
.. _`python-pptx`:
https://github.com/scanny/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
---------------
1.0.2 (2023-08-01)
+++++++++++++++++++
- Add `shape.visible` property returns or sets the visibility of the specified object
1.0.2 (2023-06-06)
+++++++++++++++++++
- Rename name project
1.0.1 (2023-06-06)
+++++++++++++++++++
- Fix module 'collections' has no attribute 'Container' for latest python 3.10
1.0.0 (2023-06-06)
+++++++++++++++++++
- Release of a new version of the project
- Add setter for font in Run
0.6.21 (2021-09-20)
+++++++++++++++++++
- Fix #741 _DirPkgReader must implement .__contains__()
0.6.20 (2021-09-14)
+++++++++++++++++++
- Fix #206 accommodate NULL target-references in relationships.
- Fix #223 escape image filename that appears as literal in XML.
- Fix #517 option to display chart categories/values in reverse order.
- Major refactoring of ancient package loading code.
0.6.19 (2021-05-17)
+++++++++++++++++++
- Add shapes.add_ole_object(), allowing arbitrary Excel or other binary file to be
embedded as a shape on a slide. The OLE object is represented as an icon.
0.6.18 (2019-05-02)
+++++++++++++++++++
- .text property getters encode line-break as a vertical-tab (VT, '\v', ASCII 11/x0B).
This is consistent with PowerPoint's copy/paste behavior and allows like-breaks (soft
carriage-return) to be distinguished from paragraph boundary. Previously, a line-break
was encoded as a newline ('\n') and was not distinguishable from a paragraph boundary.
.text properties include Shape.text, _Cell.text, TextFrame.text, _Paragraph.text and
_Run.text.
- .text property setters accept vertical-tab character and place a line-break element in
that location. All other control characters other than horizontal-tab ('\t') and
newline ('\n') in range \x00-\x1F are accepted and escaped with plain-text like
"_x001B" for ESC (ASCII 27).
Previously a control character other than tab or newline in an assigned string would
trigger an exception related to invalid XML character.
0.6.17 (2018-12-16)
+++++++++++++++++++
- Add SlideLayouts.remove() - Delete unused slide-layout
- Add SlideLayout.used_by_slides - Get slides based on this slide-layout
- Add SlideLayouts.index() - Get index of slide-layout in master
- Add SlideLayouts.get_by_name() - Get slide-layout by its str name
0.6.16 (2018-11-09)
+++++++++++++++++++
- Feature #395 DataLabels.show_* properties, e.g. .show_percentage
- Feature #453 Chart data tolerates None for labels
0.6.15 (2018-09-24)
+++++++++++++++++++
- Fix #436 ValueAxis._cross_xAx fails on c:dateAxis
0.6.14 (2018-09-24)
+++++++++++++++++++
- Add _Cell.merge()
- Add _Cell.split()
- Add _Cell.__eq__()
- Add _Cell.is_merge_origin
- Add _Cell.is_spanned
- Add _Cell.span_height
- Add _Cell.span_width
- Add _Cell.text getter
- Add Table.iter_cells()
- Move pptx.shapes.table module to pptx.table
- Add user documentation 'Working with tables'
0.6.13 (2018-09-10)
+++++++++++++++++++
- Add Chart.font
- Fix #293 Can't hide title of single-series Chart
- Fix shape.width value is not type Emu
- Fix add a:defRPr with c:rich (fixes some font inheritance breakage)
0.6.12 (2018-08-11)
+++++++++++++++++++
- Add Picture.auto_shape_type
- Remove Python 2.6 testing from build
- Update dependencies to avoid vulnerable Pillow version
- Fix #260, #301, #382, #401
- Add _Paragraph.add_line_break()
- Add Connector.line
0.6.11 (2018-07-25)
+++++++++++++++++++
- Add gradient fill.
- Add experimental "turbo-add" option for producing large shape-count slides.
0.6.10 (2018-06-11)
+++++++++++++++++++
- Add `shape.shadow` property to autoshape, connector, picture, and group
shape, returning a `ShadowFormat` object.
- Add `ShadowFormat` object with read/write (boolean) `.inherit` property.
- Fix #328 add support for 26+ series in a chart
0.6.9 (2018-05-08)
++++++++++++++++++
- Add `Picture.crop_x` setters, allowing picture cropping values to be set,
in addition to interrogated.
- Add `Slide.background` and `SlideMaster.background`, allowing the
background fill to be set for an individual slide or for all slides based
on a slide master.
- Add option `shapes` parameter to `Shapes.add_group_shape`, allowing a group
shape to be formed from a number of existing shapes.
- Improve efficiency of `Shapes._next_shape_id` property to improve
performance on high shape-count slides.
0.6.8 (2018-04-18)
++++++++++++++++++
- Add `GroupShape`, providing properties specific to a group shape, including
its `shapes` property.
- Add `GroupShapes`, providing access to shapes contained in a group shape.
- Add `SlideShapes.add_group_shape()`, allowing a group shape to be added to
a slide.
- Add `GroupShapes.add_group_shape()`, allowing a group shape to be added to
a group shape, enabling recursive, multi-level groups.
- Add support for adding jump-to-named-slide behavior to shape and run
hyperlinks.
0.6.7 (2017-10-30)
++++++++++++++++++
- Add `SlideShapes.build_freeform()`, allowing freeform shapes (such as maps)
to be specified and added to a slide.
- Add support for patterned fills.
- Add `LineFormat.dash_style` to allow interrogation and setting of dashed
line styles.
0.6.6 (2017-06-17)
++++++++++++++++++
- Add `SlideShapes.add_movie()`, allowing video media to be added to a slide.
- fix #190 Accommodate non-conforming part names having '00' index segment.
- fix #273 Accommodate non-conforming part names having no index segment.
- fix #277 ASCII/Unicode error on non-ASCII multi-level category names
- fix #279 BaseShape.id warning appearing on placeholder access.
0.6.5 (2017-03-21)
++++++++++++++++++
- #267 compensate for non-conforming PowerPoint behavior on c:overlay element
- compensate for non-conforming (to spec) PowerPoint behavior related to
c:dLbl/c:tx that results in "can't save" error when explicit data labels
are added to bubbles on a bubble chart.
0.6.4 (2017-03-17)
++++++++++++++++++
- add Chart.chart_title and ChartTitle object
- #263 Use Number type to test for numeric category
0.6.3 (2017-02-28)
++++++++++++++++++
- add DataLabel.font
- add Axis.axis_title
0.6.2 (2017-01-03)
++++++++++++++++++
- add support for NotesSlide (slide notes, aka. notes page)
- add support for arbitrary series ordering in XML
- add Plot.categories providing access to hierarchical categories in an
existing chart.
- add support for date axes on category charts, including writing a dateAx
element for the category axis when ChartData categories are date or
datetime.
**BACKWARD INCOMPATIBILITIES:**
Some changes were made to the boilerplate XML used to create new charts. This
was done to more closely adhere to the settings PowerPoint uses when creating
a chart using the UI. This may result in some appearance changes in charts
after upgrading. In particular:
* Chart.has_legend now defaults to True for Line charts.
* Plot.vary_by_categories now defaults to False for Line charts.
0.6.1 (2016-10-09)
++++++++++++++++++
- add Connector shape type
0.6.0 (2016-08-18)
++++++++++++++++++
- add XY chart types
- add Bubble chart types
- add Radar chart types
- add Area chart types
- add Doughnut chart types
- add Series.points and Point
- add Point.data_label
- add DataLabel.text_frame
- add DataLabel.position
- add Axis.major_gridlines
- add ChartFormat with .fill and .line
- add Axis.format (fill and line formatting)
- add ValueAxis.crosses and .crosses_at
- add Point.format (fill and line formatting)
- add Slide.slide_id
- add Slides.get() (by slide id)
- add Font.language_id
- support blank (None) data points in created charts
- add Series.marker
- add Point.marker
- add Marker.format, .style, and .size
0.5.8 (2015-11-27)
++++++++++++++++++
- add Shape.click_action (hyperlink on shape)
- fix: #128 Chart cat and ser names not escaped
- fix: #153 shapes.title raises on no title shape
- fix: #170 remove seek(0) from Image.from_file()
0.5.7 (2015-01-17)
++++++++++++++++++
- add PicturePlaceholder with .insert_picture() method
- add TablePlaceholder with .insert_table() method
- add ChartPlaceholder with .insert_chart() method
- add Picture.image property, returning Image object
- add Picture.crop_left, .crop_top, .crop_right, and .crop_bottom
- add Shape.placeholder_format and PlaceholderFormat object
**BACKWARD INCOMPATIBILITIES:**
Shape.shape_type is now unconditionally `MSO_SHAPE_TYPE.PLACEHOLDER` for all
placeholder shapes. Previously, some placeholder shapes reported
`MSO_SHAPE_TYPE.AUTO_SHAPE`, `MSO_SHAPE_TYPE.CHART`,
`MSO_SHAPE_TYPE.PICTURE`, or `MSO_SHAPE_TYPE.TABLE` for that property.
0.5.6 (2014-12-06)
++++++++++++++++++
- fix #138 - UnicodeDecodeError in setup.py on Windows 7 Python 3.4
0.5.5 (2014-11-17)
++++++++++++++++++
- feature #51 - add Python 3 support
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
Raw data
{
"_id": null,
"home_page": "https://github.com/sedrew/petpptx",
"name": "petpptx",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "powerpoint ppt pptx office open xml",
"author": "Sergey Malygin",
"author_email": "maligin.serega2010@yndex.ru",
"download_url": "https://files.pythonhosted.org/packages/d3/c5/1906127eefdb221d5b2f33d176b3909c006c6bd8a0a708475030c9e37657/petpptx-1.0.3.tar.gz",
"platform": null,
"description": ".. image:: https://img.shields.io/pypi/pyversions/petpptx.svg\r\n :target: https://github.com/sedrew/petpptx\r\n.. image:: https://img.shields.io/github/license/sedrew/petpptx.svg\r\n :target: https://github.com/sedrew/python-petpptx/blob/master/LICENSE\r\n \r\n*petpptx* is a Python library for creating and updating PowerPoint (.pptx) files.\r\n\r\nThis is a fork of the `python-pptx`_ project, it has not been updated for a long time, a lot of bugs have been accumulated during this time, and for the use of new features I had to look in all forks of this project.\r\nI've been using it a lot lately in my work, so I'm adding all the features I need here.\r\nFeel free to open PR and ask your questions.\r\nTo explore the possibilities, you can use the old `python-pptx documentation`_.\r\n\r\nBrowse `examples with screenshots`_ to get a quick idea what you can do with\r\npython-pptx.\r\n\r\n============\r\nInstallation\r\n============\r\n\r\nInstall the Python **petpptx** package in the terminal using ``pip`` with::\r\n \r\n pip install petpptx\r\n\r\n.. _`python-pptx`:\r\n https://github.com/scanny/python-pptx/\r\n\r\n.. _`python-pptx documentation`:\r\n https://python-pptx.readthedocs.org/en/latest/\r\n\r\n.. _`examples with screenshots`:\r\n https://python-pptx.readthedocs.org/en/latest/user/quickstart.html\r\n\r\n\r\n.. :changelog:\r\n\r\nRelease History\r\n---------------\r\n\r\n\r\n1.0.2 (2023-08-01)\r\n+++++++++++++++++++\r\n\r\n- Add `shape.visible` property returns or sets the visibility of the specified object\r\n\r\n\r\n1.0.2 (2023-06-06)\r\n+++++++++++++++++++\r\n\r\n- Rename name project\r\n\r\n\r\n1.0.1 (2023-06-06)\r\n+++++++++++++++++++\r\n\r\n- Fix module 'collections' has no attribute 'Container' for latest python 3.10\r\n\r\n\r\n1.0.0 (2023-06-06)\r\n+++++++++++++++++++\r\n\r\n- Release of a new version of the project\r\n- Add setter for font in Run\r\n\r\n\r\n0.6.21 (2021-09-20)\r\n+++++++++++++++++++\r\n\r\n- Fix #741 _DirPkgReader must implement .__contains__()\r\n\r\n\r\n0.6.20 (2021-09-14)\r\n+++++++++++++++++++\r\n\r\n- Fix #206 accommodate NULL target-references in relationships.\r\n- Fix #223 escape image filename that appears as literal in XML.\r\n- Fix #517 option to display chart categories/values in reverse order.\r\n- Major refactoring of ancient package loading code.\r\n\r\n\r\n0.6.19 (2021-05-17)\r\n+++++++++++++++++++\r\n\r\n- Add shapes.add_ole_object(), allowing arbitrary Excel or other binary file to be\r\n embedded as a shape on a slide. The OLE object is represented as an icon.\r\n\r\n\r\n0.6.18 (2019-05-02)\r\n+++++++++++++++++++\r\n\r\n- .text property getters encode line-break as a vertical-tab (VT, '\\v', ASCII 11/x0B).\r\n This is consistent with PowerPoint's copy/paste behavior and allows like-breaks (soft\r\n carriage-return) to be distinguished from paragraph boundary. Previously, a line-break\r\n was encoded as a newline ('\\n') and was not distinguishable from a paragraph boundary.\r\n\r\n .text properties include Shape.text, _Cell.text, TextFrame.text, _Paragraph.text and\r\n _Run.text.\r\n\r\n- .text property setters accept vertical-tab character and place a line-break element in\r\n that location. All other control characters other than horizontal-tab ('\\t') and\r\n newline ('\\n') in range \\x00-\\x1F are accepted and escaped with plain-text like\r\n \"_x001B\" for ESC (ASCII 27).\r\n\r\n Previously a control character other than tab or newline in an assigned string would\r\n trigger an exception related to invalid XML character.\r\n\r\n\r\n0.6.17 (2018-12-16)\r\n+++++++++++++++++++\r\n\r\n- Add SlideLayouts.remove() - Delete unused slide-layout\r\n- Add SlideLayout.used_by_slides - Get slides based on this slide-layout\r\n- Add SlideLayouts.index() - Get index of slide-layout in master\r\n- Add SlideLayouts.get_by_name() - Get slide-layout by its str name\r\n\r\n\r\n0.6.16 (2018-11-09)\r\n+++++++++++++++++++\r\n\r\n- Feature #395 DataLabels.show_* properties, e.g. .show_percentage\r\n- Feature #453 Chart data tolerates None for labels\r\n\r\n\r\n0.6.15 (2018-09-24)\r\n+++++++++++++++++++\r\n\r\n- Fix #436 ValueAxis._cross_xAx fails on c:dateAxis\r\n\r\n\r\n0.6.14 (2018-09-24)\r\n+++++++++++++++++++\r\n\r\n- Add _Cell.merge()\r\n- Add _Cell.split()\r\n- Add _Cell.__eq__()\r\n- Add _Cell.is_merge_origin\r\n- Add _Cell.is_spanned\r\n- Add _Cell.span_height\r\n- Add _Cell.span_width\r\n- Add _Cell.text getter\r\n- Add Table.iter_cells()\r\n- Move pptx.shapes.table module to pptx.table\r\n- Add user documentation 'Working with tables'\r\n\r\n\r\n0.6.13 (2018-09-10)\r\n+++++++++++++++++++\r\n\r\n- Add Chart.font\r\n- Fix #293 Can't hide title of single-series Chart\r\n- Fix shape.width value is not type Emu\r\n- Fix add a:defRPr with c:rich (fixes some font inheritance breakage)\r\n\r\n\r\n0.6.12 (2018-08-11)\r\n+++++++++++++++++++\r\n\r\n- Add Picture.auto_shape_type\r\n- Remove Python 2.6 testing from build\r\n- Update dependencies to avoid vulnerable Pillow version\r\n- Fix #260, #301, #382, #401\r\n- Add _Paragraph.add_line_break()\r\n- Add Connector.line\r\n\r\n\r\n0.6.11 (2018-07-25)\r\n+++++++++++++++++++\r\n\r\n- Add gradient fill.\r\n- Add experimental \"turbo-add\" option for producing large shape-count slides.\r\n\r\n\r\n0.6.10 (2018-06-11)\r\n+++++++++++++++++++\r\n\r\n- Add `shape.shadow` property to autoshape, connector, picture, and group\r\n shape, returning a `ShadowFormat` object.\r\n- Add `ShadowFormat` object with read/write (boolean) `.inherit` property.\r\n- Fix #328 add support for 26+ series in a chart\r\n\r\n\r\n0.6.9 (2018-05-08)\r\n++++++++++++++++++\r\n\r\n- Add `Picture.crop_x` setters, allowing picture cropping values to be set,\r\n in addition to interrogated.\r\n- Add `Slide.background` and `SlideMaster.background`, allowing the\r\n background fill to be set for an individual slide or for all slides based\r\n on a slide master.\r\n- Add option `shapes` parameter to `Shapes.add_group_shape`, allowing a group\r\n shape to be formed from a number of existing shapes.\r\n- Improve efficiency of `Shapes._next_shape_id` property to improve\r\n performance on high shape-count slides.\r\n\r\n\r\n0.6.8 (2018-04-18)\r\n++++++++++++++++++\r\n\r\n- Add `GroupShape`, providing properties specific to a group shape, including\r\n its `shapes` property.\r\n- Add `GroupShapes`, providing access to shapes contained in a group shape.\r\n- Add `SlideShapes.add_group_shape()`, allowing a group shape to be added to\r\n a slide.\r\n- Add `GroupShapes.add_group_shape()`, allowing a group shape to be added to\r\n a group shape, enabling recursive, multi-level groups.\r\n- Add support for adding jump-to-named-slide behavior to shape and run\r\n hyperlinks.\r\n\r\n\r\n0.6.7 (2017-10-30)\r\n++++++++++++++++++\r\n\r\n- Add `SlideShapes.build_freeform()`, allowing freeform shapes (such as maps)\r\n to be specified and added to a slide.\r\n- Add support for patterned fills.\r\n- Add `LineFormat.dash_style` to allow interrogation and setting of dashed\r\n line styles.\r\n\r\n\r\n0.6.6 (2017-06-17)\r\n++++++++++++++++++\r\n\r\n- Add `SlideShapes.add_movie()`, allowing video media to be added to a slide.\r\n\r\n- fix #190 Accommodate non-conforming part names having '00' index segment.\r\n- fix #273 Accommodate non-conforming part names having no index segment.\r\n- fix #277 ASCII/Unicode error on non-ASCII multi-level category names\r\n- fix #279 BaseShape.id warning appearing on placeholder access.\r\n\r\n\r\n0.6.5 (2017-03-21)\r\n++++++++++++++++++\r\n\r\n- #267 compensate for non-conforming PowerPoint behavior on c:overlay element\r\n\r\n- compensate for non-conforming (to spec) PowerPoint behavior related to\r\n c:dLbl/c:tx that results in \"can't save\" error when explicit data labels\r\n are added to bubbles on a bubble chart.\r\n\r\n\r\n0.6.4 (2017-03-17)\r\n++++++++++++++++++\r\n\r\n- add Chart.chart_title and ChartTitle object\r\n- #263 Use Number type to test for numeric category\r\n\r\n\r\n0.6.3 (2017-02-28)\r\n++++++++++++++++++\r\n\r\n- add DataLabel.font\r\n- add Axis.axis_title\r\n\r\n\r\n0.6.2 (2017-01-03)\r\n++++++++++++++++++\r\n\r\n- add support for NotesSlide (slide notes, aka. notes page)\r\n- add support for arbitrary series ordering in XML\r\n- add Plot.categories providing access to hierarchical categories in an\r\n existing chart.\r\n- add support for date axes on category charts, including writing a dateAx\r\n element for the category axis when ChartData categories are date or\r\n datetime.\r\n\r\n**BACKWARD INCOMPATIBILITIES:**\r\n\r\nSome changes were made to the boilerplate XML used to create new charts. This\r\nwas done to more closely adhere to the settings PowerPoint uses when creating\r\na chart using the UI. This may result in some appearance changes in charts\r\nafter upgrading. In particular:\r\n\r\n* Chart.has_legend now defaults to True for Line charts.\r\n* Plot.vary_by_categories now defaults to False for Line charts.\r\n\r\n\r\n0.6.1 (2016-10-09)\r\n++++++++++++++++++\r\n\r\n- add Connector shape type\r\n\r\n\r\n0.6.0 (2016-08-18)\r\n++++++++++++++++++\r\n\r\n- add XY chart types\r\n- add Bubble chart types\r\n- add Radar chart types\r\n- add Area chart types\r\n- add Doughnut chart types\r\n- add Series.points and Point\r\n- add Point.data_label\r\n- add DataLabel.text_frame\r\n- add DataLabel.position\r\n- add Axis.major_gridlines\r\n- add ChartFormat with .fill and .line\r\n- add Axis.format (fill and line formatting)\r\n- add ValueAxis.crosses and .crosses_at\r\n- add Point.format (fill and line formatting)\r\n- add Slide.slide_id\r\n- add Slides.get() (by slide id)\r\n- add Font.language_id\r\n- support blank (None) data points in created charts\r\n- add Series.marker\r\n- add Point.marker\r\n- add Marker.format, .style, and .size\r\n\r\n\r\n0.5.8 (2015-11-27)\r\n++++++++++++++++++\r\n\r\n- add Shape.click_action (hyperlink on shape)\r\n- fix: #128 Chart cat and ser names not escaped\r\n- fix: #153 shapes.title raises on no title shape\r\n- fix: #170 remove seek(0) from Image.from_file()\r\n\r\n\r\n0.5.7 (2015-01-17)\r\n++++++++++++++++++\r\n\r\n- add PicturePlaceholder with .insert_picture() method\r\n- add TablePlaceholder with .insert_table() method\r\n- add ChartPlaceholder with .insert_chart() method\r\n- add Picture.image property, returning Image object\r\n- add Picture.crop_left, .crop_top, .crop_right, and .crop_bottom\r\n- add Shape.placeholder_format and PlaceholderFormat object\r\n\r\n**BACKWARD INCOMPATIBILITIES:**\r\n\r\nShape.shape_type is now unconditionally `MSO_SHAPE_TYPE.PLACEHOLDER` for all\r\nplaceholder shapes. Previously, some placeholder shapes reported\r\n`MSO_SHAPE_TYPE.AUTO_SHAPE`, `MSO_SHAPE_TYPE.CHART`,\r\n`MSO_SHAPE_TYPE.PICTURE`, or `MSO_SHAPE_TYPE.TABLE` for that property.\r\n\r\n\r\n0.5.6 (2014-12-06)\r\n++++++++++++++++++\r\n\r\n- fix #138 - UnicodeDecodeError in setup.py on Windows 7 Python 3.4\r\n\r\n\r\n0.5.5 (2014-11-17)\r\n++++++++++++++++++\r\n\r\n- feature #51 - add Python 3 support\r\n\r\n\r\n0.5.4 (2014-11-15)\r\n++++++++++++++++++\r\n\r\n- feature #43 - image native size in shapes.add_picture() is now calculated\r\n based on DPI attribute in image file, if present, defaulting to 72 dpi.\r\n- feature #113 - Add Paragraph.space_before, Paragraph.space_after, and\r\n Paragraph.line_spacing\r\n\r\n\r\n0.5.3 (2014-11-09)\r\n++++++++++++++++++\r\n\r\n- add experimental feature TextFrame.fit_text()\r\n\r\n\r\n0.5.2 (2014-10-26)\r\n++++++++++++++++++\r\n\r\n- fix #127 - Shape.text_frame fails on shape having no txBody\r\n\r\n\r\n0.5.1 (2014-09-22)\r\n++++++++++++++++++\r\n\r\n- feature #120 - add Shape.rotation\r\n- feature #97 - add Font.underline\r\n- issue #117 - add BMP image support\r\n- issue #95 - add BaseShape.name setter\r\n- issue #107 - all .text properties should return unicode, not str\r\n- feature #106 - add .text getters to Shape, TextFrame, and Paragraph\r\n\r\n- Rename Shape.textframe to Shape.text_frame.\r\n **Shape.textframe property (by that name) is deprecated.**\r\n\r\n\r\n0.5.0 (2014-09-13)\r\n++++++++++++++++++\r\n\r\n- Add support for creating and manipulating bar, column, line, and pie charts\r\n- Major refactoring of XML layer (oxml)\r\n- Rationalized graphical object shape access\r\n **Note backward incompatibilities below**\r\n\r\n**BACKWARD INCOMPATIBILITIES:**\r\n\r\nA table is no longer treated as a shape. Rather it is a graphical object\r\ncontained in a GraphicFrame shape, as are Chart and SmartArt objects.\r\n\r\nExample::\r\n\r\n table = shapes.add_table(...)\r\n\r\n # becomes\r\n\r\n graphic_frame = shapes.add_table(...)\r\n table = graphic_frame.table\r\n\r\n # or\r\n\r\n table = shapes.add_table(...).table\r\n\r\nAs the enclosing shape, the id, name, shape type, position, and size are\r\nattributes of the enclosing GraphicFrame object.\r\n\r\nThe contents of a GraphicFrame shape can be identified using three available\r\nproperties on a shape: has_table, has_chart, and has_smart_art. The enclosed\r\ngraphical object is obtained using the properties GraphicFrame.table and\r\nGraphicFrame.chart. SmartArt is not yet supported. Accessing one of these\r\nproperties on a GraphicFrame not containing the corresponding object raises\r\nan exception.\r\n\r\n\r\n0.4.2 (2014-04-29)\r\n++++++++++++++++++\r\n\r\n- fix: issue #88 -- raises on supported image file having uppercase extension\r\n- fix: issue #89 -- raises on add_slide() where non-contiguous existing ids\r\n\r\n\r\n0.4.1 (2014-04-29)\r\n++++++++++++++++++\r\n\r\n- Rename Presentation.slidemasters to Presentation.slide_masters.\r\n Presentation.slidemasters property is deprecated.\r\n- Rename Presentation.slidelayouts to Presentation.slide_layouts.\r\n Presentation.slidelayouts property is deprecated.\r\n- Rename SlideMaster.slidelayouts to SlideMaster.slide_layouts.\r\n SlideMaster.slidelayouts property is deprecated.\r\n- Rename SlideLayout.slidemaster to SlideLayout.slide_master.\r\n SlideLayout.slidemaster property is deprecated.\r\n- Rename Slide.slidelayout to Slide.slide_layout. Slide.slidelayout property\r\n is deprecated.\r\n- Add SlideMaster.shapes to access shapes on slide master.\r\n- Add SlideMaster.placeholders to access placeholder shapes on slide master.\r\n- Add _MasterPlaceholder class.\r\n- Add _LayoutPlaceholder class with position and size inheritable from master\r\n placeholder.\r\n- Add _SlidePlaceholder class with position and size inheritable from layout\r\n placeholder.\r\n- Add Table.left, top, width, and height read/write properties.\r\n- Add rudimentary GroupShape with left, top, width, and height properties.\r\n- Add rudimentary Connector with left, top, width, and height properties.\r\n- Add TextFrame.auto_size property.\r\n- Add Presentation.slide_width and .slide_height read/write properties.\r\n- Add LineFormat class providing access to read and change line color and\r\n width.\r\n- Add AutoShape.line\r\n- Add Picture.line\r\n\r\n- Rationalize enumerations. **Note backward incompatibilities below**\r\n\r\n**BACKWARD INCOMPATIBILITIES:**\r\n\r\nThe following enumerations were moved/renamed during the rationalization of\r\nenumerations:\r\n\r\n- ``pptx.enum.MSO_COLOR_TYPE`` --> ``pptx.enum.dml.MSO_COLOR_TYPE``\r\n- ``pptx.enum.MSO_FILL`` --> ``pptx.enum.dml.MSO_FILL``\r\n- ``pptx.enum.MSO_THEME_COLOR`` --> ``pptx.enum.dml.MSO_THEME_COLOR``\r\n- ``pptx.constants.MSO.ANCHOR_*`` --> ``pptx.enum.text.MSO_ANCHOR.*``\r\n- ``pptx.constants.MSO_SHAPE`` --> ``pptx.enum.shapes.MSO_SHAPE``\r\n- ``pptx.constants.PP.ALIGN_*`` --> ``pptx.enum.text.PP_ALIGN.*``\r\n- ``pptx.constants.MSO.{SHAPE_TYPES}`` -->\r\n ``pptx.enum.shapes.MSO_SHAPE_TYPE.*``\r\n\r\nDocumentation for all enumerations is available in the Enumerations section\r\nof the User Guide.\r\n\r\n\r\n0.3.2 (2014-02-07)\r\n++++++++++++++++++\r\n\r\n- Hotfix: issue #80 generated presentations fail to load in Keynote and other\r\n Apple applications\r\n\r\n\r\n0.3.1 (2014-01-10)\r\n++++++++++++++++++\r\n\r\n- Hotfix: failed to load certain presentations containing images with\r\n uppercase extension\r\n\r\n\r\n0.3.0 (2013-12-12)\r\n++++++++++++++++++\r\n\r\n- Add read/write font color property supporting RGB, theme color, and inherit\r\n color types\r\n- Add font typeface and italic support\r\n- Add text frame margins and word-wrap\r\n- Add support for external relationships, e.g. linked spreadsheet\r\n- Add hyperlink support for text run in shape and table cell\r\n- Add fill color and brightness for shape and table cell, fill can also be set\r\n to transparent (no fill)\r\n- Add read/write position and size properties to shape and picture\r\n- Replace PIL dependency with Pillow\r\n- Restructure modules to better suit size of library\r\n\r\n\r\n0.2.6 (2013-06-22)\r\n++++++++++++++++++\r\n\r\n- Add read/write access to core document properties\r\n- Hotfix to accomodate connector shapes in _AutoShapeType\r\n- Hotfix to allow customXml parts to load when present\r\n\r\n\r\n0.2.5 (2013-06-11)\r\n++++++++++++++++++\r\n\r\n- Add paragraph alignment property (left, right, centered, etc.)\r\n- Add vertical alignment within table cell (top, middle, bottom)\r\n- Add table cell margin properties\r\n- Add table boolean properties: first column (row header), first row (column\r\n headings), last row (for e.g. totals row), last column (for e.g. row\r\n totals), horizontal banding, and vertical banding.\r\n- Add support for auto shape adjustment values, e.g. change radius of corner\r\n rounding on rounded rectangle, position of callout arrow, etc.\r\n\r\n\r\n0.2.4 (2013-05-16)\r\n++++++++++++++++++\r\n\r\n- Add support for auto shapes (e.g. polygons, flowchart symbols, etc.)\r\n\r\n\r\n0.2.3 (2013-05-05)\r\n++++++++++++++++++\r\n\r\n- Add support for table shapes\r\n- Add indentation support to textbox shapes, enabling multi-level bullets on\r\n bullet slides.\r\n\r\n\r\n0.2.2 (2013-03-25)\r\n++++++++++++++++++\r\n\r\n- Add support for opening and saving a presentation from/to a file-like\r\n object.\r\n- Refactor XML handling to use lxml objectify\r\n\r\n\r\n0.2.1 (2013-02-25)\r\n++++++++++++++++++\r\n\r\n- Add support for Python 2.6\r\n- Add images from a stream (e.g. StringIO) in addition to a path, allowing\r\n images retrieved from a database or network resource to be inserted without\r\n saving first.\r\n- Expand text methods to accept unicode and UTF-8 encoded 8-bit strings.\r\n- Fix potential install bug triggered by importing ``__version__`` from\r\n package ``__init__.py`` file.\r\n\r\n\r\n0.2.0 (2013-02-10)\r\n++++++++++++++++++\r\n\r\nFirst non-alpha release with basic capabilities:\r\n\r\n- open presentation/template or use built-in default template\r\n- add slide\r\n- set placeholder text (e.g. bullet slides)\r\n- add picture\r\n- add text box\r\n",
"bugtrack_url": null,
"license": "The MIT License (MIT) Copyright (c) 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. ",
"summary": "Generate and manipulate Open XML PowerPoint (.pptx) files",
"version": "1.0.3",
"project_urls": {
"Homepage": "https://github.com/sedrew/petpptx"
},
"split_keywords": [
"powerpoint",
"ppt",
"pptx",
"office",
"open",
"xml"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d3c51906127eefdb221d5b2f33d176b3909c006c6bd8a0a708475030c9e37657",
"md5": "c738772875837b214214c4eeac774147",
"sha256": "b6b77ea189751449301bd6961f33cb521f15a7196bbf16d4d7db6db9c1cc1674"
},
"downloads": -1,
"filename": "petpptx-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "c738772875837b214214c4eeac774147",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9718716,
"upload_time": "2023-08-01T06:54:34",
"upload_time_iso_8601": "2023-08-01T06:54:34.305392Z",
"url": "https://files.pythonhosted.org/packages/d3/c5/1906127eefdb221d5b2f33d176b3909c006c6bd8a0a708475030c9e37657/petpptx-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-01 06:54:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sedrew",
"github_project": "petpptx",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "behave",
"specs": [
[
">=",
"1.2.5"
]
]
},
{
"name": "flake8",
"specs": [
[
">=",
"2.0"
]
]
},
{
"name": "lxml",
"specs": [
[
">=",
"3.1.0"
]
]
},
{
"name": "mock",
"specs": [
[
">=",
"1.0.1"
]
]
},
{
"name": "Pillow",
"specs": [
[
">=",
"3.3.2"
]
]
},
{
"name": "pyparsing",
"specs": [
[
">=",
"2.0.1"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"2.5"
]
]
},
{
"name": "XlsxWriter",
"specs": [
[
">=",
"0.5.7"
]
]
}
],
"tox": true,
"lcname": "petpptx"
}
