Parse version from tag

README.md

@@ -10,26 +10,6 @@ The package is named `tinyvm` for 'tiny version manager'.
 Since this is an internship application project, I have assumed that a minimal usage of external libraries is preferred,
 so that a greater technical understanding can be demonstrated.
 
-## Usage
-
-### Gradle
-```kotlin
-repositories {
-    // other repositories
-    maven { url "https://git.koval.net/api/packages/cyclane/maven" }
-}
-
-dependencies {
-    // other dependencies
-    implementation("net.koval.teamcity-gitea-test-task:tinyvm:0.1.1")
-}
-```
-
-### Documentation
-Use autocompletion and hover menus in your IDE, or download the
-[generated HTML documentation](https://git.koval.net/cyclane/teamcity-gitea-test-task/releases/download/v0.1.1/tinyvm-0.1.1-javadoc.zip)
-from the [latest release](https://git.koval.net/cyclane/teamcity-gitea-test-task/releases).
-
 ## Instructions
 
 Create a library that implements simple Git functionality. You need to implement at least three entities:

build.gradle.kts

@@ -1,7 +1,6 @@
 plugins {
     kotlin("jvm") version "1.9.21"
     id("org.jmailen.kotlinter") version "4.1.0"
-    id("org.jetbrains.dokka") version "1.9.10"
     `maven-publish`
 }
 
@@ -24,18 +23,10 @@ kotlin {
     jvmToolchain(17)
 }
 
-val dokkaHtml by tasks.getting(org.jetbrains.dokka.gradle.DokkaTask::class)
-val javadocJar: TaskProvider<Jar> by tasks.registering(Jar::class) {
-    dependsOn(dokkaHtml)
-    archiveClassifier.set("javadoc")
-    from(dokkaHtml.outputDirectory)
-}
-
 publishing {
     publications.register<MavenPublication>("gpr") {
         artifactId = "tinyvm"
         from(components["java"])
-        artifact(javadocJar)
         pom {
             name.set("TeamCity support for Gitea - Test Task - tiny version manager")
             description.set("This is a small project to implement a subset of git's functionality in Kotlin and was " +

src/main/kotlin/tinyvm/Commit.kt

@@ -1,20 +1,29 @@
 package tinyvm
 
+import java.security.MessageDigest
 import java.time.Instant
 
-/**
- * Commits are a pointer to a 'head' tree with some metadata.
- */
+abstract class Object(
+    val type: String,
+) {
+    abstract val data: String
+
+    fun hash(): String =
+        MessageDigest
+            .getInstance("SHA-1")
+            .digest("$type ${data.length}\u0000$data".toByteArray())
+            .toHex()
+}
+
 class Commit(
     val tree: Tree,
     val author: Author,
     val message: String,
     val timestamp: Instant,
 ) : Object("commit") {
+    // Use \n\n for end of header in-case additional metadata is implemented in the future.
     override val data: String
         get() = "tree ${tree.hash()}\nauthor $author\ntimestamp ${timestamp.epochSecond}\n\n$message"
-
-    override fun toString(): String = "commit ${hash()}\n$data"
 }
 
 data class Author(

src/main/kotlin/tinyvm/Extensions.kt

@@ -0,0 +1,5 @@
+package tinyvm
+
+import java.util.HexFormat
+
+fun ByteArray.toHex(): String = HexFormat.of().formatHex(this)

src/main/kotlin/tinyvm/Object.kt

@@ -1,17 +0,0 @@
-package tinyvm
-
-import java.security.MessageDigest
-import java.util.HexFormat
-
-/**
- * Represents an arbitrary version manager object.
- */
-abstract class Object(val type: String) {
-    abstract val data: String
-
-    fun hash(): String =
-        HexFormat.of().formatHex(
-            MessageDigest.getInstance("SHA-1")
-                .digest("$type ${data.length}\u0000$data".toByteArray()),
-        )
-}

src/main/kotlin/tinyvm/Repository.kt

@@ -2,7 +2,7 @@ package tinyvm
 
 class HashCollisionException(hash: String) : Exception("Different object types with identical hash '$hash'")
 
-private class CommitTimeComparator : Comparator<Commit> {
+class CommitTimeComparator : Comparator<Commit> {
     override fun compare(
         o1: Commit,
         o2: Commit,

src/main/kotlin/tinyvm/Tree.kt

@@ -1,13 +1,7 @@
 package tinyvm
 
-/**
- * Tree nodes are either trees or blobs, represented by this sealed class.
- */
 sealed class Node(type: String) : Object(type)
 
-/**
- * A tree is a set of named nodes.
- */
 class Tree(val nodes: Map<String, Node>) : Node("tree") {
     // For simplicity just use the hex-formatted hash, not the actual value like git does.
     override val data: String
@@ -15,22 +9,6 @@ class Tree(val nodes: Map<String, Node>) : Node("tree") {
             nodes.map { (name, node) ->
                 "${node.type} $name\u0000${node.hash()}"
             }.sorted().joinToString()
-
-    override fun toString(): String =
-        "tree ${hash()}\n" +
-            nodes.map { (name, node) ->
-                when (node) {
-                    is Tree -> "+$name/\n"
-                    is Blob -> "+$name\n"
-                } + node.toString().insertLeftMargin()
-            }.sorted().joinToString("\n")
 }
 
-/**
- * A blob is a data container.
- */
-class Blob(override val data: String) : Node("blob") {
-    override fun toString(): String = "blob ${hash()}\n${data.insertLeftMargin()}"
-}
-
-private fun String.insertLeftMargin(): String = split('\n').joinToString("\n") { "| $it" }
+class Blob(override val data: String) : Node("blob")

src/test/kotlin/tinyvm/RepositoryTest.kt

@@ -18,22 +18,22 @@ internal class RepositoryTest {
                 tree =
                     Tree(
                         mapOf(
-                            "dir2" to
-                                Tree(
-                                    mapOf(
-                                        "test1.txt" to Blob("This is a second file"),
-                                    ),
-                                ),
                             "dir1" to
                                 Tree(
                                     mapOf(
                                         "test1.txt" to Blob("Hello World!"),
                                     ),
                                 ),
+                            "dir2" to
+                                Tree(
+                                    mapOf(
+                                        "test2.txt" to Blob("This is a second file"),
+                                    ),
+                                ),
                         ),
                     ),
                 author = Author("Gleb Koval", "gleb@koval.net"),
-                message = "Move test1.txt to dir1 and add dir2/test1.txt",
+                message = "Move test1.txt and add dir2/test2.txt",
                 timestamp = Instant.ofEpochSecond(50),
             ),
             Commit(
@@ -49,7 +49,7 @@ internal class RepositoryTest {
                             "dir2" to
                                 Tree(
                                     mapOf(
-                                        "test1.txt" to Blob("This is a second file"),
+                                        "test2.txt" to Blob("This is a second file"),
                                     ),
                                 ),
                             "README.md" to Blob("# This is a test repo!"),
@@ -117,39 +117,4 @@ internal class RepositoryTest {
         assertEquals(committed, repository.findCommit { it.message.matches("Move.*".toRegex()) })
         assertEquals(null, repository.getCommit("00000000000000000000"))
     }
-
-    @Test
-    fun `can display commit`() {
-        assertEquals(
-            """
-            commit 804c6f0c66da0ea0eab8ac29f23a627e03a962b2
-            tree aaebbb258bce30749fc302cbd161b78462252a32
-            author Gleb Koval <gleb@koval.net>
-            timestamp 0
-            
-            Add test1.txt
-            """.trimIndent(),
-            commits[0].toString(),
-        )
-    }
-
-    @Test
-    fun `can display tree`() {
-        assertEquals(
-            """
-            tree 048b8e267dd7a6c5d4849d59f6ff82e6ae948f13
-            +dir1/
-            | tree aaebbb258bce30749fc302cbd161b78462252a32
-            | +test1.txt
-            | | blob c57eff55ebc0c54973903af5f72bac72762cf4f4
-            | | | Hello World!
-            +dir2/
-            | tree 0e14cbdba02924cd63a58c2492fc3dd05dc682bd
-            | +test1.txt
-            | | blob da3fcc31cbc16fcbb7526d68771f77e7e7f02fb1
-            | | | This is a second file
-            """.trimIndent(),
-            commits[1].tree.toString(),
-        )
-    }
 }