Merge branch 'yogurtearl-add_path_exists_assertion'

Author: evant

assertk/src/jvmMain/kotlin/assertk/assertions/path.kt

@@ -87,3 +87,15 @@ fun Assert<Path>.isSameFileAs(expected: Path) = given { actual ->
         expected("${show(actual)} to be the same file as ${show(actual)} but is not")
     }
 }
+
+/**
+ * Assert that the path exists.
+ *
+ * @param options indicating how symbolic links are handled
+ */
+@Suppress("SpreadOperator") // https://github.com/arturbosch/detekt/issues/391
+fun Assert<Path>.exists(vararg options: LinkOption) = given { actual ->
+    if (!Files.exists(actual, *options)) {
+        expected("${show(actual)} to exist, but it does not")
+    }
+}

assertk/src/jvmTest/kotlin/test/assertk/assertions/PathTest.kt

@@ -4,11 +4,13 @@ import assertk.assertThat
 import assertk.assertions.*
 import java.nio.file.Files
 import java.nio.file.Path
+import java.nio.file.Paths
 import kotlin.test.*
 
 private var regularFile: Path? = null
 private var directory: Path? = null
 private var regularFileWithText: Path? = null
+private var doesNotExist: Path? = null
 
 class PathTest {
 
@@ -17,6 +19,7 @@ class PathTest {
         regularFile = createTempFile()
         directory = createTempDir()
         regularFileWithText = createTempFileWithText()
+        doesNotExist = Paths.get("/tmp/does_not_exist")
     }
 
     @AfterTest
@@ -122,6 +125,23 @@ class PathTest {
     }
     //endregion
 
+    //region exists
+    @Test fun exists_value_regularFile_passes() {
+        assertThat(regularFile!!).exists()
+    }
+
+    @Test fun exists_value_directory_passes() {
+        assertThat(directory!!).exists()
+    }
+
+    @Test fun exists_value_not_exists_fails() {
+        val error = assertFails {
+            assertThat(doesNotExist!!).exists()
+        }
+        assertEquals("expected <$doesNotExist> to exist, but it does not", error.message)
+    }
+    //endregion
+
     //region lines
     @Test fun lines_correct_string_passes() {
         assertThat(regularFileWithText!!).lines().containsExactly("a", "b")
@@ -137,4 +157,4 @@ class PathTest {
 
 private fun createTempDir() = Files.createTempDirectory("tempDir")
 private fun createTempFile() = Files.createTempFile("tempFile", "").apply { toFile().writeBytes(ByteArray(10)) }
-private fun createTempFileWithText() = Files.createTempFile("tempFileWithText", "").apply { toFile().writeText("a\nb", Charsets.UTF_8) }
+private fun createTempFileWithText() = Files.createTempFile("tempFileWithText", "").apply { toFile().writeText("a\nb", Charsets.UTF_8) }