Initial commit

Author: bennyhuo

.editorconfig

@@ -0,0 +1,5 @@
+root = true
+
+[*]
+indent_size = 2
+max_line_length = 80

.gitignore

@@ -0,0 +1,8 @@
+.idea
+.gradle
+build
+out
+*.iml
+testdata
+composite_build.local
+*.hprof

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Benny Huo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,91 @@
+# 《深入实践 Kotlin 元编程》随书源码
+
+## 环境
+
+* JDK 17
+* IntelliJ IDEA 2022.3.2
+* Kotlin 1.8.10
+
+## 说明
+
+本书绝大多数代码清单的内容都可以在这里找到。
+
+书中限于篇幅，通常会对一些较长的代码做出省略，这里会尽可能地给出可以直接运行的程序。
+
+为了方便读者找到对应的代码，我会将代码清单的编号作为包名，例如 com.bennyhuo.list4_20，表示代码清单 4-20 的代码在这个包中。如果包名不适合添加编号信息，我也会在代码前面用一行注释写出清单的编号，例如 `// 4-20`，表示以下代码对应于书中的代码清单 4-20。
+
+当然，也有部分代码清单的代码属于某个开源项目，例如 KotlinTuples，书中对应的源码将不在这里列出，读者可以按照下面给出的链接找到对应的项目去阅读其中的源码。
+
+如果遇到问题，也欢迎提 issue，我有空的时候会尽量帮你分析。
+
+## 章节列表
+
+### [第一章 元编程概述](chapter1)
+
+* [JDK 源码编译环境配置 - 视频](https://www.bilibili.com/video/BV1Qj411P7eZ/)
+* [Jetpack Compose 环境配置 - 视频](TODO)
+
+### [第二章 元数据简介](chapter2)
+
+### [第三章 运行时的反射](chapter3)
+
+相关开源项目：
+
+* [Retrofit](https://github.com/square/retrofit)
+* [KotlinDeepCopy](https://github.com/bennyhuo/KotlinDeepCopy)
+  * [JVM 反射实现](https://github.com/bennyhuo/KotlinDeepCopy/blob/master/reflect-impl/src/main/kotlin/com/bennyhuo/kotlin/deepcopy/reflect/DeepCopy.kt)
+  * [JS 反射实现](https://github.com/bennyhuo/KotlinDeepCopy/blob/master/reflect-impl-js/src/main/kotlin/com/bennyhuo/kotlin/deepcopy/DeepCopy.kt)
+
+### [第四章 源代码的生成](chapter4)
+
+相关开源项目：
+
+* [KotlinTuples](https://github.com/bennyhuo/KotlinTuples)
+* [Anko-Legacy/anko-asm-parser](https://github.com/bennyhuo/anko-legacy)
+* [Detekt](https://github.com/detekt/detekt)
+* [JavaPoet](https://github.com/square/javapoet)
+* [KotlinPoet](https://github.com/square/kotlinpoet)
+
+### [第五章 编译时的符号处理](chapter5)
+
+相关开源项目：
+
+* [symbol-processing-module-support](https://github.com/bennyhuo/symbol-processing-module-support)
+* [KotlinDeepCopy](https://github.com/bennyhuo/KotlinDeepCopy)
+  * [APT](https://github.com/bennyhuo/KotlinDeepCopy/tree/master/compiler/compiler-apt)
+  * [KSP](https://github.com/bennyhuo/KotlinDeepCopy/tree/master/compiler/compiler-ksp)
+
+### [第六章 程序静态分析](chapter6)
+
+* 使用 detekt 扫描程序，可以运行 :chapter6:app:detektMain 来查看效果。注意，运行所在的工作目录需要为 chapter6/app。
+* 体验 dataclass-inspection 的效果，可以运行 :chapter6:dataclass-inspection:runIde 来运行一个调试用的 IntelliJ。
+
+### 第七章 编译器插件
+
+* allopen
+  * [编译器插件源码](https://github.com/JetBrains/kotlin/tree/master/plugins/allopen)
+  * [IntelliJ 插件源码](https://github.com/JetBrains/intellij-community/tree/master/plugins/kotlin/compiler-plugins/allopen)
+* [TrimIndent](https://github.com/bennyhuo/Kotlin-Trim-Indent)
+* [DeepCopy](https://github.com/bennyhuo/KotlinDeepCopy/tree/master/kcp-impl)
+* [KAPT](https://github.com/jetbrains/kotlin/tree/master/plugins/kapt3)
+* [KSP](https://github.com/google/ksp)
+
+### 第八章 元程序的开发和调试
+
+本章主要介绍了常见的单元测试框架的用法，涉及到的框架如下：
+
+* [tschuchortdev/kotlin-compile-testing](https://github.com/tschuchortdev/kotlin-compile-testing)：Kotlin 编译器测试框架，原仓库
+* [ZacSweers/kotlin-compile-testing](https://github.com/ZacSweers/kotlin-compile-testing)：Kotlin 编译器测试框架，Fork 仓库，由 moshi 的编译器插件作者/Kotlin 社区非常活跃的开发者维护，版本更新更快
+* [bennyhuo/kotlin-compile-testing-extensions](https://github.com/bennyhuo/kotlin-compile-testing-extensions)：Kotlin 编译器测试框架的扩展，简化了测试任务的集成流程，提供了较为灵活的结果检查机制
+
+所有单测 case 的编写方法可以参见 DeepCopy 项目的单测：
+* [KAPT/KSP](https://github.com/bennyhuo/KotlinDeepCopy/tree/master/test-common/src/test/kotlin/com/benyhuo/kotlin/deepcopy/compiler)
+* [KCP](https://github.com/bennyhuo/KotlinDeepCopy/tree/master/kcp-impl/compiler-kcp/src/test/kotlin/com/bennyhuo/kotlin/kcp/deepcopy/compiler)
+
+### 第九章 Jetpack Compose 的编译时处理
+
+本章源码在 AOSP 中，读者可以直接在 AOSP 在线源代码阅读平台上直接阅读这部分源码：[androidx-main:compose](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:compose/compiler/)，也可以按照本书第一章提供的方法下载源码阅读。
+
+### [第十章  AtomicFU 的编译产物处理](chapter10)
+
+本章涉及到的 AtomicFU 的源码可以参见我 Fork 的版本：[kotlinx-atomicfu](https://github.com/bennyhuo/kotlinx-atomicfu)

build.gradle.kts

@@ -0,0 +1,26 @@
+plugins {
+  kotlin("jvm") version Version.kotlin apply false
+  kotlin("android") version Version.kotlin apply false
+  kotlin("multiplatform") version Version.kotlin apply false
+  kotlin("plugin.serialization") version Version.kotlin apply false
+  kotlin("plugin.allopen") version Version.kotlin apply false
+
+  id("com.google.devtools.ksp") version Version.ksp apply false
+  id("org.jetbrains.dokka") version Version.dokka apply false
+
+  id("com.android.application") version Version.android apply false
+  id("com.android.library") version Version.android apply false
+}
+
+group = "com.bennyhuo.kotlin"
+version = "1.0-SNAPSHOT"
+
+allprojects {
+  repositories {
+    maven("https://mirrors.tencent.com/nexus/repository/maven-public/")
+    mavenCentral()
+
+    maven("https://s01.oss.sonatype.org/content/repositories/snapshots/")
+    maven("https://oss.sonatype.org/content/repositories/snapshots/")
+  }
+}

buildSrc/build.gradle.kts

@@ -0,0 +1,7 @@
+plugins {
+  `kotlin-dsl`
+}
+
+repositories {
+  maven("https://mirrors.tencent.com/nexus/repository/maven-public/")
+}

buildSrc/src/main/kotlin/Version.kt

@@ -0,0 +1,19 @@
+object Version {
+  const val kotlin = "1.8.10"
+  const val kotlinCoroutine = ""
+  const val kotlinxMetadataJvm = "0.6.0"
+
+  const val dokka = "1.7.10"
+
+  const val android = "7.2.0"
+
+  const val ksp = "1.8.10-1.0.9"
+
+  const val javaPoet = "1.13.0"
+  const val kotlinPoet = "1.12.0"
+
+  const val grammarAntlr = "1.8.0-SNAPSHOT"
+  const val kotlinCodeAnalyzer = "1.8.0-SNAPSHOT"
+
+  const val detekt = "1.22.0"
+}

chapter1/build.gradle.kts

@@ -0,0 +1,15 @@
+plugins {
+  kotlin("jvm")
+}
+
+dependencies {
+  implementation("com.squareup.okhttp3:okhttp:4.10.0")
+  implementation("com.squareup.moshi:moshi:1.14.0")
+  implementation("com.squareup.moshi:moshi-kotlin:1.14.0")
+
+  implementation("com.squareup.retrofit2:retrofit:2.9.0")
+  implementation("com.squareup.retrofit2:converter-moshi:2.9.0")
+  implementation("com.squareup.moshi:moshi-kotlin:1.13.0")
+
+  implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.2")
+}

chapter1/gradle.properties

@@ -0,0 +1 @@
+kotlinx.atomicfu.enableIrTransformation=true

chapter1/src/main/java/com/bennyhuo/list1_1/User.java

@@ -0,0 +1,32 @@
+package com.bennyhuo.list1_1;
+
+// 1-1
+public class User {
+  private long id;
+  private String name;
+  private int age;
+
+  public long getId() {
+    return id;
+  }
+
+  public void setId(long id) {
+    this.id = id;
+  }
+
+  public String getName() {
+    return name;
+  }
+
+  public void setName(String name) {
+    this.name = name;
+  }
+
+  public int getAge() {
+    return age;
+  }
+
+  public void setAge(int age) {
+    this.age = age;
+  }
+}

chapter1/src/main/java/com/bennyhuo/list1_12_15/compile-kotlin.sh

@@ -0,0 +1,12 @@
+# 1-12
+cd $ws
+git clone https://github.com/JetBrains/kotlin.git
+
+# 1-13
+git config core.longpaths true
+
+# 1-14
+kotlin.build.isObsoleteJdkOverrideEnabled=true
+
+# 1-15
+./gradlew dist

chapter1/src/main/java/com/bennyhuo/list1_16_18/compile-intellij.sh

@@ -0,0 +1,10 @@
+# 1-16
+cd $ws
+git clone https://github.com/JetBrains/intellij-community.git
+git checkout 222.4345
+
+# 1-17
+cd $ws/intellij-community
+git clone git://git.jetbrains.org/idea/android.git android
+cd android
+git checkout 222.4345

chapter1/src/main/java/com/bennyhuo/list1_19_24/compile-compose.sh

@@ -0,0 +1,29 @@
+# 1-19
+test -d ~/bin || mkdir ~/bin
+curl https://storage.googleapis.com/git-repo-downloads/repo \
+  > ~/bin/repo && chmod 700 ~/bin/repo
+
+# 1-20
+export PATH=~/bin:$PATH
+
+# 1-21
+function repo() {
+  command python3 ~/bin/repo $@
+}
+
+# 1-22
+cd $ws
+mkdir androidx-main && cd androidx-main
+# 初始化仓库
+repo init -u https://android.googlesource.com/platform/manifest \
+    -b androidx-main --partial-clone --clone-filter=blob:limit=10M
+# 下载源码
+repo sync -c -j8
+
+# 1-23
+git config --global merge.renameLimit 999999
+git config --global diff.renameLimit 999999
+
+# 1-24
+cd $ws/androidx-main/frameworks/support
+ANDROIDX_PROJECTS=COMPOSE ./gradlew studio

chapter1/src/main/java/com/bennyhuo/list1_2/User.kt

@@ -0,0 +1,4 @@
+package com.bennyhuo.list1_2
+
+// 1-2
+class User(var id: Long, var name: String, var age: Int)

chapter1/src/main/java/com/bennyhuo/list1_3/GitHubApi.kt

@@ -0,0 +1,92 @@
+package com.bennyhuo.list1_3
+
+import com.squareup.moshi.Moshi
+import com.squareup.moshi.kotlin.reflect.KotlinJsonAdapterFactory
+import okhttp3.Call
+import okhttp3.Callback
+import okhttp3.OkHttpClient
+import okhttp3.Request
+import okhttp3.Response
+import java.io.IOException
+import kotlin.coroutines.resume
+import kotlin.coroutines.resumeWithException
+import kotlin.coroutines.suspendCoroutine
+
+// 1-3
+class GitHubApi {
+
+  private val endPoint = "https://api.github.com"
+  private val client = OkHttpClient()
+  private val moshi = Moshi.Builder().addLast(KotlinJsonAdapterFactory()).build()
+
+  fun getUser(login: String): GitUser? {
+    val request: Request = Request.Builder()
+      .url("$endPoint/users/$login").get().build()
+    return client.newCall(request).execute().use { response ->
+      response.body?.string()?.let {
+        moshi.adapter(GitUser::class.java).fromJson(it)
+      }
+    }
+  }
+
+  //region 1-4
+  fun getUser(
+    login: String,
+    onSuccess: (GitUser?) -> Unit,
+    onFailure: (Throwable) -> Unit
+  ) {
+    val request: Request = Request.Builder()
+      .url("$endPoint/users/$login").get().build()
+    client.newCall(request).enqueue(object : Callback {
+      override fun onFailure(call: Call, e: IOException) {
+        onFailure(e)
+      }
+
+      override fun onResponse(call: Call, response: Response) {
+        try {
+          val user = response.body?.string()?.let {
+            moshi.adapter(GitUser::class.java).fromJson(it)
+          }
+          onSuccess(user)
+        } catch (e: Exception) {
+          onFailure(e)
+        }
+      }
+    })
+  }
+
+  suspend fun getUserAsync(login: String): GitUser? =
+    suspendCoroutine { continuation ->
+      getUser(login, onSuccess = {
+        continuation.resume(it)
+      }, onFailure = {
+        continuation.resumeWithException(it)
+      })
+    }
+  //endregion
+
+  fun getRepository(userLogin: String, repoName: String): GitRepo? {
+    val request: Request = Request.Builder()
+      .url("$endPoint/repos/$userLogin/$repoName").get().build()
+    return client.newCall(request).execute().use { response ->
+      response.body?.string()?.let {
+        moshi.adapter(GitRepo::class.java).fromJson(it)
+      }
+    }
+  }
+
+}
+
+
+
+suspend fun main() {
+  val api = GitHubApi()
+  val user = api.getUser("bennyhuo")
+  println(user)
+
+  val repo = api.getRepository("bennyhuo", "KotlinDeepCopy")
+  println(repo)
+
+  val user2 = api.getUserAsync("bennyhuo")
+  println(user2)
+}