PyVRML97 2.3.4b3__tar.gz → 2.4.0a1__tar.gz

{pyvrml97-2.3.4b3 → pyvrml97-2.4.0a1}/MANIFEST.in

@@ -2,4 +2,5 @@ include *.txt
 include *.in
 include *.py
 include *.rst
+include *.md
 include *.ini

{pyvrml97-2.3.4b3 → pyvrml97-2.4.0a1}/PKG-INFO

@@ -1,13 +1,19 @@
 Metadata-Version: 2.4
 Name: PyVRML97
-Version: 2.3.4b3
+Version: 2.4.0a1
 Summary: VRML97 Scenegraph model for Python
 Author-email: "Mike C. Fletcher" <mcfletch@vrplumber.com>
 License: BSD-style, see license.txt for details
 Project-URL: Homepage, http://pyopengl.sourceforge.net/context/
 Keywords: VRML,VRML97,scenegraph
 Classifier: License :: OSI Approved :: BSD License
-Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: C
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
@@ -16,7 +22,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 Requires-Dist: numpy
 Requires-Dist: PyDispatcher
-Requires-Dist: simpleparse
+Requires-Dist: simpleparse>=3.0.0a3
 
 PyVRML97 Scenegraph Model
 ==========================
@@ -35,6 +41,13 @@ optimize the rendering process.
 .. _`PyDispatcher`: https://pypi.python.org/pypi/PyDispatcher
 .. _`Numpy`: https://pypi.python.org/pypi/numpy
 
+`RELEASE-NOTES-2.3.5.md`_ says what changed for a program using this release,
+including the two behaviour changes a caller may need to act on:
+``transformmatrix.orthoMatrix`` is transposed, and ``Node.copy()`` copies the
+whole subtree.
+
+.. _`RELEASE-NOTES-2.3.5.md`: RELEASE-NOTES-2.3.5.md
+
 Installation
 -------------
 

{pyvrml97-2.3.4b3 → pyvrml97-2.4.0a1}/PyVRML97.egg-info/PKG-INFO

@@ -1,13 +1,19 @@
 Metadata-Version: 2.4
 Name: PyVRML97
-Version: 2.3.4b3
+Version: 2.4.0a1
 Summary: VRML97 Scenegraph model for Python
 Author-email: "Mike C. Fletcher" <mcfletch@vrplumber.com>
 License: BSD-style, see license.txt for details
 Project-URL: Homepage, http://pyopengl.sourceforge.net/context/
 Keywords: VRML,VRML97,scenegraph
 Classifier: License :: OSI Approved :: BSD License
-Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: C
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
@@ -16,7 +22,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 Requires-Dist: numpy
 Requires-Dist: PyDispatcher
-Requires-Dist: simpleparse
+Requires-Dist: simpleparse>=3.0.0a3
 
 PyVRML97 Scenegraph Model
 ==========================
@@ -35,6 +41,13 @@ optimize the rendering process.
 .. _`PyDispatcher`: https://pypi.python.org/pypi/PyDispatcher
 .. _`Numpy`: https://pypi.python.org/pypi/numpy
 
+`RELEASE-NOTES-2.3.5.md`_ says what changed for a program using this release,
+including the two behaviour changes a caller may need to act on:
+``transformmatrix.orthoMatrix`` is transposed, and ``Node.copy()`` copies the
+whole subtree.
+
+.. _`RELEASE-NOTES-2.3.5.md`: RELEASE-NOTES-2.3.5.md
+
 Installation
 -------------
 

{pyvrml97-2.3.4b3 → pyvrml97-2.4.0a1}/PyVRML97.egg-info/SOURCES.txt

@@ -1,5 +1,6 @@
 MANIFEST.in
 README.rst
+RELEASE-NOTES-2.3.5.md
 license.txt
 pyproject.toml
 requirements.txt
@@ -11,13 +12,34 @@ PyVRML97.egg-info/dependency_links.txt
 PyVRML97.egg-info/not-zip-safe
 PyVRML97.egg-info/requires.txt
 PyVRML97.egg-info/top_level.txt
+tests/test_arrays.py
+tests/test_basefield.py
+tests/test_cache.py
+tests/test_copying.py
+tests/test_csscolors.py
+tests/test_field_assignment.py
+tests/test_field_coercion.py
+tests/test_field_declaration.py
+tests/test_fieldtype_edges.py
 tests/test_fieldtypes.py
+tests/test_linearise.py
+tests/test_matrix_primitives.py
+tests/test_node_behaviour.py
+tests/test_node_definitions.py
 tests/test_nodepath.py
 tests/test_olist.py
+tests/test_parseprocessor.py
+tests/test_parsing_values.py
+tests/test_routes_and_protofunctions.py
+tests/test_scenegraph.py
+tests/test_smallmodules.py
 tests/test_tostring.py
+tests/test_transform_composition.py
 tests/test_transformmatrix.py
+tests/test_vrml200x_parser.py
+tests/test_vrmlstr.py
+tests/test_weakcollections.py
 vrml/__init__.py
-vrml/_bytes.py
 vrml/arrays.py
 vrml/cache.py
 vrml/copier.py
@@ -30,8 +52,8 @@ vrml/nodepath.py
 vrml/olist.py
 vrml/protofunctions.py
 vrml/protonamespace.py
+vrml/py.typed
 vrml/route.py
-vrml/weakkeydictfix.py
 vrml/weaklist.py
 vrml/weaktuple.py
 vrml/vrml200x/__init__.py
@@ -50,4 +72,5 @@ vrml/vrml97/parser.py
 vrml/vrml97/scenegraph.py
 vrml/vrml97/script.py
 vrml/vrml97/shaders.py
-vrml/vrml97/transformmatrix.py
+vrml/vrml97/transformmatrix.py
+vrml/vrml97/tree.py

pyvrml97-2.4.0a1/PyVRML97.egg-info/requires.txt

@@ -0,0 +1,3 @@
+numpy
+PyDispatcher
+simpleparse>=3.0.0a3

{pyvrml97-2.3.4b3 → pyvrml97-2.4.0a1}/README.rst

@@ -15,6 +15,13 @@ optimize the rendering process.
 .. _`PyDispatcher`: https://pypi.python.org/pypi/PyDispatcher
 .. _`Numpy`: https://pypi.python.org/pypi/numpy
 
+`RELEASE-NOTES-2.3.5.md`_ says what changed for a program using this release,
+including the two behaviour changes a caller may need to act on:
+``transformmatrix.orthoMatrix`` is transposed, and ``Node.copy()`` copies the
+whole subtree.
+
+.. _`RELEASE-NOTES-2.3.5.md`: RELEASE-NOTES-2.3.5.md
+
 Installation
 -------------
 

pyvrml97-2.4.0a1/RELEASE-NOTES-2.3.5.md

@@ -0,0 +1,104 @@
+# PyVRML97 2.3.5
+
+## What changed for a program using this
+
+### `transformmatrix.orthoMatrix` is transposed
+
+It answers the row-vector form now, matching `perspectiveMatrix`, the three
+primitives beside it, and the module's own instructions: a point goes through
+a matrix here as `dot( point, matrix )`. The previous form put the offset in
+the last column, so a point through it landed the translation in `w`; a
+centred box came out right and an off-centre one did not.
+
+A caller that fed the result straight to `glLoadMatrixf` was relying on GL's
+column-major upload to transpose it back. That caller now wants
+`matrix.T` — or, better, one of the core-profile paths that take a row-vector
+matrix.
+
+### `Node.copy()` copies the whole subtree
+
+A node's copy shared the nodes its fields pointed at, so writing to the copy's
+child was writing to the original's. Each instance of a PROTO is a copy of the
+prototype's body, so this was also why two instances of one prototype drew the
+same thing: `Wheel { radius 2 }` beside `Wheel { radius 5 }` gave two wheels of
+radius 5. A node reached twice in the original is still one node in the copy,
+which is what DEF/USE and a prototype's IS wiring need.
+
+### `NULL` compares and hashes as a value
+
+`NullNode.__eq__` answered a three-way comparison — 0 for equal, which reads as
+false, and -1 for anything else, which reads as true. `NULL == 42` was true and
+`NULL == NullNode()` was false, and the class was unhashable. It now equals
+another NULL, differs from anything that is not a node, and can be a dictionary
+key.
+
+### A field left at its default is no longer written
+
+`arrays.safeCompare` is what the lineariser asks about every field it is about
+to write, and it answered two questions wrongly. Two arrays were "the same"
+when they shared a single element, and a list compared as a different type from
+an array — which is the pair the question is usually about, since a node
+declares its default as a list of numbers and stores its value as an array. So
+no vector field ever looked like its default, and every one was written out.
+
+A `Transform` with a translation set was written with all eight of its fields;
+it is written with the one now. Files are shorter and read back the same. NULL
+node fields go the same way, now that `NULL` compares as a value.
+
+A program that read the output looking for a field it had not set will not find
+it. That is what the format says, and what a file written by anything else
+looks like.
+
+### `del someNode.children[0]` removes the child
+
+It announced the removal and left the child in the list. Only the slice form
+deleted anything.
+
+### A node appended to a scene learns which scene it is in
+
+`scene.children.append(node)` left the node without a scene root, so `getProto`
+and the DEF names did not reach it; only assignment to the whole field passed
+the root down. Both do now.
+
+## What a file can say that it could not
+
+- **Every registered field type can be read.** `SFVec4f`, `SFVec2d`, `SFVec3d`,
+  `SFVec4d`, `SFUInt32`, `SFArray32`, `MFVec4f`, `MFVec2d`, `MFVec3d`,
+  `MFVec4d` and the four `MFMatrix` types had no reader; a file naming one
+  raised. The four `SFMatrix` types were not registered at all, so a PROTO
+  could not declare one.
+- **A file that is a header and nothing else parses**, as does one whose last
+  line is a comment.
+- **A PROTO declared without a body can be written out.**
+
+## What the writer gets right
+
+- An **MFString** field is written as a list of strings rather than as a list of
+  nodes. A node with a non-empty MFString — `Text`, `WorldInfo`, `Anchor`,
+  `ImageTexture`, `Script`, `Inline` — was written with an opening bracket that
+  was never closed and its next field swallowed inside it.
+- An **EXTERNPROTO** reads back: its interface is written without values, which
+  is what VRML97 has room for, and `externalURL` is no longer written as one of
+  the fields the prototype declares.
+- A **Script** is written as `DEF x Script` rather than `DEF x  Script`, and
+  closed with a comment naming `x`.
+- `Lineariser.linear( scene, skipProtos=... )` leaves the named prototypes out.
+  The argument was accepted and dropped. Name them by name, by the prototype
+  itself, or as the keys of a mapping such as a scene graph's `protoTypes`;
+  their instances are still written, which is how a caller writes a fragment
+  for a file that already declares them.
+
+## Smaller things
+
+- `protofunctions.getField` answers the field for a name that is not an
+  attribute — `' DEF'`, or an event stored under a name a program cannot write.
+  It answered the name itself.
+- `str(node)` says the node's DEF name.
+- Setting a vector field from one number works: `transform.scale = 2` raised.
+- `MFString` refuses a value it cannot read with a ValueError naming the field,
+  as its sibling types do.
+- `field.PyBaseField` names the Python implementation of the field primitives
+  whichever build is installed, so the two can be compared. Where the
+  accelerator is installed, `field.BaseField` is the compiled class as before.
+- `vrml.arrays` drops what it carried for Numeric. `typeCode` reads
+  `dtype.char`; the `typecode()` fallbacks are gone.

pyvrml97-2.4.0a1/pyproject.toml

@@ -0,0 +1,112 @@
+[build-system]
+# PyVRML97 (the root package) is pure Python - no C extensions - so it needs
+# nothing but setuptools to build. Cython/numpy build-deps live only in
+# accelerate/pyproject.toml, where the extensions actually are. setuptools>=61
+# is required to read the PEP 621 [project] table below.
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "PyVRML97"
+dynamic = ["version"]
+description = "VRML97 Scenegraph model for Python"
+requires-python = ">=3.9"
+readme = "README.rst"
+license = { text = "BSD-style, see license.txt for details" }
+authors = [
+    { name = "Mike C. Fletcher", email = "mcfletch@vrplumber.com" },
+]
+dependencies = [
+    "numpy",
+    "PyDispatcher",
+    # 3.0.0a3 or newer: the first release with wheels for a current Python.
+    # 2.2.4 has none past 3.11 and its mxTextTools C extension does not compile
+    # against a current GCC, so an install that resolves to it fails to build.
+    # Named as a pre-release so an installer does not skip it.
+    "simpleparse >= 3.0.0a3",
+]
+keywords = [
+    "VRML",
+    "VRML97",
+    "scenegraph",
+]
+classifiers = [
+    "License :: OSI Approved :: BSD License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: C",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Multimedia :: Graphics :: 3D Rendering",
+    "Intended Audience :: Developers",
+]
+
+[project.urls]
+Homepage = "http://pyopengl.sourceforge.net/context/"
+
+[tool.setuptools]
+zip-safe = false
+
+[tool.setuptools.packages.find]
+include = ["vrml*"]
+
+[tool.setuptools.package-data]
+# `py.typed` is what tells a checker this package's exports are real. Without
+# it `vrml.arrays` -- the abstraction OpenGLContext and its kin reach numpy
+# through -- resolves to nothing, and every `arrays.dot`, `arrays.zeros` and
+# their fellows becomes an error in code that is correct.
+vrml = ["py.typed"]
+
+[tool.setuptools.dynamic]
+version = { attr = "vrml.__version__" }
+
+# uv decides whether its cached metadata for a source tree is still current
+# from pyproject.toml, setup.py and setup.cfg alone. This project's version
+# lives in vrml/__init__.py, so name that file too: without it a version bump
+# leaves uv answering with the previous number, and a dependent requiring the
+# new one resolves against PyPI rather than this checkout.
+[tool.uv]
+cache-keys = [{ file = "pyproject.toml" }, { file = "vrml/__init__.py" }]
+
+# Named explicitly rather than left to ruff's default, which has widened
+# between releases: a gate whose meaning moves when a tool is upgraded is not a
+# gate. `E,W,F,B` is what the other pre-2010 projects here hold to.
+[tool.ruff.lint]
+select = ["E", "W", "F", "B"]
+# `_name` as well as `_`: an underscore prefix is how Python says a name is
+# bound but deliberately unused.
+dummy-variable-rgx = "^(_[a-zA-Z0-9_]*|err)$"
+ignore = [
+    'E501', # long lines, kept readable by hand
+    # The scenegraph's namespaces are assembled with `from x import *`, which
+    # is how the VRML97 node types are gathered; the names are there at run
+    # time. What holds the modules to importing is the suite, which imports
+    # them.
+    'F403',
+    'F405',
+]
+
+[tool.mypy]
+# This package ships `py.typed`, so what it declares is what every consumer's
+# checker believes -- `vrml.arrays` is the abstraction OpenGLContext and its
+# kin reach numpy through. Publishing types that nothing holds the package to
+# is worse than publishing none.
+python_version = "3.12"
+files = ["vrml"]
+ignore_missing_imports = true
+warn_unused_ignores = true
+# Every function body, not only the annotated ones. Nothing here was annotated,
+# so without this the gate read the module-level declarations and skipped all
+# 326 bodies -- which is where `str.replace` was called with one argument, where
+# `WeakList.get` called a method Python 2 had, and where a property assigned to
+# itself. A gate that cannot see inside a function is not checking the package.
+check_untyped_defs = true
+# Every one of the 331 definitions carries its types now, so a new one that does
+# not is a gap the gate reports rather than a body it quietly stops checking.
+# This is what keeps the setting above a floor rather than the whole of it.
+disallow_untyped_defs = true
+disallow_incomplete_defs = true

pyvrml97-2.4.0a1/requirements.txt

@@ -0,0 +1,8 @@
+--prefer-binary 
+# 3.0.0a3 or newer: it is the first release with wheels for a current
+# Python, and 2.2.4's mxTextTools C extension does not compile against a
+# current GCC.  Named as a pre-release so an installer does not skip it.
+simpleparse >= 3.0.0a3
+numpy >= 2.0.1; python_version >= '3.10'
+numpy; python_version < '3.10'
+PyDispatcher

pyvrml97-2.4.0a1/tests/test_arrays.py

@@ -0,0 +1,171 @@
+"""The array abstraction the scenegraph reaches numpy through.
+
+`vrml.arrays` is what let the package move from Numeric to numpy without every
+node changing, and OpenGLContext and the projects built on it reach numpy
+through it in turn. So what it exports is what a great deal of code sees under
+those names, and a name that shadows a builtin with something that is not a
+drop-in for it is a trap laid across all of that.
+
+The reductions -- `sum`, `min`, `max`, `any`, `abs` -- shadow builtins
+deliberately: taking the numpy one is the point, and each answers what the
+builtin does for a scalar. `bool` is the exception, and the reason this file
+names them one at a time rather than asserting a rule about the whole set.
+"""
+
+import builtins
+import math
+
+import unittest
+
+from vrml import arrays
+
+
+class TestWhatItShadows(unittest.TestCase):
+    def test_bool_is_the_builtin(self):
+        """`numpy.bool` is a scalar type, not a drop-in for the builtin.
+
+        `isinstance(True, numpy.bool)` is False and `numpy.bool(1) is not
+        True`, so a module reading `bool` out of here got a name that fails
+        both of the things `bool` is used for.
+        """
+        self.assertIs(getattr(arrays, 'bool', builtins.bool), builtins.bool)
+        self.assertNotIn('bool', arrays.__all__)
+
+    def test_it_exports_no_other_type_that_shadows_a_builtin(self):
+        """A shadowing *function* is the abstraction; a shadowing *type* is not.
+
+        `sum` and the rest answer for a scalar what the builtin does. A type
+        does not: it is what `isinstance` is asked about and what an
+        annotation names.
+        """
+        shadowing_types = [
+            name for name in arrays.__all__
+            if isinstance(getattr(arrays, name, None), type)
+            and hasattr(builtins, name)
+            and getattr(arrays, name) is not getattr(builtins, name)
+        ]
+        self.assertEqual(shadowing_types, [])
+
+    def test_the_reductions_are_still_numpy(self):
+        """Removing one shadow must not take the abstraction with it."""
+        for name in ('sum', 'min', 'max', 'any', 'abs'):
+            self.assertIn(name, arrays.__all__)
+            self.assertIsNot(getattr(arrays, name), getattr(builtins, name), name)
+
+    def test_log_is_still_not_exported(self):
+        """`math.log` and `numpy.log` differ, so neither is offered here."""
+        self.assertNotIn('log', arrays.__all__)
+
+
+class TestSafeCompare(unittest.TestCase):
+    """Comparing two field values, either of which may be an array."""
+
+    def test_two_equal_arrays_compare_equal(self):
+        first = arrays.array([1.0, 2.0, 3.0], 'f')
+        second = arrays.array([1.0, 2.0, 3.0], 'f')
+        self.assertTrue(arrays.safeCompare(first, second))
+
+    def test_two_different_arrays_do_not(self):
+        first = arrays.array([1.0, 2.0, 3.0], 'f')
+        second = arrays.array([9.0, 9.0, 9.0], 'f')
+        self.assertFalse(arrays.safeCompare(first, second))
+
+    def test_arrays_alike_in_one_place_are_not_equal(self):
+        """Every element has to match, not merely one of them: the
+        lineariser asks this to decide whether a field is still at its
+        default, and a translation of (1,0,0) shares two with (0,0,0)."""
+        first = arrays.array([0.0, 0.0, 0.0], 'f')
+        second = arrays.array([1.0, 0.0, 0.0], 'f')
+        self.assertFalse(arrays.safeCompare(first, second))
+
+    def test_arrays_of_different_lengths_are_not_equal(self):
+        self.assertFalse(arrays.safeCompare(arrays.array([1.0, 2.0], 'f'),
+                                            arrays.array([1.0], 'f')))
+
+    def test_a_sequence_equals_the_array_of_the_same_numbers(self):
+        """A node declares its default as a list and stores its value as an
+        array, and the two are the same value."""
+        self.assertTrue(arrays.safeCompare([0.0, 0.0, 0.0],
+                                           arrays.array([0.0, 0.0, 0.0], 'f')))
+
+    def test_a_sequence_of_other_numbers_does_not(self):
+        self.assertFalse(arrays.safeCompare([0.0, 0.0, 0.0],
+                                            arrays.array([1.0, 0.0, 0.0], 'f')))
+
+    def test_two_equal_sequences_compare_equal(self):
+        self.assertTrue(arrays.safeCompare([1.0, 2.0], (1.0, 2.0)))
+
+    def test_two_empty_sequences_compare_equal(self):
+        self.assertTrue(arrays.safeCompare([], arrays.array([], 'f')))
+
+    def test_a_list_of_objects_compares_by_identity(self):
+        """Which is what an MFNode's value is: the same nodes or not."""
+        held = [object(), object()]
+        self.assertTrue(arrays.safeCompare(held, list(held)))
+        self.assertFalse(arrays.safeCompare(held, [held[0], object()]))
+
+    def test_a_ragged_sequence_falls_back_to_comparing_it(self):
+        """numpy refuses to make an array of rows of different lengths, and
+        the two lists still have an answer."""
+        ragged = [[1, 2], [3]]
+        self.assertTrue(arrays.safeCompare(ragged, [[1, 2], [3]]))
+        self.assertFalse(arrays.safeCompare(ragged, [[1, 2], [4]]))
+
+    def test_something_neither_kind_falls_back_to_comparing_it(self):
+        self.assertTrue(arrays.safeCompare({'a': 1}, {'a': 1}))
+        self.assertFalse(arrays.safeCompare({'a': 1}, {'a': 2}))
+
+    def test_it_answers_a_real_bool(self):
+        """A caller writing `if x is True` or storing the answer wants one."""
+        first = arrays.array([1.0], 'f')
+        answer = arrays.safeCompare(first, arrays.array([1.0], 'f'))
+        self.assertIs(type(answer), builtins.bool)
+
+    def test_none_compares_equal_to_none(self):
+        self.assertTrue(arrays.safeCompare(None, None))
+
+    def test_none_and_a_value_do_not_compare_equal(self):
+        self.assertFalse(arrays.safeCompare(None, 3))
+        self.assertFalse(arrays.safeCompare(3, None))
+
+    def test_two_equal_scalars_compare_equal(self):
+        self.assertTrue(arrays.safeCompare(3, 3))
+        self.assertTrue(arrays.safeCompare(3.5, 3.5))
+        self.assertTrue(arrays.safeCompare('a', 'a'))
+
+    def test_values_of_different_types_do_not(self):
+        self.assertFalse(arrays.safeCompare(arrays.array([1.0], 'f'), 'a'))
+
+
+class TestTypeCode(unittest.TestCase):
+    def test_it_answers_the_arrays_own_code(self):
+        self.assertEqual(arrays.typeCode(arrays.array([1.0], 'f')), 'f')
+        self.assertEqual(arrays.typeCode(arrays.array([1.0], 'd')), 'd')
+
+    def test_it_wants_an_array_rather_than_a_sequence(self):
+        """It reads the code off the value; a list carries none."""
+        with self.assertRaises(AttributeError):
+            arrays.typeCode([1.0, 2.0])
+
+
+class TestContiguous(unittest.TestCase):
+    def test_a_contiguous_array_is_answered_as_it_is(self):
+        original = arrays.array([1.0, 2.0, 3.0], 'f')
+        self.assertTrue(arrays.contiguous(original).flags['C_CONTIGUOUS'])
+
+    def test_a_sliced_array_is_made_contiguous(self):
+        sliced = arrays.array([[1.0, 2.0], [3.0, 4.0]], 'f')[:, 0]
+        self.assertTrue(arrays.contiguous(sliced).flags['C_CONTIGUOUS'])
+
+
+class TestWhichImplementation(unittest.TestCase):
+    def test_it_names_the_one_it_is_using(self):
+        self.assertEqual(arrays.implementation_name, 'numpy')
+
+    def test_the_trig_is_the_array_kind(self):
+        """`math.sin` keeps a float32 float32; the array one widens it."""
+        self.assertIsNot(arrays.sin, math.sin)
+
+
+if __name__ == '__main__':
+    unittest.main()