@k2works/claude-code-booster 2.7.1 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (527) hide show
  1. package/lib/assets/docs/article/functional-desgin-ppp/all/01-immutability-and-data-transformation.md +475 -0
  2. package/lib/assets/docs/article/functional-desgin-ppp/all/02-function-composition.md +519 -0
  3. package/lib/assets/docs/article/functional-desgin-ppp/all/03-polymorphism.md +537 -0
  4. package/lib/assets/docs/article/functional-desgin-ppp/all/04-data-validation.md +300 -0
  5. package/lib/assets/docs/article/functional-desgin-ppp/all/05-property-based-testing.md +320 -0
  6. package/lib/assets/docs/article/functional-desgin-ppp/all/06-tdd-and-functional.md +498 -0
  7. package/lib/assets/docs/article/functional-desgin-ppp/all/07-composite-pattern.md +298 -0
  8. package/lib/assets/docs/article/functional-desgin-ppp/all/08-decorator-pattern.md +291 -0
  9. package/lib/assets/docs/article/functional-desgin-ppp/all/09-adapter-pattern.md +336 -0
  10. package/lib/assets/docs/article/functional-desgin-ppp/all/10-strategy-pattern.md +303 -0
  11. package/lib/assets/docs/article/functional-desgin-ppp/all/11-command-pattern.md +286 -0
  12. package/lib/assets/docs/article/functional-desgin-ppp/all/12-visitor-pattern.md +322 -0
  13. package/lib/assets/docs/article/functional-desgin-ppp/all/13-abstract-factory-pattern.md +319 -0
  14. package/lib/assets/docs/article/functional-desgin-ppp/all/14-abstract-server-pattern.md +365 -0
  15. package/lib/assets/docs/article/functional-desgin-ppp/all/15-gossiping-bus-drivers.md +156 -0
  16. package/lib/assets/docs/article/functional-desgin-ppp/all/16-payroll-system.md +178 -0
  17. package/lib/assets/docs/article/functional-desgin-ppp/all/17-video-rental-system.md +312 -0
  18. package/lib/assets/docs/article/functional-desgin-ppp/all/18-concurrency-system.md +287 -0
  19. package/lib/assets/docs/article/functional-desgin-ppp/all/19-wa-tor-simulation.md +286 -0
  20. package/lib/assets/docs/article/functional-desgin-ppp/all/20-pattern-interactions.md +274 -0
  21. package/lib/assets/docs/article/functional-desgin-ppp/all/21-best-practices.md +294 -0
  22. package/lib/assets/docs/article/functional-desgin-ppp/all/22-oo-to-fp-migration.md +337 -0
  23. package/lib/assets/docs/article/functional-desgin-ppp/all/index.md +388 -0
  24. package/lib/assets/docs/article/functional-desgin-ppp/clojure/01-immutability-and-data-transformation.md +271 -0
  25. package/lib/assets/docs/article/functional-desgin-ppp/clojure/02-function-composition.md +380 -0
  26. package/lib/assets/docs/article/functional-desgin-ppp/clojure/03-polymorphism.md +384 -0
  27. package/lib/assets/docs/article/functional-desgin-ppp/clojure/04-clojure-spec.md +350 -0
  28. package/lib/assets/docs/article/functional-desgin-ppp/clojure/05-property-based-testing.md +352 -0
  29. package/lib/assets/docs/article/functional-desgin-ppp/clojure/06-tdd-in-functional.md +383 -0
  30. package/lib/assets/docs/article/functional-desgin-ppp/clojure/07-composite-pattern.md +529 -0
  31. package/lib/assets/docs/article/functional-desgin-ppp/clojure/08-decorator-pattern.md +395 -0
  32. package/lib/assets/docs/article/functional-desgin-ppp/clojure/09-adapter-pattern.md +399 -0
  33. package/lib/assets/docs/article/functional-desgin-ppp/clojure/10-strategy-pattern.md +485 -0
  34. package/lib/assets/docs/article/functional-desgin-ppp/clojure/11-command-pattern.md +566 -0
  35. package/lib/assets/docs/article/functional-desgin-ppp/clojure/12-visitor-pattern.md +567 -0
  36. package/lib/assets/docs/article/functional-desgin-ppp/clojure/13-abstract-factory-pattern.md +475 -0
  37. package/lib/assets/docs/article/functional-desgin-ppp/clojure/14-abstract-server-pattern.md +462 -0
  38. package/lib/assets/docs/article/functional-desgin-ppp/clojure/15-gossiping-bus-drivers.md +323 -0
  39. package/lib/assets/docs/article/functional-desgin-ppp/clojure/16-payroll-system.md +401 -0
  40. package/lib/assets/docs/article/functional-desgin-ppp/clojure/17-video-rental-system.md +450 -0
  41. package/lib/assets/docs/article/functional-desgin-ppp/clojure/18-concurrency-system.md +475 -0
  42. package/lib/assets/docs/article/functional-desgin-ppp/clojure/19-wator-simulation.md +739 -0
  43. package/lib/assets/docs/article/functional-desgin-ppp/clojure/20-pattern-interactions.md +562 -0
  44. package/lib/assets/docs/article/functional-desgin-ppp/clojure/21-best-practices.md +506 -0
  45. package/lib/assets/docs/article/functional-desgin-ppp/clojure/22-oo-to-fp-migration.md +526 -0
  46. package/lib/assets/docs/article/functional-desgin-ppp/clojure/index.md +197 -0
  47. package/lib/assets/docs/article/functional-desgin-ppp/elixir/01-immutability-and-data-transformation.md +381 -0
  48. package/lib/assets/docs/article/functional-desgin-ppp/elixir/02-function-composition.md +374 -0
  49. package/lib/assets/docs/article/functional-desgin-ppp/elixir/03-polymorphism.md +375 -0
  50. package/lib/assets/docs/article/functional-desgin-ppp/elixir/04-data-validation.md +195 -0
  51. package/lib/assets/docs/article/functional-desgin-ppp/elixir/05-property-based-testing.md +268 -0
  52. package/lib/assets/docs/article/functional-desgin-ppp/elixir/06-tdd-and-fp.md +294 -0
  53. package/lib/assets/docs/article/functional-desgin-ppp/elixir/07-effects-and-pure-functions.md +164 -0
  54. package/lib/assets/docs/article/functional-desgin-ppp/elixir/08-error-handling-strategies.md +168 -0
  55. package/lib/assets/docs/article/functional-desgin-ppp/elixir/09-io-and-external-systems.md +254 -0
  56. package/lib/assets/docs/article/functional-desgin-ppp/elixir/10-concurrency-patterns.md +269 -0
  57. package/lib/assets/docs/article/functional-desgin-ppp/elixir/11-command-pattern.md +148 -0
  58. package/lib/assets/docs/article/functional-desgin-ppp/elixir/12-visitor-pattern.md +176 -0
  59. package/lib/assets/docs/article/functional-desgin-ppp/elixir/13-abstract-factory-pattern.md +604 -0
  60. package/lib/assets/docs/article/functional-desgin-ppp/elixir/14-abstract-server-pattern.md +729 -0
  61. package/lib/assets/docs/article/functional-desgin-ppp/elixir/15-gossiping-bus-drivers.md +291 -0
  62. package/lib/assets/docs/article/functional-desgin-ppp/elixir/16-payroll-system.md +420 -0
  63. package/lib/assets/docs/article/functional-desgin-ppp/elixir/17-video-rental-system.md +319 -0
  64. package/lib/assets/docs/article/functional-desgin-ppp/elixir/18-concurrency-system.md +466 -0
  65. package/lib/assets/docs/article/functional-desgin-ppp/elixir/19-wator-simulation.md +523 -0
  66. package/lib/assets/docs/article/functional-desgin-ppp/elixir/20-pattern-interactions.md +287 -0
  67. package/lib/assets/docs/article/functional-desgin-ppp/elixir/21-best-practices.md +340 -0
  68. package/lib/assets/docs/article/functional-desgin-ppp/elixir/22-oo-to-fp-migration.md +395 -0
  69. package/lib/assets/docs/article/functional-desgin-ppp/elixir/index.md +204 -0
  70. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/01-immutability-and-data-transformation.md +382 -0
  71. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/02-function-composition.md +452 -0
  72. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/03-polymorphism.md +495 -0
  73. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/04-data-validation.md +416 -0
  74. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/05-property-based-testing.md +382 -0
  75. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/06-tdd-functional.md +687 -0
  76. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/07-composite-pattern.md +442 -0
  77. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/08-decorator-pattern.md +479 -0
  78. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/09-adapter-pattern.md +479 -0
  79. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/10-strategy-pattern.md +427 -0
  80. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/11-command-pattern.md +428 -0
  81. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/12-visitor-pattern.md +339 -0
  82. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/13-abstract-factory-pattern.md +309 -0
  83. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/14-abstract-server-pattern.md +596 -0
  84. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/15-gossiping-bus-drivers.md +353 -0
  85. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/16-payroll-system.md +350 -0
  86. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/17-video-rental-system.md +412 -0
  87. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/18-concurrency-system.md +367 -0
  88. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/19-wator-simulation.md +401 -0
  89. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/20-pattern-interactions.md +291 -0
  90. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/21-best-practices.md +320 -0
  91. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/22-oo-to-fp-migration.md +322 -0
  92. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/index.md +230 -0
  93. package/lib/assets/docs/article/functional-desgin-ppp/haskell/01-immutability-and-data-transformation.md +298 -0
  94. package/lib/assets/docs/article/functional-desgin-ppp/haskell/02-function-composition.md +304 -0
  95. package/lib/assets/docs/article/functional-desgin-ppp/haskell/03-polymorphism.md +362 -0
  96. package/lib/assets/docs/article/functional-desgin-ppp/haskell/04-data-validation.md +257 -0
  97. package/lib/assets/docs/article/functional-desgin-ppp/haskell/05-property-based-testing.md +254 -0
  98. package/lib/assets/docs/article/functional-desgin-ppp/haskell/06-tdd-functional.md +283 -0
  99. package/lib/assets/docs/article/functional-desgin-ppp/haskell/07-composite-pattern.md +395 -0
  100. package/lib/assets/docs/article/functional-desgin-ppp/haskell/08-decorator-pattern.md +319 -0
  101. package/lib/assets/docs/article/functional-desgin-ppp/haskell/09-adapter-pattern.md +382 -0
  102. package/lib/assets/docs/article/functional-desgin-ppp/haskell/10-strategy-pattern.md +287 -0
  103. package/lib/assets/docs/article/functional-desgin-ppp/haskell/11-command-pattern.md +303 -0
  104. package/lib/assets/docs/article/functional-desgin-ppp/haskell/12-visitor-pattern.md +326 -0
  105. package/lib/assets/docs/article/functional-desgin-ppp/haskell/13-abstract-factory-pattern.md +332 -0
  106. package/lib/assets/docs/article/functional-desgin-ppp/haskell/14-abstract-server-pattern.md +379 -0
  107. package/lib/assets/docs/article/functional-desgin-ppp/haskell/15-gossiping-bus-drivers.md +175 -0
  108. package/lib/assets/docs/article/functional-desgin-ppp/haskell/16-payroll-system.md +219 -0
  109. package/lib/assets/docs/article/functional-desgin-ppp/haskell/17-video-rental-system.md +244 -0
  110. package/lib/assets/docs/article/functional-desgin-ppp/haskell/18-concurrency-system.md +363 -0
  111. package/lib/assets/docs/article/functional-desgin-ppp/haskell/19-wator-simulation.md +438 -0
  112. package/lib/assets/docs/article/functional-desgin-ppp/haskell/20-pattern-interactions.md +323 -0
  113. package/lib/assets/docs/article/functional-desgin-ppp/haskell/21-best-practices.md +403 -0
  114. package/lib/assets/docs/article/functional-desgin-ppp/haskell/22-oo-to-fp-migration.md +469 -0
  115. package/lib/assets/docs/article/functional-desgin-ppp/haskell/index.md +174 -0
  116. package/lib/assets/docs/article/functional-desgin-ppp/index.md +90 -0
  117. package/lib/assets/docs/article/functional-desgin-ppp/rust/01-immutability-and-data-transformation.md +448 -0
  118. package/lib/assets/docs/article/functional-desgin-ppp/rust/02-function-composition.md +463 -0
  119. package/lib/assets/docs/article/functional-desgin-ppp/rust/03-polymorphism.md +425 -0
  120. package/lib/assets/docs/article/functional-desgin-ppp/rust/04-data-validation.md +273 -0
  121. package/lib/assets/docs/article/functional-desgin-ppp/rust/05-property-based-testing.md +247 -0
  122. package/lib/assets/docs/article/functional-desgin-ppp/rust/06-tdd-and-functional.md +841 -0
  123. package/lib/assets/docs/article/functional-desgin-ppp/rust/07-composite-pattern.md +384 -0
  124. package/lib/assets/docs/article/functional-desgin-ppp/rust/08-decorator-pattern.md +383 -0
  125. package/lib/assets/docs/article/functional-desgin-ppp/rust/09-adapter-pattern.md +339 -0
  126. package/lib/assets/docs/article/functional-desgin-ppp/rust/10-strategy-pattern.md +331 -0
  127. package/lib/assets/docs/article/functional-desgin-ppp/rust/11-command-pattern.md +356 -0
  128. package/lib/assets/docs/article/functional-desgin-ppp/rust/12-visitor-pattern.md +379 -0
  129. package/lib/assets/docs/article/functional-desgin-ppp/rust/13-abstract-factory-pattern.md +361 -0
  130. package/lib/assets/docs/article/functional-desgin-ppp/rust/14-abstract-server-pattern.md +392 -0
  131. package/lib/assets/docs/article/functional-desgin-ppp/rust/15-gossiping-bus-drivers.md +300 -0
  132. package/lib/assets/docs/article/functional-desgin-ppp/rust/16-payroll-system.md +297 -0
  133. package/lib/assets/docs/article/functional-desgin-ppp/rust/17-video-rental-system.md +304 -0
  134. package/lib/assets/docs/article/functional-desgin-ppp/rust/18-concurrency-system.md +315 -0
  135. package/lib/assets/docs/article/functional-desgin-ppp/rust/19-wator-simulation.md +311 -0
  136. package/lib/assets/docs/article/functional-desgin-ppp/rust/20-pattern-interactions.md +304 -0
  137. package/lib/assets/docs/article/functional-desgin-ppp/rust/21-best-practices.md +336 -0
  138. package/lib/assets/docs/article/functional-desgin-ppp/rust/22-oo-to-fp-migration.md +349 -0
  139. package/lib/assets/docs/article/functional-desgin-ppp/rust/index.md +199 -0
  140. package/lib/assets/docs/article/functional-desgin-ppp/scala/01-immutability-and-data-transformation.md +326 -0
  141. package/lib/assets/docs/article/functional-desgin-ppp/scala/02-function-composition.md +348 -0
  142. package/lib/assets/docs/article/functional-desgin-ppp/scala/03-polymorphism.md +357 -0
  143. package/lib/assets/docs/article/functional-desgin-ppp/scala/04-data-validation.md +364 -0
  144. package/lib/assets/docs/article/functional-desgin-ppp/scala/05-property-based-testing.md +515 -0
  145. package/lib/assets/docs/article/functional-desgin-ppp/scala/06-tdd-functional.md +557 -0
  146. package/lib/assets/docs/article/functional-desgin-ppp/scala/07-composite-pattern.md +363 -0
  147. package/lib/assets/docs/article/functional-desgin-ppp/scala/08-decorator-pattern.md +327 -0
  148. package/lib/assets/docs/article/functional-desgin-ppp/scala/09-adapter-pattern.md +517 -0
  149. package/lib/assets/docs/article/functional-desgin-ppp/scala/10-strategy-pattern.md +441 -0
  150. package/lib/assets/docs/article/functional-desgin-ppp/scala/11-command-pattern.md +407 -0
  151. package/lib/assets/docs/article/functional-desgin-ppp/scala/12-visitor-pattern.md +379 -0
  152. package/lib/assets/docs/article/functional-desgin-ppp/scala/13-abstract-factory-pattern.md +398 -0
  153. package/lib/assets/docs/article/functional-desgin-ppp/scala/14-abstract-server-pattern.md +476 -0
  154. package/lib/assets/docs/article/functional-desgin-ppp/scala/15-gossiping-bus-drivers.md +389 -0
  155. package/lib/assets/docs/article/functional-desgin-ppp/scala/16-payroll-system.md +342 -0
  156. package/lib/assets/docs/article/functional-desgin-ppp/scala/17-video-rental-system.md +324 -0
  157. package/lib/assets/docs/article/functional-desgin-ppp/scala/18-concurrency-system.md +730 -0
  158. package/lib/assets/docs/article/functional-desgin-ppp/scala/19-wator-simulation.md +624 -0
  159. package/lib/assets/docs/article/functional-desgin-ppp/scala/20-pattern-interactions.md +512 -0
  160. package/lib/assets/docs/article/functional-desgin-ppp/scala/21-best-practices.md +427 -0
  161. package/lib/assets/docs/article/functional-desgin-ppp/scala/22-oo-to-fp-migration.md +682 -0
  162. package/lib/assets/docs/article/functional-desgin-ppp/scala/index.md +199 -0
  163. package/lib/assets/docs/article/getting-start-tdd/clojure/01-todo-list-and-first-test.md +166 -0
  164. package/lib/assets/docs/article/getting-start-tdd/clojure/02-fake-it-and-triangulation.md +162 -0
  165. package/lib/assets/docs/article/getting-start-tdd/clojure/03-obvious-implementation-and-refactoring.md +135 -0
  166. package/lib/assets/docs/article/getting-start-tdd/clojure/04-version-control-and-conventional-commits.md +88 -0
  167. package/lib/assets/docs/article/getting-start-tdd/clojure/05-package-management-and-static-analysis.md +299 -0
  168. package/lib/assets/docs/article/getting-start-tdd/clojure/06-task-runner-and-ci-cd.md +241 -0
  169. package/lib/assets/docs/article/getting-start-tdd/clojure/07-protocols-and-records.md +131 -0
  170. package/lib/assets/docs/article/getting-start-tdd/clojure/08-multimethods-and-design-patterns.md +130 -0
  171. package/lib/assets/docs/article/getting-start-tdd/clojure/09-namespaces-and-module-design.md +127 -0
  172. package/lib/assets/docs/article/getting-start-tdd/clojure/10-higher-order-functions-and-composition.md +114 -0
  173. package/lib/assets/docs/article/getting-start-tdd/clojure/11-persistent-data-and-pipeline.md +138 -0
  174. package/lib/assets/docs/article/getting-start-tdd/clojure/12-error-handling-and-spec.md +161 -0
  175. package/lib/assets/docs/article/getting-start-tdd/clojure/index.md +65 -0
  176. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter01.md +232 -0
  177. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter02.md +244 -0
  178. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter03.md +202 -0
  179. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter04.md +92 -0
  180. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter05.md +256 -0
  181. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter06.md +195 -0
  182. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter07.md +214 -0
  183. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter08.md +249 -0
  184. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter09.md +174 -0
  185. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter10.md +166 -0
  186. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter11.md +192 -0
  187. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter12.md +211 -0
  188. package/lib/assets/docs/article/getting-start-tdd/csharp/index.md +83 -0
  189. package/lib/assets/docs/article/getting-start-tdd/elixir/01-todo-list-and-first-test.md +87 -0
  190. package/lib/assets/docs/article/getting-start-tdd/elixir/02-fake-it-and-triangulation.md +95 -0
  191. package/lib/assets/docs/article/getting-start-tdd/elixir/03-obvious-implementation-and-refactoring.md +109 -0
  192. package/lib/assets/docs/article/getting-start-tdd/elixir/04-version-control-and-conventional-commits.md +96 -0
  193. package/lib/assets/docs/article/getting-start-tdd/elixir/05-package-management-and-static-analysis.md +88 -0
  194. package/lib/assets/docs/article/getting-start-tdd/elixir/06-task-runner-and-ci-cd.md +71 -0
  195. package/lib/assets/docs/article/getting-start-tdd/elixir/07-structs-and-protocols.md +110 -0
  196. package/lib/assets/docs/article/getting-start-tdd/elixir/08-pattern-matching-and-guards.md +108 -0
  197. package/lib/assets/docs/article/getting-start-tdd/elixir/09-module-design-and-behaviours.md +104 -0
  198. package/lib/assets/docs/article/getting-start-tdd/elixir/10-higher-order-functions-and-pipeline.md +178 -0
  199. package/lib/assets/docs/article/getting-start-tdd/elixir/11-stream-and-lazy-evaluation.md +142 -0
  200. package/lib/assets/docs/article/getting-start-tdd/elixir/12-error-handling-and-with.md +145 -0
  201. package/lib/assets/docs/article/getting-start-tdd/elixir/index.md +35 -0
  202. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter01.md +202 -0
  203. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter02.md +246 -0
  204. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter03.md +218 -0
  205. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter04.md +179 -0
  206. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter05.md +267 -0
  207. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter06.md +190 -0
  208. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter07.md +161 -0
  209. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter08.md +175 -0
  210. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter09.md +222 -0
  211. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter10.md +189 -0
  212. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter11.md +212 -0
  213. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter12.md +215 -0
  214. package/lib/assets/docs/article/getting-start-tdd/fsharp/index.md +71 -0
  215. package/lib/assets/docs/article/getting-start-tdd/go/01-todo-list-and-first-test.md +213 -0
  216. package/lib/assets/docs/article/getting-start-tdd/go/02-fake-it-and-triangulation.md +302 -0
  217. package/lib/assets/docs/article/getting-start-tdd/go/03-obvious-implementation-and-refactoring.md +339 -0
  218. package/lib/assets/docs/article/getting-start-tdd/go/04-version-control-and-conventional-commits.md +112 -0
  219. package/lib/assets/docs/article/getting-start-tdd/go/05-package-management-and-static-analysis.md +272 -0
  220. package/lib/assets/docs/article/getting-start-tdd/go/06-task-runner-and-ci-cd.md +233 -0
  221. package/lib/assets/docs/article/getting-start-tdd/go/07-encapsulation-and-polymorphism.md +394 -0
  222. package/lib/assets/docs/article/getting-start-tdd/go/08-design-patterns.md +422 -0
  223. package/lib/assets/docs/article/getting-start-tdd/go/09-solid-principles-and-module-design.md +400 -0
  224. package/lib/assets/docs/article/getting-start-tdd/go/10-higher-order-functions-and-composition.md +226 -0
  225. package/lib/assets/docs/article/getting-start-tdd/go/11-immutable-data-and-pipeline.md +296 -0
  226. package/lib/assets/docs/article/getting-start-tdd/go/12-error-handling-and-type-safety.md +411 -0
  227. package/lib/assets/docs/article/getting-start-tdd/go/index.md +83 -0
  228. package/lib/assets/docs/article/getting-start-tdd/haskell/01-todo-list-and-first-test.md +279 -0
  229. package/lib/assets/docs/article/getting-start-tdd/haskell/02-fake-it-and-triangulation.md +337 -0
  230. package/lib/assets/docs/article/getting-start-tdd/haskell/03-obvious-implementation-and-refactoring.md +257 -0
  231. package/lib/assets/docs/article/getting-start-tdd/haskell/04-version-control-and-conventional-commits.md +182 -0
  232. package/lib/assets/docs/article/getting-start-tdd/haskell/05-package-management-and-static-analysis.md +313 -0
  233. package/lib/assets/docs/article/getting-start-tdd/haskell/06-task-runner-and-ci-cd.md +309 -0
  234. package/lib/assets/docs/article/getting-start-tdd/haskell/07-algebraic-data-types-and-type-classes.md +412 -0
  235. package/lib/assets/docs/article/getting-start-tdd/haskell/08-pattern-matching-and-guards.md +390 -0
  236. package/lib/assets/docs/article/getting-start-tdd/haskell/09-module-design-and-smart-constructors.md +461 -0
  237. package/lib/assets/docs/article/getting-start-tdd/haskell/10-higher-order-functions-and-currying.md +434 -0
  238. package/lib/assets/docs/article/getting-start-tdd/haskell/11-function-composition-and-point-free.md +392 -0
  239. package/lib/assets/docs/article/getting-start-tdd/haskell/12-monad-and-error-handling.md +631 -0
  240. package/lib/assets/docs/article/getting-start-tdd/haskell/index.md +49 -0
  241. package/lib/assets/docs/article/getting-start-tdd/index.md +93 -0
  242. package/lib/assets/docs/article/getting-start-tdd/integration/01-language-overview.md +375 -0
  243. package/lib/assets/docs/article/getting-start-tdd/integration/02-test-framework-comparison.md +349 -0
  244. package/lib/assets/docs/article/getting-start-tdd/integration/03-tdd-pattern-comparison.md +445 -0
  245. package/lib/assets/docs/article/getting-start-tdd/integration/04-type-system-comparison.md +405 -0
  246. package/lib/assets/docs/article/getting-start-tdd/integration/05-dev-environment-comparison.md +330 -0
  247. package/lib/assets/docs/article/getting-start-tdd/integration/06-learning-roadmap.md +274 -0
  248. package/lib/assets/docs/article/getting-start-tdd/integration/index.md +69 -0
  249. package/lib/assets/docs/article/getting-start-tdd/java/01-todo-list-and-first-test.md +234 -0
  250. package/lib/assets/docs/article/getting-start-tdd/java/02-fake-it-and-triangulation.md +261 -0
  251. package/lib/assets/docs/article/getting-start-tdd/java/03-obvious-implementation-and-refactoring.md +185 -0
  252. package/lib/assets/docs/article/getting-start-tdd/java/04-version-control-and-conventional-commits.md +115 -0
  253. package/lib/assets/docs/article/getting-start-tdd/java/05-package-management-and-static-analysis.md +382 -0
  254. package/lib/assets/docs/article/getting-start-tdd/java/06-task-runner-and-ci-cd.md +272 -0
  255. package/lib/assets/docs/article/getting-start-tdd/java/07-encapsulation-and-polymorphism.md +626 -0
  256. package/lib/assets/docs/article/getting-start-tdd/java/08-design-patterns.md +393 -0
  257. package/lib/assets/docs/article/getting-start-tdd/java/09-solid-principles-and-module-design.md +310 -0
  258. package/lib/assets/docs/article/getting-start-tdd/java/10-higher-order-functions-and-composition.md +188 -0
  259. package/lib/assets/docs/article/getting-start-tdd/java/11-immutable-data-and-pipeline.md +167 -0
  260. package/lib/assets/docs/article/getting-start-tdd/java/12-error-handling-and-type-safety.md +205 -0
  261. package/lib/assets/docs/article/getting-start-tdd/java/index.md +61 -0
  262. package/lib/assets/docs/article/getting-start-tdd/node/01-todo-list-and-first-test.md +244 -0
  263. package/lib/assets/docs/article/getting-start-tdd/node/02-fake-it-and-triangulation.md +262 -0
  264. package/lib/assets/docs/article/getting-start-tdd/node/03-obvious-implementation-and-refactoring.md +169 -0
  265. package/lib/assets/docs/article/getting-start-tdd/node/04-version-control-and-conventional-commits.md +112 -0
  266. package/lib/assets/docs/article/getting-start-tdd/node/05-package-management-and-static-analysis.md +314 -0
  267. package/lib/assets/docs/article/getting-start-tdd/node/06-task-runner-and-ci-cd.md +235 -0
  268. package/lib/assets/docs/article/getting-start-tdd/node/07-encapsulation-and-polymorphism.md +327 -0
  269. package/lib/assets/docs/article/getting-start-tdd/node/08-design-patterns.md +322 -0
  270. package/lib/assets/docs/article/getting-start-tdd/node/09-solid-principles-and-module-design.md +285 -0
  271. package/lib/assets/docs/article/getting-start-tdd/node/10-higher-order-functions-and-composition.md +199 -0
  272. package/lib/assets/docs/article/getting-start-tdd/node/11-immutable-data-and-pipeline.md +207 -0
  273. package/lib/assets/docs/article/getting-start-tdd/node/12-error-handling-and-type-safety.md +295 -0
  274. package/lib/assets/docs/article/getting-start-tdd/node/index.md +56 -0
  275. package/lib/assets/docs/article/getting-start-tdd/php/01-todo-list-and-first-test.md +259 -0
  276. package/lib/assets/docs/article/getting-start-tdd/php/02-fake-it-and-triangulation.md +200 -0
  277. package/lib/assets/docs/article/getting-start-tdd/php/03-obvious-implementation-and-refactoring.md +248 -0
  278. package/lib/assets/docs/article/getting-start-tdd/php/04-version-control-and-conventional-commits.md +141 -0
  279. package/lib/assets/docs/article/getting-start-tdd/php/05-package-management-and-static-analysis.md +410 -0
  280. package/lib/assets/docs/article/getting-start-tdd/php/06-task-runner-and-ci-cd.md +321 -0
  281. package/lib/assets/docs/article/getting-start-tdd/php/07-encapsulation-and-polymorphism.md +372 -0
  282. package/lib/assets/docs/article/getting-start-tdd/php/08-design-patterns.md +453 -0
  283. package/lib/assets/docs/article/getting-start-tdd/php/09-solid-principles-and-module-design.md +460 -0
  284. package/lib/assets/docs/article/getting-start-tdd/php/10-higher-order-functions-and-composition.md +182 -0
  285. package/lib/assets/docs/article/getting-start-tdd/php/11-immutable-data-and-pipeline.md +266 -0
  286. package/lib/assets/docs/article/getting-start-tdd/php/12-error-handling-and-type-safety.md +308 -0
  287. package/lib/assets/docs/article/getting-start-tdd/php/index.md +84 -0
  288. package/lib/assets/docs/article/getting-start-tdd/python/01-todo-list-and-first-test.md +201 -0
  289. package/lib/assets/docs/article/getting-start-tdd/python/02-fake-it-and-triangulation.md +247 -0
  290. package/lib/assets/docs/article/getting-start-tdd/python/03-obvious-implementation-and-refactoring.md +199 -0
  291. package/lib/assets/docs/article/getting-start-tdd/python/04-version-control-and-conventional-commits.md +87 -0
  292. package/lib/assets/docs/article/getting-start-tdd/python/05-package-management-and-static-analysis.md +274 -0
  293. package/lib/assets/docs/article/getting-start-tdd/python/06-task-runner-and-ci-cd.md +190 -0
  294. package/lib/assets/docs/article/getting-start-tdd/python/07-encapsulation-and-polymorphism.md +208 -0
  295. package/lib/assets/docs/article/getting-start-tdd/python/08-design-patterns.md +172 -0
  296. package/lib/assets/docs/article/getting-start-tdd/python/09-solid-principles-and-module-design.md +130 -0
  297. package/lib/assets/docs/article/getting-start-tdd/python/10-higher-order-functions-and-composition.md +122 -0
  298. package/lib/assets/docs/article/getting-start-tdd/python/11-immutable-data-and-pipeline.md +116 -0
  299. package/lib/assets/docs/article/getting-start-tdd/python/12-error-handling-and-type-safety.md +126 -0
  300. package/lib/assets/docs/article/getting-start-tdd/python/index.md +55 -0
  301. package/lib/assets/docs/article/getting-start-tdd/ruby/01-todo-list-and-first-test.md +231 -0
  302. package/lib/assets/docs/article/getting-start-tdd/ruby/02-fake-it-and-triangulation.md +238 -0
  303. package/lib/assets/docs/article/getting-start-tdd/ruby/03-obvious-implementation-and-refactoring.md +228 -0
  304. package/lib/assets/docs/article/getting-start-tdd/ruby/04-version-control-and-conventional-commits.md +112 -0
  305. package/lib/assets/docs/article/getting-start-tdd/ruby/05-package-management-and-static-analysis.md +287 -0
  306. package/lib/assets/docs/article/getting-start-tdd/ruby/06-task-runner-and-ci-cd.md +248 -0
  307. package/lib/assets/docs/article/getting-start-tdd/ruby/07-encapsulation-and-polymorphism.md +279 -0
  308. package/lib/assets/docs/article/getting-start-tdd/ruby/08-design-patterns.md +329 -0
  309. package/lib/assets/docs/article/getting-start-tdd/ruby/09-solid-principles-and-module-design.md +196 -0
  310. package/lib/assets/docs/article/getting-start-tdd/ruby/10-higher-order-functions-and-composition.md +175 -0
  311. package/lib/assets/docs/article/getting-start-tdd/ruby/11-immutable-data-and-pipeline.md +233 -0
  312. package/lib/assets/docs/article/getting-start-tdd/ruby/12-error-handling-and-type-safety.md +398 -0
  313. package/lib/assets/docs/article/getting-start-tdd/ruby/index.md +83 -0
  314. package/lib/assets/docs/article/getting-start-tdd/rust/01-todo-list-and-first-test.md +211 -0
  315. package/lib/assets/docs/article/getting-start-tdd/rust/02-fake-it-and-triangulation.md +264 -0
  316. package/lib/assets/docs/article/getting-start-tdd/rust/03-obvious-implementation-and-refactoring.md +233 -0
  317. package/lib/assets/docs/article/getting-start-tdd/rust/04-version-control-and-conventional-commits.md +92 -0
  318. package/lib/assets/docs/article/getting-start-tdd/rust/05-package-management-and-static-analysis.md +212 -0
  319. package/lib/assets/docs/article/getting-start-tdd/rust/06-task-runner-and-ci-cd.md +164 -0
  320. package/lib/assets/docs/article/getting-start-tdd/rust/07-encapsulation-and-polymorphism.md +142 -0
  321. package/lib/assets/docs/article/getting-start-tdd/rust/08-design-patterns.md +145 -0
  322. package/lib/assets/docs/article/getting-start-tdd/rust/09-solid-principles-and-module-design.md +110 -0
  323. package/lib/assets/docs/article/getting-start-tdd/rust/10-higher-order-functions-and-composition.md +94 -0
  324. package/lib/assets/docs/article/getting-start-tdd/rust/11-immutable-data-and-pipeline.md +105 -0
  325. package/lib/assets/docs/article/getting-start-tdd/rust/12-error-handling-and-type-safety.md +112 -0
  326. package/lib/assets/docs/article/getting-start-tdd/rust/index.md +83 -0
  327. package/lib/assets/docs/article/getting-start-tdd/scala/01-todo-list-and-first-test.md +111 -0
  328. package/lib/assets/docs/article/getting-start-tdd/scala/02-fake-it-and-triangulation.md +107 -0
  329. package/lib/assets/docs/article/getting-start-tdd/scala/03-obvious-implementation-and-refactoring.md +99 -0
  330. package/lib/assets/docs/article/getting-start-tdd/scala/04-version-control-and-conventional-commits.md +123 -0
  331. package/lib/assets/docs/article/getting-start-tdd/scala/05-package-management-and-static-analysis.md +196 -0
  332. package/lib/assets/docs/article/getting-start-tdd/scala/06-task-runner-and-ci-cd.md +186 -0
  333. package/lib/assets/docs/article/getting-start-tdd/scala/07-case-classes-and-traits.md +139 -0
  334. package/lib/assets/docs/article/getting-start-tdd/scala/08-pattern-matching-and-sealed-traits.md +106 -0
  335. package/lib/assets/docs/article/getting-start-tdd/scala/09-packages-and-module-design.md +75 -0
  336. package/lib/assets/docs/article/getting-start-tdd/scala/10-higher-order-functions-and-composition.md +104 -0
  337. package/lib/assets/docs/article/getting-start-tdd/scala/11-collections-and-lazy-evaluation.md +94 -0
  338. package/lib/assets/docs/article/getting-start-tdd/scala/12-error-handling-and-type-safety.md +92 -0
  339. package/lib/assets/docs/article/getting-start-tdd/scala/index.md +65 -0
  340. package/lib/assets/docs/article/grokking-concurrency/all/index.md +404 -0
  341. package/lib/assets/docs/article/grokking-concurrency/all/part-1-ch02-sequential.md +554 -0
  342. package/lib/assets/docs/article/grokking-concurrency/all/part-2-ch04-05-threads.md +469 -0
  343. package/lib/assets/docs/article/grokking-concurrency/all/part-3-ch06-multitasking.md +520 -0
  344. package/lib/assets/docs/article/grokking-concurrency/all/part-4-ch07-parallel-patterns.md +420 -0
  345. package/lib/assets/docs/article/grokking-concurrency/all/part-5-ch08-09-synchronization.md +510 -0
  346. package/lib/assets/docs/article/grokking-concurrency/all/part-6-ch10-11-nonblocking-io.md +435 -0
  347. package/lib/assets/docs/article/grokking-concurrency/all/part-7-ch12-async.md +465 -0
  348. package/lib/assets/docs/article/grokking-concurrency/all/part-8-ch13-mapreduce.md +377 -0
  349. package/lib/assets/docs/article/grokking-concurrency/clojure/index.md +116 -0
  350. package/lib/assets/docs/article/grokking-concurrency/clojure/part-1.md +108 -0
  351. package/lib/assets/docs/article/grokking-concurrency/clojure/part-2.md +101 -0
  352. package/lib/assets/docs/article/grokking-concurrency/clojure/part-3.md +122 -0
  353. package/lib/assets/docs/article/grokking-concurrency/clojure/part-4.md +123 -0
  354. package/lib/assets/docs/article/grokking-concurrency/clojure/part-5.md +118 -0
  355. package/lib/assets/docs/article/grokking-concurrency/clojure/part-6.md +89 -0
  356. package/lib/assets/docs/article/grokking-concurrency/clojure/part-7.md +100 -0
  357. package/lib/assets/docs/article/grokking-concurrency/clojure/part-8.md +120 -0
  358. package/lib/assets/docs/article/grokking-concurrency/csharp/index.md +101 -0
  359. package/lib/assets/docs/article/grokking-concurrency/csharp/part-1.md +97 -0
  360. package/lib/assets/docs/article/grokking-concurrency/csharp/part-2.md +123 -0
  361. package/lib/assets/docs/article/grokking-concurrency/csharp/part-3.md +101 -0
  362. package/lib/assets/docs/article/grokking-concurrency/csharp/part-4.md +112 -0
  363. package/lib/assets/docs/article/grokking-concurrency/csharp/part-5.md +99 -0
  364. package/lib/assets/docs/article/grokking-concurrency/csharp/part-6.md +61 -0
  365. package/lib/assets/docs/article/grokking-concurrency/csharp/part-7.md +84 -0
  366. package/lib/assets/docs/article/grokking-concurrency/csharp/part-8.md +92 -0
  367. package/lib/assets/docs/article/grokking-concurrency/fsharp/index.md +65 -0
  368. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-1.md +80 -0
  369. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-2.md +103 -0
  370. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-3.md +94 -0
  371. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-4.md +110 -0
  372. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-5.md +104 -0
  373. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-6.md +93 -0
  374. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-7.md +121 -0
  375. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-8.md +107 -0
  376. package/lib/assets/docs/article/grokking-concurrency/haskell/index.md +248 -0
  377. package/lib/assets/docs/article/grokking-concurrency/haskell/part-1.md +96 -0
  378. package/lib/assets/docs/article/grokking-concurrency/haskell/part-2.md +96 -0
  379. package/lib/assets/docs/article/grokking-concurrency/haskell/part-3.md +91 -0
  380. package/lib/assets/docs/article/grokking-concurrency/haskell/part-4.md +106 -0
  381. package/lib/assets/docs/article/grokking-concurrency/haskell/part-5.md +99 -0
  382. package/lib/assets/docs/article/grokking-concurrency/haskell/part-6.md +95 -0
  383. package/lib/assets/docs/article/grokking-concurrency/haskell/part-7.md +111 -0
  384. package/lib/assets/docs/article/grokking-concurrency/haskell/part-8.md +118 -0
  385. package/lib/assets/docs/article/grokking-concurrency/index.md +66 -0
  386. package/lib/assets/docs/article/grokking-concurrency/java/index.md +102 -0
  387. package/lib/assets/docs/article/grokking-concurrency/java/part-1.md +308 -0
  388. package/lib/assets/docs/article/grokking-concurrency/java/part-2.md +334 -0
  389. package/lib/assets/docs/article/grokking-concurrency/java/part-3.md +221 -0
  390. package/lib/assets/docs/article/grokking-concurrency/java/part-4.md +213 -0
  391. package/lib/assets/docs/article/grokking-concurrency/java/part-5.md +112 -0
  392. package/lib/assets/docs/article/grokking-concurrency/java/part-6.md +69 -0
  393. package/lib/assets/docs/article/grokking-concurrency/java/part-7.md +101 -0
  394. package/lib/assets/docs/article/grokking-concurrency/java/part-8.md +101 -0
  395. package/lib/assets/docs/article/grokking-concurrency/python/index.md +313 -0
  396. package/lib/assets/docs/article/grokking-concurrency/python/part-1.md +239 -0
  397. package/lib/assets/docs/article/grokking-concurrency/python/part-2.md +418 -0
  398. package/lib/assets/docs/article/grokking-concurrency/python/part-3.md +227 -0
  399. package/lib/assets/docs/article/grokking-concurrency/python/part-4.md +299 -0
  400. package/lib/assets/docs/article/grokking-concurrency/python/part-5.md +315 -0
  401. package/lib/assets/docs/article/grokking-concurrency/python/part-6.md +297 -0
  402. package/lib/assets/docs/article/grokking-concurrency/python/part-7.md +314 -0
  403. package/lib/assets/docs/article/grokking-concurrency/python/part-8.md +360 -0
  404. package/lib/assets/docs/article/grokking-concurrency/rust/index.md +270 -0
  405. package/lib/assets/docs/article/grokking-concurrency/rust/part-1.md +108 -0
  406. package/lib/assets/docs/article/grokking-concurrency/rust/part-2.md +120 -0
  407. package/lib/assets/docs/article/grokking-concurrency/rust/part-3.md +126 -0
  408. package/lib/assets/docs/article/grokking-concurrency/rust/part-4.md +175 -0
  409. package/lib/assets/docs/article/grokking-concurrency/rust/part-5.md +158 -0
  410. package/lib/assets/docs/article/grokking-concurrency/rust/part-6.md +94 -0
  411. package/lib/assets/docs/article/grokking-concurrency/rust/part-7.md +133 -0
  412. package/lib/assets/docs/article/grokking-concurrency/rust/part-8.md +155 -0
  413. package/lib/assets/docs/article/grokking-concurrency/scala/index.md +69 -0
  414. package/lib/assets/docs/article/grokking-concurrency/scala/part-1.md +78 -0
  415. package/lib/assets/docs/article/grokking-concurrency/scala/part-2.md +112 -0
  416. package/lib/assets/docs/article/grokking-concurrency/scala/part-3.md +93 -0
  417. package/lib/assets/docs/article/grokking-concurrency/scala/part-4.md +110 -0
  418. package/lib/assets/docs/article/grokking-concurrency/scala/part-5.md +119 -0
  419. package/lib/assets/docs/article/grokking-concurrency/scala/part-6.md +83 -0
  420. package/lib/assets/docs/article/grokking-concurrency/scala/part-7.md +131 -0
  421. package/lib/assets/docs/article/grokking-concurrency/scala/part-8.md +129 -0
  422. package/lib/assets/docs/article/grokkingfp/all/index.md +368 -0
  423. package/lib/assets/docs/article/grokkingfp/all/part-1-ch01-fp-introduction.md +530 -0
  424. package/lib/assets/docs/article/grokkingfp/all/part-1-ch02-pure-functions.md +923 -0
  425. package/lib/assets/docs/article/grokkingfp/all/part-2-ch03-immutable-data.md +1122 -0
  426. package/lib/assets/docs/article/grokkingfp/all/part-2-ch04-higher-order-functions.md +1104 -0
  427. package/lib/assets/docs/article/grokkingfp/all/part-2-ch05-flatmap.md +1026 -0
  428. package/lib/assets/docs/article/grokkingfp/all/part-3-ch06-option.md +777 -0
  429. package/lib/assets/docs/article/grokkingfp/all/part-3-ch07-either-adt.md +871 -0
  430. package/lib/assets/docs/article/grokkingfp/all/part-4-ch08-io-monad.md +972 -0
  431. package/lib/assets/docs/article/grokkingfp/all/part-4-ch09-streams.md +926 -0
  432. package/lib/assets/docs/article/grokkingfp/all/part-5-ch10-concurrency.md +870 -0
  433. package/lib/assets/docs/article/grokkingfp/all/part-6-ch11-application.md +715 -0
  434. package/lib/assets/docs/article/grokkingfp/all/part-6-ch12-testing.md +626 -0
  435. package/lib/assets/docs/article/grokkingfp/all/writing-plan.md +696 -0
  436. package/lib/assets/docs/article/grokkingfp/clojure/index.md +276 -0
  437. package/lib/assets/docs/article/grokkingfp/clojure/part-1.md +667 -0
  438. package/lib/assets/docs/article/grokkingfp/clojure/part-2.md +643 -0
  439. package/lib/assets/docs/article/grokkingfp/clojure/part-3.md +620 -0
  440. package/lib/assets/docs/article/grokkingfp/clojure/part-4.md +697 -0
  441. package/lib/assets/docs/article/grokkingfp/clojure/part-5.md +751 -0
  442. package/lib/assets/docs/article/grokkingfp/clojure/part-6.md +721 -0
  443. package/lib/assets/docs/article/grokkingfp/csharp/index.md +246 -0
  444. package/lib/assets/docs/article/grokkingfp/csharp/part-1.md +811 -0
  445. package/lib/assets/docs/article/grokkingfp/csharp/part-2.md +971 -0
  446. package/lib/assets/docs/article/grokkingfp/csharp/part-3.md +981 -0
  447. package/lib/assets/docs/article/grokkingfp/csharp/part-4.md +949 -0
  448. package/lib/assets/docs/article/grokkingfp/csharp/part-5.md +947 -0
  449. package/lib/assets/docs/article/grokkingfp/csharp/part-6.md +739 -0
  450. package/lib/assets/docs/article/grokkingfp/elixir/index.md +203 -0
  451. package/lib/assets/docs/article/grokkingfp/elixir/part-1.md +710 -0
  452. package/lib/assets/docs/article/grokkingfp/elixir/part-2.md +838 -0
  453. package/lib/assets/docs/article/grokkingfp/elixir/part-3.md +985 -0
  454. package/lib/assets/docs/article/grokkingfp/elixir/part-4.md +974 -0
  455. package/lib/assets/docs/article/grokkingfp/elixir/part-5.md +1284 -0
  456. package/lib/assets/docs/article/grokkingfp/elixir/part-6.md +1047 -0
  457. package/lib/assets/docs/article/grokkingfp/fsharp/index.md +210 -0
  458. package/lib/assets/docs/article/grokkingfp/fsharp/part-1.md +714 -0
  459. package/lib/assets/docs/article/grokkingfp/fsharp/part-2.md +961 -0
  460. package/lib/assets/docs/article/grokkingfp/fsharp/part-3.md +972 -0
  461. package/lib/assets/docs/article/grokkingfp/fsharp/part-4.md +832 -0
  462. package/lib/assets/docs/article/grokkingfp/fsharp/part-5.md +911 -0
  463. package/lib/assets/docs/article/grokkingfp/fsharp/part-6.md +920 -0
  464. package/lib/assets/docs/article/grokkingfp/haskell/index.md +234 -0
  465. package/lib/assets/docs/article/grokkingfp/haskell/part-1.md +591 -0
  466. package/lib/assets/docs/article/grokkingfp/haskell/part-2.md +866 -0
  467. package/lib/assets/docs/article/grokkingfp/haskell/part-3.md +915 -0
  468. package/lib/assets/docs/article/grokkingfp/haskell/part-4.md +876 -0
  469. package/lib/assets/docs/article/grokkingfp/haskell/part-5.md +845 -0
  470. package/lib/assets/docs/article/grokkingfp/haskell/part-6.md +842 -0
  471. package/lib/assets/docs/article/grokkingfp/index.md +143 -0
  472. package/lib/assets/docs/article/grokkingfp/java/index.md +211 -0
  473. package/lib/assets/docs/article/grokkingfp/java/part-1.md +646 -0
  474. package/lib/assets/docs/article/grokkingfp/java/part-2.md +667 -0
  475. package/lib/assets/docs/article/grokkingfp/java/part-3.md +672 -0
  476. package/lib/assets/docs/article/grokkingfp/java/part-4.md +771 -0
  477. package/lib/assets/docs/article/grokkingfp/java/part-5.md +959 -0
  478. package/lib/assets/docs/article/grokkingfp/java/part-6.md +1324 -0
  479. package/lib/assets/docs/article/grokkingfp/python/index.md +258 -0
  480. package/lib/assets/docs/article/grokkingfp/python/part-1.md +437 -0
  481. package/lib/assets/docs/article/grokkingfp/python/part-2.md +958 -0
  482. package/lib/assets/docs/article/grokkingfp/python/part-3.md +1004 -0
  483. package/lib/assets/docs/article/grokkingfp/python/part-4.md +765 -0
  484. package/lib/assets/docs/article/grokkingfp/python/part-5.md +747 -0
  485. package/lib/assets/docs/article/grokkingfp/python/part-6.md +861 -0
  486. package/lib/assets/docs/article/grokkingfp/ruby/index.md +330 -0
  487. package/lib/assets/docs/article/grokkingfp/ruby/part-1.md +753 -0
  488. package/lib/assets/docs/article/grokkingfp/ruby/part-2.md +938 -0
  489. package/lib/assets/docs/article/grokkingfp/ruby/part-3.md +946 -0
  490. package/lib/assets/docs/article/grokkingfp/ruby/part-4.md +921 -0
  491. package/lib/assets/docs/article/grokkingfp/ruby/part-5.md +908 -0
  492. package/lib/assets/docs/article/grokkingfp/ruby/part-6.md +1410 -0
  493. package/lib/assets/docs/article/grokkingfp/rust/index.md +242 -0
  494. package/lib/assets/docs/article/grokkingfp/rust/part-1.md +634 -0
  495. package/lib/assets/docs/article/grokkingfp/rust/part-2.md +1060 -0
  496. package/lib/assets/docs/article/grokkingfp/rust/part-3.md +994 -0
  497. package/lib/assets/docs/article/grokkingfp/rust/part-4.md +571 -0
  498. package/lib/assets/docs/article/grokkingfp/rust/part-5.md +705 -0
  499. package/lib/assets/docs/article/grokkingfp/rust/part-6.md +508 -0
  500. package/lib/assets/docs/article/grokkingfp/scala/index.md +171 -0
  501. package/lib/assets/docs/article/grokkingfp/scala/part-1.md +541 -0
  502. package/lib/assets/docs/article/grokkingfp/scala/part-2.md +946 -0
  503. package/lib/assets/docs/article/grokkingfp/scala/part-3.md +917 -0
  504. package/lib/assets/docs/article/grokkingfp/scala/part-4.md +742 -0
  505. package/lib/assets/docs/article/grokkingfp/scala/part-5.md +722 -0
  506. package/lib/assets/docs/article/grokkingfp/scala/part-6.md +865 -0
  507. package/lib/assets/docs/article/grokkingfp/typescript/index.md +273 -0
  508. package/lib/assets/docs/article/grokkingfp/typescript/part-1.md +559 -0
  509. package/lib/assets/docs/article/grokkingfp/typescript/part-2.md +1129 -0
  510. package/lib/assets/docs/article/grokkingfp/typescript/part-3.md +842 -0
  511. package/lib/assets/docs/article/grokkingfp/typescript/part-4.md +1085 -0
  512. package/lib/assets/docs/article/grokkingfp/typescript/part-5.md +717 -0
  513. package/lib/assets/docs/article/grokkingfp/typescript/part-6.md +980 -0
  514. package/lib/assets/docs/article/index.md +36 -0
  515. package/lib/assets/docs/design/index.md +39 -27
  516. package/lib/assets/docs/development/index.md +11 -1
  517. package/lib/assets/docs/index.md +33 -103
  518. package/lib/assets/docs/operation/index.md +16 -6
  519. package/lib/assets/docs/reference/index.md +5 -4
  520. package/lib/assets/docs/requirements/index.md +13 -6
  521. package/lib/assets/docs/review/index.md +5 -0
  522. package/lib/assets/docs/strategy/index.md +15 -0
  523. package/lib/assets/docs/template/index.md +9 -5
  524. package/lib/assets/mkdocs.yml +33 -19
  525. package/package.json +1 -1
  526. package/lib/assets/docs/analysis/index.md +0 -8
  527. /package/lib/assets/docs/{analysis → strategy}/slide/.gitkeep +0 -0
@@ -0,0 +1,1284 @@
1
+ # Part V: 並行処理と OTP
2
+
3
+ 本章では、Elixir における並行処理を学びます。軽量プロセスによる並行実行、Agent/Task による安全な状態管理と非同期処理、そして OTP パターン(GenServer、Supervisor)による堅牢な並行システムの構築方法を習得します。
4
+
5
+ ---
6
+
7
+ ## 第10章: 並行処理
8
+
9
+ ### 10.1 並行処理の課題
10
+
11
+ 従来の並行処理には多くの課題があります:
12
+
13
+ - デッドロック
14
+ - 競合状態(Race Condition)
15
+ - 共有状態の管理の複雑さ
16
+ - スレッドのオーバーヘッド
17
+
18
+ ```plantuml
19
+ @startuml
20
+ !theme plain
21
+
22
+ rectangle "従来の並行処理の問題" {
23
+ rectangle "問題" as problems {
24
+ card "デッドロック"
25
+ card "競合状態"
26
+ card "可変状態の共有"
27
+ card "スレッド管理"
28
+ }
29
+
30
+ rectangle "Elixir の解決策" as solutions {
31
+ card "イミュータブルデータ"
32
+ card "Agent(共有状態)"
33
+ card "軽量プロセス"
34
+ card "メッセージパッシング"
35
+ }
36
+ }
37
+
38
+ problems --> solutions : Elixir/OTP アプローチ
39
+
40
+ @enduml
41
+ ```
42
+
43
+ ### 10.2 Elixir の並行モデル
44
+
45
+ Elixir は **アクターモデル** に基づいた並行処理を提供します:
46
+
47
+ - 各プロセスは独立した状態を持つ
48
+ - プロセス間はメッセージで通信
49
+ - プロセスは非常に軽量(数 KB)
50
+ - 数百万のプロセスを同時に実行可能
51
+
52
+ ```plantuml
53
+ @startuml
54
+ !theme plain
55
+
56
+ rectangle "Elixir のプロセスモデル" {
57
+ rectangle "プロセス 1" as p1 {
58
+ card "状態"
59
+ card "メールボックス"
60
+ }
61
+
62
+ rectangle "プロセス 2" as p2 {
63
+ card "状態"
64
+ card "メールボックス"
65
+ }
66
+
67
+ rectangle "プロセス 3" as p3 {
68
+ card "状態"
69
+ card "メールボックス"
70
+ }
71
+
72
+ p1 --> p2 : メッセージ
73
+ p2 --> p3 : メッセージ
74
+ p3 --> p1 : メッセージ
75
+ }
76
+
77
+ note bottom
78
+ 各プロセスは独立
79
+ 共有状態なし
80
+ end note
81
+
82
+ @enduml
83
+ ```
84
+
85
+ ### 10.3 チェックインのリアルタイム集計
86
+
87
+ **ソースファイル**: `app/elixir/lib/ch10/concurrency.ex`
88
+
89
+ 都市へのチェックインをリアルタイムで集計し、ランキングを更新する例を見ていきます。
90
+
91
+ ```elixir
92
+ defmodule City do
93
+ defstruct [:name]
94
+ end
95
+
96
+ defmodule CityStats do
97
+ defstruct [:city, :check_ins]
98
+ end
99
+ ```
100
+
101
+ #### トップ N 都市の計算(純粋関数)
102
+
103
+ ```elixir
104
+ def top_cities(city_check_ins, n \\ 3) do
105
+ city_check_ins
106
+ |> Enum.map(fn {city, check_ins} ->
107
+ %CityStats{city: city, check_ins: check_ins}
108
+ end)
109
+ |> Enum.sort_by(& &1.check_ins, :desc)
110
+ |> Enum.take(n)
111
+ end
112
+ ```
113
+
114
+ ### 10.4 Agent - 共有状態の管理
115
+
116
+ **Agent** は、プロセスベースの状態管理を提供します。Scala の `Ref` に相当します。
117
+
118
+ ```elixir
119
+ # Agent の作成
120
+ {:ok, counter} = Agent.start_link(fn -> 0 end)
121
+
122
+ # 値の取得
123
+ Agent.get(counter, & &1) # 0
124
+
125
+ # アトミックな更新
126
+ Agent.update(counter, &(&1 + 1))
127
+ Agent.get(counter, & &1) # 1
128
+
129
+ # 停止
130
+ Agent.stop(counter)
131
+ ```
132
+
133
+ ```plantuml
134
+ @startuml
135
+ !theme plain
136
+
137
+ rectangle "Agent の操作" {
138
+ card "Agent.start_link(fn -> 0 end)" as create
139
+ card "Agent.update(counter, &(&1 + 3))" as update
140
+ card "Agent.get(counter, & &1)" as get
141
+
142
+ create --> update : 作成
143
+ update --> get : 更新
144
+ }
145
+
146
+ note bottom of update
147
+ update はアトミック
148
+ 他の処理と競合しない
149
+ end note
150
+
151
+ @enduml
152
+ ```
153
+
154
+ #### Agent の主要関数
155
+
156
+ | 関数 | 説明 | 例 |
157
+ |------|------|-----|
158
+ | `Agent.start_link(fun)` | 初期値で Agent を作成 | `Agent.start_link(fn -> 0 end)` |
159
+ | `Agent.get(agent, fun)` | 現在の値を取得 | `Agent.get(counter, & &1)` |
160
+ | `Agent.update(agent, fun)` | アトミックに更新 | `Agent.update(counter, &(&1 + 1))` |
161
+ | `Agent.get_and_update(agent, fun)` | 取得と更新を同時に | `Agent.get_and_update(counter, &{&1, &1 + 1})` |
162
+
163
+ #### チェックインストアの実装
164
+
165
+ ```elixir
166
+ def create_check_in_store do
167
+ Agent.start_link(fn -> %{} end)
168
+ end
169
+
170
+ def store_check_in(agent, city) do
171
+ Agent.update(agent, fn state ->
172
+ Map.update(state, city, 1, &(&1 + 1))
173
+ end)
174
+ end
175
+
176
+ def get_check_ins(agent) do
177
+ Agent.get(agent, & &1)
178
+ end
179
+ ```
180
+
181
+ ### 10.5 Task - 並列実行
182
+
183
+ `Task` を使って処理を並列に実行できます。Scala の `parSequence` に相当します。
184
+
185
+ ```elixir
186
+ # 複数のタスクを並列実行
187
+ tasks = [fn -> 1 end, fn -> 2 end, fn -> 3 end]
188
+
189
+ results =
190
+ tasks
191
+ |> Enum.map(&Task.async/1)
192
+ |> Task.await_many()
193
+
194
+ # [1, 2, 3]
195
+ ```
196
+
197
+ ```plantuml
198
+ @startuml
199
+ !theme plain
200
+
201
+ rectangle "Task による並列実行" {
202
+ rectangle "順次実行" as seq {
203
+ card "Task 1" as s1
204
+ card "Task 2" as s2
205
+ card "Task 3" as s3
206
+ s1 --> s2
207
+ s2 --> s3
208
+ }
209
+
210
+ rectangle "並列実行" as par {
211
+ card "Task 1" as p1
212
+ card "Task 2" as p2
213
+ card "Task 3" as p3
214
+ }
215
+ }
216
+
217
+ note bottom of seq
218
+ 合計時間 = T1 + T2 + T3
219
+ end note
220
+
221
+ note bottom of par
222
+ 合計時間 ≈ max(T1, T2, T3)
223
+ end note
224
+
225
+ @enduml
226
+ ```
227
+
228
+ #### 並列マッピング
229
+
230
+ ```elixir
231
+ def parallel_map(items, f) do
232
+ items
233
+ |> Enum.map(fn item -> Task.async(fn -> f.(item) end) end)
234
+ |> Task.await_many()
235
+ end
236
+
237
+ # 使用例
238
+ parallel_map([1, 2, 3], &(&1 * 2)) # [2, 4, 6]
239
+ ```
240
+
241
+ ### 10.6 サイコロを並行して振る
242
+
243
+ ```elixir
244
+ def cast_the_die do
245
+ :rand.uniform(6)
246
+ end
247
+
248
+ def cast_dice_parallel(n) do
249
+ 1..n
250
+ |> Enum.map(fn _ -> Task.async(&cast_the_die/0) end)
251
+ |> Task.await_many()
252
+ |> Enum.sum()
253
+ end
254
+
255
+ # 3つのサイコロを並行して振って合計
256
+ cast_dice_parallel(3) # 3〜18 の値
257
+ ```
258
+
259
+ #### Agent と Task の組み合わせ
260
+
261
+ ```elixir
262
+ def cast_dice_and_store(n, agent) do
263
+ tasks =
264
+ 1..n
265
+ |> Enum.map(fn _ ->
266
+ Task.async(fn ->
267
+ result = cast_the_die()
268
+ Agent.update(agent, &[result | &1])
269
+ result
270
+ end)
271
+ end)
272
+
273
+ Task.await_many(tasks)
274
+ :ok
275
+ end
276
+
277
+ # 使用例
278
+ {:ok, agent} = Agent.start_link(fn -> [] end)
279
+ cast_dice_and_store(5, agent)
280
+ results = Agent.get(agent, & &1) # 5つのサイコロの結果
281
+ ```
282
+
283
+ ### 10.7 プロセスによる軽量スレッド
284
+
285
+ Elixir のプロセスは、Scala の `Fiber` に相当する軽量な実行単位です。
286
+
287
+ ```plantuml
288
+ @startuml
289
+ !theme plain
290
+
291
+ rectangle "Thread vs Process" {
292
+ rectangle "OS Thread" as thread {
293
+ card "重い(MB単位のメモリ)"
294
+ card "OS が管理"
295
+ card "数千程度が限界"
296
+ }
297
+
298
+ rectangle "Elixir Process" as process {
299
+ card "軽い(KB単位のメモリ)"
300
+ card "BEAM VM が管理"
301
+ card "数百万も可能"
302
+ }
303
+ }
304
+
305
+ @enduml
306
+ ```
307
+
308
+ #### プロセスの起動とキャンセル
309
+
310
+ ```elixir
311
+ def start_background(f) do
312
+ pid = spawn(f)
313
+ {:ok, pid}
314
+ end
315
+
316
+ def cancel(pid) do
317
+ Process.exit(pid, :kill)
318
+ :ok
319
+ end
320
+
321
+ # 使用例
322
+ {:ok, pid} = start_background(fn ->
323
+ Process.sleep(1000)
324
+ IO.puts("done")
325
+ end)
326
+
327
+ # 途中でキャンセル
328
+ cancel(pid)
329
+ ```
330
+
331
+ #### 繰り返し実行するプロセス
332
+
333
+ ```elixir
334
+ def start_repeating(f, interval_ms) do
335
+ pid =
336
+ spawn(fn ->
337
+ repeat_forever(f, interval_ms)
338
+ end)
339
+
340
+ {:ok, pid}
341
+ end
342
+
343
+ defp repeat_forever(f, interval_ms) do
344
+ f.()
345
+ Process.sleep(interval_ms)
346
+ repeat_forever(f, interval_ms)
347
+ end
348
+
349
+ # 100ms ごとにカウントアップ
350
+ {:ok, agent} = Agent.start_link(fn -> 0 end)
351
+ {:ok, pid} = start_repeating(fn -> Agent.update(agent, &(&1 + 1)) end, 100)
352
+ ```
353
+
354
+ ### 10.8 チェックイン処理の並行版
355
+
356
+ ```elixir
357
+ defmodule ProcessingCheckIns do
358
+ defstruct [:check_in_store, :ranking_store, :ranking_updater_pid, :check_in_processor_pid]
359
+ end
360
+
361
+ def start_processing(cities) do
362
+ {:ok, check_in_store} = create_check_in_store()
363
+ {:ok, ranking_store} = create_ranking_store()
364
+
365
+ # ランキング更新プロセスを起動
366
+ {:ok, ranking_updater_pid} =
367
+ start_repeating(
368
+ fn ->
369
+ check_ins = get_check_ins(check_in_store)
370
+ ranking = top_cities(check_ins)
371
+ update_ranking(ranking_store, ranking)
372
+ end,
373
+ 10
374
+ )
375
+
376
+ # チェックイン処理プロセスを起動
377
+ check_in_processor_pid =
378
+ spawn(fn ->
379
+ Enum.each(cities, fn city ->
380
+ store_check_in(check_in_store, city)
381
+ end)
382
+ end)
383
+
384
+ {:ok, %ProcessingCheckIns{...}}
385
+ end
386
+
387
+ def current_ranking(processing) do
388
+ get_ranking(processing.ranking_store)
389
+ end
390
+
391
+ def stop_processing(processing) do
392
+ cancel(processing.ranking_updater_pid)
393
+ cancel(processing.check_in_processor_pid)
394
+ Agent.stop(processing.check_in_store)
395
+ Agent.stop(processing.ranking_store)
396
+ :ok
397
+ end
398
+ ```
399
+
400
+ ```plantuml
401
+ @startuml
402
+ !theme plain
403
+
404
+ rectangle "並行処理の構造" {
405
+ rectangle "チェックイン処理" as checkin {
406
+ card "Stream からチェックインを受信"
407
+ card "Agent に保存"
408
+ }
409
+
410
+ rectangle "ランキング更新" as ranking {
411
+ card "Agent からデータを読み取り"
412
+ card "ランキングを計算"
413
+ card "結果を Agent に保存"
414
+ }
415
+ }
416
+
417
+ note bottom
418
+ 2つの処理が並行して実行される
419
+ end note
420
+
421
+ @enduml
422
+ ```
423
+
424
+ ### 10.9 並行カウント
425
+
426
+ ```elixir
427
+ def count_evens(ios) do
428
+ {:ok, counter} = Agent.start_link(fn -> 0 end)
429
+
430
+ ios
431
+ |> Enum.map(fn io ->
432
+ Task.async(fn ->
433
+ n = io.()
434
+
435
+ if rem(n, 2) == 0 do
436
+ Agent.update(counter, &(&1 + 1))
437
+ end
438
+ end)
439
+ end)
440
+ |> Task.await_many()
441
+
442
+ result = Agent.get(counter, & &1)
443
+ Agent.stop(counter)
444
+ result
445
+ end
446
+
447
+ # 使用例
448
+ ios = Enum.map(1..100, fn n -> fn -> n end end)
449
+ count_evens(ios) # 50
450
+ ```
451
+
452
+ ### 10.10 Process.sleep の特性
453
+
454
+ Elixir の `Process.sleep` は他のプロセスをブロックしません。
455
+
456
+ | 特性 | Process.sleep | Thread.sleep (Java) |
457
+ |------|---------------|---------------------|
458
+ | ブロック対象 | 現在のプロセスのみ | OS スレッド |
459
+ | リソース | 軽量 | 重い |
460
+ | 並行性 | 他のプロセスは実行可能 | スレッドがブロック |
461
+
462
+ ```elixir
463
+ # 3つのプロセスで並列スリープ → 約100msで完了
464
+ {time, _} = :timer.tc(fn ->
465
+ 1..3
466
+ |> Enum.map(fn _ -> Task.async(fn -> Process.sleep(100) end) end)
467
+ |> Task.await_many()
468
+ end)
469
+
470
+ time < 200_000 # true(200ms未満)
471
+ ```
472
+
473
+ ---
474
+
475
+ ## 第11章: OTP パターン
476
+
477
+ ### 11.1 OTP とは
478
+
479
+ **OTP (Open Telecom Platform)** は、Erlang/Elixir で堅牢な並行システムを構築するためのフレームワークです。
480
+
481
+ 主なコンポーネント:
482
+ - **GenServer**: 汎用サーバープロセス
483
+ - **Supervisor**: プロセスの監視と再起動
484
+ - **Application**: アプリケーションの管理
485
+
486
+ ```plantuml
487
+ @startuml
488
+ !theme plain
489
+
490
+ rectangle "OTP の構成" {
491
+ rectangle "Application" as app {
492
+ rectangle "Supervisor" as sup {
493
+ card "GenServer 1" as gs1
494
+ card "GenServer 2" as gs2
495
+ card "GenServer 3" as gs3
496
+ }
497
+ }
498
+ }
499
+
500
+ sup --> gs1 : 監視
501
+ sup --> gs2 : 監視
502
+ sup --> gs3 : 監視
503
+
504
+ note bottom
505
+ Supervisor がプロセスを監視
506
+ クラッシュ時は自動再起動
507
+ end note
508
+
509
+ @enduml
510
+ ```
511
+
512
+ ### 11.2 GenServer によるカウンター
513
+
514
+ **ソースファイル**: `app/elixir/lib/ch11/otp_patterns.ex`
515
+
516
+ GenServer は、状態を持つサーバープロセスを簡単に実装できます。
517
+
518
+ ```elixir
519
+ defmodule Counter do
520
+ use GenServer
521
+
522
+ # クライアント API
523
+
524
+ def start_link(initial_value \\ 0) do
525
+ GenServer.start_link(__MODULE__, initial_value)
526
+ end
527
+
528
+ def get(counter) do
529
+ GenServer.call(counter, :get)
530
+ end
531
+
532
+ def increment(counter) do
533
+ GenServer.cast(counter, :increment)
534
+ end
535
+
536
+ def add(counter, value) do
537
+ GenServer.cast(counter, {:add, value})
538
+ end
539
+
540
+ # サーバーコールバック
541
+
542
+ @impl true
543
+ def init(initial_value) do
544
+ {:ok, initial_value}
545
+ end
546
+
547
+ @impl true
548
+ def handle_call(:get, _from, state) do
549
+ {:reply, state, state}
550
+ end
551
+
552
+ @impl true
553
+ def handle_cast(:increment, state) do
554
+ {:noreply, state + 1}
555
+ end
556
+
557
+ @impl true
558
+ def handle_cast({:add, value}, state) do
559
+ {:noreply, state + value}
560
+ end
561
+ end
562
+ ```
563
+
564
+ ```elixir
565
+ # 使用例
566
+ {:ok, counter} = Counter.start_link(0)
567
+ Counter.get(counter) # 0
568
+ Counter.increment(counter)
569
+ Counter.get(counter) # 1
570
+ Counter.add(counter, 10)
571
+ Counter.get(counter) # 11
572
+ GenServer.stop(counter)
573
+ ```
574
+
575
+ ```plantuml
576
+ @startuml
577
+ !theme plain
578
+
579
+ rectangle "GenServer の通信パターン" {
580
+ card "クライアント" as client
581
+
582
+ rectangle "GenServer" as server {
583
+ card "状態"
584
+ card "メールボックス"
585
+ }
586
+
587
+ client --> server : call (同期)
588
+ client --> server : cast (非同期)
589
+ server --> client : reply
590
+ }
591
+
592
+ note bottom
593
+ call: 応答を待つ
594
+ cast: 応答を待たない
595
+ end note
596
+
597
+ @enduml
598
+ ```
599
+
600
+ ### 11.3 GenServer によるチェックインストア
601
+
602
+ ```elixir
603
+ defmodule CheckInStore do
604
+ use GenServer
605
+
606
+ # クライアント API
607
+
608
+ def start_link(opts \\ []) do
609
+ GenServer.start_link(__MODULE__, %{}, opts)
610
+ end
611
+
612
+ def check_in(store, city) do
613
+ GenServer.cast(store, {:check_in, city})
614
+ end
615
+
616
+ def get_count(store, city) do
617
+ GenServer.call(store, {:get_count, city})
618
+ end
619
+
620
+ def get_all(store) do
621
+ GenServer.call(store, :get_all)
622
+ end
623
+
624
+ def top_cities(store, n \\ 3) do
625
+ GenServer.call(store, {:top_cities, n})
626
+ end
627
+
628
+ # サーバーコールバック
629
+
630
+ @impl true
631
+ def init(state) do
632
+ {:ok, state}
633
+ end
634
+
635
+ @impl true
636
+ def handle_cast({:check_in, city}, state) do
637
+ new_state = Map.update(state, city, 1, &(&1 + 1))
638
+ {:noreply, new_state}
639
+ end
640
+
641
+ @impl true
642
+ def handle_call({:get_count, city}, _from, state) do
643
+ {:reply, Map.get(state, city, 0), state}
644
+ end
645
+
646
+ @impl true
647
+ def handle_call(:get_all, _from, state) do
648
+ {:reply, state, state}
649
+ end
650
+
651
+ @impl true
652
+ def handle_call({:top_cities, n}, _from, state) do
653
+ top =
654
+ state
655
+ |> Enum.sort_by(fn {_city, count} -> count end, :desc)
656
+ |> Enum.take(n)
657
+
658
+ {:reply, top, state}
659
+ end
660
+ end
661
+ ```
662
+
663
+ ### 11.4 定期実行タスク
664
+
665
+ ```elixir
666
+ defmodule PeriodicTask do
667
+ use GenServer
668
+
669
+ def start_link(task_fn, interval_ms) do
670
+ GenServer.start_link(__MODULE__, {task_fn, interval_ms})
671
+ end
672
+
673
+ @impl true
674
+ def init({task_fn, interval_ms}) do
675
+ schedule_work(interval_ms)
676
+ {:ok, %{task_fn: task_fn, interval_ms: interval_ms}}
677
+ end
678
+
679
+ @impl true
680
+ def handle_info(:work, %{task_fn: task_fn, interval_ms: interval_ms} = state) do
681
+ task_fn.()
682
+ schedule_work(interval_ms)
683
+ {:noreply, state}
684
+ end
685
+
686
+ defp schedule_work(interval_ms) do
687
+ Process.send_after(self(), :work, interval_ms)
688
+ end
689
+ end
690
+
691
+ # 使用例:100ms ごとにタスクを実行
692
+ {:ok, agent} = Agent.start_link(fn -> 0 end)
693
+ {:ok, task} = PeriodicTask.start_link(
694
+ fn -> Agent.update(agent, &(&1 + 1)) end,
695
+ 100
696
+ )
697
+ ```
698
+
699
+ ### 11.5 状態マシン
700
+
701
+ GenServer で状態マシンを実装できます。
702
+
703
+ ```elixir
704
+ defmodule TrafficLight do
705
+ use GenServer
706
+
707
+ def start_link do
708
+ GenServer.start_link(__MODULE__, :red)
709
+ end
710
+
711
+ def current(light) do
712
+ GenServer.call(light, :current)
713
+ end
714
+
715
+ def next(light) do
716
+ GenServer.cast(light, :next)
717
+ end
718
+
719
+ @impl true
720
+ def init(initial_state) do
721
+ {:ok, initial_state}
722
+ end
723
+
724
+ @impl true
725
+ def handle_call(:current, _from, state) do
726
+ {:reply, state, state}
727
+ end
728
+
729
+ @impl true
730
+ def handle_cast(:next, state) do
731
+ next_state =
732
+ case state do
733
+ :red -> :green
734
+ :green -> :yellow
735
+ :yellow -> :red
736
+ end
737
+
738
+ {:noreply, next_state}
739
+ end
740
+ end
741
+ ```
742
+
743
+ ```plantuml
744
+ @startuml
745
+ !theme plain
746
+
747
+ state "Red" as red
748
+ state "Green" as green
749
+ state "Yellow" as yellow
750
+
751
+ [*] --> red
752
+ red --> green : next
753
+ green --> yellow : next
754
+ yellow --> red : next
755
+
756
+ @enduml
757
+ ```
758
+
759
+ ### 11.6 ジョブキュー
760
+
761
+ ```elixir
762
+ defmodule JobQueue do
763
+ use GenServer
764
+
765
+ def start_link do
766
+ GenServer.start_link(__MODULE__, :queue.new())
767
+ end
768
+
769
+ def enqueue(queue, job) do
770
+ GenServer.cast(queue, {:enqueue, job})
771
+ end
772
+
773
+ def dequeue(queue) do
774
+ GenServer.call(queue, :dequeue)
775
+ end
776
+
777
+ def size(queue) do
778
+ GenServer.call(queue, :size)
779
+ end
780
+
781
+ @impl true
782
+ def init(queue), do: {:ok, queue}
783
+
784
+ @impl true
785
+ def handle_cast({:enqueue, job}, queue) do
786
+ {:noreply, :queue.in(job, queue)}
787
+ end
788
+
789
+ @impl true
790
+ def handle_call(:dequeue, _from, queue) do
791
+ case :queue.out(queue) do
792
+ {{:value, job}, new_queue} -> {:reply, {:ok, job}, new_queue}
793
+ {:empty, queue} -> {:reply, :empty, queue}
794
+ end
795
+ end
796
+
797
+ @impl true
798
+ def handle_call(:size, _from, queue) do
799
+ {:reply, :queue.len(queue), queue}
800
+ end
801
+ end
802
+ ```
803
+
804
+ ### 11.7 Supervisor による耐障害性
805
+
806
+ Supervisor は子プロセスを監視し、クラッシュ時に自動再起動します。
807
+
808
+ ```elixir
809
+ defmodule CounterSupervisor do
810
+ use Supervisor
811
+
812
+ def start_link do
813
+ Supervisor.start_link(__MODULE__, :ok)
814
+ end
815
+
816
+ def get_counter(supervisor) do
817
+ [{_, counter, _, _}] = Supervisor.which_children(supervisor)
818
+ counter
819
+ end
820
+
821
+ @impl true
822
+ def init(:ok) do
823
+ children = [
824
+ {Counter, 0}
825
+ ]
826
+
827
+ Supervisor.init(children, strategy: :one_for_one)
828
+ end
829
+ end
830
+ ```
831
+
832
+ ```plantuml
833
+ @startuml
834
+ !theme plain
835
+
836
+ rectangle "Supervisor 戦略" {
837
+ rectangle ":one_for_one" as o4o {
838
+ card "クラッシュしたプロセスのみ再起動"
839
+ }
840
+
841
+ rectangle ":one_for_all" as o4a {
842
+ card "1つがクラッシュしたら全て再起動"
843
+ }
844
+
845
+ rectangle ":rest_for_one" as r4o {
846
+ card "クラッシュしたプロセスと後続を再起動"
847
+ }
848
+ }
849
+
850
+ @enduml
851
+ ```
852
+
853
+ ### 11.8 DynamicSupervisor
854
+
855
+ 動的にプロセスを追加・削除できる Supervisor です。
856
+
857
+ ```elixir
858
+ defmodule WorkerSupervisor do
859
+ use DynamicSupervisor
860
+
861
+ def start_link do
862
+ DynamicSupervisor.start_link(__MODULE__, :ok)
863
+ end
864
+
865
+ def start_worker(supervisor, initial_value) do
866
+ spec = {Counter, initial_value}
867
+ DynamicSupervisor.start_child(supervisor, spec)
868
+ end
869
+
870
+ def stop_worker(supervisor, worker) do
871
+ DynamicSupervisor.terminate_child(supervisor, worker)
872
+ end
873
+
874
+ def count_workers(supervisor) do
875
+ DynamicSupervisor.count_children(supervisor).active
876
+ end
877
+
878
+ @impl true
879
+ def init(:ok) do
880
+ DynamicSupervisor.init(strategy: :one_for_one)
881
+ end
882
+ end
883
+
884
+ # 使用例
885
+ {:ok, sup} = WorkerSupervisor.start_link()
886
+ {:ok, worker1} = WorkerSupervisor.start_worker(sup, 0)
887
+ {:ok, worker2} = WorkerSupervisor.start_worker(sup, 100)
888
+
889
+ Counter.increment(worker1)
890
+ Counter.get(worker1) # 1
891
+ Counter.get(worker2) # 100
892
+
893
+ WorkerSupervisor.count_workers(sup) # 2
894
+ ```
895
+
896
+ ### 11.9 Task.Supervisor
897
+
898
+ Task を監視付きで実行できます。
899
+
900
+ ```elixir
901
+ defmodule TaskRunner do
902
+ def start_link do
903
+ Task.Supervisor.start_link()
904
+ end
905
+
906
+ def run_async(supervisor, task_fn) do
907
+ Task.Supervisor.async(supervisor, task_fn)
908
+ end
909
+
910
+ def run_all(supervisor, task_fns) do
911
+ task_fns
912
+ |> Enum.map(&Task.Supervisor.async(supervisor, &1))
913
+ |> Task.await_many()
914
+ end
915
+
916
+ def run_with_timeout(supervisor, task_fn, timeout_ms) do
917
+ task = Task.Supervisor.async_nolink(supervisor, task_fn)
918
+
919
+ case Task.yield(task, timeout_ms) do
920
+ {:ok, result} -> {:ok, result}
921
+ nil ->
922
+ Task.shutdown(task, :brutal_kill)
923
+ {:error, :timeout}
924
+ end
925
+ end
926
+ end
927
+
928
+ # 使用例
929
+ {:ok, runner} = TaskRunner.start_link()
930
+ results = TaskRunner.run_all(runner, [fn -> 1 end, fn -> 2 end, fn -> 3 end])
931
+ # [1, 2, 3]
932
+ ```
933
+
934
+ ### 11.10 PubSub パターン
935
+
936
+ Publish/Subscribe パターンの実装です。
937
+
938
+ ```elixir
939
+ defmodule PubSub do
940
+ use GenServer
941
+
942
+ def start_link do
943
+ GenServer.start_link(__MODULE__, %{})
944
+ end
945
+
946
+ def subscribe(server, topic) do
947
+ GenServer.call(server, {:subscribe, topic, self()})
948
+ end
949
+
950
+ def unsubscribe(server, topic) do
951
+ GenServer.call(server, {:unsubscribe, topic, self()})
952
+ end
953
+
954
+ def publish(server, topic, message) do
955
+ GenServer.cast(server, {:publish, topic, message})
956
+ end
957
+
958
+ @impl true
959
+ def init(state), do: {:ok, state}
960
+
961
+ @impl true
962
+ def handle_call({:subscribe, topic, pid}, _from, state) do
963
+ subscribers = Map.get(state, topic, MapSet.new())
964
+ new_subscribers = MapSet.put(subscribers, pid)
965
+ {:reply, :ok, Map.put(state, topic, new_subscribers)}
966
+ end
967
+
968
+ @impl true
969
+ def handle_cast({:publish, topic, message}, state) do
970
+ subscribers = Map.get(state, topic, MapSet.new())
971
+
972
+ Enum.each(subscribers, fn pid ->
973
+ send(pid, {:pubsub, topic, message})
974
+ end)
975
+
976
+ {:noreply, state}
977
+ end
978
+ end
979
+
980
+ # 使用例
981
+ {:ok, pubsub} = PubSub.start_link()
982
+ PubSub.subscribe(pubsub, "events")
983
+ PubSub.publish(pubsub, "events", :hello)
984
+
985
+ receive do
986
+ {:pubsub, "events", message} -> IO.inspect(message) # :hello
987
+ end
988
+ ```
989
+
990
+ ---
991
+
992
+ ## まとめ
993
+
994
+ ### Part V で学んだこと
995
+
996
+ ```plantuml
997
+ @startuml
998
+ !theme plain
999
+
1000
+ rectangle "Part V: 並行処理と OTP" {
1001
+ rectangle "第10章" as ch10 {
1002
+ card "Agent(共有状態)"
1003
+ card "Task(並列実行)"
1004
+ card "軽量プロセス"
1005
+ card "spawn / cancel"
1006
+ }
1007
+
1008
+ rectangle "第11章" as ch11 {
1009
+ card "GenServer"
1010
+ card "Supervisor"
1011
+ card "DynamicSupervisor"
1012
+ card "Task.Supervisor"
1013
+ card "PubSub パターン"
1014
+ }
1015
+ }
1016
+
1017
+ ch10 --> ch11
1018
+
1019
+ @enduml
1020
+ ```
1021
+
1022
+ ### Scala との対応
1023
+
1024
+ | Scala | Elixir |
1025
+ |-------|--------|
1026
+ | `Ref[IO, A]` | `Agent` |
1027
+ | `parSequence` | `Task.await_many` |
1028
+ | `Fiber` | プロセス(`spawn`) |
1029
+ | `fiber.start` | `spawn` / `Task.async` |
1030
+ | `fiber.cancel` | `Process.exit(pid, :kill)` |
1031
+ | `foreverM` | 再帰的プロセス |
1032
+ | - | `GenServer` |
1033
+ | - | `Supervisor` |
1034
+
1035
+ ### キーポイント
1036
+
1037
+ 1. **Agent**: プロセスベースの状態管理(Ref 相当)
1038
+ 2. **Task**: 非同期タスクの実行と結果の取得
1039
+ 3. **プロセス**: 軽量な実行単位(数百万も可能)
1040
+ 4. **GenServer**: 汎用的なサーバープロセス
1041
+ 5. **Supervisor**: プロセスの監視と自動再起動
1042
+ 6. **DynamicSupervisor**: 動的なプロセス管理
1043
+
1044
+ ### 設計パターン
1045
+
1046
+ ```plantuml
1047
+ @startuml
1048
+ !theme plain
1049
+
1050
+ rectangle "並行処理の設計パターン" {
1051
+ rectangle "パターン1: Agent + Task" as p1 {
1052
+ card "Agent で状態を共有"
1053
+ card "Task で並列処理"
1054
+ }
1055
+
1056
+ rectangle "パターン2: GenServer" as p2 {
1057
+ card "状態とロジックをカプセル化"
1058
+ card "同期/非同期 API を提供"
1059
+ }
1060
+
1061
+ rectangle "パターン3: Supervisor Tree" as p3 {
1062
+ card "Supervisor で監視"
1063
+ card "障害時は自動復旧"
1064
+ }
1065
+ }
1066
+
1067
+ @enduml
1068
+ ```
1069
+
1070
+ ### 次のステップ
1071
+
1072
+ Part VI では、以下のトピックを学びます:
1073
+
1074
+ - 実践的なアプリケーション構築
1075
+ - 外部 API との連携
1076
+ - テスト戦略
1077
+
1078
+ ---
1079
+
1080
+ ## 演習問題
1081
+
1082
+ ### 問題 1: Agent の基本
1083
+
1084
+ 以下のプログラムを実装してください。カウンターを 0 から始めて、3回インクリメントした結果を返します。
1085
+
1086
+ ```elixir
1087
+ def increment_three_times do
1088
+ ???
1089
+ end
1090
+
1091
+ # 期待される動作
1092
+ increment_three_times() # 3
1093
+ ```
1094
+
1095
+ <details>
1096
+ <summary>解答</summary>
1097
+
1098
+ ```elixir
1099
+ def increment_three_times do
1100
+ {:ok, counter} = Agent.start_link(fn -> 0 end)
1101
+ Agent.update(counter, &(&1 + 1))
1102
+ Agent.update(counter, &(&1 + 1))
1103
+ Agent.update(counter, &(&1 + 1))
1104
+ result = Agent.get(counter, & &1)
1105
+ Agent.stop(counter)
1106
+ result
1107
+ end
1108
+ ```
1109
+
1110
+ </details>
1111
+
1112
+ ### 問題 2: 並列実行
1113
+
1114
+ 以下のプログラムを実装してください。3つのタスクを並列実行し、結果の合計を返します。
1115
+
1116
+ ```elixir
1117
+ def sum_parallel(tasks) do
1118
+ ???
1119
+ end
1120
+
1121
+ # 期待される動作
1122
+ sum_parallel([fn -> 1 end, fn -> 2 end, fn -> 3 end]) # 6
1123
+ ```
1124
+
1125
+ <details>
1126
+ <summary>解答</summary>
1127
+
1128
+ ```elixir
1129
+ def sum_parallel(tasks) do
1130
+ tasks
1131
+ |> Enum.map(&Task.async/1)
1132
+ |> Task.await_many()
1133
+ |> Enum.sum()
1134
+ end
1135
+ ```
1136
+
1137
+ </details>
1138
+
1139
+ ### 問題 3: GenServer
1140
+
1141
+ 以下の GenServer を実装してください。リストを管理し、要素の追加と取得ができます。
1142
+
1143
+ ```elixir
1144
+ defmodule ListStore do
1145
+ use GenServer
1146
+
1147
+ # ???
1148
+ end
1149
+
1150
+ # 期待される動作
1151
+ {:ok, store} = ListStore.start_link()
1152
+ ListStore.add(store, 1)
1153
+ ListStore.add(store, 2)
1154
+ ListStore.add(store, 3)
1155
+ ListStore.get_all(store) # [1, 2, 3]
1156
+ ```
1157
+
1158
+ <details>
1159
+ <summary>解答</summary>
1160
+
1161
+ ```elixir
1162
+ defmodule ListStore do
1163
+ use GenServer
1164
+
1165
+ def start_link do
1166
+ GenServer.start_link(__MODULE__, [])
1167
+ end
1168
+
1169
+ def add(store, item) do
1170
+ GenServer.cast(store, {:add, item})
1171
+ end
1172
+
1173
+ def get_all(store) do
1174
+ GenServer.call(store, :get_all)
1175
+ end
1176
+
1177
+ @impl true
1178
+ def init(state), do: {:ok, state}
1179
+
1180
+ @impl true
1181
+ def handle_cast({:add, item}, state) do
1182
+ {:noreply, state ++ [item]}
1183
+ end
1184
+
1185
+ @impl true
1186
+ def handle_call(:get_all, _from, state) do
1187
+ {:reply, state, state}
1188
+ end
1189
+ end
1190
+ ```
1191
+
1192
+ </details>
1193
+
1194
+ ### 問題 4: タイムアウト付き収集
1195
+
1196
+ 以下のプログラムを実装してください。指定時間後にプロセスを停止し、それまでに蓄積された結果を返します。
1197
+
1198
+ ```elixir
1199
+ def collect_for(duration_ms, interval_ms, generator) do
1200
+ ???
1201
+ end
1202
+
1203
+ # 期待される動作
1204
+ # 100ms 間、10ms ごとに乱数を生成
1205
+ results = collect_for(100, 10, fn -> :rand.uniform(100) end)
1206
+ # 約10個の要素が返される
1207
+ ```
1208
+
1209
+ <details>
1210
+ <summary>解答</summary>
1211
+
1212
+ ```elixir
1213
+ def collect_for(duration_ms, interval_ms, generator) do
1214
+ {:ok, collected} = Agent.start_link(fn -> [] end)
1215
+
1216
+ {:ok, producer_pid} =
1217
+ start_repeating(
1218
+ fn ->
1219
+ value = generator.()
1220
+ Agent.update(collected, &[value | &1])
1221
+ end,
1222
+ interval_ms
1223
+ )
1224
+
1225
+ Process.sleep(duration_ms)
1226
+ cancel(producer_pid)
1227
+
1228
+ result = Agent.get(collected, &Enum.reverse/1)
1229
+ Agent.stop(collected)
1230
+ result
1231
+ end
1232
+ ```
1233
+
1234
+ </details>
1235
+
1236
+ ### 問題 5: Supervisor
1237
+
1238
+ 以下の Supervisor を実装してください。2つのカウンターを監視します。
1239
+
1240
+ ```elixir
1241
+ defmodule DualCounterSupervisor do
1242
+ use Supervisor
1243
+
1244
+ # ???
1245
+ end
1246
+
1247
+ # 期待される動作
1248
+ {:ok, sup} = DualCounterSupervisor.start_link()
1249
+ {counter1, counter2} = DualCounterSupervisor.get_counters(sup)
1250
+ Counter.increment(counter1)
1251
+ Counter.get(counter1) # 1
1252
+ Counter.get(counter2) # 0
1253
+ ```
1254
+
1255
+ <details>
1256
+ <summary>解答</summary>
1257
+
1258
+ ```elixir
1259
+ defmodule DualCounterSupervisor do
1260
+ use Supervisor
1261
+
1262
+ def start_link do
1263
+ Supervisor.start_link(__MODULE__, :ok)
1264
+ end
1265
+
1266
+ def get_counters(supervisor) do
1267
+ children = Supervisor.which_children(supervisor)
1268
+ [{:counter1, c1, _, _}, {:counter2, c2, _, _}] = children
1269
+ {c1, c2}
1270
+ end
1271
+
1272
+ @impl true
1273
+ def init(:ok) do
1274
+ children = [
1275
+ Supervisor.child_spec({Counter, 0}, id: :counter1),
1276
+ Supervisor.child_spec({Counter, 0}, id: :counter2)
1277
+ ]
1278
+
1279
+ Supervisor.init(children, strategy: :one_for_one)
1280
+ end
1281
+ end
1282
+ ```
1283
+
1284
+ </details>