File System

// From a path
val file = KxFile("/data/data/com.klyx/files/myfile.txt")

// From a URI
val file = KxFile(Uri.parse("content://..."))

// From existing types
val kxFile = File("/path/to/file").wrap()
val kxFile = uri.wrap()
val kxFile = documentFile.wrap()

val bytes: ByteArray = file.readBytes()
val text: String = file.readText()
val lines: List<String> = file.readLines()
val input: InputStream = file.inputStream()

file.writeBytes(byteArrayOf(1, 2, 3))
file.writeText("Hello, world!")
file.outputStream().use { it.write(data) }

file.name          // "myfile.txt"
file.absolutePath  // Full path
file.extension     // "txt"
file.mimeType      // "text/plain"
file.exists        // true/false
file.isDirectory   // true/false
file.isFile        // true/false
file.length        // Size in bytes
file.lastModified  // Timestamp
file.canRead       // true/false
file.canWrite      // true/false

file.list()                       // Array<String>?
file.listFiles()                  // Array<KxFile>?
file.listFiles(filter) { it.isFile }
file.mkdirs()                     // Boolean

file.delete()                     // Boolean
file.deleteRecursively()          // Boolean
file.renameTo(newFile)            // Boolean

private val fileSystem: FileSystem by plugin()

data class FileCapabilities(
    val canWrite: Boolean,
    val canDelete: Boolean,
    val canRename: Boolean,
    val canCreate: Boolean
)

Paths.filesDir
Paths.dataDir
Paths.tempDir
Paths.externalFilesDir
Paths.nativeLibraryDir
Paths.pluginsDir         // dataDir/klyx/plugins
Paths.installedPluginsJson // pluginsDir/installed.json

val category = fileSystem.determineFileCategory(uri)
when (category) {
    FileCategory.TEXT -> // Open in editor
    FileCategory.IMAGE -> // Show image viewer
    FileCategory.BINARY_UNSUPPORTED -> // Show error
    FileCategory.ERROR -> // Handle error
}