plyfile

Changed

• Minor metadata updates.

Added

• Official support for Python 3.13.
• Official support for NumPy 2.1 and NumPy 2.2.

Changed

• Build backend from pdm-pep517 to pdm-backend. Thanks to @bcbnz for the fix.

Fixed

• Integer overflow when reading large files. Thanks to @cdcseacave for the fix.

Removed

• Official support for NumPy < 1.25.

Added

• Official support for NumPy 2.0.
• Support for write-through memory-mapping. Thanks to @nh2 and @chpatrick for the original implementation.

Fixed

• A small unit test bug.

Removed

• Official support for Python 3.8.
• Official support for NumPy < 1.21.

Fixed

• Maintainers' documentation for publishing.

Added

• Official support for Python 3.12 and numpy 1.26.

Changed

• Minor change to project metadata.

Added

• PDM user scripts for common development workflow tasks.
• New guides for contributing and maintaining.
• .readthedocs.yaml configuration for documentation hosting on readthedocs.io.
• Official support for Python 3.11 and numpy 1.25.

Changed

• Major documentation overhaul:
  • documentation moved from README.md to doc/;
  • Sphinx configuration to render documentation nicely as HTML, including API reference via autodoc.
• Reordering of code in plyfile.py.

Removed

• examples/plot.py, which was a bit out of place.
• Official support for Python 3.7.

Added

• Support for reading ASCII-format PLY files from text streams.
• Doctest runner in unit test suite.

Changed

• Docstring formatting style:
  • better PEP-257 compliance;
  • adoption of NumPy docstring style.

Fixed

• Support for reading Mac-style line endings.

Removed

• Python2-specific code paths.
• make2d function (redundant with numpy.vstack).

Changed

• Package metadata management via PDM, rather than setuptools.

Fixed

• Project classifiers array.

Added

• known_list_len optional argument. Thanks to @markbandstra.

Removed

• Official support for Python<3.7 and numpy<1.17.

Fixed

• DeprecationWarning fix on numpy>=1.19. Thanks to @markbandstra.

Added

• Memory-mapping made optional.
• FAQ section in README.md.
• PlyElement.__len__ and PlyElement.__contains__. Thanks to @athompson673.

Changed

• Syntax highlighting in README.md improved.

Added

• Long description added to package distribution.

Fixed

• License file included in distribution.

Added

• Read & write support for file-like objects.

Fixed

• Documentation improved.

Changed

• Changed line endings back to Unix-style.

Fixed

• make2d on numpy>=1.14.

Deprecated

• make2d function. Please use numpy.vstack.

Added

• Project metadata suitable for PyPI.
• More unit tests.
• Official support for NumPy 1.10 and 1.11.
• Automatic unit test coverage reporting through test runner.
• CHANGELOG.md.
• Comment validation and preservation of leading spaces. Thanks to @Zac-HD for the bug report.
• Better validation of element and property names.

Changed

• Made "private" variables explicitly so.
• Used memory mapping for "simple" PLY elements. Thanks to @Zac-HD for the original pull request.
• (Under the hood) Rewrote header parser.

Removed

• Official support for Python 2.6.

Fixed

• Fixed reading and writing through unicode filenames.
• Fixed documentation bugs. Thanks to @jeremyherbert.

Added

• PlyParseError for parsing errors.
• Explicit (limited) mutability of PLY metadata.
• Better validation when modifying PLY metadata.
• More unit tests.

Removed

• Ability to change element and property names by mutation, which was never handled correctly anyway.