Sync flatten-array (exercism#459)

[no important files changed]

Author: keiravillekode

exercises/practice/flatten-array/.docs/instructions.append.md

@@ -0,0 +1,3 @@
+# Instructions Append
+
+The input and output are represented as lists.

exercises/practice/flatten-array/.docs/instructions.md

@@ -1,11 +1,16 @@
 # Instructions
 
-Take a nested list and return a single flattened list with all values except nil/null.
+Take a nested array of any depth and return a fully flattened array.
 
-The challenge is to take an arbitrarily-deep nested list-like structure and produce a flattened structure without any nil/null values.
+Note that some language tracks may include null-like values in the input array, and the way these values are represented varies by track.
+Such values should be excluded from the flattened array.
 
-For example:
+Additionally, the input may be of a different data type and contain different types, depending on the track.
 
-input: [1,[2,3,null,4],[null],5]
+Check the test suite for details.
 
-output: [1,2,3,4,5]
+## Example
+
+input: `[1, [2, 6, null], [[null, [4]], 5]]`
+
+output: `[1, 2, 6, 4, 5]`

exercises/practice/flatten-array/.meta/tests.toml

@@ -32,12 +32,32 @@ description = "null values are omitted from the final result"
 
 [c6cf26de-8ccd-4410-84bd-b9efd88fd2bc]
 description = "consecutive null values at the front of the list are omitted from the final result"
+include = false
+
+[bc72da10-5f55-4ada-baf3-50e4da02ec8e]
+description = "consecutive null values at the front of the array are omitted from the final result"
+reimplements = "c6cf26de-8ccd-4410-84bd-b9efd88fd2bc"
 
 [382c5242-587e-4577-b8ce-a5fb51e385a1]
 description = "consecutive null values in the middle of the list are omitted from the final result"
+include = false
+
+[6991836d-0d9b-4703-80a0-3f1f23eb5981]
+description = "consecutive null values in the middle of the array are omitted from the final result"
+reimplements = "382c5242-587e-4577-b8ce-a5fb51e385a1"
 
 [ef1d4790-1b1e-4939-a179-51ace0829dbd]
 description = "6 level nest list with null values"
+include = false
+
+[dc90a09c-5376-449c-a7b3-c2d20d540069]
+description = "6 level nested array with null values"
+reimplements = "ef1d4790-1b1e-4939-a179-51ace0829dbd"
 
 [85721643-705a-4150-93ab-7ae398e2942d]
 description = "all values in nested list are null"
+include = false
+
+[51f5d9af-8f7f-4fb5-a156-69e8282cb275]
+description = "all values in nested array are null"
+reimplements = "85721643-705a-4150-93ab-7ae398e2942d"

exercises/practice/flatten-array/flatten-array-test.el

@@ -1,4 +1,4 @@
-;;; flatten-array-test.el --- Flatten Array (exercism)  -*- lexical-binding: t; -*-
+;;; flatten-array-test.el --- Tests for Flatten Array (exercism)  -*- lexical-binding: t; -*-
 
 ;;; Commentary:
 
@@ -10,20 +10,31 @@
 
 
 (ert-deftest empty ()
-  (should (equal (list-flatten '()) '())))
+  (should
+   (equal
+    (list-flatten '())
+    '())))
 
 
 (ert-deftest no-nesting ()
-  (should (equal (list-flatten '(0 1 2)) '(0 1 2))))
+  (should
+   (equal
+    (list-flatten '(0 1 2))
+    '(0 1 2))))
 
 
 (ert-deftest flattens-a-nested-array ()
-  (should (equal (list-flatten '((()))) '())))
+  (should
+   (equal
+    (list-flatten '((())))
+    '())))
 
 
 (ert-deftest flattens-array-with-just-integers-present ()
   (should
-   (equal (list-flatten '(1 (2 3 4 5 6 7) 8)) '(1 2 3 4 5 6 7 8))))
+   (equal
+    (list-flatten '(1 (2 3 4 5 6 7) 8))
+    '(1 2 3 4 5 6 7 8))))
 
 
 (ert-deftest 5-level-nesting ()
@@ -41,33 +52,42 @@
 
 
 (ert-deftest null-values-are-omitted-from-the-final-result ()
-  (should (equal (list-flatten '(1 2 nil)) '(1 2))))
+  (should
+   (equal
+    (list-flatten '(1 2 nil))
+    '(1 2))))
 
 
 (ert-deftest
-    consecutive-null-values-at-the-front-of-the-list-are-omitted-from-the-final-result
+    consecutive-null-values-at-the-front-of-the-array-are-omitted-from-the-final-result
     ()
-  (should (equal (list-flatten '(nil nil 3)) '(3))))
+  (should
+   (equal
+    (list-flatten '(nil nil 3))
+    '(3))))
 
 
 (ert-deftest
-    consecutive-null-values-in-the-middle-of-the-list-are-omitted-from-the-final-result
+    consecutive-null-values-in-the-middle-of-the-array-are-omitted-from-the-final-result
     ()
-  (should (equal (list-flatten '(1 nil nil 4)) '(1 4))))
+  (should
+   (equal
+    (list-flatten '(1 nil nil 4))
+    '(1 4))))
 
 
-(ert-deftest 6-level-nest-list-with-null-values ()
+(ert-deftest 6-level-nested-array-with-null-values ()
   (should
    (equal
-    (list-flatten
-     '(0 2 ((2 3) 8 ((100)) nil ((nil))) -2))
+    (list-flatten '(0 2 ((2 3) 8 ((100)) nil ((nil))) -2))
     '(0 2 2 3 8 100 -2))))
 
 
-(ert-deftest all-values-in-nested-list-are-null ()
+(ert-deftest all-values-in-nested-array-are-null ()
   (should
    (equal
-    (list-flatten '(nil (((nil))) nil nil ((nil nil) nil) nil)) '())))
+    (list-flatten '(nil (((nil))) nil nil ((nil nil) nil) nil))
+    '())))
 
 
 (provide 'flatten-array-test)