@k2works/claude-code-booster 3.6.1 → 3.8.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.
- package/LICENSE +21 -21
- package/README.md +42 -42
- package/bin/claude-code-booster +90 -90
- package/lib/assets/.claude/README.md +258 -239
- package/lib/assets/.claude/agent-memory/xp-programmer/MEMORY.md +6 -0
- package/lib/assets/.claude/agent-memory/xp-programmer/project_cargo_tracker.md +11 -0
- package/lib/assets/.claude/agent-memory/xp-programmer/project_ddd_patterns.md +27 -0
- package/lib/assets/.claude/agent-memory/xp-programmer/project_us07_route_assignment.md +19 -0
- package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
- package/lib/assets/.claude/settings.json +11 -11
- package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +111 -111
- package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +83 -83
- package/lib/assets/.claude/skills/analyzing-business/SKILL.md +95 -95
- package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +77 -77
- package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +117 -117
- package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +84 -84
- package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +95 -95
- package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +95 -95
- package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +91 -91
- package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +101 -101
- package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +89 -89
- package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +80 -80
- package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +72 -72
- package/lib/assets/.claude/skills/creating-adr/SKILL.md +113 -113
- package/lib/assets/.claude/skills/developing-backend/SKILL.md +100 -100
- package/lib/assets/.claude/skills/developing-frontend/SKILL.md +93 -93
- package/lib/assets/.claude/skills/developing-release/SKILL.md +120 -120
- package/lib/assets/.claude/skills/generating-bmc/SKILL.md +97 -0
- package/lib/assets/.claude/skills/generating-slides/SKILL.md +94 -94
- package/lib/assets/.claude/skills/git-commit/SKILL.md +81 -81
- package/lib/assets/.claude/skills/killing-processes/SKILL.md +44 -44
- package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -59
- package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -54
- package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -67
- package/lib/assets/.claude/skills/operating-docs/SKILL.md +219 -219
- package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -77
- package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -63
- package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +104 -104
- package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +27 -21
- package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +158 -158
- package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +144 -144
- package/lib/assets/.claude/skills/planning-releases/SKILL.md +119 -119
- package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +151 -151
- package/lib/assets/.claude/skills/tracking-progress/SKILL.md +91 -91
- package/lib/assets/.claude/skills/validating-iteration-plan/SKILL.md +215 -215
- package/lib/assets/.devcontainer/devcontainer.json +34 -34
- package/lib/assets/.env.example +17 -17
- package/lib/assets/.gitattributes +4 -4
- package/lib/assets/.github/workflows/docker-publish.yml +77 -77
- package/lib/assets/.github/workflows/mkdocs.yml +39 -39
- package/lib/assets/AGENTS.md +94 -94
- package/lib/assets/CLAUDE.md +1 -0
- package/lib/assets/README.md +254 -254
- package/lib/assets/docker-compose.yml +33 -33
- package/lib/assets/docs/adr/index.md +10 -10
- package/lib/assets/docs/article/functional-desgin-ppp/all/01-immutability-and-data-transformation.md +475 -475
- package/lib/assets/docs/article/functional-desgin-ppp/all/02-function-composition.md +519 -519
- package/lib/assets/docs/article/functional-desgin-ppp/all/03-polymorphism.md +537 -537
- package/lib/assets/docs/article/functional-desgin-ppp/all/04-data-validation.md +300 -300
- package/lib/assets/docs/article/functional-desgin-ppp/all/05-property-based-testing.md +320 -320
- package/lib/assets/docs/article/functional-desgin-ppp/all/06-tdd-and-functional.md +498 -498
- package/lib/assets/docs/article/functional-desgin-ppp/all/07-composite-pattern.md +298 -298
- package/lib/assets/docs/article/functional-desgin-ppp/all/08-decorator-pattern.md +291 -291
- package/lib/assets/docs/article/functional-desgin-ppp/all/09-adapter-pattern.md +336 -336
- package/lib/assets/docs/article/functional-desgin-ppp/all/10-strategy-pattern.md +303 -303
- package/lib/assets/docs/article/functional-desgin-ppp/all/11-command-pattern.md +286 -286
- package/lib/assets/docs/article/functional-desgin-ppp/all/12-visitor-pattern.md +322 -322
- package/lib/assets/docs/article/functional-desgin-ppp/all/13-abstract-factory-pattern.md +319 -319
- package/lib/assets/docs/article/functional-desgin-ppp/all/14-abstract-server-pattern.md +365 -365
- package/lib/assets/docs/article/functional-desgin-ppp/all/15-gossiping-bus-drivers.md +156 -156
- package/lib/assets/docs/article/functional-desgin-ppp/all/16-payroll-system.md +178 -178
- package/lib/assets/docs/article/functional-desgin-ppp/all/17-video-rental-system.md +312 -312
- package/lib/assets/docs/article/functional-desgin-ppp/all/18-concurrency-system.md +287 -287
- package/lib/assets/docs/article/functional-desgin-ppp/all/19-wa-tor-simulation.md +286 -286
- package/lib/assets/docs/article/functional-desgin-ppp/all/20-pattern-interactions.md +274 -274
- package/lib/assets/docs/article/functional-desgin-ppp/all/21-best-practices.md +294 -294
- package/lib/assets/docs/article/functional-desgin-ppp/all/22-oo-to-fp-migration.md +337 -337
- package/lib/assets/docs/article/functional-desgin-ppp/all/index.md +388 -388
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/01-immutability-and-data-transformation.md +273 -273
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/02-function-composition.md +380 -380
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/03-polymorphism.md +384 -384
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/04-clojure-spec.md +350 -350
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/05-property-based-testing.md +352 -352
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/06-tdd-in-functional.md +383 -383
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/07-composite-pattern.md +529 -529
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/08-decorator-pattern.md +395 -395
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/09-adapter-pattern.md +399 -399
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/10-strategy-pattern.md +485 -485
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/11-command-pattern.md +566 -566
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/12-visitor-pattern.md +567 -567
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/13-abstract-factory-pattern.md +475 -475
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/14-abstract-server-pattern.md +462 -462
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/15-gossiping-bus-drivers.md +325 -325
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/16-payroll-system.md +401 -401
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/17-video-rental-system.md +450 -450
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/18-concurrency-system.md +475 -475
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/19-wator-simulation.md +739 -739
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/20-pattern-interactions.md +567 -567
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/21-best-practices.md +518 -518
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/22-oo-to-fp-migration.md +532 -532
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/index.md +241 -241
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/01-immutability-and-data-transformation.md +383 -383
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/02-function-composition.md +374 -374
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/03-polymorphism.md +375 -375
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/04-data-validation.md +195 -195
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/05-property-based-testing.md +268 -268
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/06-tdd-and-fp.md +294 -294
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/07-effects-and-pure-functions.md +164 -164
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/08-error-handling-strategies.md +168 -168
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/09-io-and-external-systems.md +254 -254
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/10-concurrency-patterns.md +269 -269
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/11-command-pattern.md +148 -148
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/12-visitor-pattern.md +176 -176
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/13-abstract-factory-pattern.md +604 -604
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/14-abstract-server-pattern.md +729 -729
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/15-gossiping-bus-drivers.md +291 -291
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/16-payroll-system.md +420 -420
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/17-video-rental-system.md +319 -319
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/18-concurrency-system.md +466 -466
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/19-wator-simulation.md +523 -523
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/20-pattern-interactions.md +287 -287
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/21-best-practices.md +340 -340
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/22-oo-to-fp-migration.md +395 -395
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/index.md +248 -248
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/01-immutability-and-data-transformation.md +384 -384
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/02-function-composition.md +452 -452
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/03-polymorphism.md +495 -495
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/04-data-validation.md +416 -416
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/05-property-based-testing.md +382 -382
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/06-tdd-functional.md +687 -687
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/07-composite-pattern.md +442 -442
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/08-decorator-pattern.md +479 -479
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/09-adapter-pattern.md +479 -479
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/10-strategy-pattern.md +427 -427
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/11-command-pattern.md +428 -428
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/12-visitor-pattern.md +339 -339
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/13-abstract-factory-pattern.md +309 -309
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/14-abstract-server-pattern.md +596 -596
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/15-gossiping-bus-drivers.md +355 -355
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/16-payroll-system.md +350 -350
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/17-video-rental-system.md +414 -414
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/18-concurrency-system.md +367 -367
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/19-wator-simulation.md +403 -403
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/20-pattern-interactions.md +291 -291
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/21-best-practices.md +324 -324
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/22-oo-to-fp-migration.md +332 -332
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/index.md +274 -274
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/01-immutability-and-data-transformation.md +298 -298
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/02-function-composition.md +304 -304
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/03-polymorphism.md +362 -362
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/04-data-validation.md +257 -257
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/05-property-based-testing.md +254 -254
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/06-tdd-functional.md +283 -283
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/07-composite-pattern.md +395 -395
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/08-decorator-pattern.md +319 -319
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/09-adapter-pattern.md +382 -382
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/10-strategy-pattern.md +287 -287
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/11-command-pattern.md +303 -303
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/12-visitor-pattern.md +326 -326
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/13-abstract-factory-pattern.md +332 -332
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/14-abstract-server-pattern.md +379 -379
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/15-gossiping-bus-drivers.md +177 -177
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/16-payroll-system.md +219 -219
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/17-video-rental-system.md +244 -244
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/18-concurrency-system.md +363 -363
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/19-wator-simulation.md +438 -438
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/20-pattern-interactions.md +325 -325
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/21-best-practices.md +403 -403
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/22-oo-to-fp-migration.md +469 -469
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/index.md +174 -174
- package/lib/assets/docs/article/functional-desgin-ppp/index.md +90 -90
- package/lib/assets/docs/article/functional-desgin-ppp/rust/01-immutability-and-data-transformation.md +450 -450
- package/lib/assets/docs/article/functional-desgin-ppp/rust/02-function-composition.md +463 -463
- package/lib/assets/docs/article/functional-desgin-ppp/rust/03-polymorphism.md +425 -425
- package/lib/assets/docs/article/functional-desgin-ppp/rust/04-data-validation.md +273 -273
- package/lib/assets/docs/article/functional-desgin-ppp/rust/05-property-based-testing.md +247 -247
- package/lib/assets/docs/article/functional-desgin-ppp/rust/06-tdd-and-functional.md +841 -841
- package/lib/assets/docs/article/functional-desgin-ppp/rust/07-composite-pattern.md +384 -384
- package/lib/assets/docs/article/functional-desgin-ppp/rust/08-decorator-pattern.md +383 -383
- package/lib/assets/docs/article/functional-desgin-ppp/rust/09-adapter-pattern.md +339 -339
- package/lib/assets/docs/article/functional-desgin-ppp/rust/10-strategy-pattern.md +331 -331
- package/lib/assets/docs/article/functional-desgin-ppp/rust/11-command-pattern.md +356 -356
- package/lib/assets/docs/article/functional-desgin-ppp/rust/12-visitor-pattern.md +379 -379
- package/lib/assets/docs/article/functional-desgin-ppp/rust/13-abstract-factory-pattern.md +361 -361
- package/lib/assets/docs/article/functional-desgin-ppp/rust/14-abstract-server-pattern.md +392 -392
- package/lib/assets/docs/article/functional-desgin-ppp/rust/15-gossiping-bus-drivers.md +300 -300
- package/lib/assets/docs/article/functional-desgin-ppp/rust/16-payroll-system.md +297 -297
- package/lib/assets/docs/article/functional-desgin-ppp/rust/17-video-rental-system.md +304 -304
- package/lib/assets/docs/article/functional-desgin-ppp/rust/18-concurrency-system.md +315 -315
- package/lib/assets/docs/article/functional-desgin-ppp/rust/19-wator-simulation.md +311 -311
- package/lib/assets/docs/article/functional-desgin-ppp/rust/20-pattern-interactions.md +304 -304
- package/lib/assets/docs/article/functional-desgin-ppp/rust/21-best-practices.md +336 -336
- package/lib/assets/docs/article/functional-desgin-ppp/rust/22-oo-to-fp-migration.md +349 -349
- package/lib/assets/docs/article/functional-desgin-ppp/rust/index.md +243 -243
- package/lib/assets/docs/article/functional-desgin-ppp/scala/01-immutability-and-data-transformation.md +328 -328
- package/lib/assets/docs/article/functional-desgin-ppp/scala/02-function-composition.md +348 -348
- package/lib/assets/docs/article/functional-desgin-ppp/scala/03-polymorphism.md +357 -357
- package/lib/assets/docs/article/functional-desgin-ppp/scala/04-data-validation.md +364 -364
- package/lib/assets/docs/article/functional-desgin-ppp/scala/05-property-based-testing.md +515 -515
- package/lib/assets/docs/article/functional-desgin-ppp/scala/06-tdd-functional.md +557 -557
- package/lib/assets/docs/article/functional-desgin-ppp/scala/07-composite-pattern.md +363 -363
- package/lib/assets/docs/article/functional-desgin-ppp/scala/08-decorator-pattern.md +327 -327
- package/lib/assets/docs/article/functional-desgin-ppp/scala/09-adapter-pattern.md +517 -517
- package/lib/assets/docs/article/functional-desgin-ppp/scala/10-strategy-pattern.md +441 -441
- package/lib/assets/docs/article/functional-desgin-ppp/scala/11-command-pattern.md +407 -407
- package/lib/assets/docs/article/functional-desgin-ppp/scala/12-visitor-pattern.md +379 -379
- package/lib/assets/docs/article/functional-desgin-ppp/scala/13-abstract-factory-pattern.md +398 -398
- package/lib/assets/docs/article/functional-desgin-ppp/scala/14-abstract-server-pattern.md +476 -476
- package/lib/assets/docs/article/functional-desgin-ppp/scala/15-gossiping-bus-drivers.md +391 -391
- package/lib/assets/docs/article/functional-desgin-ppp/scala/16-payroll-system.md +342 -342
- package/lib/assets/docs/article/functional-desgin-ppp/scala/17-video-rental-system.md +324 -324
- package/lib/assets/docs/article/functional-desgin-ppp/scala/18-concurrency-system.md +730 -730
- package/lib/assets/docs/article/functional-desgin-ppp/scala/19-wator-simulation.md +624 -624
- package/lib/assets/docs/article/functional-desgin-ppp/scala/20-pattern-interactions.md +512 -512
- package/lib/assets/docs/article/functional-desgin-ppp/scala/21-best-practices.md +433 -433
- package/lib/assets/docs/article/functional-desgin-ppp/scala/22-oo-to-fp-migration.md +688 -688
- package/lib/assets/docs/article/functional-desgin-ppp/scala/index.md +243 -243
- package/lib/assets/docs/article/getting-start-tdd/clojure/01-todo-list-and-first-test.md +166 -166
- package/lib/assets/docs/article/getting-start-tdd/clojure/02-fake-it-and-triangulation.md +162 -162
- package/lib/assets/docs/article/getting-start-tdd/clojure/03-obvious-implementation-and-refactoring.md +135 -135
- package/lib/assets/docs/article/getting-start-tdd/clojure/04-version-control-and-conventional-commits.md +88 -88
- package/lib/assets/docs/article/getting-start-tdd/clojure/05-package-management-and-static-analysis.md +299 -299
- package/lib/assets/docs/article/getting-start-tdd/clojure/06-task-runner-and-ci-cd.md +241 -241
- package/lib/assets/docs/article/getting-start-tdd/clojure/07-protocols-and-records.md +131 -131
- package/lib/assets/docs/article/getting-start-tdd/clojure/08-multimethods-and-design-patterns.md +130 -130
- package/lib/assets/docs/article/getting-start-tdd/clojure/09-namespaces-and-module-design.md +127 -127
- package/lib/assets/docs/article/getting-start-tdd/clojure/10-higher-order-functions-and-composition.md +114 -114
- package/lib/assets/docs/article/getting-start-tdd/clojure/11-persistent-data-and-pipeline.md +138 -138
- package/lib/assets/docs/article/getting-start-tdd/clojure/12-error-handling-and-spec.md +161 -161
- package/lib/assets/docs/article/getting-start-tdd/clojure/index.md +65 -65
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter01.md +232 -232
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter02.md +244 -244
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter03.md +202 -202
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter04.md +92 -92
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter05.md +256 -256
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter06.md +195 -195
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter07.md +214 -214
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter08.md +249 -249
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter09.md +174 -174
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter10.md +166 -166
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter11.md +192 -192
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter12.md +211 -211
- package/lib/assets/docs/article/getting-start-tdd/csharp/index.md +83 -83
- package/lib/assets/docs/article/getting-start-tdd/elixir/01-todo-list-and-first-test.md +87 -87
- package/lib/assets/docs/article/getting-start-tdd/elixir/02-fake-it-and-triangulation.md +95 -95
- package/lib/assets/docs/article/getting-start-tdd/elixir/03-obvious-implementation-and-refactoring.md +109 -109
- package/lib/assets/docs/article/getting-start-tdd/elixir/04-version-control-and-conventional-commits.md +96 -96
- package/lib/assets/docs/article/getting-start-tdd/elixir/05-package-management-and-static-analysis.md +88 -88
- package/lib/assets/docs/article/getting-start-tdd/elixir/06-task-runner-and-ci-cd.md +71 -71
- package/lib/assets/docs/article/getting-start-tdd/elixir/07-structs-and-protocols.md +110 -110
- package/lib/assets/docs/article/getting-start-tdd/elixir/08-pattern-matching-and-guards.md +108 -108
- package/lib/assets/docs/article/getting-start-tdd/elixir/09-module-design-and-behaviours.md +104 -104
- package/lib/assets/docs/article/getting-start-tdd/elixir/10-higher-order-functions-and-pipeline.md +178 -178
- package/lib/assets/docs/article/getting-start-tdd/elixir/11-stream-and-lazy-evaluation.md +142 -142
- package/lib/assets/docs/article/getting-start-tdd/elixir/12-error-handling-and-with.md +145 -145
- package/lib/assets/docs/article/getting-start-tdd/elixir/index.md +35 -35
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter01.md +202 -202
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter02.md +246 -246
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter03.md +218 -218
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter04.md +179 -179
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter05.md +267 -267
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter06.md +190 -190
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter07.md +161 -161
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter08.md +175 -175
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter09.md +222 -222
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter10.md +189 -189
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter11.md +212 -212
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter12.md +215 -215
- package/lib/assets/docs/article/getting-start-tdd/fsharp/index.md +71 -71
- package/lib/assets/docs/article/getting-start-tdd/go/01-todo-list-and-first-test.md +213 -213
- package/lib/assets/docs/article/getting-start-tdd/go/02-fake-it-and-triangulation.md +302 -302
- package/lib/assets/docs/article/getting-start-tdd/go/03-obvious-implementation-and-refactoring.md +339 -339
- package/lib/assets/docs/article/getting-start-tdd/go/04-version-control-and-conventional-commits.md +112 -112
- package/lib/assets/docs/article/getting-start-tdd/go/05-package-management-and-static-analysis.md +272 -272
- package/lib/assets/docs/article/getting-start-tdd/go/06-task-runner-and-ci-cd.md +233 -233
- package/lib/assets/docs/article/getting-start-tdd/go/07-encapsulation-and-polymorphism.md +394 -394
- package/lib/assets/docs/article/getting-start-tdd/go/08-design-patterns.md +422 -422
- package/lib/assets/docs/article/getting-start-tdd/go/09-solid-principles-and-module-design.md +400 -400
- package/lib/assets/docs/article/getting-start-tdd/go/10-higher-order-functions-and-composition.md +226 -226
- package/lib/assets/docs/article/getting-start-tdd/go/11-immutable-data-and-pipeline.md +296 -296
- package/lib/assets/docs/article/getting-start-tdd/go/12-error-handling-and-type-safety.md +411 -411
- package/lib/assets/docs/article/getting-start-tdd/go/index.md +83 -83
- package/lib/assets/docs/article/getting-start-tdd/haskell/01-todo-list-and-first-test.md +279 -279
- package/lib/assets/docs/article/getting-start-tdd/haskell/02-fake-it-and-triangulation.md +337 -337
- package/lib/assets/docs/article/getting-start-tdd/haskell/03-obvious-implementation-and-refactoring.md +257 -257
- package/lib/assets/docs/article/getting-start-tdd/haskell/04-version-control-and-conventional-commits.md +182 -182
- package/lib/assets/docs/article/getting-start-tdd/haskell/05-package-management-and-static-analysis.md +313 -313
- package/lib/assets/docs/article/getting-start-tdd/haskell/06-task-runner-and-ci-cd.md +309 -309
- package/lib/assets/docs/article/getting-start-tdd/haskell/07-algebraic-data-types-and-type-classes.md +412 -412
- package/lib/assets/docs/article/getting-start-tdd/haskell/08-pattern-matching-and-guards.md +390 -390
- package/lib/assets/docs/article/getting-start-tdd/haskell/09-module-design-and-smart-constructors.md +461 -461
- package/lib/assets/docs/article/getting-start-tdd/haskell/10-higher-order-functions-and-currying.md +434 -434
- package/lib/assets/docs/article/getting-start-tdd/haskell/11-function-composition-and-point-free.md +392 -392
- package/lib/assets/docs/article/getting-start-tdd/haskell/12-monad-and-error-handling.md +631 -631
- package/lib/assets/docs/article/getting-start-tdd/haskell/index.md +49 -49
- package/lib/assets/docs/article/getting-start-tdd/index.md +93 -93
- package/lib/assets/docs/article/getting-start-tdd/integration/01-language-overview.md +375 -375
- package/lib/assets/docs/article/getting-start-tdd/integration/02-test-framework-comparison.md +349 -349
- package/lib/assets/docs/article/getting-start-tdd/integration/03-tdd-pattern-comparison.md +445 -445
- package/lib/assets/docs/article/getting-start-tdd/integration/04-type-system-comparison.md +409 -409
- package/lib/assets/docs/article/getting-start-tdd/integration/05-dev-environment-comparison.md +330 -330
- package/lib/assets/docs/article/getting-start-tdd/integration/06-learning-roadmap.md +290 -290
- package/lib/assets/docs/article/getting-start-tdd/integration/index.md +69 -69
- package/lib/assets/docs/article/getting-start-tdd/java/01-todo-list-and-first-test.md +234 -234
- package/lib/assets/docs/article/getting-start-tdd/java/02-fake-it-and-triangulation.md +261 -261
- package/lib/assets/docs/article/getting-start-tdd/java/03-obvious-implementation-and-refactoring.md +185 -185
- package/lib/assets/docs/article/getting-start-tdd/java/04-version-control-and-conventional-commits.md +115 -115
- package/lib/assets/docs/article/getting-start-tdd/java/05-package-management-and-static-analysis.md +382 -382
- package/lib/assets/docs/article/getting-start-tdd/java/06-task-runner-and-ci-cd.md +272 -272
- package/lib/assets/docs/article/getting-start-tdd/java/07-encapsulation-and-polymorphism.md +626 -626
- package/lib/assets/docs/article/getting-start-tdd/java/08-design-patterns.md +393 -393
- package/lib/assets/docs/article/getting-start-tdd/java/09-solid-principles-and-module-design.md +310 -310
- package/lib/assets/docs/article/getting-start-tdd/java/10-higher-order-functions-and-composition.md +188 -188
- package/lib/assets/docs/article/getting-start-tdd/java/11-immutable-data-and-pipeline.md +167 -167
- package/lib/assets/docs/article/getting-start-tdd/java/12-error-handling-and-type-safety.md +205 -205
- package/lib/assets/docs/article/getting-start-tdd/java/index.md +61 -61
- package/lib/assets/docs/article/getting-start-tdd/node/01-todo-list-and-first-test.md +244 -244
- package/lib/assets/docs/article/getting-start-tdd/node/02-fake-it-and-triangulation.md +262 -262
- package/lib/assets/docs/article/getting-start-tdd/node/03-obvious-implementation-and-refactoring.md +169 -169
- package/lib/assets/docs/article/getting-start-tdd/node/04-version-control-and-conventional-commits.md +112 -112
- package/lib/assets/docs/article/getting-start-tdd/node/05-package-management-and-static-analysis.md +314 -314
- package/lib/assets/docs/article/getting-start-tdd/node/06-task-runner-and-ci-cd.md +235 -235
- package/lib/assets/docs/article/getting-start-tdd/node/07-encapsulation-and-polymorphism.md +327 -327
- package/lib/assets/docs/article/getting-start-tdd/node/08-design-patterns.md +322 -322
- package/lib/assets/docs/article/getting-start-tdd/node/09-solid-principles-and-module-design.md +285 -285
- package/lib/assets/docs/article/getting-start-tdd/node/10-higher-order-functions-and-composition.md +199 -199
- package/lib/assets/docs/article/getting-start-tdd/node/11-immutable-data-and-pipeline.md +207 -207
- package/lib/assets/docs/article/getting-start-tdd/node/12-error-handling-and-type-safety.md +295 -295
- package/lib/assets/docs/article/getting-start-tdd/node/index.md +56 -56
- package/lib/assets/docs/article/getting-start-tdd/php/01-todo-list-and-first-test.md +259 -259
- package/lib/assets/docs/article/getting-start-tdd/php/02-fake-it-and-triangulation.md +200 -200
- package/lib/assets/docs/article/getting-start-tdd/php/03-obvious-implementation-and-refactoring.md +248 -248
- package/lib/assets/docs/article/getting-start-tdd/php/04-version-control-and-conventional-commits.md +141 -141
- package/lib/assets/docs/article/getting-start-tdd/php/05-package-management-and-static-analysis.md +410 -410
- package/lib/assets/docs/article/getting-start-tdd/php/06-task-runner-and-ci-cd.md +321 -321
- package/lib/assets/docs/article/getting-start-tdd/php/07-encapsulation-and-polymorphism.md +372 -372
- package/lib/assets/docs/article/getting-start-tdd/php/08-design-patterns.md +453 -453
- package/lib/assets/docs/article/getting-start-tdd/php/09-solid-principles-and-module-design.md +460 -460
- package/lib/assets/docs/article/getting-start-tdd/php/10-higher-order-functions-and-composition.md +182 -182
- package/lib/assets/docs/article/getting-start-tdd/php/11-immutable-data-and-pipeline.md +266 -266
- package/lib/assets/docs/article/getting-start-tdd/php/12-error-handling-and-type-safety.md +308 -308
- package/lib/assets/docs/article/getting-start-tdd/php/index.md +84 -84
- package/lib/assets/docs/article/getting-start-tdd/python/01-todo-list-and-first-test.md +201 -201
- package/lib/assets/docs/article/getting-start-tdd/python/02-fake-it-and-triangulation.md +247 -247
- package/lib/assets/docs/article/getting-start-tdd/python/03-obvious-implementation-and-refactoring.md +199 -199
- package/lib/assets/docs/article/getting-start-tdd/python/04-version-control-and-conventional-commits.md +87 -87
- package/lib/assets/docs/article/getting-start-tdd/python/05-package-management-and-static-analysis.md +274 -274
- package/lib/assets/docs/article/getting-start-tdd/python/06-task-runner-and-ci-cd.md +190 -190
- package/lib/assets/docs/article/getting-start-tdd/python/07-encapsulation-and-polymorphism.md +208 -208
- package/lib/assets/docs/article/getting-start-tdd/python/08-design-patterns.md +172 -172
- package/lib/assets/docs/article/getting-start-tdd/python/09-solid-principles-and-module-design.md +130 -130
- package/lib/assets/docs/article/getting-start-tdd/python/10-higher-order-functions-and-composition.md +122 -122
- package/lib/assets/docs/article/getting-start-tdd/python/11-immutable-data-and-pipeline.md +116 -116
- package/lib/assets/docs/article/getting-start-tdd/python/12-error-handling-and-type-safety.md +126 -126
- package/lib/assets/docs/article/getting-start-tdd/python/index.md +55 -55
- package/lib/assets/docs/article/getting-start-tdd/ruby/01-todo-list-and-first-test.md +231 -231
- package/lib/assets/docs/article/getting-start-tdd/ruby/02-fake-it-and-triangulation.md +238 -238
- package/lib/assets/docs/article/getting-start-tdd/ruby/03-obvious-implementation-and-refactoring.md +228 -228
- package/lib/assets/docs/article/getting-start-tdd/ruby/04-version-control-and-conventional-commits.md +112 -112
- package/lib/assets/docs/article/getting-start-tdd/ruby/05-package-management-and-static-analysis.md +287 -287
- package/lib/assets/docs/article/getting-start-tdd/ruby/06-task-runner-and-ci-cd.md +248 -248
- package/lib/assets/docs/article/getting-start-tdd/ruby/07-encapsulation-and-polymorphism.md +279 -279
- package/lib/assets/docs/article/getting-start-tdd/ruby/08-design-patterns.md +329 -329
- package/lib/assets/docs/article/getting-start-tdd/ruby/09-solid-principles-and-module-design.md +196 -196
- package/lib/assets/docs/article/getting-start-tdd/ruby/10-higher-order-functions-and-composition.md +175 -175
- package/lib/assets/docs/article/getting-start-tdd/ruby/11-immutable-data-and-pipeline.md +237 -237
- package/lib/assets/docs/article/getting-start-tdd/ruby/12-error-handling-and-type-safety.md +398 -398
- package/lib/assets/docs/article/getting-start-tdd/ruby/index.md +83 -83
- package/lib/assets/docs/article/getting-start-tdd/rust/01-todo-list-and-first-test.md +211 -211
- package/lib/assets/docs/article/getting-start-tdd/rust/02-fake-it-and-triangulation.md +264 -264
- package/lib/assets/docs/article/getting-start-tdd/rust/03-obvious-implementation-and-refactoring.md +233 -233
- package/lib/assets/docs/article/getting-start-tdd/rust/04-version-control-and-conventional-commits.md +92 -92
- package/lib/assets/docs/article/getting-start-tdd/rust/05-package-management-and-static-analysis.md +212 -212
- package/lib/assets/docs/article/getting-start-tdd/rust/06-task-runner-and-ci-cd.md +164 -164
- package/lib/assets/docs/article/getting-start-tdd/rust/07-encapsulation-and-polymorphism.md +142 -142
- package/lib/assets/docs/article/getting-start-tdd/rust/08-design-patterns.md +145 -145
- package/lib/assets/docs/article/getting-start-tdd/rust/09-solid-principles-and-module-design.md +110 -110
- package/lib/assets/docs/article/getting-start-tdd/rust/10-higher-order-functions-and-composition.md +94 -94
- package/lib/assets/docs/article/getting-start-tdd/rust/11-immutable-data-and-pipeline.md +105 -105
- package/lib/assets/docs/article/getting-start-tdd/rust/12-error-handling-and-type-safety.md +112 -112
- package/lib/assets/docs/article/getting-start-tdd/rust/index.md +83 -83
- package/lib/assets/docs/article/getting-start-tdd/scala/01-todo-list-and-first-test.md +111 -111
- package/lib/assets/docs/article/getting-start-tdd/scala/02-fake-it-and-triangulation.md +107 -107
- package/lib/assets/docs/article/getting-start-tdd/scala/03-obvious-implementation-and-refactoring.md +99 -99
- package/lib/assets/docs/article/getting-start-tdd/scala/04-version-control-and-conventional-commits.md +123 -123
- package/lib/assets/docs/article/getting-start-tdd/scala/05-package-management-and-static-analysis.md +196 -196
- package/lib/assets/docs/article/getting-start-tdd/scala/06-task-runner-and-ci-cd.md +186 -186
- package/lib/assets/docs/article/getting-start-tdd/scala/07-case-classes-and-traits.md +139 -139
- package/lib/assets/docs/article/getting-start-tdd/scala/08-pattern-matching-and-sealed-traits.md +106 -106
- package/lib/assets/docs/article/getting-start-tdd/scala/09-packages-and-module-design.md +75 -75
- package/lib/assets/docs/article/getting-start-tdd/scala/10-higher-order-functions-and-composition.md +104 -104
- package/lib/assets/docs/article/getting-start-tdd/scala/11-collections-and-lazy-evaluation.md +94 -94
- package/lib/assets/docs/article/getting-start-tdd/scala/12-error-handling-and-type-safety.md +92 -92
- package/lib/assets/docs/article/getting-start-tdd/scala/index.md +65 -65
- package/lib/assets/docs/article/grokking-concurrency/all/index.md +404 -404
- package/lib/assets/docs/article/grokking-concurrency/all/part-1-ch02-sequential.md +554 -554
- package/lib/assets/docs/article/grokking-concurrency/all/part-2-ch04-05-threads.md +469 -469
- package/lib/assets/docs/article/grokking-concurrency/all/part-3-ch06-multitasking.md +520 -520
- package/lib/assets/docs/article/grokking-concurrency/all/part-4-ch07-parallel-patterns.md +420 -420
- package/lib/assets/docs/article/grokking-concurrency/all/part-5-ch08-09-synchronization.md +510 -510
- package/lib/assets/docs/article/grokking-concurrency/all/part-6-ch10-11-nonblocking-io.md +435 -435
- package/lib/assets/docs/article/grokking-concurrency/all/part-7-ch12-async.md +465 -465
- package/lib/assets/docs/article/grokking-concurrency/all/part-8-ch13-mapreduce.md +377 -377
- package/lib/assets/docs/article/grokking-concurrency/clojure/index.md +116 -116
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-1.md +108 -108
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-2.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-3.md +122 -122
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-4.md +123 -123
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-5.md +118 -118
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-6.md +89 -89
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-7.md +100 -100
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-8.md +120 -120
- package/lib/assets/docs/article/grokking-concurrency/csharp/index.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-1.md +97 -97
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-2.md +123 -123
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-3.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-4.md +112 -112
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-5.md +99 -99
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-6.md +61 -61
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-7.md +84 -84
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-8.md +92 -92
- package/lib/assets/docs/article/grokking-concurrency/fsharp/index.md +65 -65
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-1.md +80 -80
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-2.md +103 -103
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-3.md +94 -94
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-4.md +110 -110
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-5.md +104 -104
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-6.md +93 -93
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-7.md +121 -121
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-8.md +107 -107
- package/lib/assets/docs/article/grokking-concurrency/haskell/index.md +248 -248
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-1.md +96 -96
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-2.md +96 -96
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-3.md +91 -91
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-4.md +106 -106
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-5.md +99 -99
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-6.md +95 -95
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-7.md +111 -111
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-8.md +118 -118
- package/lib/assets/docs/article/grokking-concurrency/index.md +66 -66
- package/lib/assets/docs/article/grokking-concurrency/java/index.md +102 -102
- package/lib/assets/docs/article/grokking-concurrency/java/part-1.md +308 -308
- package/lib/assets/docs/article/grokking-concurrency/java/part-2.md +334 -334
- package/lib/assets/docs/article/grokking-concurrency/java/part-3.md +221 -221
- package/lib/assets/docs/article/grokking-concurrency/java/part-4.md +213 -213
- package/lib/assets/docs/article/grokking-concurrency/java/part-5.md +112 -112
- package/lib/assets/docs/article/grokking-concurrency/java/part-6.md +69 -69
- package/lib/assets/docs/article/grokking-concurrency/java/part-7.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/java/part-8.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/python/index.md +313 -313
- package/lib/assets/docs/article/grokking-concurrency/python/part-1.md +239 -239
- package/lib/assets/docs/article/grokking-concurrency/python/part-2.md +418 -418
- package/lib/assets/docs/article/grokking-concurrency/python/part-3.md +227 -227
- package/lib/assets/docs/article/grokking-concurrency/python/part-4.md +299 -299
- package/lib/assets/docs/article/grokking-concurrency/python/part-5.md +315 -315
- package/lib/assets/docs/article/grokking-concurrency/python/part-6.md +297 -297
- package/lib/assets/docs/article/grokking-concurrency/python/part-7.md +314 -314
- package/lib/assets/docs/article/grokking-concurrency/python/part-8.md +360 -360
- package/lib/assets/docs/article/grokking-concurrency/rust/index.md +270 -270
- package/lib/assets/docs/article/grokking-concurrency/rust/part-1.md +108 -108
- package/lib/assets/docs/article/grokking-concurrency/rust/part-2.md +120 -120
- package/lib/assets/docs/article/grokking-concurrency/rust/part-3.md +126 -126
- package/lib/assets/docs/article/grokking-concurrency/rust/part-4.md +175 -175
- package/lib/assets/docs/article/grokking-concurrency/rust/part-5.md +158 -158
- package/lib/assets/docs/article/grokking-concurrency/rust/part-6.md +94 -94
- package/lib/assets/docs/article/grokking-concurrency/rust/part-7.md +133 -133
- package/lib/assets/docs/article/grokking-concurrency/rust/part-8.md +155 -155
- package/lib/assets/docs/article/grokking-concurrency/scala/index.md +69 -69
- package/lib/assets/docs/article/grokking-concurrency/scala/part-1.md +78 -78
- package/lib/assets/docs/article/grokking-concurrency/scala/part-2.md +112 -112
- package/lib/assets/docs/article/grokking-concurrency/scala/part-3.md +93 -93
- package/lib/assets/docs/article/grokking-concurrency/scala/part-4.md +110 -110
- package/lib/assets/docs/article/grokking-concurrency/scala/part-5.md +119 -119
- package/lib/assets/docs/article/grokking-concurrency/scala/part-6.md +83 -83
- package/lib/assets/docs/article/grokking-concurrency/scala/part-7.md +131 -131
- package/lib/assets/docs/article/grokking-concurrency/scala/part-8.md +129 -129
- package/lib/assets/docs/article/grokkingfp/all/index.md +368 -368
- package/lib/assets/docs/article/grokkingfp/all/part-1-ch01-fp-introduction.md +530 -530
- package/lib/assets/docs/article/grokkingfp/all/part-1-ch02-pure-functions.md +923 -923
- package/lib/assets/docs/article/grokkingfp/all/part-2-ch03-immutable-data.md +1128 -1128
- package/lib/assets/docs/article/grokkingfp/all/part-2-ch04-higher-order-functions.md +1104 -1104
- package/lib/assets/docs/article/grokkingfp/all/part-2-ch05-flatmap.md +1026 -1026
- package/lib/assets/docs/article/grokkingfp/all/part-3-ch06-option.md +785 -785
- package/lib/assets/docs/article/grokkingfp/all/part-3-ch07-either-adt.md +871 -871
- package/lib/assets/docs/article/grokkingfp/all/part-4-ch08-io-monad.md +972 -972
- package/lib/assets/docs/article/grokkingfp/all/part-4-ch09-streams.md +926 -926
- package/lib/assets/docs/article/grokkingfp/all/part-5-ch10-concurrency.md +870 -870
- package/lib/assets/docs/article/grokkingfp/all/part-6-ch11-application.md +715 -715
- package/lib/assets/docs/article/grokkingfp/all/part-6-ch12-testing.md +626 -626
- package/lib/assets/docs/article/grokkingfp/all/writing-plan.md +712 -712
- package/lib/assets/docs/article/grokkingfp/clojure/index.md +276 -276
- package/lib/assets/docs/article/grokkingfp/clojure/part-1.md +667 -667
- package/lib/assets/docs/article/grokkingfp/clojure/part-2.md +643 -643
- package/lib/assets/docs/article/grokkingfp/clojure/part-3.md +620 -620
- package/lib/assets/docs/article/grokkingfp/clojure/part-4.md +697 -697
- package/lib/assets/docs/article/grokkingfp/clojure/part-5.md +751 -751
- package/lib/assets/docs/article/grokkingfp/clojure/part-6.md +721 -721
- package/lib/assets/docs/article/grokkingfp/csharp/index.md +246 -246
- package/lib/assets/docs/article/grokkingfp/csharp/part-1.md +811 -811
- package/lib/assets/docs/article/grokkingfp/csharp/part-2.md +971 -971
- package/lib/assets/docs/article/grokkingfp/csharp/part-3.md +981 -981
- package/lib/assets/docs/article/grokkingfp/csharp/part-4.md +949 -949
- package/lib/assets/docs/article/grokkingfp/csharp/part-5.md +947 -947
- package/lib/assets/docs/article/grokkingfp/csharp/part-6.md +739 -739
- package/lib/assets/docs/article/grokkingfp/elixir/index.md +203 -203
- package/lib/assets/docs/article/grokkingfp/elixir/part-1.md +712 -712
- package/lib/assets/docs/article/grokkingfp/elixir/part-2.md +838 -838
- package/lib/assets/docs/article/grokkingfp/elixir/part-3.md +985 -985
- package/lib/assets/docs/article/grokkingfp/elixir/part-4.md +974 -974
- package/lib/assets/docs/article/grokkingfp/elixir/part-5.md +1286 -1286
- package/lib/assets/docs/article/grokkingfp/elixir/part-6.md +1049 -1049
- package/lib/assets/docs/article/grokkingfp/fsharp/index.md +210 -210
- package/lib/assets/docs/article/grokkingfp/fsharp/part-1.md +714 -714
- package/lib/assets/docs/article/grokkingfp/fsharp/part-2.md +961 -961
- package/lib/assets/docs/article/grokkingfp/fsharp/part-3.md +972 -972
- package/lib/assets/docs/article/grokkingfp/fsharp/part-4.md +832 -832
- package/lib/assets/docs/article/grokkingfp/fsharp/part-5.md +911 -911
- package/lib/assets/docs/article/grokkingfp/fsharp/part-6.md +922 -922
- package/lib/assets/docs/article/grokkingfp/haskell/index.md +234 -234
- package/lib/assets/docs/article/grokkingfp/haskell/part-1.md +591 -591
- package/lib/assets/docs/article/grokkingfp/haskell/part-2.md +866 -866
- package/lib/assets/docs/article/grokkingfp/haskell/part-3.md +915 -915
- package/lib/assets/docs/article/grokkingfp/haskell/part-4.md +878 -878
- package/lib/assets/docs/article/grokkingfp/haskell/part-5.md +845 -845
- package/lib/assets/docs/article/grokkingfp/haskell/part-6.md +844 -844
- package/lib/assets/docs/article/grokkingfp/index.md +143 -143
- package/lib/assets/docs/article/grokkingfp/java/index.md +211 -211
- package/lib/assets/docs/article/grokkingfp/java/part-1.md +648 -648
- package/lib/assets/docs/article/grokkingfp/java/part-2.md +675 -675
- package/lib/assets/docs/article/grokkingfp/java/part-3.md +672 -672
- package/lib/assets/docs/article/grokkingfp/java/part-4.md +771 -771
- package/lib/assets/docs/article/grokkingfp/java/part-5.md +959 -959
- package/lib/assets/docs/article/grokkingfp/java/part-6.md +1328 -1328
- package/lib/assets/docs/article/grokkingfp/python/index.md +258 -258
- package/lib/assets/docs/article/grokkingfp/python/part-1.md +443 -443
- package/lib/assets/docs/article/grokkingfp/python/part-2.md +958 -958
- package/lib/assets/docs/article/grokkingfp/python/part-3.md +1004 -1004
- package/lib/assets/docs/article/grokkingfp/python/part-4.md +765 -765
- package/lib/assets/docs/article/grokkingfp/python/part-5.md +747 -747
- package/lib/assets/docs/article/grokkingfp/python/part-6.md +861 -861
- package/lib/assets/docs/article/grokkingfp/ruby/index.md +330 -330
- package/lib/assets/docs/article/grokkingfp/ruby/part-1.md +755 -755
- package/lib/assets/docs/article/grokkingfp/ruby/part-2.md +938 -938
- package/lib/assets/docs/article/grokkingfp/ruby/part-3.md +946 -946
- package/lib/assets/docs/article/grokkingfp/ruby/part-4.md +921 -921
- package/lib/assets/docs/article/grokkingfp/ruby/part-5.md +908 -908
- package/lib/assets/docs/article/grokkingfp/ruby/part-6.md +1412 -1412
- package/lib/assets/docs/article/grokkingfp/rust/index.md +242 -242
- package/lib/assets/docs/article/grokkingfp/rust/part-1.md +634 -634
- package/lib/assets/docs/article/grokkingfp/rust/part-2.md +1060 -1060
- package/lib/assets/docs/article/grokkingfp/rust/part-3.md +994 -994
- package/lib/assets/docs/article/grokkingfp/rust/part-4.md +573 -573
- package/lib/assets/docs/article/grokkingfp/rust/part-5.md +705 -705
- package/lib/assets/docs/article/grokkingfp/rust/part-6.md +508 -508
- package/lib/assets/docs/article/grokkingfp/scala/index.md +171 -171
- package/lib/assets/docs/article/grokkingfp/scala/part-1.md +543 -543
- package/lib/assets/docs/article/grokkingfp/scala/part-2.md +946 -946
- package/lib/assets/docs/article/grokkingfp/scala/part-3.md +919 -919
- package/lib/assets/docs/article/grokkingfp/scala/part-4.md +742 -742
- package/lib/assets/docs/article/grokkingfp/scala/part-5.md +722 -722
- package/lib/assets/docs/article/grokkingfp/scala/part-6.md +867 -867
- package/lib/assets/docs/article/grokkingfp/typescript/index.md +273 -273
- package/lib/assets/docs/article/grokkingfp/typescript/part-1.md +561 -561
- package/lib/assets/docs/article/grokkingfp/typescript/part-2.md +1129 -1129
- package/lib/assets/docs/article/grokkingfp/typescript/part-3.md +842 -842
- package/lib/assets/docs/article/grokkingfp/typescript/part-4.md +1087 -1087
- package/lib/assets/docs/article/grokkingfp/typescript/part-5.md +717 -717
- package/lib/assets/docs/article/grokkingfp/typescript/part-6.md +982 -982
- package/lib/assets/docs/article/practical-database-design/index.md +121 -121
- package/lib/assets/docs/article/practical-database-design/part1/chapter01.md +288 -288
- package/lib/assets/docs/article/practical-database-design/part1/chapter02.md +518 -518
- package/lib/assets/docs/article/practical-database-design/part1/chapter03.md +557 -557
- package/lib/assets/docs/article/practical-database-design/part2/chapter04.md +924 -924
- package/lib/assets/docs/article/practical-database-design/part2/chapter05.md +1627 -1627
- package/lib/assets/docs/article/practical-database-design/part2/chapter06.md +2716 -2716
- package/lib/assets/docs/article/practical-database-design/part2/chapter07.md +2082 -2082
- package/lib/assets/docs/article/practical-database-design/part2/chapter08.md +2105 -2105
- package/lib/assets/docs/article/practical-database-design/part2/chapter09.md +2031 -2031
- package/lib/assets/docs/article/practical-database-design/part2/chapter10.md +1387 -1387
- package/lib/assets/docs/article/practical-database-design/part2/chapter11.md +1677 -1677
- package/lib/assets/docs/article/practical-database-design/part2/chapter12.md +1417 -1417
- package/lib/assets/docs/article/practical-database-design/part2/chapter13.md +1434 -1434
- package/lib/assets/docs/article/practical-database-design/part3/chapter14.md +667 -667
- package/lib/assets/docs/article/practical-database-design/part3/chapter15.md +1625 -1625
- package/lib/assets/docs/article/practical-database-design/part3/chapter16.md +1915 -1915
- package/lib/assets/docs/article/practical-database-design/part3/chapter17.md +1708 -1708
- package/lib/assets/docs/article/practical-database-design/part3/chapter18.md +2095 -2095
- package/lib/assets/docs/article/practical-database-design/part3/chapter19.md +1123 -1123
- package/lib/assets/docs/article/practical-database-design/part3/chapter20.md +1031 -1031
- package/lib/assets/docs/article/practical-database-design/part3/chapter21.md +1382 -1382
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter14-orm.md +991 -991
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter15-orm.md +1300 -1300
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter16-orm.md +1166 -1166
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter17-orm.md +1584 -1584
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter18-orm.md +1183 -1183
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter19-orm.md +1016 -1016
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter20-orm.md +1753 -1753
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter21-orm.md +1447 -1447
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter22-orm.md +1878 -1878
- package/lib/assets/docs/article/practical-database-design/part4/chapter22.md +965 -965
- package/lib/assets/docs/article/practical-database-design/part4/chapter23.md +2069 -2069
- package/lib/assets/docs/article/practical-database-design/part4/chapter24.md +2439 -2439
- package/lib/assets/docs/article/practical-database-design/part4/chapter25.md +3661 -3661
- package/lib/assets/docs/article/practical-database-design/part4/chapter26.md +2916 -2916
- package/lib/assets/docs/article/practical-database-design/part4/chapter27.md +3105 -3105
- package/lib/assets/docs/article/practical-database-design/part4/chapter28.md +2697 -2697
- package/lib/assets/docs/article/practical-database-design/part4/chapter29.md +2544 -2544
- package/lib/assets/docs/article/practical-database-design/part4/chapter30.md +2180 -2180
- package/lib/assets/docs/article/practical-database-design/part4/chapter31.md +1192 -1192
- package/lib/assets/docs/article/practical-database-design/part4/chapter32.md +2101 -2101
- package/lib/assets/docs/article/practical-database-design/part5/chapter33.md +1032 -1032
- package/lib/assets/docs/article/practical-database-design/part5/chapter34.md +1609 -1609
- package/lib/assets/docs/article/practical-database-design/part5/chapter35.md +1453 -1453
- package/lib/assets/docs/article/practical-database-design/part5/chapter36.md +1292 -1292
- package/lib/assets/docs/article/practical-database-design/part5/chapter37.md +1470 -1470
- package/lib/assets/docs/article/practical-database-design/part5/chapter38.md +1698 -1698
- package/lib/assets/docs/article/practical-database-design/part5/chapter39.md +2334 -2334
- package/lib/assets/docs/article/practical-database-design/study/study2-1.md +1693 -1693
- package/lib/assets/docs/article/practical-database-design/study/study2-2.md +1347 -1347
- package/lib/assets/docs/article/practical-database-design/study/study2-3.md +2044 -2044
- package/lib/assets/docs/article/practical-database-design/study/study2-4.md +2229 -2229
- package/lib/assets/docs/article/practical-database-design/study/study2-5.md +2418 -2418
- package/lib/assets/docs/article/practical-database-design/study/study3-1.md +2205 -2205
- package/lib/assets/docs/article/practical-database-design/study/study3-2.md +2221 -2221
- package/lib/assets/docs/article/practical-database-design/study/study3-3.md +2253 -2253
- package/lib/assets/docs/article/practical-database-design/study/study3-4.md +2106 -2106
- package/lib/assets/docs/article/practical-database-design/study/study3-5.md +2507 -2507
- package/lib/assets/docs/article/practical-database-design/study/study4-1.md +2587 -2587
- package/lib/assets/docs/article/practical-database-design/study/study4-2.md +2075 -2075
- package/lib/assets/docs/article/practical-database-design/study/study4-3.md +1805 -1805
- package/lib/assets/docs/article/practical-database-design/study/study4-4.md +1895 -1895
- package/lib/assets/docs/article/practical-database-design/study/study4-5.md +2878 -2878
- package/lib/assets/docs/assets/css/extra.css +29 -29
- package/lib/assets/docs/assets/js/extra.js +44 -44
- package/lib/assets/docs/development/index.md +39 -39
- package/lib/assets/docs/operation/index.md +11 -11
- package/lib/assets/docs/reference/CodexCLIMCP/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/343/203/225/343/203/255/343/203/274.md +19 -5
- package/lib/assets/docs/reference/CodexCLIMCP/343/202/265/343/203/274/343/203/220/343/203/274/350/250/255/345/256/232/346/211/213/351/240/206.md +341 -341
- package/lib/assets/docs/reference/Java/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +581 -581
- package/lib/assets/docs/reference/SonarQube/343/203/255/343/203/274/343/202/253/343/203/253/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +642 -642
- package/lib/assets/docs/reference/TypeScript/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +465 -465
- package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +450 -450
- package/lib/assets/docs/reference/images/Ansoff.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandBasicStrategy.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandCategorization.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandRecurutementStrategy.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandValue.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BusinessActivitiy.svg +3 -3
- package/lib/assets/docs/reference/images/HRM.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/MarketingStructure.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/OrganizationElemnts.svg +3 -3
- package/lib/assets/docs/reference/images/PPM.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/PositioningMap.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ProductLayer.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ProductMix.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/SWOT.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/TargetMarket.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ThreeGenericStrategies.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/VRIO.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ValueChain.drawio.svg +3 -3
- package/lib/assets/docs/reference/index.md +52 -52
- package/lib/assets/docs/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md +250 -250
- package/lib/assets/docs/reference//343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +2216 -2216
- package/lib/assets/docs/reference//343/202/244/343/203/263/343/203/225/343/203/251/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +1878 -1878
- package/lib/assets/docs/reference//343/202/250/343/202/257/343/202/271/343/203/210/343/203/252/343/203/274/343/203/240/343/203/227/343/203/255/343/202/260/343/203/251/343/203/237/343/203/263/343/202/260.md +550 -550
- package/lib/assets/docs/reference//343/202/263/343/203/274/343/203/207/343/202/243/343/203/263/343/202/260/343/201/250/343/203/206/343/202/271/343/203/210/343/202/254/343/202/244/343/203/211.md +705 -705
- package/lib/assets/docs/reference//343/203/206/343/202/271/343/203/210/346/210/246/347/225/245/343/202/254/343/202/244/343/203/211.md +1313 -1313
- package/lib/assets/docs/reference//343/203/207/343/203/274/343/202/277/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +311 -311
- package/lib/assets/docs/reference//343/203/211/343/203/241/343/202/244/343/203/263/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +599 -599
- package/lib/assets/docs/reference//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +528 -528
- package/lib/assets/docs/reference//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +689 -689
- package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/202/254/343/202/244/343/203/211.md +461 -461
- package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/203/273/343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273/343/202/254/343/202/244/343/203/211.md +580 -580
- package/lib/assets/docs/reference//343/203/255/343/202/270/343/202/253/343/203/253/343/202/267/343/203/263/343/202/255/343/203/263/343/202/260.md +1367 -1367
- package/lib/assets/docs/reference//344/274/201/346/245/255/347/265/214/345/226/266/350/253/226.md +2637 -2637
- package/lib/assets/docs/reference//347/222/260/345/242/203/345/244/211/346/225/260/347/256/241/347/220/206/343/202/254/343/202/244/343/203/211.md +665 -665
- package/lib/assets/docs/reference//350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1248 -1248
- package/lib/assets/docs/reference//350/250/200/350/252/236/345/210/245/351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +518 -518
- package/lib/assets/docs/reference//351/201/213/345/226/266/347/256/241/347/220/206.md +1482 -1482
- package/lib/assets/docs/reference//351/201/213/347/224/250/343/202/271/343/202/257/343/203/252/343/203/227/343/203/210/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +421 -421
- package/lib/assets/docs/reference//351/201/213/347/224/250/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +392 -392
- package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +299 -299
- package/lib/assets/docs/reference//351/235/236/346/251/237/350/203/275/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1236 -1236
- package/lib/assets/docs/review/index.md +5 -5
- package/lib/assets/docs/strategy/index.md +1 -1
- package/lib/assets/docs/template/ADR.md +30 -30
- package/lib/assets/docs/template/AWS/343/202/271/343/203/206/343/203/274/343/202/270/343/203/263/343/202/260/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +1366 -1366
- package/lib/assets/docs/template/AWS/343/203/227/343/203/255/343/203/200/343/202/257/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +634 -634
- package/lib/assets/docs/template/README.md +50 -50
- package/lib/assets/docs/template/index.md +23 -23
- package/lib/assets/docs/template//343/201/276/343/201/232/343/201/223/343/202/214/343/202/222/350/252/255/343/202/202/343/201/206/343/203/252/343/202/271/343/203/210.md +12 -12
- package/lib/assets/docs/template//343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +547 -547
- package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +58 -58
- package/lib/assets/docs/template//343/202/244/343/203/263/343/202/273/343/203/227/343/202/267/343/203/247/343/203/263/343/203/207/343/203/203/343/202/255.md +13 -13
- package/lib/assets/docs/template//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243.md +379 -379
- package/lib/assets/docs/template//344/274/201/346/245/255/345/210/206/346/236/220.md +573 -573
- package/lib/assets/docs/template//345/256/214/345/205/250/345/275/242/345/274/217/343/201/256/343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271.md +69 -69
- package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
- package/lib/assets/docs/template//350/250/255/350/250/210.md +173 -173
- package/lib/assets/docs/template//351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +688 -688
- package/lib/assets/gulpfile.js +25 -25
- package/lib/assets/mkdocs.yml +136 -136
- package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
- package/lib/assets/ops/scripts/journal.js +180 -180
- package/lib/assets/ops/scripts/mkdocs.js +82 -82
- package/lib/assets/ops/scripts/release.js +431 -431
- package/lib/assets/ops/scripts/sonar_local.js +726 -726
- package/lib/assets/ops/scripts/ssh.js +190 -190
- package/lib/assets/ops/scripts/vault.js +299 -299
- package/lib/assets/package-lock.json +1653 -1653
- package/lib/assets/package.json +40 -40
- package/lib/gulpfile.js +37 -37
- package/package.json +41 -41
|
@@ -1,972 +1,972 @@
|
|
|
1
|
-
# Part IV - 第 8 章:IO モナドと副作用の分離
|
|
2
|
-
|
|
3
|
-
## 8.1 はじめに:副作用の問題
|
|
4
|
-
|
|
5
|
-
純粋関数は同じ入力に対して常に同じ出力を返し、外部の状態を変更しません。しかし、実際のプログラムには副作用が不可欠です:
|
|
6
|
-
|
|
7
|
-
- ファイルの読み書き
|
|
8
|
-
- ネットワーク通信
|
|
9
|
-
- データベースアクセス
|
|
10
|
-
- 乱数生成
|
|
11
|
-
- 現在時刻の取得
|
|
12
|
-
|
|
13
|
-
関数型プログラミングの核心的な問いは「副作用をどう管理するか」です。本章では、11 言語がこの問いにどう答えるかを横断的に比較し、以下を明らかにします:
|
|
14
|
-
|
|
15
|
-
- IO の抽象化レベルの違い(言語組み込み vs ライブラリ vs 慣習的分離)
|
|
16
|
-
- 「記述」と「実行」を分離する共通パターン
|
|
17
|
-
- IO の合成方法と糖衣構文の言語間差異
|
|
18
|
-
|
|
19
|
-
```plantuml
|
|
20
|
-
@startuml
|
|
21
|
-
!theme plain
|
|
22
|
-
|
|
23
|
-
rectangle "副作用の管理" {
|
|
24
|
-
card "不純な関数" as impure #LightCoral
|
|
25
|
-
card "IO 型(記述)" as io #LightGreen
|
|
26
|
-
card "実行(interpret)" as run #LightBlue
|
|
27
|
-
|
|
28
|
-
impure --> io : 副作用をラップ
|
|
29
|
-
io --> run : 明示的に実行
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
note bottom of io
|
|
33
|
-
IO 値を作成しただけでは
|
|
34
|
-
副作用は発生しない
|
|
35
|
-
end note
|
|
36
|
-
|
|
37
|
-
@enduml
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
---
|
|
41
|
-
|
|
42
|
-
## 8.2 共通の本質:記述と実行の分離
|
|
43
|
-
|
|
44
|
-
11 言語すべてに共通する IO の原則は、**副作用の「記述」と「実行」を分離する**ことです:
|
|
45
|
-
|
|
46
|
-
1. **記述(Description)**: 副作用を持つ計算を「値」として表現する
|
|
47
|
-
2. **合成(Composition)**: IO 値を flatMap / bind / chain で組み合わせる
|
|
48
|
-
3. **実行(Interpretation)**: プログラムの端(main / エントリーポイント)で一度だけ実行する
|
|
49
|
-
|
|
50
|
-
3 つの言語グループから代表例を見てみましょう:
|
|
51
|
-
|
|
52
|
-
```haskell
|
|
53
|
-
-- Haskell: IO モナド(言語組み込み)
|
|
54
|
-
castTheDie :: IO Int
|
|
55
|
-
castTheDie = randomRIO (1, 6)
|
|
56
|
-
|
|
57
|
-
-- do 記法で合成
|
|
58
|
-
castTheDieTwice :: IO Int
|
|
59
|
-
castTheDieTwice = do
|
|
60
|
-
first <- castTheDie
|
|
61
|
-
second <- castTheDie
|
|
62
|
-
return (first + second)
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
```scala
|
|
66
|
-
// Scala: cats-effect IO(ライブラリ)
|
|
67
|
-
def castTheDie(): IO[Int] = IO.delay(random.nextInt(6) + 1)
|
|
68
|
-
|
|
69
|
-
// for 内包表記で合成
|
|
70
|
-
def castTheDieTwice(): IO[Int] =
|
|
71
|
-
for {
|
|
72
|
-
first <- castTheDie()
|
|
73
|
-
second <- castTheDie()
|
|
74
|
-
} yield first + second
|
|
75
|
-
|
|
76
|
-
// 明示的に実行(unsafeRunSync)
|
|
77
|
-
castTheDieTwice().unsafeRunSync()
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
```python
|
|
81
|
-
# Python: カスタム LazyIO クラス
|
|
82
|
-
def cast_the_die() -> LazyIO[int]:
|
|
83
|
-
return LazyIO(lambda: random.randint(1, 6))
|
|
84
|
-
|
|
85
|
-
# bind/map で合成
|
|
86
|
-
def cast_the_die_twice() -> LazyIO[int]:
|
|
87
|
-
return cast_the_die().bind(
|
|
88
|
-
lambda first: cast_the_die().map(lambda second: first + second)
|
|
89
|
-
)
|
|
90
|
-
|
|
91
|
-
# 明示的に実行
|
|
92
|
-
cast_the_die_twice().run()
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
## 8.3 IO の実装方式
|
|
98
|
-
|
|
99
|
-
### アプローチ 1: 言語組み込み IO
|
|
100
|
-
|
|
101
|
-
| 言語 | IO 型 | 実行方法 | 特徴 |
|
|
102
|
-
|------|-------|---------|------|
|
|
103
|
-
| **Haskell** | `IO a` | `main` 関数 | 言語レベルで純粋性を強制 |
|
|
104
|
-
|
|
105
|
-
Haskell は唯一、IO を**言語レベル**で強制する言語です。`IO` 型を持たない関数は副作用を起こせません。
|
|
106
|
-
|
|
107
|
-
### アプローチ 2: エフェクトライブラリ
|
|
108
|
-
|
|
109
|
-
| 言語 | ライブラリ | IO 型 | 実行方法 |
|
|
110
|
-
|------|-----------|-------|---------|
|
|
111
|
-
| **Scala** | cats-effect | `IO[A]` | `unsafeRunSync()` |
|
|
112
|
-
| **TypeScript** | fp-ts | `IO<A>` / `Task<A>` | `io()` / `task()` |
|
|
113
|
-
| **Java** | 独自実装 | `IO<A>` | `unsafeRun()` |
|
|
114
|
-
| **Python** | 独自実装 | `LazyIO[A]` | `run()` |
|
|
115
|
-
| **Ruby** | 独自実装 | `IO` | `run!` |
|
|
116
|
-
|
|
117
|
-
### アプローチ 3: 言語固有の非同期プリミティブ
|
|
118
|
-
|
|
119
|
-
| 言語 | プリミティブ | 実行方法 | 特徴 |
|
|
120
|
-
|------|-----------|---------|------|
|
|
121
|
-
| **F#** | `Async<'a>` | `Async.RunSynchronously` | コンピュテーション式 |
|
|
122
|
-
| **C#** | `Task<T>` | `await` / `GetResult()` | async/await |
|
|
123
|
-
| **Rust** | `Future<Output=T>` | `.await` + tokio ランタイム | ゼロコスト抽象化 |
|
|
124
|
-
|
|
125
|
-
### アプローチ 4: 実用的プリミティブ
|
|
126
|
-
|
|
127
|
-
| 言語 | プリミティブ | 特徴 |
|
|
128
|
-
|------|-----------|------|
|
|
129
|
-
| **Clojure** | `delay` / `atom` / `future` | 複数のプリミティブを使い分け |
|
|
130
|
-
| **Elixir** | 無名関数 + `Agent` / `Task` | OTP の軽量プロセスと組み合わせ |
|
|
131
|
-
|
|
132
|
-
---
|
|
133
|
-
|
|
134
|
-
## 8.4 サイコロを振る:IO の基本パターン
|
|
135
|
-
|
|
136
|
-
最もシンプルな IO の例として、サイコロを振る関数を 11 言語で比較します。
|
|
137
|
-
|
|
138
|
-
### 代表 3 言語の比較
|
|
139
|
-
|
|
140
|
-
**Haskell**: `randomRIO` が直接 `IO Int` を返す
|
|
141
|
-
|
|
142
|
-
```haskell
|
|
143
|
-
import System.Random (randomRIO)
|
|
144
|
-
|
|
145
|
-
castTheDie :: IO Int
|
|
146
|
-
castTheDie = randomRIO (1, 6)
|
|
147
|
-
|
|
148
|
-
castTheDieTwice :: IO Int
|
|
149
|
-
castTheDieTwice = do
|
|
150
|
-
first <- castTheDie
|
|
151
|
-
second <- castTheDie
|
|
152
|
-
return (first + second)
|
|
153
|
-
```
|
|
154
|
-
|
|
155
|
-
**Scala**: `IO.delay` で不純な関数をラップ
|
|
156
|
-
|
|
157
|
-
```scala
|
|
158
|
-
import cats.effect.IO
|
|
159
|
-
|
|
160
|
-
def castTheDie(): IO[Int] = IO.delay(random.nextInt(6) + 1)
|
|
161
|
-
|
|
162
|
-
def castTheDieTwice(): IO[Int] =
|
|
163
|
-
for {
|
|
164
|
-
first <- castTheDie()
|
|
165
|
-
second <- castTheDie()
|
|
166
|
-
} yield first + second
|
|
167
|
-
```
|
|
168
|
-
|
|
169
|
-
**Rust**: `async fn` が `Future` を返す
|
|
170
|
-
|
|
171
|
-
```rust
|
|
172
|
-
pub async fn cast_the_die() -> i32 {
|
|
173
|
-
cast_the_die_impure()
|
|
174
|
-
}
|
|
175
|
-
|
|
176
|
-
pub async fn cast_the_die_twice() -> i32 {
|
|
177
|
-
let first = cast_the_die().await;
|
|
178
|
-
let second = cast_the_die().await;
|
|
179
|
-
first + second
|
|
180
|
-
}
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
### 全 11 言語の実装
|
|
184
|
-
|
|
185
|
-
#### 関数型ファースト言語
|
|
186
|
-
|
|
187
|
-
<details>
|
|
188
|
-
<summary>Haskell 実装</summary>
|
|
189
|
-
|
|
190
|
-
```haskell
|
|
191
|
-
import System.Random (randomRIO)
|
|
192
|
-
|
|
193
|
-
castTheDie :: IO Int
|
|
194
|
-
castTheDie = randomRIO (1, 6)
|
|
195
|
-
|
|
196
|
-
castTheDieTwice :: IO Int
|
|
197
|
-
castTheDieTwice = do
|
|
198
|
-
first <- castTheDie
|
|
199
|
-
second <- castTheDie
|
|
200
|
-
return (first + second)
|
|
201
|
-
|
|
202
|
-
-- replicateM で n 回繰り返し
|
|
203
|
-
castTheDieN :: Int -> IO [Int]
|
|
204
|
-
castTheDieN n = replicateM n castTheDie
|
|
205
|
-
```
|
|
206
|
-
|
|
207
|
-
Haskell では `randomRIO` 自体が `IO Int` を返します。副作用のある関数は必ず `IO` 型を持ち、純粋関数との分離が**言語レベルで強制**されます。
|
|
208
|
-
|
|
209
|
-
</details>
|
|
210
|
-
|
|
211
|
-
<details>
|
|
212
|
-
<summary>Clojure 実装</summary>
|
|
213
|
-
|
|
214
|
-
```clojure
|
|
215
|
-
(defn cast-the-die-impure!
|
|
216
|
-
"サイコロを振る(不純)"
|
|
217
|
-
[]
|
|
218
|
-
(inc (rand-int 6)))
|
|
219
|
-
|
|
220
|
-
;; delay で遅延評価
|
|
221
|
-
(defn cast-the-die []
|
|
222
|
-
(delay (cast-the-die-impure!)))
|
|
223
|
-
|
|
224
|
-
;; force で実行
|
|
225
|
-
(force (cast-the-die)) ; => 4
|
|
226
|
-
|
|
227
|
-
;; atom で状態管理
|
|
228
|
-
(def game-state (atom {:rolls [] :total 0}))
|
|
229
|
-
|
|
230
|
-
(defn roll-die! []
|
|
231
|
-
(let [roll (cast-the-die-impure!)]
|
|
232
|
-
(swap! game-state
|
|
233
|
-
(fn [state]
|
|
234
|
-
(-> state
|
|
235
|
-
(update :rolls conj roll)
|
|
236
|
-
(update :total + roll))))
|
|
237
|
-
roll))
|
|
238
|
-
```
|
|
239
|
-
|
|
240
|
-
Clojure は IO モナドを使わず、`delay` / `atom` / `future` という実用的なプリミティブで副作用を管理します。`delay` は一度だけ評価されキャッシュされる点に注意してください。
|
|
241
|
-
|
|
242
|
-
</details>
|
|
243
|
-
|
|
244
|
-
<details>
|
|
245
|
-
<summary>Elixir 実装</summary>
|
|
246
|
-
|
|
247
|
-
```elixir
|
|
248
|
-
def cast_the_die_impure do
|
|
249
|
-
:rand.uniform(6)
|
|
250
|
-
end
|
|
251
|
-
|
|
252
|
-
# 無名関数で遅延実行
|
|
253
|
-
@spec delay((-> any())) :: (-> any())
|
|
254
|
-
def delay(f) when is_function(f, 0), do: f
|
|
255
|
-
|
|
256
|
-
@spec run((-> any())) :: any()
|
|
257
|
-
def run(f) when is_function(f, 0), do: f.()
|
|
258
|
-
|
|
259
|
-
def cast_the_die do
|
|
260
|
-
delay(fn -> cast_the_die_impure() end)
|
|
261
|
-
end
|
|
262
|
-
|
|
263
|
-
# flat_map で合成
|
|
264
|
-
def cast_the_die_twice do
|
|
265
|
-
flat_map(cast_the_die(), fn first ->
|
|
266
|
-
map(cast_the_die(), fn second ->
|
|
267
|
-
first + second
|
|
268
|
-
end)
|
|
269
|
-
end)
|
|
270
|
-
end
|
|
271
|
-
```
|
|
272
|
-
|
|
273
|
-
Elixir は無名関数 `fn -> ... end` で副作用を遅延実行します。Scala の `IO.delay` に相当する `delay/1` と `run/1` を自前で定義します。
|
|
274
|
-
|
|
275
|
-
</details>
|
|
276
|
-
|
|
277
|
-
<details>
|
|
278
|
-
<summary>F# 実装</summary>
|
|
279
|
-
|
|
280
|
-
```fsharp
|
|
281
|
-
let castTheDie () : Async<int> =
|
|
282
|
-
async { return (Random()).Next(1, 7) }
|
|
283
|
-
|
|
284
|
-
let castTheDieTwice () : Async<int> =
|
|
285
|
-
async {
|
|
286
|
-
let! firstCast = castTheDie ()
|
|
287
|
-
let! secondCast = castTheDie ()
|
|
288
|
-
return firstCast + secondCast
|
|
289
|
-
}
|
|
290
|
-
|
|
291
|
-
// 実行
|
|
292
|
-
let result = Async.RunSynchronously (castTheDieTwice ())
|
|
293
|
-
```
|
|
294
|
-
|
|
295
|
-
F# の `async { }` コンピュテーション式は Haskell の do 記法に相当します。`let!` でバインドし、`return` で値をラップします。
|
|
296
|
-
|
|
297
|
-
</details>
|
|
298
|
-
|
|
299
|
-
#### マルチパラダイム言語
|
|
300
|
-
|
|
301
|
-
<details>
|
|
302
|
-
<summary>Scala 実装</summary>
|
|
303
|
-
|
|
304
|
-
```scala
|
|
305
|
-
import cats.effect.IO
|
|
306
|
-
|
|
307
|
-
def castTheDie(): IO[Int] = IO.delay(random.nextInt(6) + 1)
|
|
308
|
-
|
|
309
|
-
def castTheDieTwice(): IO[Int] =
|
|
310
|
-
for {
|
|
311
|
-
first <- castTheDie()
|
|
312
|
-
second <- castTheDie()
|
|
313
|
-
} yield first + second
|
|
314
|
-
|
|
315
|
-
// IO.pure: 副作用なし
|
|
316
|
-
val pureValue: IO[Int] = IO.pure(42)
|
|
317
|
-
|
|
318
|
-
// 実行
|
|
319
|
-
castTheDieTwice().unsafeRunSync()
|
|
320
|
-
```
|
|
321
|
-
|
|
322
|
-
</details>
|
|
323
|
-
|
|
324
|
-
<details>
|
|
325
|
-
<summary>Rust 実装</summary>
|
|
326
|
-
|
|
327
|
-
```rust
|
|
328
|
-
pub async fn cast_the_die() -> i32 {
|
|
329
|
-
use std::time::{SystemTime, UNIX_EPOCH};
|
|
330
|
-
let nanos = SystemTime::now()
|
|
331
|
-
.duration_since(UNIX_EPOCH)
|
|
332
|
-
.unwrap()
|
|
333
|
-
.subsec_nanos();
|
|
334
|
-
(nanos % 6) as i32 + 1
|
|
335
|
-
}
|
|
336
|
-
|
|
337
|
-
pub async fn cast_the_die_twice() -> i32 {
|
|
338
|
-
let first = cast_the_die().await;
|
|
339
|
-
let second = cast_the_die().await;
|
|
340
|
-
first + second
|
|
341
|
-
}
|
|
342
|
-
```
|
|
343
|
-
|
|
344
|
-
Rust の `async fn` は `Future` を返します。`.await` されるまで実行されない点が IO モナドと共通しています。
|
|
345
|
-
|
|
346
|
-
</details>
|
|
347
|
-
|
|
348
|
-
<details>
|
|
349
|
-
<summary>TypeScript (fp-ts) 実装</summary>
|
|
350
|
-
|
|
351
|
-
```typescript
|
|
352
|
-
import * as IO from 'fp-ts/IO'
|
|
353
|
-
import { pipe } from 'fp-ts/function'
|
|
354
|
-
|
|
355
|
-
const castTheDie: IO.IO<number> = () => Math.floor(Math.random() * 6) + 1
|
|
356
|
-
|
|
357
|
-
const castTheDieTwice: IO.IO<number> = pipe(
|
|
358
|
-
castTheDie,
|
|
359
|
-
IO.chain((first) =>
|
|
360
|
-
pipe(
|
|
361
|
-
castTheDie,
|
|
362
|
-
IO.map((second) => first + second)
|
|
363
|
-
)
|
|
364
|
-
)
|
|
365
|
-
)
|
|
366
|
-
|
|
367
|
-
// 実行
|
|
368
|
-
castTheDieTwice() // 2〜12 の値
|
|
369
|
-
```
|
|
370
|
-
|
|
371
|
-
fp-ts の `IO<A>` は `() => A` 型のエイリアスです。`chain`(= flatMap)と `map` で合成し、`()` で実行します。
|
|
372
|
-
|
|
373
|
-
</details>
|
|
374
|
-
|
|
375
|
-
#### OOP + FP ライブラリ言語
|
|
376
|
-
|
|
377
|
-
<details>
|
|
378
|
-
<summary>Java 実装</summary>
|
|
379
|
-
|
|
380
|
-
```java
|
|
381
|
-
public final class IO<A> {
|
|
382
|
-
private final Supplier<A> thunk;
|
|
383
|
-
|
|
384
|
-
private IO(Supplier<A> thunk) { this.thunk = thunk; }
|
|
385
|
-
|
|
386
|
-
public static <A> IO<A> delay(Supplier<A> supplier) {
|
|
387
|
-
return new IO<>(supplier);
|
|
388
|
-
}
|
|
389
|
-
|
|
390
|
-
public static <A> IO<A> pure(A value) {
|
|
391
|
-
return new IO<>(() -> value);
|
|
392
|
-
}
|
|
393
|
-
|
|
394
|
-
public A unsafeRun() { return thunk.get(); }
|
|
395
|
-
|
|
396
|
-
public <B> IO<B> map(Function<A, B> f) {
|
|
397
|
-
return new IO<>(() -> f.apply(thunk.get()));
|
|
398
|
-
}
|
|
399
|
-
|
|
400
|
-
public <B> IO<B> flatMap(Function<A, IO<B>> f) {
|
|
401
|
-
return new IO<>(() -> f.apply(thunk.get()).unsafeRun());
|
|
402
|
-
}
|
|
403
|
-
}
|
|
404
|
-
|
|
405
|
-
// 使用例
|
|
406
|
-
public static IO<Integer> castTheDie() {
|
|
407
|
-
return IO.delay(() -> random.nextInt(6) + 1);
|
|
408
|
-
}
|
|
409
|
-
|
|
410
|
-
public static IO<Integer> castTheDieTwice() {
|
|
411
|
-
return castTheDie()
|
|
412
|
-
.flatMap(first -> castTheDie()
|
|
413
|
-
.map(second -> first + second));
|
|
414
|
-
}
|
|
415
|
-
```
|
|
416
|
-
|
|
417
|
-
Java には IO ライブラリがないため、`Supplier<A>` ベースの IO クラスを自前で実装します。
|
|
418
|
-
|
|
419
|
-
</details>
|
|
420
|
-
|
|
421
|
-
<details>
|
|
422
|
-
<summary>C# 実装</summary>
|
|
423
|
-
|
|
424
|
-
```csharp
|
|
425
|
-
public static Task<int> CastTheDie() =>
|
|
426
|
-
Task.Run(() => new Random().Next(1, 7));
|
|
427
|
-
|
|
428
|
-
public static async Task<int> CastTheDieTwice()
|
|
429
|
-
{
|
|
430
|
-
var first = await CastTheDie();
|
|
431
|
-
var second = await CastTheDie();
|
|
432
|
-
return first + second;
|
|
433
|
-
}
|
|
434
|
-
|
|
435
|
-
// 実行
|
|
436
|
-
await CastTheDieTwice();
|
|
437
|
-
```
|
|
438
|
-
|
|
439
|
-
C# は `Task<T>` と `async/await` で副作用を管理します。Rust と同様に言語組み込みの非同期プリミティブを使います。
|
|
440
|
-
|
|
441
|
-
</details>
|
|
442
|
-
|
|
443
|
-
<details>
|
|
444
|
-
<summary>Python 実装</summary>
|
|
445
|
-
|
|
446
|
-
```python
|
|
447
|
-
class LazyIO(Generic[T]):
|
|
448
|
-
def __init__(self, effect: Callable[[], T]) -> None:
|
|
449
|
-
self._effect = effect
|
|
450
|
-
|
|
451
|
-
def run(self) -> T:
|
|
452
|
-
return self._effect()
|
|
453
|
-
|
|
454
|
-
def map(self, f: Callable[[T], U]) -> "LazyIO[U]":
|
|
455
|
-
return LazyIO(lambda: f(self.run()))
|
|
456
|
-
|
|
457
|
-
def bind(self, f: Callable[[T], "LazyIO[U]"]) -> "LazyIO[U]":
|
|
458
|
-
return LazyIO(lambda: f(self.run()).run())
|
|
459
|
-
|
|
460
|
-
# 使用例
|
|
461
|
-
def cast_the_die() -> LazyIO[int]:
|
|
462
|
-
return LazyIO(lambda: random.randint(1, 6))
|
|
463
|
-
|
|
464
|
-
def cast_the_die_twice() -> LazyIO[int]:
|
|
465
|
-
return cast_the_die().bind(
|
|
466
|
-
lambda first: cast_the_die().map(lambda second: first + second)
|
|
467
|
-
)
|
|
468
|
-
```
|
|
469
|
-
|
|
470
|
-
Python では Java と同様にカスタムの `LazyIO` クラスを実装します。ラムダ式で副作用を遅延評価し、`run()` で実行します。
|
|
471
|
-
|
|
472
|
-
</details>
|
|
473
|
-
|
|
474
|
-
<details>
|
|
475
|
-
<summary>Ruby 実装</summary>
|
|
476
|
-
|
|
477
|
-
```ruby
|
|
478
|
-
class IO
|
|
479
|
-
def initialize(&computation)
|
|
480
|
-
@computation = computation
|
|
481
|
-
end
|
|
482
|
-
|
|
483
|
-
def self.delay(&block) = new(&block)
|
|
484
|
-
def self.pure(value) = new { value }
|
|
485
|
-
|
|
486
|
-
def run! = @computation.call
|
|
487
|
-
|
|
488
|
-
def fmap(&f) = IO.new { f.call(run!) }
|
|
489
|
-
def bind(&f) = IO.new { f.call(run!).run! }
|
|
490
|
-
end
|
|
491
|
-
|
|
492
|
-
# 使用例
|
|
493
|
-
def cast_the_die
|
|
494
|
-
IO.delay { rand(1..6) }
|
|
495
|
-
end
|
|
496
|
-
|
|
497
|
-
def cast_the_die_twice
|
|
498
|
-
cast_the_die.bind do |first|
|
|
499
|
-
cast_the_die.fmap { |second| first + second }
|
|
500
|
-
end
|
|
501
|
-
end
|
|
502
|
-
```
|
|
503
|
-
|
|
504
|
-
Ruby もカスタム IO クラスで実装します。ブロック構文によりネストが比較的読みやすくなっています。
|
|
505
|
-
|
|
506
|
-
</details>
|
|
507
|
-
|
|
508
|
-
---
|
|
509
|
-
|
|
510
|
-
## 8.5 IO の合成構文比較
|
|
511
|
-
|
|
512
|
-
IO の合成は flatMap / bind の連鎖です。各言語の糖衣構文を比較します。
|
|
513
|
-
|
|
514
|
-
### 合成構文一覧
|
|
515
|
-
|
|
516
|
-
| 言語 | 構文 | バインド | 例 |
|
|
517
|
-
|------|------|---------|-----|
|
|
518
|
-
| **Haskell** | do 記法 | `<-` | `do { x <- io; return x }` |
|
|
519
|
-
| **Scala** | for 内包表記 | `<-` | `for { x <- io } yield x` |
|
|
520
|
-
| **F#** | async { } | `let!` | `async { let! x = io; return x }` |
|
|
521
|
-
| **C#** | async/await | `await` | `async { var x = await io; return x; }` |
|
|
522
|
-
| **Rust** | async/await | `.await` | `async { let x = io.await; x }` |
|
|
523
|
-
| **TypeScript** | pipe + chain | `chain` | `pipe(io, IO.chain(x => ...))` |
|
|
524
|
-
| **Elixir** | flat_map | `flat_map` | `flat_map(io, fn x -> ... end)` |
|
|
525
|
-
| **Java** | flatMap chain | `.flatMap` | `io.flatMap(x -> ...)` |
|
|
526
|
-
| **Python** | bind chain | `.bind` | `io.bind(lambda x: ...)` |
|
|
527
|
-
| **Ruby** | bind block | `.bind` | `io.bind { \|x\| ... }` |
|
|
528
|
-
| **Clojure** | delay + force | 手動 | `(force (delay ...))` |
|
|
529
|
-
|
|
530
|
-
### 可読性の比較
|
|
531
|
-
|
|
532
|
-
**糖衣構文あり**(手続き的に読める):
|
|
533
|
-
|
|
534
|
-
```haskell
|
|
535
|
-
-- Haskell: do 記法
|
|
536
|
-
scheduledMeetings person1 person2 = do
|
|
537
|
-
entries1 <- calendarEntries person1
|
|
538
|
-
entries2 <- calendarEntries person2
|
|
539
|
-
return (entries1 ++ entries2)
|
|
540
|
-
```
|
|
541
|
-
|
|
542
|
-
```fsharp
|
|
543
|
-
// F#: async { } コンピュテーション式
|
|
544
|
-
let scheduledMeetings person1 person2 =
|
|
545
|
-
async {
|
|
546
|
-
let! entries1 = calendarEntries person1
|
|
547
|
-
let! entries2 = calendarEntries person2
|
|
548
|
-
return entries1 @ entries2
|
|
549
|
-
}
|
|
550
|
-
```
|
|
551
|
-
|
|
552
|
-
```csharp
|
|
553
|
-
// C#: async/await
|
|
554
|
-
public static async Task<Seq<MeetingTime>> ScheduledMeetings(
|
|
555
|
-
string person1, string person2)
|
|
556
|
-
{
|
|
557
|
-
var entries1 = await CalendarEntries(person1);
|
|
558
|
-
var entries2 = await CalendarEntries(person2);
|
|
559
|
-
return entries1.Concat(entries2);
|
|
560
|
-
}
|
|
561
|
-
```
|
|
562
|
-
|
|
563
|
-
**糖衣構文なし**(ラムダのネストが必要):
|
|
564
|
-
|
|
565
|
-
```java
|
|
566
|
-
// Java: flatMap チェーン
|
|
567
|
-
public static IO<List<MeetingTime>> scheduledMeetings(
|
|
568
|
-
String person1, String person2) {
|
|
569
|
-
return calendarEntries(person1).flatMap(entries1 ->
|
|
570
|
-
calendarEntries(person2).map(entries2 ->
|
|
571
|
-
entries1.appendedAll(entries2)));
|
|
572
|
-
}
|
|
573
|
-
```
|
|
574
|
-
|
|
575
|
-
---
|
|
576
|
-
|
|
577
|
-
## 8.6 エラーハンドリングとリトライ
|
|
578
|
-
|
|
579
|
-
IO は失敗する可能性があります。各言語のエラーハンドリングとリトライ戦略を比較します。
|
|
580
|
-
|
|
581
|
-
### orElse によるフォールバック
|
|
582
|
-
|
|
583
|
-
```scala
|
|
584
|
-
// Scala: orElse
|
|
585
|
-
val year: IO[Int] = IO.delay(996)
|
|
586
|
-
val noYear: IO[Int] = IO.delay(throw new Exception("no year"))
|
|
587
|
-
|
|
588
|
-
year.orElse(IO.delay(2020)).unsafeRunSync() // 996
|
|
589
|
-
noYear.orElse(IO.delay(2020)).unsafeRunSync() // 2020
|
|
590
|
-
```
|
|
591
|
-
|
|
592
|
-
### リトライ戦略の比較
|
|
593
|
-
|
|
594
|
-
#### 代表 3 言語
|
|
595
|
-
|
|
596
|
-
**Scala**: orElse の fold
|
|
597
|
-
|
|
598
|
-
```scala
|
|
599
|
-
def retry[A](action: IO[A], maxRetries: Int): IO[A] =
|
|
600
|
-
List.range(0, maxRetries)
|
|
601
|
-
.map(_ => action)
|
|
602
|
-
.foldLeft(action)((program, retryAction) =>
|
|
603
|
-
program.orElse(retryAction))
|
|
604
|
-
```
|
|
605
|
-
|
|
606
|
-
**Haskell**: 再帰 + try/catch
|
|
607
|
-
|
|
608
|
-
```haskell
|
|
609
|
-
retryIO :: Int -> IO a -> IO (Maybe a)
|
|
610
|
-
retryIO 0 _ = return Nothing
|
|
611
|
-
retryIO n action = do
|
|
612
|
-
result <- try action :: IO (Either SomeException a)
|
|
613
|
-
case result of
|
|
614
|
-
Right a -> return (Just a)
|
|
615
|
-
Left _ -> retryIO (n - 1) action
|
|
616
|
-
```
|
|
617
|
-
|
|
618
|
-
**Rust**: ジェネリック関数 + Result
|
|
619
|
-
|
|
620
|
-
```rust
|
|
621
|
-
pub async fn retry<T, E, F, Fut>(action: F, max_retries: usize) -> Result<T, E>
|
|
622
|
-
where
|
|
623
|
-
F: Fn() -> Fut,
|
|
624
|
-
Fut: Future<Output = Result<T, E>>,
|
|
625
|
-
{
|
|
626
|
-
let mut last_error = None;
|
|
627
|
-
for _ in 0..max_retries {
|
|
628
|
-
match action().await {
|
|
629
|
-
Ok(result) => return Ok(result),
|
|
630
|
-
Err(e) => last_error = Some(e),
|
|
631
|
-
}
|
|
632
|
-
}
|
|
633
|
-
Err(last_error.unwrap())
|
|
634
|
-
}
|
|
635
|
-
```
|
|
636
|
-
|
|
637
|
-
### 全 11 言語のエラーハンドリング比較
|
|
638
|
-
|
|
639
|
-
| 言語 | フォールバック | リトライ方式 | エラー型 |
|
|
640
|
-
|------|-------------|------------|---------|
|
|
641
|
-
| **Haskell** | `catch` / 手動 | 再帰 + `try` | `SomeException` |
|
|
642
|
-
| **Scala** | `IO.orElse` | fold / handleErrorWith | `Throwable` |
|
|
643
|
-
| **Rust** | `or_else` / `unwrap_or` | ループ + `Result` | `E` (ジェネリック) |
|
|
644
|
-
| **F#** | `try/with` + Async | Async.Catch | `exn` |
|
|
645
|
-
| **C#** | `try/catch` + Task | ループ + try/catch | `Exception` |
|
|
646
|
-
| **TypeScript** | `TaskEither` + `orElse` | pipe + orElse | `E` (ジェネリック) |
|
|
647
|
-
| **Java** | try/catch 内 IO | ループ + try/catch | `Exception` |
|
|
648
|
-
| **Python** | try/except 内 LazyIO | ループ + try/except | `Exception` |
|
|
649
|
-
| **Ruby** | `or_else` ブロック | ループ + rescue | `StandardError` |
|
|
650
|
-
| **Clojure** | `try/catch` | 再帰 + try/catch | Java 例外 |
|
|
651
|
-
| **Elixir** | `or_else` 関数 | 再帰 + rescue | `RuntimeError` |
|
|
652
|
-
|
|
653
|
-
---
|
|
654
|
-
|
|
655
|
-
## 8.7 sequence:IO のリスト変換
|
|
656
|
-
|
|
657
|
-
`List[IO[A]]` → `IO[List[A]]` の変換は、複数の IO を一つにまとめる重要なパターンです。
|
|
658
|
-
|
|
659
|
-
### 代表的な実装
|
|
660
|
-
|
|
661
|
-
```scala
|
|
662
|
-
// Scala: cats の sequence
|
|
663
|
-
import cats.implicits._
|
|
664
|
-
|
|
665
|
-
val actions: List[IO[Int]] = List(IO.pure(1), IO.pure(2), IO.pure(3))
|
|
666
|
-
val combined: IO[List[Int]] = actions.sequence
|
|
667
|
-
combined.unsafeRunSync() // List(1, 2, 3)
|
|
668
|
-
|
|
669
|
-
// 複数人の予定を取得
|
|
670
|
-
def scheduledMeetings(attendees: List[String]): IO[List[MeetingTime]] =
|
|
671
|
-
attendees
|
|
672
|
-
.map(attendee => retry(calendarEntries(attendee), 10))
|
|
673
|
-
.sequence
|
|
674
|
-
.map(_.flatten)
|
|
675
|
-
```
|
|
676
|
-
|
|
677
|
-
```haskell
|
|
678
|
-
-- Haskell: sequence(標準ライブラリ)
|
|
679
|
-
sequenceIO :: [IO a] -> IO [a]
|
|
680
|
-
sequenceIO [] = return []
|
|
681
|
-
sequenceIO (x:xs) = do
|
|
682
|
-
a <- x
|
|
683
|
-
as <- sequenceIO xs
|
|
684
|
-
return (a : as)
|
|
685
|
-
|
|
686
|
-
-- replicateM で n 回実行
|
|
687
|
-
castTheDieN :: Int -> IO [Int]
|
|
688
|
-
castTheDieN n = replicateM n castTheDie
|
|
689
|
-
```
|
|
690
|
-
|
|
691
|
-
```rust
|
|
692
|
-
// Rust: join_all で並行実行
|
|
693
|
-
pub async fn scheduled_meetings_for_all(attendees: &[&str]) -> Vec<MeetingTime> {
|
|
694
|
-
let futures: Vec<_> = attendees
|
|
695
|
-
.iter()
|
|
696
|
-
.map(|name| calendar_entries(name))
|
|
697
|
-
.collect();
|
|
698
|
-
|
|
699
|
-
let results = futures::future::join_all(futures).await;
|
|
700
|
-
results.into_iter().flatten().collect()
|
|
701
|
-
}
|
|
702
|
-
```
|
|
703
|
-
|
|
704
|
-
### 語彙比較
|
|
705
|
-
|
|
706
|
-
| 言語 | List[IO[A]] → IO[List[A]] | 並行実行 |
|
|
707
|
-
|------|--------------------------|---------|
|
|
708
|
-
| **Haskell** | `sequence` / `mapM` | `mapConcurrently` |
|
|
709
|
-
| **Scala** | `.sequence` (cats) | `parSequence` |
|
|
710
|
-
| **Rust** | `join_all` / `try_join_all` | `join_all`(デフォルト並行) |
|
|
711
|
-
| **F#** | `Async.Parallel` | `Async.Parallel`(デフォルト並行) |
|
|
712
|
-
| **C#** | `Task.WhenAll` | `Task.WhenAll`(デフォルト並行) |
|
|
713
|
-
| **TypeScript** | `array.sequence(T.task)` | `Promise.all` |
|
|
714
|
-
| **Java** | 手動 flatMap ループ | `CompletableFuture.allOf` |
|
|
715
|
-
| **Python** | 手動 bind ループ | `asyncio.gather` |
|
|
716
|
-
| **Ruby** | 手動 bind ループ | `Thread` / `Ractor` |
|
|
717
|
-
| **Clojure** | `(doall (map deref ...))` | `pmap` |
|
|
718
|
-
| **Elixir** | 手動 fold | `Task.async_stream` |
|
|
719
|
-
|
|
720
|
-
---
|
|
721
|
-
|
|
722
|
-
## 8.8 比較分析:3 つの発見
|
|
723
|
-
|
|
724
|
-
### 発見 1: IO の抽象化レベルは 4 段階に分かれる
|
|
725
|
-
|
|
726
|
-
```plantuml
|
|
727
|
-
@startuml
|
|
728
|
-
!theme plain
|
|
729
|
-
left to right direction
|
|
730
|
-
|
|
731
|
-
rectangle "Level 1: 言語組み込み IO" #LightGreen {
|
|
732
|
-
card "Haskell (IO モナド)" as h
|
|
733
|
-
}
|
|
734
|
-
|
|
735
|
-
rectangle "Level 2: エフェクトライブラリ" #LightBlue {
|
|
736
|
-
card "Scala (cats-effect IO)" as sc
|
|
737
|
-
card "TypeScript (fp-ts IO/Task)" as ts
|
|
738
|
-
}
|
|
739
|
-
|
|
740
|
-
rectangle "Level 3: 言語の非同期プリミティブ" #LightYellow {
|
|
741
|
-
card "F# (Async)" as fs
|
|
742
|
-
card "C# (Task)" as cs
|
|
743
|
-
card "Rust (Future / async)" as rs
|
|
744
|
-
}
|
|
745
|
-
|
|
746
|
-
rectangle "Level 4: 慣習的分離 / 自前実装" #LightCoral {
|
|
747
|
-
card "Java (カスタム IO)" as jv
|
|
748
|
-
card "Python (LazyIO)" as py
|
|
749
|
-
card "Ruby (カスタム IO)" as rb
|
|
750
|
-
card "Clojure (delay/atom)" as clj
|
|
751
|
-
card "Elixir (無名関数)" as ex
|
|
752
|
-
}
|
|
753
|
-
|
|
754
|
-
@enduml
|
|
755
|
-
```
|
|
756
|
-
|
|
757
|
-
**Level 1(Haskell)** は言語レベルで純粋性を保証します。IO 型を持たない関数は副作用を起こせないため、型シグネチャだけで純粋性がわかります。
|
|
758
|
-
|
|
759
|
-
**Level 2(Scala, TypeScript)** はライブラリが IO 型を提供し、`unsafeRunSync` / `io()` で実行を明示します。純粋性はライブラリの規約に依存します。
|
|
760
|
-
|
|
761
|
-
**Level 3(F#, C#, Rust)** は言語の非同期プリミティブ(`Async`, `Task`, `Future`)で副作用を遅延実行します。IO モナドとは異なりますが、「記述と実行の分離」を実現しています。
|
|
762
|
-
|
|
763
|
-
**Level 4(Java, Python, Ruby, Clojure, Elixir)** は標準的な IO 型がなく、カスタム実装または慣習的な分離に頼ります。
|
|
764
|
-
|
|
765
|
-
### 発見 2: 合成構文は 3 系統に分かれる
|
|
766
|
-
|
|
767
|
-
| 系統 | 構文 | 言語 | 可読性 |
|
|
768
|
-
|------|------|------|--------|
|
|
769
|
-
| **モナド内包表記** | do / for / async { } / LINQ | Haskell, Scala, F#, C# | 高(手続き的に読める) |
|
|
770
|
-
| **async/await** | async fn / await | C#, Rust, F# | 高(主流の構文) |
|
|
771
|
-
| **明示的チェーン** | flatMap / bind / chain | Java, Python, Ruby, TypeScript, Elixir, Clojure | 低〜中(ラムダのネスト) |
|
|
772
|
-
|
|
773
|
-
モナド内包表記と async/await は本質的に同じ脱糖を行います:
|
|
774
|
-
|
|
775
|
-
```
|
|
776
|
-
-- Haskell do 記法の脱糖
|
|
777
|
-
do { x <- io1; y <- io2; return (x + y) }
|
|
778
|
-
≡ io1 >>= \x -> io2 >>= \y -> return (x + y)
|
|
779
|
-
|
|
780
|
-
-- C# async/await の脱糖
|
|
781
|
-
async { var x = await task1; var y = await task2; return x + y; }
|
|
782
|
-
≡ task1.ContinueWith(x => task2.ContinueWith(y => x + y))
|
|
783
|
-
```
|
|
784
|
-
|
|
785
|
-
### 発見 3: 純粋コア / 不純シェルはすべての言語で有効
|
|
786
|
-
|
|
787
|
-
IO の抽象化レベルに関わらず、**Pure Core / Impure Shell** パターンはすべての言語で適用できます:
|
|
788
|
-
|
|
789
|
-
```plantuml
|
|
790
|
-
@startuml
|
|
791
|
-
!theme plain
|
|
792
|
-
|
|
793
|
-
rectangle "Pure Core / Impure Shell" {
|
|
794
|
-
rectangle "Impure Shell(IO 境界)" #LightCoral {
|
|
795
|
-
rectangle "Pure Core(純粋ロジック)" #LightGreen {
|
|
796
|
-
card "meetingsOverlap" as overlap
|
|
797
|
-
card "possibleMeetings" as possible
|
|
798
|
-
card "parseAndValidate" as parse
|
|
799
|
-
}
|
|
800
|
-
|
|
801
|
-
card "calendarEntries" as cal
|
|
802
|
-
card "createMeeting" as create
|
|
803
|
-
card "getLine / putStrLn" as stdio
|
|
804
|
-
}
|
|
805
|
-
|
|
806
|
-
cal --> possible : データを渡す
|
|
807
|
-
possible --> create : 結果を渡す
|
|
808
|
-
stdio --> parse : 入力を渡す
|
|
809
|
-
}
|
|
810
|
-
|
|
811
|
-
note bottom
|
|
812
|
-
ビジネスロジックは純粋関数で
|
|
813
|
-
IO は境界部分のみ
|
|
814
|
-
end note
|
|
815
|
-
|
|
816
|
-
@enduml
|
|
817
|
-
```
|
|
818
|
-
|
|
819
|
-
```haskell
|
|
820
|
-
-- Haskell: 純粋関数と IO の明確な分離
|
|
821
|
-
-- 純粋関数(テスト容易)
|
|
822
|
-
possibleMeetings :: [MeetingTime] -> Int -> Int -> Int -> [MeetingTime]
|
|
823
|
-
possibleMeetings existingMeetings startHour endHour lengthHours =
|
|
824
|
-
let slots = [MeetingTime s (s + lengthHours) | s <- [startHour .. endHour - lengthHours]]
|
|
825
|
-
in filter (\slot -> all (not . meetingsOverlap slot) existingMeetings) slots
|
|
826
|
-
|
|
827
|
-
-- IO 関数(外部 API)
|
|
828
|
-
calendarEntries :: String -> IO [MeetingTime]
|
|
829
|
-
scheduledMeetings :: String -> String -> IO [MeetingTime]
|
|
830
|
-
```
|
|
831
|
-
|
|
832
|
-
---
|
|
833
|
-
|
|
834
|
-
## 8.9 言語固有の特徴
|
|
835
|
-
|
|
836
|
-
### Haskell: IO の純粋性保証
|
|
837
|
-
|
|
838
|
-
Haskell は唯一、**型シグネチャで純粋性を保証**する言語です:
|
|
839
|
-
|
|
840
|
-
```haskell
|
|
841
|
-
-- 純粋関数(IO なし):副作用は不可能
|
|
842
|
-
possibleMeetings :: [MeetingTime] -> Int -> Int -> Int -> [MeetingTime]
|
|
843
|
-
|
|
844
|
-
-- IO 関数:副作用があることが明示的
|
|
845
|
-
calendarEntries :: String -> IO [MeetingTime]
|
|
846
|
-
```
|
|
847
|
-
|
|
848
|
-
コンパイラが純粋関数内の IO 使用を禁止するため、「うっかり副作用を混入」という事故が起きません。
|
|
849
|
-
|
|
850
|
-
### Rust: ゼロコスト抽象化の async/await
|
|
851
|
-
|
|
852
|
-
Rust の `async fn` はコンパイル時にステートマシンに変換され、ランタイムオーバーヘッドがゼロです:
|
|
853
|
-
|
|
854
|
-
```rust
|
|
855
|
-
// コンパイル後、ヒープ割り当てなしのステートマシンに変換
|
|
856
|
-
pub async fn scheduled_meetings(person1: &str, person2: &str) -> Vec<MeetingTime> {
|
|
857
|
-
let entries1 = calendar_entries(person1).await;
|
|
858
|
-
let entries2 = calendar_entries(person2).await;
|
|
859
|
-
[entries1, entries2].concat()
|
|
860
|
-
}
|
|
861
|
-
```
|
|
862
|
-
|
|
863
|
-
### TypeScript: IO / Task / TaskEither の 3 層
|
|
864
|
-
|
|
865
|
-
fp-ts は同期・非同期・エラー付き非同期の 3 つの IO 型を提供します:
|
|
866
|
-
|
|
867
|
-
```typescript
|
|
868
|
-
import * as IO from 'fp-ts/IO' // 同期 IO
|
|
869
|
-
import * as T from 'fp-ts/Task' // 非同期 IO(成功のみ)
|
|
870
|
-
import * as TE from 'fp-ts/TaskEither' // 非同期 IO(エラーあり)
|
|
871
|
-
|
|
872
|
-
// IO<A>: () => A
|
|
873
|
-
// Task<A>: () => Promise<A>
|
|
874
|
-
// TaskEither<E, A>: () => Promise<Either<E, A>>
|
|
875
|
-
```
|
|
876
|
-
|
|
877
|
-
### Clojure: 複数プリミティブの使い分け
|
|
878
|
-
|
|
879
|
-
Clojure は単一の IO 型ではなく、用途別のプリミティブを使い分けます:
|
|
880
|
-
|
|
881
|
-
```clojure
|
|
882
|
-
;; delay: 遅延評価(キャッシュあり)
|
|
883
|
-
(def lazy-val (delay (expensive-computation)))
|
|
884
|
-
|
|
885
|
-
;; atom: 状態管理(同期的な更新)
|
|
886
|
-
(def state (atom {:count 0}))
|
|
887
|
-
(swap! state update :count inc)
|
|
888
|
-
|
|
889
|
-
;; future: 非同期計算(別スレッド)
|
|
890
|
-
(def async-result (future (api-call)))
|
|
891
|
-
@async-result ; 結果を待つ
|
|
892
|
-
```
|
|
893
|
-
|
|
894
|
-
### Elixir: OTP プロセスとの統合
|
|
895
|
-
|
|
896
|
-
Elixir は無名関数に加え、`Agent` と `Task` で状態管理と非同期処理を OTP の軽量プロセスで実現します:
|
|
897
|
-
|
|
898
|
-
```elixir
|
|
899
|
-
# Agent: 状態管理(プロセス内)
|
|
900
|
-
{:ok, agent} = Agent.start_link(fn -> %{} end)
|
|
901
|
-
Agent.update(agent, fn state -> Map.put(state, :key, "value") end)
|
|
902
|
-
|
|
903
|
-
# Task: 非同期処理(並行プロセス)
|
|
904
|
-
task = Task.async(fn -> expensive_computation() end)
|
|
905
|
-
result = Task.await(task)
|
|
906
|
-
```
|
|
907
|
-
|
|
908
|
-
---
|
|
909
|
-
|
|
910
|
-
## 8.10 実践的な選択指針
|
|
911
|
-
|
|
912
|
-
### IO の抽象化レベルの選択
|
|
913
|
-
|
|
914
|
-
| 要件 | 推奨言語 | 理由 |
|
|
915
|
-
|------|---------|------|
|
|
916
|
-
| 最も厳格な純粋性保証 | Haskell | 型レベルで IO と純粋関数を分離 |
|
|
917
|
-
| 高性能な非同期処理 | Rust | ゼロコスト抽象化の async/await |
|
|
918
|
-
| JVM でのエフェクト管理 | Scala + cats-effect | 成熟した IO ライブラリ |
|
|
919
|
-
| .NET での非同期処理 | F# (Async) / C# (Task) | コンピュテーション式 / async-await |
|
|
920
|
-
| フロントエンドでの型安全 IO | TypeScript + fp-ts | IO / Task / TaskEither の 3 層 |
|
|
921
|
-
| 分散システム | Elixir | OTP の軽量プロセスモデル |
|
|
922
|
-
| 並行状態管理 | Clojure | atom / ref / STM |
|
|
923
|
-
|
|
924
|
-
### プロジェクト規模別の推奨
|
|
925
|
-
|
|
926
|
-
| 規模 | 推奨アプローチ | 言語例 |
|
|
927
|
-
|------|-------------|-------|
|
|
928
|
-
| 小規模 | Pure Core / Impure Shell の慣習的分離 | Python, Ruby, Java |
|
|
929
|
-
| 中規模 | エフェクトライブラリの導入 | Scala (cats-effect), TypeScript (fp-ts) |
|
|
930
|
-
| 大規模 | 言語レベルの IO 分離 | Haskell, F# |
|
|
931
|
-
|
|
932
|
-
---
|
|
933
|
-
|
|
934
|
-
## 8.11 まとめ
|
|
935
|
-
|
|
936
|
-
本章では、11 言語での IO モナドと副作用の分離を比較し、以下を確認しました:
|
|
937
|
-
|
|
938
|
-
**共通の原則**:
|
|
939
|
-
|
|
940
|
-
- IO = 副作用の「記述」と「実行」の分離
|
|
941
|
-
- flatMap / bind / chain による IO の合成
|
|
942
|
-
- Pure Core / Impure Shell パターンはすべての言語で有効
|
|
943
|
-
|
|
944
|
-
**言語間の差異**:
|
|
945
|
-
|
|
946
|
-
- 抽象化レベルは 4 段階(言語組み込み → ライブラリ → 非同期プリミティブ → 慣習的分離)
|
|
947
|
-
- 合成構文は 3 系統(モナド内包表記 / async-await / 明示的チェーン)
|
|
948
|
-
- Haskell のみが型レベルで純粋性を保証
|
|
949
|
-
|
|
950
|
-
**学び**:
|
|
951
|
-
|
|
952
|
-
- 副作用の管理は「型で表現する」か「慣習で分離する」かの選択
|
|
953
|
-
- async/await は IO モナドの脱糖と本質的に同じ
|
|
954
|
-
- エラーハンドリングとリトライは IO の合成で自然に表現できる
|
|
955
|
-
|
|
956
|
-
---
|
|
957
|
-
|
|
958
|
-
### 各言語の詳細記事
|
|
959
|
-
|
|
960
|
-
| 言語 | 記事リンク |
|
|
961
|
-
|------|-----------|
|
|
962
|
-
| Scala | [Part IV: IO と副作用の管理](../scala/part-4.md) |
|
|
963
|
-
| Java | [Part IV: IO と副作用の管理](../java/part-4.md) |
|
|
964
|
-
| F# | [Part IV: 非同期処理とストリーム](../fsharp/part-4.md) |
|
|
965
|
-
| C# | [Part IV: 非同期処理とストリーム](../csharp/part-4.md) |
|
|
966
|
-
| Haskell | [Part IV: IO と副作用の管理](../haskell/part-4.md) |
|
|
967
|
-
| Clojure | [Part IV: 状態管理とストリーム処理](../clojure/part-4.md) |
|
|
968
|
-
| Elixir | [Part IV: IO とストリーム処理](../elixir/part-4.md) |
|
|
969
|
-
| Rust | [Part IV: 非同期処理とストリーム](../rust/part-4.md) |
|
|
970
|
-
| Python | [Part IV: IO と副作用の管理](../python/part-4.md) |
|
|
971
|
-
| TypeScript | [Part IV: IO と副作用の管理](../typescript/part-4.md) |
|
|
972
|
-
| Ruby | [Part IV: IO と副作用の管理](../ruby/part-4.md) |
|
|
1
|
+
# Part IV - 第 8 章:IO モナドと副作用の分離
|
|
2
|
+
|
|
3
|
+
## 8.1 はじめに:副作用の問題
|
|
4
|
+
|
|
5
|
+
純粋関数は同じ入力に対して常に同じ出力を返し、外部の状態を変更しません。しかし、実際のプログラムには副作用が不可欠です:
|
|
6
|
+
|
|
7
|
+
- ファイルの読み書き
|
|
8
|
+
- ネットワーク通信
|
|
9
|
+
- データベースアクセス
|
|
10
|
+
- 乱数生成
|
|
11
|
+
- 現在時刻の取得
|
|
12
|
+
|
|
13
|
+
関数型プログラミングの核心的な問いは「副作用をどう管理するか」です。本章では、11 言語がこの問いにどう答えるかを横断的に比較し、以下を明らかにします:
|
|
14
|
+
|
|
15
|
+
- IO の抽象化レベルの違い(言語組み込み vs ライブラリ vs 慣習的分離)
|
|
16
|
+
- 「記述」と「実行」を分離する共通パターン
|
|
17
|
+
- IO の合成方法と糖衣構文の言語間差異
|
|
18
|
+
|
|
19
|
+
```plantuml
|
|
20
|
+
@startuml
|
|
21
|
+
!theme plain
|
|
22
|
+
|
|
23
|
+
rectangle "副作用の管理" {
|
|
24
|
+
card "不純な関数" as impure #LightCoral
|
|
25
|
+
card "IO 型(記述)" as io #LightGreen
|
|
26
|
+
card "実行(interpret)" as run #LightBlue
|
|
27
|
+
|
|
28
|
+
impure --> io : 副作用をラップ
|
|
29
|
+
io --> run : 明示的に実行
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
note bottom of io
|
|
33
|
+
IO 値を作成しただけでは
|
|
34
|
+
副作用は発生しない
|
|
35
|
+
end note
|
|
36
|
+
|
|
37
|
+
@enduml
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## 8.2 共通の本質:記述と実行の分離
|
|
43
|
+
|
|
44
|
+
11 言語すべてに共通する IO の原則は、**副作用の「記述」と「実行」を分離する**ことです:
|
|
45
|
+
|
|
46
|
+
1. **記述(Description)**: 副作用を持つ計算を「値」として表現する
|
|
47
|
+
2. **合成(Composition)**: IO 値を flatMap / bind / chain で組み合わせる
|
|
48
|
+
3. **実行(Interpretation)**: プログラムの端(main / エントリーポイント)で一度だけ実行する
|
|
49
|
+
|
|
50
|
+
3 つの言語グループから代表例を見てみましょう:
|
|
51
|
+
|
|
52
|
+
```haskell
|
|
53
|
+
-- Haskell: IO モナド(言語組み込み)
|
|
54
|
+
castTheDie :: IO Int
|
|
55
|
+
castTheDie = randomRIO (1, 6)
|
|
56
|
+
|
|
57
|
+
-- do 記法で合成
|
|
58
|
+
castTheDieTwice :: IO Int
|
|
59
|
+
castTheDieTwice = do
|
|
60
|
+
first <- castTheDie
|
|
61
|
+
second <- castTheDie
|
|
62
|
+
return (first + second)
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
```scala
|
|
66
|
+
// Scala: cats-effect IO(ライブラリ)
|
|
67
|
+
def castTheDie(): IO[Int] = IO.delay(random.nextInt(6) + 1)
|
|
68
|
+
|
|
69
|
+
// for 内包表記で合成
|
|
70
|
+
def castTheDieTwice(): IO[Int] =
|
|
71
|
+
for {
|
|
72
|
+
first <- castTheDie()
|
|
73
|
+
second <- castTheDie()
|
|
74
|
+
} yield first + second
|
|
75
|
+
|
|
76
|
+
// 明示的に実行(unsafeRunSync)
|
|
77
|
+
castTheDieTwice().unsafeRunSync()
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
```python
|
|
81
|
+
# Python: カスタム LazyIO クラス
|
|
82
|
+
def cast_the_die() -> LazyIO[int]:
|
|
83
|
+
return LazyIO(lambda: random.randint(1, 6))
|
|
84
|
+
|
|
85
|
+
# bind/map で合成
|
|
86
|
+
def cast_the_die_twice() -> LazyIO[int]:
|
|
87
|
+
return cast_the_die().bind(
|
|
88
|
+
lambda first: cast_the_die().map(lambda second: first + second)
|
|
89
|
+
)
|
|
90
|
+
|
|
91
|
+
# 明示的に実行
|
|
92
|
+
cast_the_die_twice().run()
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## 8.3 IO の実装方式
|
|
98
|
+
|
|
99
|
+
### アプローチ 1: 言語組み込み IO
|
|
100
|
+
|
|
101
|
+
| 言語 | IO 型 | 実行方法 | 特徴 |
|
|
102
|
+
|------|-------|---------|------|
|
|
103
|
+
| **Haskell** | `IO a` | `main` 関数 | 言語レベルで純粋性を強制 |
|
|
104
|
+
|
|
105
|
+
Haskell は唯一、IO を**言語レベル**で強制する言語です。`IO` 型を持たない関数は副作用を起こせません。
|
|
106
|
+
|
|
107
|
+
### アプローチ 2: エフェクトライブラリ
|
|
108
|
+
|
|
109
|
+
| 言語 | ライブラリ | IO 型 | 実行方法 |
|
|
110
|
+
|------|-----------|-------|---------|
|
|
111
|
+
| **Scala** | cats-effect | `IO[A]` | `unsafeRunSync()` |
|
|
112
|
+
| **TypeScript** | fp-ts | `IO<A>` / `Task<A>` | `io()` / `task()` |
|
|
113
|
+
| **Java** | 独自実装 | `IO<A>` | `unsafeRun()` |
|
|
114
|
+
| **Python** | 独自実装 | `LazyIO[A]` | `run()` |
|
|
115
|
+
| **Ruby** | 独自実装 | `IO` | `run!` |
|
|
116
|
+
|
|
117
|
+
### アプローチ 3: 言語固有の非同期プリミティブ
|
|
118
|
+
|
|
119
|
+
| 言語 | プリミティブ | 実行方法 | 特徴 |
|
|
120
|
+
|------|-----------|---------|------|
|
|
121
|
+
| **F#** | `Async<'a>` | `Async.RunSynchronously` | コンピュテーション式 |
|
|
122
|
+
| **C#** | `Task<T>` | `await` / `GetResult()` | async/await |
|
|
123
|
+
| **Rust** | `Future<Output=T>` | `.await` + tokio ランタイム | ゼロコスト抽象化 |
|
|
124
|
+
|
|
125
|
+
### アプローチ 4: 実用的プリミティブ
|
|
126
|
+
|
|
127
|
+
| 言語 | プリミティブ | 特徴 |
|
|
128
|
+
|------|-----------|------|
|
|
129
|
+
| **Clojure** | `delay` / `atom` / `future` | 複数のプリミティブを使い分け |
|
|
130
|
+
| **Elixir** | 無名関数 + `Agent` / `Task` | OTP の軽量プロセスと組み合わせ |
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## 8.4 サイコロを振る:IO の基本パターン
|
|
135
|
+
|
|
136
|
+
最もシンプルな IO の例として、サイコロを振る関数を 11 言語で比較します。
|
|
137
|
+
|
|
138
|
+
### 代表 3 言語の比較
|
|
139
|
+
|
|
140
|
+
**Haskell**: `randomRIO` が直接 `IO Int` を返す
|
|
141
|
+
|
|
142
|
+
```haskell
|
|
143
|
+
import System.Random (randomRIO)
|
|
144
|
+
|
|
145
|
+
castTheDie :: IO Int
|
|
146
|
+
castTheDie = randomRIO (1, 6)
|
|
147
|
+
|
|
148
|
+
castTheDieTwice :: IO Int
|
|
149
|
+
castTheDieTwice = do
|
|
150
|
+
first <- castTheDie
|
|
151
|
+
second <- castTheDie
|
|
152
|
+
return (first + second)
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
**Scala**: `IO.delay` で不純な関数をラップ
|
|
156
|
+
|
|
157
|
+
```scala
|
|
158
|
+
import cats.effect.IO
|
|
159
|
+
|
|
160
|
+
def castTheDie(): IO[Int] = IO.delay(random.nextInt(6) + 1)
|
|
161
|
+
|
|
162
|
+
def castTheDieTwice(): IO[Int] =
|
|
163
|
+
for {
|
|
164
|
+
first <- castTheDie()
|
|
165
|
+
second <- castTheDie()
|
|
166
|
+
} yield first + second
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
**Rust**: `async fn` が `Future` を返す
|
|
170
|
+
|
|
171
|
+
```rust
|
|
172
|
+
pub async fn cast_the_die() -> i32 {
|
|
173
|
+
cast_the_die_impure()
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
pub async fn cast_the_die_twice() -> i32 {
|
|
177
|
+
let first = cast_the_die().await;
|
|
178
|
+
let second = cast_the_die().await;
|
|
179
|
+
first + second
|
|
180
|
+
}
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
### 全 11 言語の実装
|
|
184
|
+
|
|
185
|
+
#### 関数型ファースト言語
|
|
186
|
+
|
|
187
|
+
<details>
|
|
188
|
+
<summary>Haskell 実装</summary>
|
|
189
|
+
|
|
190
|
+
```haskell
|
|
191
|
+
import System.Random (randomRIO)
|
|
192
|
+
|
|
193
|
+
castTheDie :: IO Int
|
|
194
|
+
castTheDie = randomRIO (1, 6)
|
|
195
|
+
|
|
196
|
+
castTheDieTwice :: IO Int
|
|
197
|
+
castTheDieTwice = do
|
|
198
|
+
first <- castTheDie
|
|
199
|
+
second <- castTheDie
|
|
200
|
+
return (first + second)
|
|
201
|
+
|
|
202
|
+
-- replicateM で n 回繰り返し
|
|
203
|
+
castTheDieN :: Int -> IO [Int]
|
|
204
|
+
castTheDieN n = replicateM n castTheDie
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
Haskell では `randomRIO` 自体が `IO Int` を返します。副作用のある関数は必ず `IO` 型を持ち、純粋関数との分離が**言語レベルで強制**されます。
|
|
208
|
+
|
|
209
|
+
</details>
|
|
210
|
+
|
|
211
|
+
<details>
|
|
212
|
+
<summary>Clojure 実装</summary>
|
|
213
|
+
|
|
214
|
+
```clojure
|
|
215
|
+
(defn cast-the-die-impure!
|
|
216
|
+
"サイコロを振る(不純)"
|
|
217
|
+
[]
|
|
218
|
+
(inc (rand-int 6)))
|
|
219
|
+
|
|
220
|
+
;; delay で遅延評価
|
|
221
|
+
(defn cast-the-die []
|
|
222
|
+
(delay (cast-the-die-impure!)))
|
|
223
|
+
|
|
224
|
+
;; force で実行
|
|
225
|
+
(force (cast-the-die)) ; => 4
|
|
226
|
+
|
|
227
|
+
;; atom で状態管理
|
|
228
|
+
(def game-state (atom {:rolls [] :total 0}))
|
|
229
|
+
|
|
230
|
+
(defn roll-die! []
|
|
231
|
+
(let [roll (cast-the-die-impure!)]
|
|
232
|
+
(swap! game-state
|
|
233
|
+
(fn [state]
|
|
234
|
+
(-> state
|
|
235
|
+
(update :rolls conj roll)
|
|
236
|
+
(update :total + roll))))
|
|
237
|
+
roll))
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
Clojure は IO モナドを使わず、`delay` / `atom` / `future` という実用的なプリミティブで副作用を管理します。`delay` は一度だけ評価されキャッシュされる点に注意してください。
|
|
241
|
+
|
|
242
|
+
</details>
|
|
243
|
+
|
|
244
|
+
<details>
|
|
245
|
+
<summary>Elixir 実装</summary>
|
|
246
|
+
|
|
247
|
+
```elixir
|
|
248
|
+
def cast_the_die_impure do
|
|
249
|
+
:rand.uniform(6)
|
|
250
|
+
end
|
|
251
|
+
|
|
252
|
+
# 無名関数で遅延実行
|
|
253
|
+
@spec delay((-> any())) :: (-> any())
|
|
254
|
+
def delay(f) when is_function(f, 0), do: f
|
|
255
|
+
|
|
256
|
+
@spec run((-> any())) :: any()
|
|
257
|
+
def run(f) when is_function(f, 0), do: f.()
|
|
258
|
+
|
|
259
|
+
def cast_the_die do
|
|
260
|
+
delay(fn -> cast_the_die_impure() end)
|
|
261
|
+
end
|
|
262
|
+
|
|
263
|
+
# flat_map で合成
|
|
264
|
+
def cast_the_die_twice do
|
|
265
|
+
flat_map(cast_the_die(), fn first ->
|
|
266
|
+
map(cast_the_die(), fn second ->
|
|
267
|
+
first + second
|
|
268
|
+
end)
|
|
269
|
+
end)
|
|
270
|
+
end
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
Elixir は無名関数 `fn -> ... end` で副作用を遅延実行します。Scala の `IO.delay` に相当する `delay/1` と `run/1` を自前で定義します。
|
|
274
|
+
|
|
275
|
+
</details>
|
|
276
|
+
|
|
277
|
+
<details>
|
|
278
|
+
<summary>F# 実装</summary>
|
|
279
|
+
|
|
280
|
+
```fsharp
|
|
281
|
+
let castTheDie () : Async<int> =
|
|
282
|
+
async { return (Random()).Next(1, 7) }
|
|
283
|
+
|
|
284
|
+
let castTheDieTwice () : Async<int> =
|
|
285
|
+
async {
|
|
286
|
+
let! firstCast = castTheDie ()
|
|
287
|
+
let! secondCast = castTheDie ()
|
|
288
|
+
return firstCast + secondCast
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
// 実行
|
|
292
|
+
let result = Async.RunSynchronously (castTheDieTwice ())
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
F# の `async { }` コンピュテーション式は Haskell の do 記法に相当します。`let!` でバインドし、`return` で値をラップします。
|
|
296
|
+
|
|
297
|
+
</details>
|
|
298
|
+
|
|
299
|
+
#### マルチパラダイム言語
|
|
300
|
+
|
|
301
|
+
<details>
|
|
302
|
+
<summary>Scala 実装</summary>
|
|
303
|
+
|
|
304
|
+
```scala
|
|
305
|
+
import cats.effect.IO
|
|
306
|
+
|
|
307
|
+
def castTheDie(): IO[Int] = IO.delay(random.nextInt(6) + 1)
|
|
308
|
+
|
|
309
|
+
def castTheDieTwice(): IO[Int] =
|
|
310
|
+
for {
|
|
311
|
+
first <- castTheDie()
|
|
312
|
+
second <- castTheDie()
|
|
313
|
+
} yield first + second
|
|
314
|
+
|
|
315
|
+
// IO.pure: 副作用なし
|
|
316
|
+
val pureValue: IO[Int] = IO.pure(42)
|
|
317
|
+
|
|
318
|
+
// 実行
|
|
319
|
+
castTheDieTwice().unsafeRunSync()
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
</details>
|
|
323
|
+
|
|
324
|
+
<details>
|
|
325
|
+
<summary>Rust 実装</summary>
|
|
326
|
+
|
|
327
|
+
```rust
|
|
328
|
+
pub async fn cast_the_die() -> i32 {
|
|
329
|
+
use std::time::{SystemTime, UNIX_EPOCH};
|
|
330
|
+
let nanos = SystemTime::now()
|
|
331
|
+
.duration_since(UNIX_EPOCH)
|
|
332
|
+
.unwrap()
|
|
333
|
+
.subsec_nanos();
|
|
334
|
+
(nanos % 6) as i32 + 1
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
pub async fn cast_the_die_twice() -> i32 {
|
|
338
|
+
let first = cast_the_die().await;
|
|
339
|
+
let second = cast_the_die().await;
|
|
340
|
+
first + second
|
|
341
|
+
}
|
|
342
|
+
```
|
|
343
|
+
|
|
344
|
+
Rust の `async fn` は `Future` を返します。`.await` されるまで実行されない点が IO モナドと共通しています。
|
|
345
|
+
|
|
346
|
+
</details>
|
|
347
|
+
|
|
348
|
+
<details>
|
|
349
|
+
<summary>TypeScript (fp-ts) 実装</summary>
|
|
350
|
+
|
|
351
|
+
```typescript
|
|
352
|
+
import * as IO from 'fp-ts/IO'
|
|
353
|
+
import { pipe } from 'fp-ts/function'
|
|
354
|
+
|
|
355
|
+
const castTheDie: IO.IO<number> = () => Math.floor(Math.random() * 6) + 1
|
|
356
|
+
|
|
357
|
+
const castTheDieTwice: IO.IO<number> = pipe(
|
|
358
|
+
castTheDie,
|
|
359
|
+
IO.chain((first) =>
|
|
360
|
+
pipe(
|
|
361
|
+
castTheDie,
|
|
362
|
+
IO.map((second) => first + second)
|
|
363
|
+
)
|
|
364
|
+
)
|
|
365
|
+
)
|
|
366
|
+
|
|
367
|
+
// 実行
|
|
368
|
+
castTheDieTwice() // 2〜12 の値
|
|
369
|
+
```
|
|
370
|
+
|
|
371
|
+
fp-ts の `IO<A>` は `() => A` 型のエイリアスです。`chain`(= flatMap)と `map` で合成し、`()` で実行します。
|
|
372
|
+
|
|
373
|
+
</details>
|
|
374
|
+
|
|
375
|
+
#### OOP + FP ライブラリ言語
|
|
376
|
+
|
|
377
|
+
<details>
|
|
378
|
+
<summary>Java 実装</summary>
|
|
379
|
+
|
|
380
|
+
```java
|
|
381
|
+
public final class IO<A> {
|
|
382
|
+
private final Supplier<A> thunk;
|
|
383
|
+
|
|
384
|
+
private IO(Supplier<A> thunk) { this.thunk = thunk; }
|
|
385
|
+
|
|
386
|
+
public static <A> IO<A> delay(Supplier<A> supplier) {
|
|
387
|
+
return new IO<>(supplier);
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
public static <A> IO<A> pure(A value) {
|
|
391
|
+
return new IO<>(() -> value);
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
public A unsafeRun() { return thunk.get(); }
|
|
395
|
+
|
|
396
|
+
public <B> IO<B> map(Function<A, B> f) {
|
|
397
|
+
return new IO<>(() -> f.apply(thunk.get()));
|
|
398
|
+
}
|
|
399
|
+
|
|
400
|
+
public <B> IO<B> flatMap(Function<A, IO<B>> f) {
|
|
401
|
+
return new IO<>(() -> f.apply(thunk.get()).unsafeRun());
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
|
|
405
|
+
// 使用例
|
|
406
|
+
public static IO<Integer> castTheDie() {
|
|
407
|
+
return IO.delay(() -> random.nextInt(6) + 1);
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
public static IO<Integer> castTheDieTwice() {
|
|
411
|
+
return castTheDie()
|
|
412
|
+
.flatMap(first -> castTheDie()
|
|
413
|
+
.map(second -> first + second));
|
|
414
|
+
}
|
|
415
|
+
```
|
|
416
|
+
|
|
417
|
+
Java には IO ライブラリがないため、`Supplier<A>` ベースの IO クラスを自前で実装します。
|
|
418
|
+
|
|
419
|
+
</details>
|
|
420
|
+
|
|
421
|
+
<details>
|
|
422
|
+
<summary>C# 実装</summary>
|
|
423
|
+
|
|
424
|
+
```csharp
|
|
425
|
+
public static Task<int> CastTheDie() =>
|
|
426
|
+
Task.Run(() => new Random().Next(1, 7));
|
|
427
|
+
|
|
428
|
+
public static async Task<int> CastTheDieTwice()
|
|
429
|
+
{
|
|
430
|
+
var first = await CastTheDie();
|
|
431
|
+
var second = await CastTheDie();
|
|
432
|
+
return first + second;
|
|
433
|
+
}
|
|
434
|
+
|
|
435
|
+
// 実行
|
|
436
|
+
await CastTheDieTwice();
|
|
437
|
+
```
|
|
438
|
+
|
|
439
|
+
C# は `Task<T>` と `async/await` で副作用を管理します。Rust と同様に言語組み込みの非同期プリミティブを使います。
|
|
440
|
+
|
|
441
|
+
</details>
|
|
442
|
+
|
|
443
|
+
<details>
|
|
444
|
+
<summary>Python 実装</summary>
|
|
445
|
+
|
|
446
|
+
```python
|
|
447
|
+
class LazyIO(Generic[T]):
|
|
448
|
+
def __init__(self, effect: Callable[[], T]) -> None:
|
|
449
|
+
self._effect = effect
|
|
450
|
+
|
|
451
|
+
def run(self) -> T:
|
|
452
|
+
return self._effect()
|
|
453
|
+
|
|
454
|
+
def map(self, f: Callable[[T], U]) -> "LazyIO[U]":
|
|
455
|
+
return LazyIO(lambda: f(self.run()))
|
|
456
|
+
|
|
457
|
+
def bind(self, f: Callable[[T], "LazyIO[U]"]) -> "LazyIO[U]":
|
|
458
|
+
return LazyIO(lambda: f(self.run()).run())
|
|
459
|
+
|
|
460
|
+
# 使用例
|
|
461
|
+
def cast_the_die() -> LazyIO[int]:
|
|
462
|
+
return LazyIO(lambda: random.randint(1, 6))
|
|
463
|
+
|
|
464
|
+
def cast_the_die_twice() -> LazyIO[int]:
|
|
465
|
+
return cast_the_die().bind(
|
|
466
|
+
lambda first: cast_the_die().map(lambda second: first + second)
|
|
467
|
+
)
|
|
468
|
+
```
|
|
469
|
+
|
|
470
|
+
Python では Java と同様にカスタムの `LazyIO` クラスを実装します。ラムダ式で副作用を遅延評価し、`run()` で実行します。
|
|
471
|
+
|
|
472
|
+
</details>
|
|
473
|
+
|
|
474
|
+
<details>
|
|
475
|
+
<summary>Ruby 実装</summary>
|
|
476
|
+
|
|
477
|
+
```ruby
|
|
478
|
+
class IO
|
|
479
|
+
def initialize(&computation)
|
|
480
|
+
@computation = computation
|
|
481
|
+
end
|
|
482
|
+
|
|
483
|
+
def self.delay(&block) = new(&block)
|
|
484
|
+
def self.pure(value) = new { value }
|
|
485
|
+
|
|
486
|
+
def run! = @computation.call
|
|
487
|
+
|
|
488
|
+
def fmap(&f) = IO.new { f.call(run!) }
|
|
489
|
+
def bind(&f) = IO.new { f.call(run!).run! }
|
|
490
|
+
end
|
|
491
|
+
|
|
492
|
+
# 使用例
|
|
493
|
+
def cast_the_die
|
|
494
|
+
IO.delay { rand(1..6) }
|
|
495
|
+
end
|
|
496
|
+
|
|
497
|
+
def cast_the_die_twice
|
|
498
|
+
cast_the_die.bind do |first|
|
|
499
|
+
cast_the_die.fmap { |second| first + second }
|
|
500
|
+
end
|
|
501
|
+
end
|
|
502
|
+
```
|
|
503
|
+
|
|
504
|
+
Ruby もカスタム IO クラスで実装します。ブロック構文によりネストが比較的読みやすくなっています。
|
|
505
|
+
|
|
506
|
+
</details>
|
|
507
|
+
|
|
508
|
+
---
|
|
509
|
+
|
|
510
|
+
## 8.5 IO の合成構文比較
|
|
511
|
+
|
|
512
|
+
IO の合成は flatMap / bind の連鎖です。各言語の糖衣構文を比較します。
|
|
513
|
+
|
|
514
|
+
### 合成構文一覧
|
|
515
|
+
|
|
516
|
+
| 言語 | 構文 | バインド | 例 |
|
|
517
|
+
|------|------|---------|-----|
|
|
518
|
+
| **Haskell** | do 記法 | `<-` | `do { x <- io; return x }` |
|
|
519
|
+
| **Scala** | for 内包表記 | `<-` | `for { x <- io } yield x` |
|
|
520
|
+
| **F#** | async { } | `let!` | `async { let! x = io; return x }` |
|
|
521
|
+
| **C#** | async/await | `await` | `async { var x = await io; return x; }` |
|
|
522
|
+
| **Rust** | async/await | `.await` | `async { let x = io.await; x }` |
|
|
523
|
+
| **TypeScript** | pipe + chain | `chain` | `pipe(io, IO.chain(x => ...))` |
|
|
524
|
+
| **Elixir** | flat_map | `flat_map` | `flat_map(io, fn x -> ... end)` |
|
|
525
|
+
| **Java** | flatMap chain | `.flatMap` | `io.flatMap(x -> ...)` |
|
|
526
|
+
| **Python** | bind chain | `.bind` | `io.bind(lambda x: ...)` |
|
|
527
|
+
| **Ruby** | bind block | `.bind` | `io.bind { \|x\| ... }` |
|
|
528
|
+
| **Clojure** | delay + force | 手動 | `(force (delay ...))` |
|
|
529
|
+
|
|
530
|
+
### 可読性の比較
|
|
531
|
+
|
|
532
|
+
**糖衣構文あり**(手続き的に読める):
|
|
533
|
+
|
|
534
|
+
```haskell
|
|
535
|
+
-- Haskell: do 記法
|
|
536
|
+
scheduledMeetings person1 person2 = do
|
|
537
|
+
entries1 <- calendarEntries person1
|
|
538
|
+
entries2 <- calendarEntries person2
|
|
539
|
+
return (entries1 ++ entries2)
|
|
540
|
+
```
|
|
541
|
+
|
|
542
|
+
```fsharp
|
|
543
|
+
// F#: async { } コンピュテーション式
|
|
544
|
+
let scheduledMeetings person1 person2 =
|
|
545
|
+
async {
|
|
546
|
+
let! entries1 = calendarEntries person1
|
|
547
|
+
let! entries2 = calendarEntries person2
|
|
548
|
+
return entries1 @ entries2
|
|
549
|
+
}
|
|
550
|
+
```
|
|
551
|
+
|
|
552
|
+
```csharp
|
|
553
|
+
// C#: async/await
|
|
554
|
+
public static async Task<Seq<MeetingTime>> ScheduledMeetings(
|
|
555
|
+
string person1, string person2)
|
|
556
|
+
{
|
|
557
|
+
var entries1 = await CalendarEntries(person1);
|
|
558
|
+
var entries2 = await CalendarEntries(person2);
|
|
559
|
+
return entries1.Concat(entries2);
|
|
560
|
+
}
|
|
561
|
+
```
|
|
562
|
+
|
|
563
|
+
**糖衣構文なし**(ラムダのネストが必要):
|
|
564
|
+
|
|
565
|
+
```java
|
|
566
|
+
// Java: flatMap チェーン
|
|
567
|
+
public static IO<List<MeetingTime>> scheduledMeetings(
|
|
568
|
+
String person1, String person2) {
|
|
569
|
+
return calendarEntries(person1).flatMap(entries1 ->
|
|
570
|
+
calendarEntries(person2).map(entries2 ->
|
|
571
|
+
entries1.appendedAll(entries2)));
|
|
572
|
+
}
|
|
573
|
+
```
|
|
574
|
+
|
|
575
|
+
---
|
|
576
|
+
|
|
577
|
+
## 8.6 エラーハンドリングとリトライ
|
|
578
|
+
|
|
579
|
+
IO は失敗する可能性があります。各言語のエラーハンドリングとリトライ戦略を比較します。
|
|
580
|
+
|
|
581
|
+
### orElse によるフォールバック
|
|
582
|
+
|
|
583
|
+
```scala
|
|
584
|
+
// Scala: orElse
|
|
585
|
+
val year: IO[Int] = IO.delay(996)
|
|
586
|
+
val noYear: IO[Int] = IO.delay(throw new Exception("no year"))
|
|
587
|
+
|
|
588
|
+
year.orElse(IO.delay(2020)).unsafeRunSync() // 996
|
|
589
|
+
noYear.orElse(IO.delay(2020)).unsafeRunSync() // 2020
|
|
590
|
+
```
|
|
591
|
+
|
|
592
|
+
### リトライ戦略の比較
|
|
593
|
+
|
|
594
|
+
#### 代表 3 言語
|
|
595
|
+
|
|
596
|
+
**Scala**: orElse の fold
|
|
597
|
+
|
|
598
|
+
```scala
|
|
599
|
+
def retry[A](action: IO[A], maxRetries: Int): IO[A] =
|
|
600
|
+
List.range(0, maxRetries)
|
|
601
|
+
.map(_ => action)
|
|
602
|
+
.foldLeft(action)((program, retryAction) =>
|
|
603
|
+
program.orElse(retryAction))
|
|
604
|
+
```
|
|
605
|
+
|
|
606
|
+
**Haskell**: 再帰 + try/catch
|
|
607
|
+
|
|
608
|
+
```haskell
|
|
609
|
+
retryIO :: Int -> IO a -> IO (Maybe a)
|
|
610
|
+
retryIO 0 _ = return Nothing
|
|
611
|
+
retryIO n action = do
|
|
612
|
+
result <- try action :: IO (Either SomeException a)
|
|
613
|
+
case result of
|
|
614
|
+
Right a -> return (Just a)
|
|
615
|
+
Left _ -> retryIO (n - 1) action
|
|
616
|
+
```
|
|
617
|
+
|
|
618
|
+
**Rust**: ジェネリック関数 + Result
|
|
619
|
+
|
|
620
|
+
```rust
|
|
621
|
+
pub async fn retry<T, E, F, Fut>(action: F, max_retries: usize) -> Result<T, E>
|
|
622
|
+
where
|
|
623
|
+
F: Fn() -> Fut,
|
|
624
|
+
Fut: Future<Output = Result<T, E>>,
|
|
625
|
+
{
|
|
626
|
+
let mut last_error = None;
|
|
627
|
+
for _ in 0..max_retries {
|
|
628
|
+
match action().await {
|
|
629
|
+
Ok(result) => return Ok(result),
|
|
630
|
+
Err(e) => last_error = Some(e),
|
|
631
|
+
}
|
|
632
|
+
}
|
|
633
|
+
Err(last_error.unwrap())
|
|
634
|
+
}
|
|
635
|
+
```
|
|
636
|
+
|
|
637
|
+
### 全 11 言語のエラーハンドリング比較
|
|
638
|
+
|
|
639
|
+
| 言語 | フォールバック | リトライ方式 | エラー型 |
|
|
640
|
+
|------|-------------|------------|---------|
|
|
641
|
+
| **Haskell** | `catch` / 手動 | 再帰 + `try` | `SomeException` |
|
|
642
|
+
| **Scala** | `IO.orElse` | fold / handleErrorWith | `Throwable` |
|
|
643
|
+
| **Rust** | `or_else` / `unwrap_or` | ループ + `Result` | `E` (ジェネリック) |
|
|
644
|
+
| **F#** | `try/with` + Async | Async.Catch | `exn` |
|
|
645
|
+
| **C#** | `try/catch` + Task | ループ + try/catch | `Exception` |
|
|
646
|
+
| **TypeScript** | `TaskEither` + `orElse` | pipe + orElse | `E` (ジェネリック) |
|
|
647
|
+
| **Java** | try/catch 内 IO | ループ + try/catch | `Exception` |
|
|
648
|
+
| **Python** | try/except 内 LazyIO | ループ + try/except | `Exception` |
|
|
649
|
+
| **Ruby** | `or_else` ブロック | ループ + rescue | `StandardError` |
|
|
650
|
+
| **Clojure** | `try/catch` | 再帰 + try/catch | Java 例外 |
|
|
651
|
+
| **Elixir** | `or_else` 関数 | 再帰 + rescue | `RuntimeError` |
|
|
652
|
+
|
|
653
|
+
---
|
|
654
|
+
|
|
655
|
+
## 8.7 sequence:IO のリスト変換
|
|
656
|
+
|
|
657
|
+
`List[IO[A]]` → `IO[List[A]]` の変換は、複数の IO を一つにまとめる重要なパターンです。
|
|
658
|
+
|
|
659
|
+
### 代表的な実装
|
|
660
|
+
|
|
661
|
+
```scala
|
|
662
|
+
// Scala: cats の sequence
|
|
663
|
+
import cats.implicits._
|
|
664
|
+
|
|
665
|
+
val actions: List[IO[Int]] = List(IO.pure(1), IO.pure(2), IO.pure(3))
|
|
666
|
+
val combined: IO[List[Int]] = actions.sequence
|
|
667
|
+
combined.unsafeRunSync() // List(1, 2, 3)
|
|
668
|
+
|
|
669
|
+
// 複数人の予定を取得
|
|
670
|
+
def scheduledMeetings(attendees: List[String]): IO[List[MeetingTime]] =
|
|
671
|
+
attendees
|
|
672
|
+
.map(attendee => retry(calendarEntries(attendee), 10))
|
|
673
|
+
.sequence
|
|
674
|
+
.map(_.flatten)
|
|
675
|
+
```
|
|
676
|
+
|
|
677
|
+
```haskell
|
|
678
|
+
-- Haskell: sequence(標準ライブラリ)
|
|
679
|
+
sequenceIO :: [IO a] -> IO [a]
|
|
680
|
+
sequenceIO [] = return []
|
|
681
|
+
sequenceIO (x:xs) = do
|
|
682
|
+
a <- x
|
|
683
|
+
as <- sequenceIO xs
|
|
684
|
+
return (a : as)
|
|
685
|
+
|
|
686
|
+
-- replicateM で n 回実行
|
|
687
|
+
castTheDieN :: Int -> IO [Int]
|
|
688
|
+
castTheDieN n = replicateM n castTheDie
|
|
689
|
+
```
|
|
690
|
+
|
|
691
|
+
```rust
|
|
692
|
+
// Rust: join_all で並行実行
|
|
693
|
+
pub async fn scheduled_meetings_for_all(attendees: &[&str]) -> Vec<MeetingTime> {
|
|
694
|
+
let futures: Vec<_> = attendees
|
|
695
|
+
.iter()
|
|
696
|
+
.map(|name| calendar_entries(name))
|
|
697
|
+
.collect();
|
|
698
|
+
|
|
699
|
+
let results = futures::future::join_all(futures).await;
|
|
700
|
+
results.into_iter().flatten().collect()
|
|
701
|
+
}
|
|
702
|
+
```
|
|
703
|
+
|
|
704
|
+
### 語彙比較
|
|
705
|
+
|
|
706
|
+
| 言語 | List[IO[A]] → IO[List[A]] | 並行実行 |
|
|
707
|
+
|------|--------------------------|---------|
|
|
708
|
+
| **Haskell** | `sequence` / `mapM` | `mapConcurrently` |
|
|
709
|
+
| **Scala** | `.sequence` (cats) | `parSequence` |
|
|
710
|
+
| **Rust** | `join_all` / `try_join_all` | `join_all`(デフォルト並行) |
|
|
711
|
+
| **F#** | `Async.Parallel` | `Async.Parallel`(デフォルト並行) |
|
|
712
|
+
| **C#** | `Task.WhenAll` | `Task.WhenAll`(デフォルト並行) |
|
|
713
|
+
| **TypeScript** | `array.sequence(T.task)` | `Promise.all` |
|
|
714
|
+
| **Java** | 手動 flatMap ループ | `CompletableFuture.allOf` |
|
|
715
|
+
| **Python** | 手動 bind ループ | `asyncio.gather` |
|
|
716
|
+
| **Ruby** | 手動 bind ループ | `Thread` / `Ractor` |
|
|
717
|
+
| **Clojure** | `(doall (map deref ...))` | `pmap` |
|
|
718
|
+
| **Elixir** | 手動 fold | `Task.async_stream` |
|
|
719
|
+
|
|
720
|
+
---
|
|
721
|
+
|
|
722
|
+
## 8.8 比較分析:3 つの発見
|
|
723
|
+
|
|
724
|
+
### 発見 1: IO の抽象化レベルは 4 段階に分かれる
|
|
725
|
+
|
|
726
|
+
```plantuml
|
|
727
|
+
@startuml
|
|
728
|
+
!theme plain
|
|
729
|
+
left to right direction
|
|
730
|
+
|
|
731
|
+
rectangle "Level 1: 言語組み込み IO" #LightGreen {
|
|
732
|
+
card "Haskell (IO モナド)" as h
|
|
733
|
+
}
|
|
734
|
+
|
|
735
|
+
rectangle "Level 2: エフェクトライブラリ" #LightBlue {
|
|
736
|
+
card "Scala (cats-effect IO)" as sc
|
|
737
|
+
card "TypeScript (fp-ts IO/Task)" as ts
|
|
738
|
+
}
|
|
739
|
+
|
|
740
|
+
rectangle "Level 3: 言語の非同期プリミティブ" #LightYellow {
|
|
741
|
+
card "F# (Async)" as fs
|
|
742
|
+
card "C# (Task)" as cs
|
|
743
|
+
card "Rust (Future / async)" as rs
|
|
744
|
+
}
|
|
745
|
+
|
|
746
|
+
rectangle "Level 4: 慣習的分離 / 自前実装" #LightCoral {
|
|
747
|
+
card "Java (カスタム IO)" as jv
|
|
748
|
+
card "Python (LazyIO)" as py
|
|
749
|
+
card "Ruby (カスタム IO)" as rb
|
|
750
|
+
card "Clojure (delay/atom)" as clj
|
|
751
|
+
card "Elixir (無名関数)" as ex
|
|
752
|
+
}
|
|
753
|
+
|
|
754
|
+
@enduml
|
|
755
|
+
```
|
|
756
|
+
|
|
757
|
+
**Level 1(Haskell)** は言語レベルで純粋性を保証します。IO 型を持たない関数は副作用を起こせないため、型シグネチャだけで純粋性がわかります。
|
|
758
|
+
|
|
759
|
+
**Level 2(Scala, TypeScript)** はライブラリが IO 型を提供し、`unsafeRunSync` / `io()` で実行を明示します。純粋性はライブラリの規約に依存します。
|
|
760
|
+
|
|
761
|
+
**Level 3(F#, C#, Rust)** は言語の非同期プリミティブ(`Async`, `Task`, `Future`)で副作用を遅延実行します。IO モナドとは異なりますが、「記述と実行の分離」を実現しています。
|
|
762
|
+
|
|
763
|
+
**Level 4(Java, Python, Ruby, Clojure, Elixir)** は標準的な IO 型がなく、カスタム実装または慣習的な分離に頼ります。
|
|
764
|
+
|
|
765
|
+
### 発見 2: 合成構文は 3 系統に分かれる
|
|
766
|
+
|
|
767
|
+
| 系統 | 構文 | 言語 | 可読性 |
|
|
768
|
+
|------|------|------|--------|
|
|
769
|
+
| **モナド内包表記** | do / for / async { } / LINQ | Haskell, Scala, F#, C# | 高(手続き的に読める) |
|
|
770
|
+
| **async/await** | async fn / await | C#, Rust, F# | 高(主流の構文) |
|
|
771
|
+
| **明示的チェーン** | flatMap / bind / chain | Java, Python, Ruby, TypeScript, Elixir, Clojure | 低〜中(ラムダのネスト) |
|
|
772
|
+
|
|
773
|
+
モナド内包表記と async/await は本質的に同じ脱糖を行います:
|
|
774
|
+
|
|
775
|
+
```
|
|
776
|
+
-- Haskell do 記法の脱糖
|
|
777
|
+
do { x <- io1; y <- io2; return (x + y) }
|
|
778
|
+
≡ io1 >>= \x -> io2 >>= \y -> return (x + y)
|
|
779
|
+
|
|
780
|
+
-- C# async/await の脱糖
|
|
781
|
+
async { var x = await task1; var y = await task2; return x + y; }
|
|
782
|
+
≡ task1.ContinueWith(x => task2.ContinueWith(y => x + y))
|
|
783
|
+
```
|
|
784
|
+
|
|
785
|
+
### 発見 3: 純粋コア / 不純シェルはすべての言語で有効
|
|
786
|
+
|
|
787
|
+
IO の抽象化レベルに関わらず、**Pure Core / Impure Shell** パターンはすべての言語で適用できます:
|
|
788
|
+
|
|
789
|
+
```plantuml
|
|
790
|
+
@startuml
|
|
791
|
+
!theme plain
|
|
792
|
+
|
|
793
|
+
rectangle "Pure Core / Impure Shell" {
|
|
794
|
+
rectangle "Impure Shell(IO 境界)" #LightCoral {
|
|
795
|
+
rectangle "Pure Core(純粋ロジック)" #LightGreen {
|
|
796
|
+
card "meetingsOverlap" as overlap
|
|
797
|
+
card "possibleMeetings" as possible
|
|
798
|
+
card "parseAndValidate" as parse
|
|
799
|
+
}
|
|
800
|
+
|
|
801
|
+
card "calendarEntries" as cal
|
|
802
|
+
card "createMeeting" as create
|
|
803
|
+
card "getLine / putStrLn" as stdio
|
|
804
|
+
}
|
|
805
|
+
|
|
806
|
+
cal --> possible : データを渡す
|
|
807
|
+
possible --> create : 結果を渡す
|
|
808
|
+
stdio --> parse : 入力を渡す
|
|
809
|
+
}
|
|
810
|
+
|
|
811
|
+
note bottom
|
|
812
|
+
ビジネスロジックは純粋関数で
|
|
813
|
+
IO は境界部分のみ
|
|
814
|
+
end note
|
|
815
|
+
|
|
816
|
+
@enduml
|
|
817
|
+
```
|
|
818
|
+
|
|
819
|
+
```haskell
|
|
820
|
+
-- Haskell: 純粋関数と IO の明確な分離
|
|
821
|
+
-- 純粋関数(テスト容易)
|
|
822
|
+
possibleMeetings :: [MeetingTime] -> Int -> Int -> Int -> [MeetingTime]
|
|
823
|
+
possibleMeetings existingMeetings startHour endHour lengthHours =
|
|
824
|
+
let slots = [MeetingTime s (s + lengthHours) | s <- [startHour .. endHour - lengthHours]]
|
|
825
|
+
in filter (\slot -> all (not . meetingsOverlap slot) existingMeetings) slots
|
|
826
|
+
|
|
827
|
+
-- IO 関数(外部 API)
|
|
828
|
+
calendarEntries :: String -> IO [MeetingTime]
|
|
829
|
+
scheduledMeetings :: String -> String -> IO [MeetingTime]
|
|
830
|
+
```
|
|
831
|
+
|
|
832
|
+
---
|
|
833
|
+
|
|
834
|
+
## 8.9 言語固有の特徴
|
|
835
|
+
|
|
836
|
+
### Haskell: IO の純粋性保証
|
|
837
|
+
|
|
838
|
+
Haskell は唯一、**型シグネチャで純粋性を保証**する言語です:
|
|
839
|
+
|
|
840
|
+
```haskell
|
|
841
|
+
-- 純粋関数(IO なし):副作用は不可能
|
|
842
|
+
possibleMeetings :: [MeetingTime] -> Int -> Int -> Int -> [MeetingTime]
|
|
843
|
+
|
|
844
|
+
-- IO 関数:副作用があることが明示的
|
|
845
|
+
calendarEntries :: String -> IO [MeetingTime]
|
|
846
|
+
```
|
|
847
|
+
|
|
848
|
+
コンパイラが純粋関数内の IO 使用を禁止するため、「うっかり副作用を混入」という事故が起きません。
|
|
849
|
+
|
|
850
|
+
### Rust: ゼロコスト抽象化の async/await
|
|
851
|
+
|
|
852
|
+
Rust の `async fn` はコンパイル時にステートマシンに変換され、ランタイムオーバーヘッドがゼロです:
|
|
853
|
+
|
|
854
|
+
```rust
|
|
855
|
+
// コンパイル後、ヒープ割り当てなしのステートマシンに変換
|
|
856
|
+
pub async fn scheduled_meetings(person1: &str, person2: &str) -> Vec<MeetingTime> {
|
|
857
|
+
let entries1 = calendar_entries(person1).await;
|
|
858
|
+
let entries2 = calendar_entries(person2).await;
|
|
859
|
+
[entries1, entries2].concat()
|
|
860
|
+
}
|
|
861
|
+
```
|
|
862
|
+
|
|
863
|
+
### TypeScript: IO / Task / TaskEither の 3 層
|
|
864
|
+
|
|
865
|
+
fp-ts は同期・非同期・エラー付き非同期の 3 つの IO 型を提供します:
|
|
866
|
+
|
|
867
|
+
```typescript
|
|
868
|
+
import * as IO from 'fp-ts/IO' // 同期 IO
|
|
869
|
+
import * as T from 'fp-ts/Task' // 非同期 IO(成功のみ)
|
|
870
|
+
import * as TE from 'fp-ts/TaskEither' // 非同期 IO(エラーあり)
|
|
871
|
+
|
|
872
|
+
// IO<A>: () => A
|
|
873
|
+
// Task<A>: () => Promise<A>
|
|
874
|
+
// TaskEither<E, A>: () => Promise<Either<E, A>>
|
|
875
|
+
```
|
|
876
|
+
|
|
877
|
+
### Clojure: 複数プリミティブの使い分け
|
|
878
|
+
|
|
879
|
+
Clojure は単一の IO 型ではなく、用途別のプリミティブを使い分けます:
|
|
880
|
+
|
|
881
|
+
```clojure
|
|
882
|
+
;; delay: 遅延評価(キャッシュあり)
|
|
883
|
+
(def lazy-val (delay (expensive-computation)))
|
|
884
|
+
|
|
885
|
+
;; atom: 状態管理(同期的な更新)
|
|
886
|
+
(def state (atom {:count 0}))
|
|
887
|
+
(swap! state update :count inc)
|
|
888
|
+
|
|
889
|
+
;; future: 非同期計算(別スレッド)
|
|
890
|
+
(def async-result (future (api-call)))
|
|
891
|
+
@async-result ; 結果を待つ
|
|
892
|
+
```
|
|
893
|
+
|
|
894
|
+
### Elixir: OTP プロセスとの統合
|
|
895
|
+
|
|
896
|
+
Elixir は無名関数に加え、`Agent` と `Task` で状態管理と非同期処理を OTP の軽量プロセスで実現します:
|
|
897
|
+
|
|
898
|
+
```elixir
|
|
899
|
+
# Agent: 状態管理(プロセス内)
|
|
900
|
+
{:ok, agent} = Agent.start_link(fn -> %{} end)
|
|
901
|
+
Agent.update(agent, fn state -> Map.put(state, :key, "value") end)
|
|
902
|
+
|
|
903
|
+
# Task: 非同期処理(並行プロセス)
|
|
904
|
+
task = Task.async(fn -> expensive_computation() end)
|
|
905
|
+
result = Task.await(task)
|
|
906
|
+
```
|
|
907
|
+
|
|
908
|
+
---
|
|
909
|
+
|
|
910
|
+
## 8.10 実践的な選択指針
|
|
911
|
+
|
|
912
|
+
### IO の抽象化レベルの選択
|
|
913
|
+
|
|
914
|
+
| 要件 | 推奨言語 | 理由 |
|
|
915
|
+
|------|---------|------|
|
|
916
|
+
| 最も厳格な純粋性保証 | Haskell | 型レベルで IO と純粋関数を分離 |
|
|
917
|
+
| 高性能な非同期処理 | Rust | ゼロコスト抽象化の async/await |
|
|
918
|
+
| JVM でのエフェクト管理 | Scala + cats-effect | 成熟した IO ライブラリ |
|
|
919
|
+
| .NET での非同期処理 | F# (Async) / C# (Task) | コンピュテーション式 / async-await |
|
|
920
|
+
| フロントエンドでの型安全 IO | TypeScript + fp-ts | IO / Task / TaskEither の 3 層 |
|
|
921
|
+
| 分散システム | Elixir | OTP の軽量プロセスモデル |
|
|
922
|
+
| 並行状態管理 | Clojure | atom / ref / STM |
|
|
923
|
+
|
|
924
|
+
### プロジェクト規模別の推奨
|
|
925
|
+
|
|
926
|
+
| 規模 | 推奨アプローチ | 言語例 |
|
|
927
|
+
|------|-------------|-------|
|
|
928
|
+
| 小規模 | Pure Core / Impure Shell の慣習的分離 | Python, Ruby, Java |
|
|
929
|
+
| 中規模 | エフェクトライブラリの導入 | Scala (cats-effect), TypeScript (fp-ts) |
|
|
930
|
+
| 大規模 | 言語レベルの IO 分離 | Haskell, F# |
|
|
931
|
+
|
|
932
|
+
---
|
|
933
|
+
|
|
934
|
+
## 8.11 まとめ
|
|
935
|
+
|
|
936
|
+
本章では、11 言語での IO モナドと副作用の分離を比較し、以下を確認しました:
|
|
937
|
+
|
|
938
|
+
**共通の原則**:
|
|
939
|
+
|
|
940
|
+
- IO = 副作用の「記述」と「実行」の分離
|
|
941
|
+
- flatMap / bind / chain による IO の合成
|
|
942
|
+
- Pure Core / Impure Shell パターンはすべての言語で有効
|
|
943
|
+
|
|
944
|
+
**言語間の差異**:
|
|
945
|
+
|
|
946
|
+
- 抽象化レベルは 4 段階(言語組み込み → ライブラリ → 非同期プリミティブ → 慣習的分離)
|
|
947
|
+
- 合成構文は 3 系統(モナド内包表記 / async-await / 明示的チェーン)
|
|
948
|
+
- Haskell のみが型レベルで純粋性を保証
|
|
949
|
+
|
|
950
|
+
**学び**:
|
|
951
|
+
|
|
952
|
+
- 副作用の管理は「型で表現する」か「慣習で分離する」かの選択
|
|
953
|
+
- async/await は IO モナドの脱糖と本質的に同じ
|
|
954
|
+
- エラーハンドリングとリトライは IO の合成で自然に表現できる
|
|
955
|
+
|
|
956
|
+
---
|
|
957
|
+
|
|
958
|
+
### 各言語の詳細記事
|
|
959
|
+
|
|
960
|
+
| 言語 | 記事リンク |
|
|
961
|
+
|------|-----------|
|
|
962
|
+
| Scala | [Part IV: IO と副作用の管理](../scala/part-4.md) |
|
|
963
|
+
| Java | [Part IV: IO と副作用の管理](../java/part-4.md) |
|
|
964
|
+
| F# | [Part IV: 非同期処理とストリーム](../fsharp/part-4.md) |
|
|
965
|
+
| C# | [Part IV: 非同期処理とストリーム](../csharp/part-4.md) |
|
|
966
|
+
| Haskell | [Part IV: IO と副作用の管理](../haskell/part-4.md) |
|
|
967
|
+
| Clojure | [Part IV: 状態管理とストリーム処理](../clojure/part-4.md) |
|
|
968
|
+
| Elixir | [Part IV: IO とストリーム処理](../elixir/part-4.md) |
|
|
969
|
+
| Rust | [Part IV: 非同期処理とストリーム](../rust/part-4.md) |
|
|
970
|
+
| Python | [Part IV: IO と副作用の管理](../python/part-4.md) |
|
|
971
|
+
| TypeScript | [Part IV: IO と副作用の管理](../typescript/part-4.md) |
|
|
972
|
+
| Ruby | [Part IV: IO と副作用の管理](../ruby/part-4.md) |
|