ply-parser 2.0.0__tar.gz

ply_parser-2.0.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.1
+Name: ply_parser
+Version: 2.0.0
+Summary: A python module that parses ascii PLY (.ply) (Polygon File Format) files. It includes a class PLYObject for storing PLY file data and a function parse_ply_file() for reading PLY files and creating PLYObject instances and can easily be customized.
+Home-page: https://github.com/Qrishna/ply_parser
+Author: Krishna Bhattarai
+Author-email: Krishna Bhattarai <krishna@kbhattarai.com>
+Project-URL: Homepage, https://github.com/Qrishna/ply_parser
+Project-URL: Bug Tracker, https://github.com/Qrishna/ply_parser/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11.4
+Description-Content-Type: text/markdown
+
+### PLY File Parser
+This Python module provides a simple PLY (Polygon File Format) file parser. It includes a class PLYObject for storing PLY file data and a function parse_ply_file for reading PLY files and creating PLYObject instances.
+
+### Usage
+### PLYObject Class
+The PLYObject class represents a PLY object with attributes:
+
+`name`: Name of the PLY object.
+
+`vertices`: List of vertex coordinates.
+
+`faces`: List of face indices.
+
+`colors`: List of RGB color values for vertices.
+
+
+#### parse_ply_file Function
+The parse_ply_file function takes a PLY file as input and returns a PLYObject instance. It reads the file, extracts vertex and face information, and handles color properties. If any inconsistencies or errors are detected in the PLY file, appropriate error messages are displayed.
+```
+file = "data/cube_colors.ply"
+parsed_object = parse_ply_file(file)
+if parsed_object:
+    print("name:", parsed_object.name)
+    print("total_vertices:", len(parsed_object.vertices))
+    print("total_faces:", len(parsed_object.faces))
+    print("total_colors:", len(parsed_object.colors))
+```
+
+### Requirements
+`Python 3.11.x`
+
+### PLY File Format Support
+This parser currently supports PLY files with the following characteristics:
+
+`ASCII format`
+
+`Vertex coordinates (X, Y, Z)`
+
+`Face indices (triangles and quads)`
+
+`Vertex colors`
+
+### Testing
+```
+python3 -m unittest tests/test_ply_parser.py -v
+```
+
+### Limitations
+The parser assumes the input PLY file follows the standard specifications.
+It may not handle non-standard or corrupted PLY files gracefully.
+
+
+### Contribution
+Feel free to contribute by opening issues or submitting pull requests. Bug reports, suggestions, and improvements are welcome.
+
+### License
+This PLY file parser is licensed under the MIT License. See the LICENSE file for details.

ply_parser-2.0.0/README.md

@@ -0,0 +1,57 @@
+### PLY File Parser
+This Python module provides a simple PLY (Polygon File Format) file parser. It includes a class PLYObject for storing PLY file data and a function parse_ply_file for reading PLY files and creating PLYObject instances.
+
+### Usage
+### PLYObject Class
+The PLYObject class represents a PLY object with attributes:
+
+`name`: Name of the PLY object.
+
+`vertices`: List of vertex coordinates.
+
+`faces`: List of face indices.
+
+`colors`: List of RGB color values for vertices.
+
+
+#### parse_ply_file Function
+The parse_ply_file function takes a PLY file as input and returns a PLYObject instance. It reads the file, extracts vertex and face information, and handles color properties. If any inconsistencies or errors are detected in the PLY file, appropriate error messages are displayed.
+```
+file = "data/cube_colors.ply"
+parsed_object = parse_ply_file(file)
+if parsed_object:
+    print("name:", parsed_object.name)
+    print("total_vertices:", len(parsed_object.vertices))
+    print("total_faces:", len(parsed_object.faces))
+    print("total_colors:", len(parsed_object.colors))
+```
+
+### Requirements
+`Python 3.11.x`
+
+### PLY File Format Support
+This parser currently supports PLY files with the following characteristics:
+
+`ASCII format`
+
+`Vertex coordinates (X, Y, Z)`
+
+`Face indices (triangles and quads)`
+
+`Vertex colors`
+
+### Testing
+```
+python3 -m unittest tests/test_ply_parser.py -v
+```
+
+### Limitations
+The parser assumes the input PLY file follows the standard specifications.
+It may not handle non-standard or corrupted PLY files gracefully.
+
+
+### Contribution
+Feel free to contribute by opening issues or submitting pull requests. Bug reports, suggestions, and improvements are welcome.
+
+### License
+This PLY file parser is licensed under the MIT License. See the LICENSE file for details.

ply_parser-2.0.0/pyproject.toml

@@ -0,0 +1,19 @@
+
+[project]
+name = "ply_parser"
+version = "2.0.0"
+authors = [
+  { name="Krishna Bhattarai", email="krishna@kbhattarai.com" },
+]
+description = "A python module that parses ascii PLY (.ply) (Polygon File Format) files. It includes a class PLYObject for storing PLY file data and a function parse_ply_file() for reading PLY files and creating PLYObject instances and can easily be customized."
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/Qrishna/ply_parser"
+"Bug Tracker" = "https://github.com/Qrishna/ply_parser/issues"

ply_parser-2.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ply_parser-2.0.0/setup.py

@@ -0,0 +1,26 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name='ply_parser',
+    version='2.0.0',
+    author='Krishna Bhattarai',
+    author_email='krishna@kbhattarai.com',
+    description='A python module that parses ascii PLY (.ply) (Polygon File Format) files. It includes a class PLYObject for storing PLY file data and a function parse_ply_file() for reading PLY files and creating PLYObject instances and can easily be customized. ',
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/Qrishna/ply_parser",
+    project_urls={
+      "Bug Tracker": "https://github.com/Qrishna/ply_parser/issues"
+    },
+    package_dir={'': "src"},
+    packages=find_packages("src"),
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+    ],
+    python_requires='>=3.11.4',
+)

ply_parser-2.0.0/src/ply_parser/__init__.py

@@ -0,0 +1 @@
+from .ply_parser import *

ply_parser-2.0.0/src/ply_parser/ply_parser.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+# Krishna Bhattarai
+# Nov 23
+import re
+
+
+class PLYObject:
+    def __init__(self, vertices, faces, colors, name=None):
+        self.name = name
+        self.vertices = vertices
+        self.faces = faces
+        self.colors = colors
+
+
+def get_file_data(file_name):
+    with open(file_name, 'r') as file:
+        data = file.readlines()
+    return data
+
+
+def parse_ply_file_data(lines):
+    expected_faces = None
+    expected_vertices = None
+    vertices, faces, colors = [], [], []
+
+    vertex_count = 0
+    faces_count = 0
+
+    property_red = 0
+    property_blue = 0
+    property_green = 0
+
+    for x in range(0, len(lines)):
+        line = lines[x].strip()
+        if not line or line == '':
+            continue
+        if line.startswith("format"):
+            file_format = line.strip().split()[1]
+            if file_format.lower() != "ascii":
+                # print("File format is not ascii! It is: %s" % file_format)
+                raise ValueError("File format is not ascii! It is: %s" % file_format)
+
+        if line.startswith("comment"):
+            continue
+
+        if "element vertex" in line:
+            expected_vertices = int(re.match(r'^element\s+vertex\s+(\d+)', line).group(1))
+            continue
+
+        if "property uchar red" in line:
+            property_red += 1
+            continue
+
+        if "property uchar green" in line:
+            property_green += 1
+            continue
+
+        if "property uchar blue" in line:
+            property_blue += 1
+            continue
+
+        if re.match(r'^element\s+face\s+\d+', line):
+            expected_faces = int(re.match(r'^element\s+face\s+(\d+)', line).group(1))
+            continue
+
+        elif "end_header" in line:
+            continue
+
+        if re.match(r'^([-|\d]+(\.\d+)?)\s+([-|\d]+(\.\d+)?)\s+([-|\d]+(\.\d+)?)', line) and vertex_count != expected_vertices:
+            vertex_count += 1
+
+            if property_red and property_green and property_blue:
+                vertex = line.strip().split()[0:6]
+                vertices.append([float(vertex[0]), float(vertex[1]), float(vertex[2])])
+                colors.append([float(vertex[3]), float(vertex[4]), float(vertex[5])])
+            else:
+                vertex = line.strip().split()[0:3]
+                vertices.append([float(vertex[0]), float(vertex[1]), float(vertex[2])])
+
+        if re.match(r'^[34]\s+\d+\s+\d+\s\d+', line) and faces_count != expected_faces:
+            faces_count += 1
+            if line[0].startswith('3'):
+                face = line.strip().split()[1:4]
+                faces.append([int(face[0]), int(face[1]), int(face[2])])
+            elif line[0].startswith('4'):
+                face = line.strip().split()[1:5]
+                faces.append([int(face[0]), int(face[1]), int(face[2]), int(face[3])])
+
+    if len(vertices) != expected_vertices:
+        # print("Error: total vertices read: %s does not match expected vertices: %s" % (len(vertices), expected_vertices))
+        raise ValueError("Error: total vertices read: %s does not match expected vertices: %s" % (len(vertices), expected_vertices))
+
+    if len(faces) != expected_faces:
+        # print("Error: total faces read: %s does not match expected faces: %s" % (len(faces), expected_faces))
+        raise ValueError("Error: total faces read: %s does not match expected faces: %s" % (len(faces), expected_faces))
+
+    return [vertices, faces, colors]
+
+
+def parse_ply_file(file_name):
+    file_data_lines = get_file_data(file_name)
+    parsed_data = parse_ply_file_data(file_data_lines)
+    if parsed_data:
+        v, f, c = parsed_data[0], parsed_data[1], parsed_data[2]
+        return PLYObject(v, f, c, file_name.strip())

ply_parser-2.0.0/src/ply_parser/test_ply_parser.py

@@ -0,0 +1,226 @@
+import unittest
+from ply_parser import *
+
+
+class TestPLYParsing(unittest.TestCase):
+    def test_parse_ply_data_with_vertices_and_faces(self):
+        data = """ply
+    format ascii 1.0
+    comment Some comment
+    element vertex 3
+    property float x
+    property float y
+    property float z
+    element face 1
+    end_header
+    1.0 2.0 3.0
+    4.0 5.0 6.0
+    7.0 8.0 9.0
+    3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 0)
+
+    def test_parse_ply_data_with_vertices_colors_and_faces(self):
+        data = """ply
+    format ascii 1.0
+    element vertex 3
+    property float x
+    property float y
+    property float z
+    property uchar red
+    property uchar green
+    property uchar blue
+    element face 1
+    property list uchar int vertex_indices
+    end_header
+    1.0 2.0 3.0 255 0 0
+    4.0 5.0 6.0 0 255 0
+    7.0 8.0 9.0 0 0 255
+    3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 3)
+
+    def test_distinguish_and_count_lines_for_vertices_and_faces(self):
+        data = """ply
+format ascii 1.0
+element vertex 3
+property float x
+property float y
+property float z
+element face 3
+property list uchar int vertex_indices
+end_header
+1.0 2.0 3.0
+4.0 5.0 6.0
+7.0 8.0 9.0
+3 2 1 2
+3 2 2 3
+3 1 2 3"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(vertices, [[1, 2, 3], [4, 5, 6], [7, 8, 9]])
+        self.assertEqual(len(faces), 3)
+        self.assertEqual(faces, [[2, 1, 2], [2, 2, 3], [1, 2, 3]])
+        self.assertEqual(len(colors), 0)
+
+    def test_handle_face_lines_starting_with_4(self):
+        data = """ply
+    format ascii 1.0
+    element vertex 3
+    property float x
+    property float y
+    property float z
+    element face 3
+    property list uchar int vertex_indices
+    end_header
+    1.0 2.0 3.0
+    4.0 5.0 6.0
+    7.0 8.0 9.0
+    4 2 1 2 2
+    4 2 2 3 1
+    4 1 2 3 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(vertices, [[1, 2, 3], [4, 5, 6], [7, 8, 9]])
+        self.assertEqual(len(faces), 3)
+        self.assertEqual(faces, [[2, 1, 2, 2], [2, 2, 3, 1], [1, 2, 3, 2]])
+        self.assertEqual(len(colors), 0)
+
+    def test_parse_ply_data_with_no_vertices_or_faces(self):
+        data = """ply
+format ascii 1.0
+element vertex 0
+element face 0
+end_header"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 0)
+        self.assertEqual(len(faces), 0)
+        self.assertEqual(len(colors), 0)
+
+    def test_handle_invalid_ply_format(self):
+        invalid_format_data = """ply
+format binary 1.0
+element vertex 3
+property float x
+property float y
+property float z
+end_header
+1.0 2.0 3.0
+4.0 5.0 6.0
+7.0 8.0 9.0"""
+
+        with self.assertRaises(ValueError) as context:
+            parse_ply_file_data(invalid_format_data.splitlines())
+        self.assertEqual(str(context.exception), 'File format is not ascii! It is: binary')
+
+    def test_handle_incomplete_vertex_data(self):
+        incomplete_vertex_data = """ply
+    format ascii 1.0
+    element vertex 3
+    property float x
+    property float y
+    property float z
+    end_header
+    1.0 2.0 3.0
+    4.0 5.0 6.0"""
+
+        with self.assertRaises(ValueError) as context:
+            parse_ply_file_data(incomplete_vertex_data.splitlines())
+        self.assertEqual(str(context.exception), 'Error: total vertices read: 2 does not match expected vertices: 3')
+
+    def test_parse_ply_colors_data_if_described_in_header(self):
+        data = """ply
+format ascii 1.0
+element vertex 3
+property float x
+property float y
+property float z
+property uchar red
+property uchar green
+property uchar blue
+element face 1
+end_header
+1.0 2.0 3.0 255 0 0
+4.0 5.0 6.0 0 255 0
+7.0 8.0 9.0 0 0 255
+3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 3)
+        self.assertEqual(colors, [[255, 0, 0], [0, 255, 0], [0, 0, 255]])
+
+    def test_not_parse_colors_if_color_property_not_described(self):
+        data = """ply
+format ascii 1.0
+element vertex 3
+property float x
+property float y
+property float z
+element face 1
+end_header
+1.0 2.0 3.0 255 0 0
+4.0 5.0 6.0 0 255 0
+7.0 8.0 9.0 0 0 255
+3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 0)
+
+    def test_parse_ply_data_with_negative_coordinates(self):
+        data = """ply
+format ascii 1.0
+element vertex 3
+property float x
+property float y
+property float z
+element face 1
+end_header
+-1.0 -2.0 -3.0
+-4.0 -5.0 -6.0
+-7.0 -8.0 -9.0
+3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 0)
+
+    def test_handle_incomplete_face_data(self):
+        incomplete_face_data = """ply
+format ascii 1.0
+element vertex 3
+element face 2
+end_header
+1.0 2.0 3.0
+4.0 5.0 6.0
+7.0 8.0 9.0
+3 0 1 2"""
+
+        with self.assertRaises(ValueError) as context:
+            parse_ply_file_data(incomplete_face_data.splitlines())
+        self.assertEqual(str(context.exception), 'Error: total faces read: 1 does not match expected faces: 2')
+
+
+if __name__ == '__main__':
+    unittest.main()

ply_parser-2.0.0/src/ply_parser.egg-info/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.1
+Name: ply-parser
+Version: 2.0.0
+Summary: A python module that parses ascii PLY (.ply) (Polygon File Format) files. It includes a class PLYObject for storing PLY file data and a function parse_ply_file() for reading PLY files and creating PLYObject instances and can easily be customized.
+Home-page: https://github.com/Qrishna/ply_parser
+Author: Krishna Bhattarai
+Author-email: Krishna Bhattarai <krishna@kbhattarai.com>
+Project-URL: Homepage, https://github.com/Qrishna/ply_parser
+Project-URL: Bug Tracker, https://github.com/Qrishna/ply_parser/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11.4
+Description-Content-Type: text/markdown
+
+### PLY File Parser
+This Python module provides a simple PLY (Polygon File Format) file parser. It includes a class PLYObject for storing PLY file data and a function parse_ply_file for reading PLY files and creating PLYObject instances.
+
+### Usage
+### PLYObject Class
+The PLYObject class represents a PLY object with attributes:
+
+`name`: Name of the PLY object.
+
+`vertices`: List of vertex coordinates.
+
+`faces`: List of face indices.
+
+`colors`: List of RGB color values for vertices.
+
+
+#### parse_ply_file Function
+The parse_ply_file function takes a PLY file as input and returns a PLYObject instance. It reads the file, extracts vertex and face information, and handles color properties. If any inconsistencies or errors are detected in the PLY file, appropriate error messages are displayed.
+```
+file = "data/cube_colors.ply"
+parsed_object = parse_ply_file(file)
+if parsed_object:
+    print("name:", parsed_object.name)
+    print("total_vertices:", len(parsed_object.vertices))
+    print("total_faces:", len(parsed_object.faces))
+    print("total_colors:", len(parsed_object.colors))
+```
+
+### Requirements
+`Python 3.11.x`
+
+### PLY File Format Support
+This parser currently supports PLY files with the following characteristics:
+
+`ASCII format`
+
+`Vertex coordinates (X, Y, Z)`
+
+`Face indices (triangles and quads)`
+
+`Vertex colors`
+
+### Testing
+```
+python3 -m unittest tests/test_ply_parser.py -v
+```
+
+### Limitations
+The parser assumes the input PLY file follows the standard specifications.
+It may not handle non-standard or corrupted PLY files gracefully.
+
+
+### Contribution
+Feel free to contribute by opening issues or submitting pull requests. Bug reports, suggestions, and improvements are welcome.
+
+### License
+This PLY file parser is licensed under the MIT License. See the LICENSE file for details.

ply_parser-2.0.0/src/ply_parser.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+setup.py
+src/ply_parser/__init__.py
+src/ply_parser/ply_parser.py
+src/ply_parser/test_ply_parser.py
+src/ply_parser.egg-info/PKG-INFO
+src/ply_parser.egg-info/SOURCES.txt
+src/ply_parser.egg-info/dependency_links.txt
+src/ply_parser.egg-info/top_level.txt
+tests/test_ply_parser.py

ply_parser-2.0.0/src/ply_parser.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ply_parser-2.0.0/src/ply_parser.egg-info/top_level.txt

@@ -0,0 +1 @@
+ply_parser

ply_parser-2.0.0/tests/test_ply_parser.py

@@ -0,0 +1,226 @@
+import unittest
+from ply_parser import *
+
+
+class TestPLYParsing(unittest.TestCase):
+    def test_parse_ply_data_with_vertices_and_faces(self):
+        data = """ply
+    format ascii 1.0
+    comment Some comment
+    element vertex 3
+    property float x
+    property float y
+    property float z
+    element face 1
+    end_header
+    1.0 2.0 3.0
+    4.0 5.0 6.0
+    7.0 8.0 9.0
+    3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 0)
+
+    def test_parse_ply_data_with_vertices_colors_and_faces(self):
+        data = """ply
+    format ascii 1.0
+    element vertex 3
+    property float x
+    property float y
+    property float z
+    property uchar red
+    property uchar green
+    property uchar blue
+    element face 1
+    property list uchar int vertex_indices
+    end_header
+    1.0 2.0 3.0 255 0 0
+    4.0 5.0 6.0 0 255 0
+    7.0 8.0 9.0 0 0 255
+    3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 3)
+
+    def test_distinguish_and_count_lines_for_vertices_and_faces(self):
+        data = """ply
+format ascii 1.0
+element vertex 3
+property float x
+property float y
+property float z
+element face 3
+property list uchar int vertex_indices
+end_header
+1.0 2.0 3.0
+4.0 5.0 6.0
+7.0 8.0 9.0
+3 2 1 2
+3 2 2 3
+3 1 2 3"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(vertices, [[1, 2, 3], [4, 5, 6], [7, 8, 9]])
+        self.assertEqual(len(faces), 3)
+        self.assertEqual(faces, [[2, 1, 2], [2, 2, 3], [1, 2, 3]])
+        self.assertEqual(len(colors), 0)
+
+    def test_handle_face_lines_starting_with_4(self):
+        data = """ply
+    format ascii 1.0
+    element vertex 3
+    property float x
+    property float y
+    property float z
+    element face 3
+    property list uchar int vertex_indices
+    end_header
+    1.0 2.0 3.0
+    4.0 5.0 6.0
+    7.0 8.0 9.0
+    4 2 1 2 2
+    4 2 2 3 1
+    4 1 2 3 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(vertices, [[1, 2, 3], [4, 5, 6], [7, 8, 9]])
+        self.assertEqual(len(faces), 3)
+        self.assertEqual(faces, [[2, 1, 2, 2], [2, 2, 3, 1], [1, 2, 3, 2]])
+        self.assertEqual(len(colors), 0)
+
+    def test_parse_ply_data_with_no_vertices_or_faces(self):
+        data = """ply
+format ascii 1.0
+element vertex 0
+element face 0
+end_header"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 0)
+        self.assertEqual(len(faces), 0)
+        self.assertEqual(len(colors), 0)
+
+    def test_handle_invalid_ply_format(self):
+        invalid_format_data = """ply
+format binary 1.0
+element vertex 3
+property float x
+property float y
+property float z
+end_header
+1.0 2.0 3.0
+4.0 5.0 6.0
+7.0 8.0 9.0"""
+
+        with self.assertRaises(ValueError) as context:
+            parse_ply_file_data(invalid_format_data.splitlines())
+        self.assertEqual(str(context.exception), 'File format is not ascii! It is: binary')
+
+    def test_handle_incomplete_vertex_data(self):
+        incomplete_vertex_data = """ply
+    format ascii 1.0
+    element vertex 3
+    property float x
+    property float y
+    property float z
+    end_header
+    1.0 2.0 3.0
+    4.0 5.0 6.0"""
+
+        with self.assertRaises(ValueError) as context:
+            parse_ply_file_data(incomplete_vertex_data.splitlines())
+        self.assertEqual(str(context.exception), 'Error: total vertices read: 2 does not match expected vertices: 3')
+
+    def test_parse_ply_colors_data_if_described_in_header(self):
+        data = """ply
+format ascii 1.0
+element vertex 3
+property float x
+property float y
+property float z
+property uchar red
+property uchar green
+property uchar blue
+element face 1
+end_header
+1.0 2.0 3.0 255 0 0
+4.0 5.0 6.0 0 255 0
+7.0 8.0 9.0 0 0 255
+3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 3)
+        self.assertEqual(colors, [[255, 0, 0], [0, 255, 0], [0, 0, 255]])
+
+    def test_not_parse_colors_if_color_property_not_described(self):
+        data = """ply
+format ascii 1.0
+element vertex 3
+property float x
+property float y
+property float z
+element face 1
+end_header
+1.0 2.0 3.0 255 0 0
+4.0 5.0 6.0 0 255 0
+7.0 8.0 9.0 0 0 255
+3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 0)
+
+    def test_parse_ply_data_with_negative_coordinates(self):
+        data = """ply
+format ascii 1.0
+element vertex 3
+property float x
+property float y
+property float z
+element face 1
+end_header
+-1.0 -2.0 -3.0
+-4.0 -5.0 -6.0
+-7.0 -8.0 -9.0
+3 0 1 2"""
+
+        result = parse_ply_file_data(data.splitlines())
+        vertices, faces, colors = result[0], result[1], result[2]
+        self.assertEqual(len(vertices), 3)
+        self.assertEqual(len(faces), 1)
+        self.assertEqual(len(colors), 0)
+
+    def test_handle_incomplete_face_data(self):
+        incomplete_face_data = """ply
+format ascii 1.0
+element vertex 3
+element face 2
+end_header
+1.0 2.0 3.0
+4.0 5.0 6.0
+7.0 8.0 9.0
+3 0 1 2"""
+
+        with self.assertRaises(ValueError) as context:
+            parse_ply_file_data(incomplete_face_data.splitlines())
+        self.assertEqual(str(context.exception), 'Error: total faces read: 1 does not match expected faces: 2')
+
+
+if __name__ == '__main__':
+    unittest.main()