picogl.tests.test_vertex_buffer_group

Unit tests for the VertexBufferGroup class in the PicoGL OpenGL backend.

This module contains a comprehensive suite of unit tests for verifying the correctness, robustness, and interface of the picogl.gpu.buffers.vertex.legacy.VertexBufferGroup class, which manages legacy OpenGL vertex buffer objects and mimics VAO functionality.

The tests cover:

• Object initialization and setup

• VBO management and attribute configuration

• EBO (Element Buffer Object) management

• Layout descriptor configuration

• Drawing operations with various modes

• Buffer cleanup and memory management

• Error handling and edge cases

• Legacy client state management

Dependencies:

• unittest (standard library)

• unittest.mock.MagicMock for OpenGL function mocking

• numpy for test data

• picogl.gpu.buffers.vertex.legacy.VertexBufferGroup

• picogl.buffers.attributes.LayoutDescriptor

To run the tests:

python -m unittest picogl.tests.test_vertex_buffer_group

Classes

TestVertexBufferGroup

Test cases for VertexBufferGroup class.

Module Contents

class picogl.tests.test_vertex_buffer_group.TestVertexBufferGroup(methodName='runTest')

Bases: unittest.TestCase

Test cases for VertexBufferGroup class.

setUp()

Set up test fixtures before each test method.

tearDown()

Clean up after each test method.

test_initialization()

Test VertexBufferGroup initialization.

test_add_vbo_object()

Test add_vbo_object method for VBO management.

test_get_vbo_object()

Test get_vbo_object method for VBO retrieval.

test_index_count_property()

Test index_count property.

test_add_vbo()

Test add_vbo method with different buffer types.

test_add_vbo_with_custom_parameters()

Test add_vbo method with custom parameters.

test_add_vbo_invalid_parameters()

Test add_vbo method with invalid parameters.

test_add_ebo()

Test add_ebo method.

test_get_buffer_class()

Test get_buffer_class method.

test_draw_with_arrays()

Test draw method with vertex arrays.

test_draw_with_auto_index_count()

Test draw method with automatic index count.

test_draw_elements()

Test draw_elements method.

test_draw_elements_without_ebo()

Test draw_elements method without EBO raises error.

test_draw_elements_with_auto_count()

Test draw_elements method with automatic count.

test_set_layout()

Test set_layout method.

test_bind_with_layout()

Test bind method with layout.

test_bind_without_layout()

Test bind method without layout.

test_bind_with_missing_vbo()

Test bind method with missing VBO in layout.

test_unbind_with_layout()

Test unbind method with layout.

test_unbind_without_layout()

Test unbind method without layout.

test_delete()

Test delete method.

test_delete_with_none_buffers()

Test delete method with None buffers.

test_context_manager()

Test that VertexBufferGroup can be used as a context manager.

test_error_handling_in_add_vbo()

Test error handling in add_vbo method.

test_error_handling_in_bind()

Test error handling in bind method.

test_bind_without_ebo()

bind() skips EBO when geometry uses glDrawArrays only.

test_bind_legacy_buffer_roles()

bind() resolves pointer method names and VertexBufferRole attributes.

test_bind_uses_vbo_handle()

bind() passes VBO handle to glBindBuffer, not the buffer object.

test_bind_resolves_role_from_attr_role()

bind() uses AttributeSpec.role as the canonical buffer role.

test_bind_resolves_role_from_vbo_type()

bind() resolves buffer role from AttributeSpec.vbo_type.

test_compat_properties_sync_named_vbos()

vbo/cbo/nbo/ebo properties read and write named_vbos.

test_draw_elements_uses_layout_bind_only()

draw_elements() relies on layout bind(), not per-VBO bind().

test_type_conversion_in_bind()

Test type conversion handling in bind method.

test_repr_string()

Test string representation of VertexBufferGroup.

test_vbo_classes_mapping()

Test VBO classes mapping is correct.

test_resolve_client_states()

_resolve_client_states() derives gl client states from layout roles.

test_legacy_client_states_integration()

Test integration with legacy client states.