@k2works/claude-code-booster 3.5.0 → 3.6.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 +239 -239
- 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 -88
- 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-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 +162 -161
- 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 +183 -183
- 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 +532 -532
- 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 -580
- 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 -242
- 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 -544
- 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 -682
- 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 -560
- 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 -2636
- 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 -663
- 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 +28 -0
- 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 -68
- 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 -135
- 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
- package/lib/assets/.claude/agent-memory/xp-programmer/MEMORY.md +0 -6
- package/lib/assets/.claude/agent-memory/xp-programmer/project_cargo_tracker.md +0 -11
- package/lib/assets/.claude/agent-memory/xp-programmer/project_ddd_patterns.md +0 -27
- package/lib/assets/.claude/agent-memory/xp-programmer/project_us07_route_assignment.md +0 -19
|
@@ -1,785 +1,785 @@
|
|
|
1
|
-
# Part III - 第 6 章:Option 型による安全なエラーハンドリング
|
|
2
|
-
|
|
3
|
-
## 6.1 はじめに:null の問題
|
|
4
|
-
|
|
5
|
-
`null` は「10 億ドルの過ち」と呼ばれるほど、ソフトウェア開発に多大なバグをもたらしてきました。値が「ない」ことを `null` で表現すると、コンパイラはその検査を強制できず、実行時に `NullPointerException` や `TypeError` が発生します。
|
|
6
|
-
|
|
7
|
-
関数型プログラミングでは、値の有無を**型**で表現します。`Option`(Haskell では `Maybe`)型は、「値があるかもしれないし、ないかもしれない」を型レベルで表し、コンパイラによる安全性検査を可能にします。
|
|
8
|
-
|
|
9
|
-
本章では、11 言語での Option/Maybe の実装を横断的に比較し、以下を明らかにします:
|
|
10
|
-
|
|
11
|
-
- Option 型の実装方式(言語組み込み vs ライブラリ vs nil ベース)の違い
|
|
12
|
-
- 複数の Option を合成する方法(for / do / LINQ / ? 演算子)の多様性
|
|
13
|
-
- フォールバック(orElse)と 2 つのエラーハンドリング戦略
|
|
14
|
-
|
|
15
|
-
```plantuml
|
|
16
|
-
@startuml
|
|
17
|
-
!theme plain
|
|
18
|
-
|
|
19
|
-
rectangle "null の世界" #LightCoral {
|
|
20
|
-
card "値がある: \"hello\"" as v1
|
|
21
|
-
card "値がない: null" as v2
|
|
22
|
-
card "実行時エラー: NullPointerException" as err
|
|
23
|
-
v2 -right-> err : アクセス
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
rectangle "Option の世界" #LightGreen {
|
|
27
|
-
card "値がある: Some(\"hello\")" as o1
|
|
28
|
-
card "値がない: None" as o2
|
|
29
|
-
card "コンパイル時に検査" as safe
|
|
30
|
-
o2 -right-> safe : パターンマッチ必須
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
@enduml
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
---
|
|
37
|
-
|
|
38
|
-
## 6.2 共通の本質:Option = Some | None
|
|
39
|
-
|
|
40
|
-
11 言語すべてで共通する Option の構造は、**2 つのケース**の判別共用体です:
|
|
41
|
-
|
|
42
|
-
1. **Some(value)**: 値が存在する
|
|
43
|
-
2. **None**: 値が存在しない
|
|
44
|
-
|
|
45
|
-
```plantuml
|
|
46
|
-
@startuml
|
|
47
|
-
!theme plain
|
|
48
|
-
|
|
49
|
-
rectangle "Option[A]" #LightBlue {
|
|
50
|
-
card "Some(value: A)" as some #LightGreen
|
|
51
|
-
card "None" as none #LightCoral
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
rectangle "操作" #LightYellow {
|
|
55
|
-
card "map: 中身を変換" as m
|
|
56
|
-
card "flatMap: 中身から新しい Option を生成" as fm
|
|
57
|
-
card "getOrElse: None ならデフォルト値" as goe
|
|
58
|
-
card "orElse: None なら別の Option を試す" as oe
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
some --> m
|
|
62
|
-
some --> fm
|
|
63
|
-
none --> goe
|
|
64
|
-
none --> oe
|
|
65
|
-
|
|
66
|
-
@enduml
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
3 つの言語グループから代表例を見てみましょう:
|
|
70
|
-
|
|
71
|
-
```haskell
|
|
72
|
-
-- Haskell: Maybe 型(言語組み込み)
|
|
73
|
-
data Maybe a = Nothing | Just a
|
|
74
|
-
|
|
75
|
-
-- 使用例
|
|
76
|
-
Just 42 :: Maybe Int -- 値がある
|
|
77
|
-
Nothing :: Maybe Int -- 値がない
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
```rust
|
|
81
|
-
// Rust: Option 型(言語組み込み)
|
|
82
|
-
let some_value: Option<i32> = Some(42);
|
|
83
|
-
let no_value: Option<i32> = None;
|
|
84
|
-
|
|
85
|
-
// パターンマッチでの取り出し(コンパイラが網羅性を検査)
|
|
86
|
-
match some_value {
|
|
87
|
-
Some(v) => println!("Value: {}", v),
|
|
88
|
-
None => println!("No value"),
|
|
89
|
-
}
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
```scala
|
|
93
|
-
// Scala: Option 型(標準ライブラリ)
|
|
94
|
-
val some: Option[Int] = Some(42)
|
|
95
|
-
val none: Option[Int] = None
|
|
96
|
-
|
|
97
|
-
// map で変換
|
|
98
|
-
some.map(_ * 2) // Some(84)
|
|
99
|
-
none.map(_ * 2) // None(安全に伝播)
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
---
|
|
103
|
-
|
|
104
|
-
## 6.3 Option の実装方式:3 つのアプローチ
|
|
105
|
-
|
|
106
|
-
### アプローチ 1: 言語組み込み
|
|
107
|
-
|
|
108
|
-
型システムで `null` の使用自体を排除し、Option/Maybe を唯一の「値の不在」表現とします。
|
|
109
|
-
|
|
110
|
-
| 言語 | 型名 | Some | None | 特徴 |
|
|
111
|
-
|------|------|------|------|------|
|
|
112
|
-
| **Haskell** | `Maybe a` | `Just a` | `Nothing` | 完全な型安全性、`null` が存在しない |
|
|
113
|
-
| **Rust** | `Option<T>` | `Some(T)` | `None` | `null` が存在しない、`?` 演算子 |
|
|
114
|
-
| **F#** | `'a option` | `Some a` | `None` | .NET 上だが Option がファーストクラス |
|
|
115
|
-
|
|
116
|
-
### アプローチ 2: ライブラリ提供
|
|
117
|
-
|
|
118
|
-
言語自体には `null` が存在するが、FP ライブラリで Option 型を提供します。
|
|
119
|
-
|
|
120
|
-
| 言語 | ライブラリ | 型名 | Some | None |
|
|
121
|
-
|------|-----------|------|------|------|
|
|
122
|
-
| **Scala** | 標準ライブラリ | `Option[A]` | `Some(a)` | `None` |
|
|
123
|
-
| **Java** | Vavr | `Option<T>` | `Option.some(t)` | `Option.none()` |
|
|
124
|
-
| **C#** | LanguageExt | `Option<T>` | `Some(t)` | `None` |
|
|
125
|
-
| **TypeScript** | fp-ts | `Option<A>` | `O.some(a)` | `O.none` |
|
|
126
|
-
| **Python** | returns | `Maybe[A]` | `Some(a)` | `Nothing` |
|
|
127
|
-
| **Ruby** | dry-monads | `Maybe` | `Some(a)` | `None()` |
|
|
128
|
-
|
|
129
|
-
### アプローチ 3: nil ベース + マクロ / パターンマッチ
|
|
130
|
-
|
|
131
|
-
専用の型を持たず、`nil` を「値がない」として扱い、言語機能でサポートします。
|
|
132
|
-
|
|
133
|
-
| 言語 | 不在の表現 | サポート機構 |
|
|
134
|
-
|------|-----------|------------|
|
|
135
|
-
| **Clojure** | `nil` | `some->` / `some->>` マクロ、`when-let` |
|
|
136
|
-
| **Elixir** | `nil` | `with` 式、パターンマッチ |
|
|
137
|
-
|
|
138
|
-
---
|
|
139
|
-
|
|
140
|
-
## 6.4 TV 番組パース:Option の合成パターン
|
|
141
|
-
|
|
142
|
-
Option の真価は、複数の「失敗するかもしれない」操作を安全に連鎖させることです。TV 番組文字列 `"Breaking Bad (2008-2013)"` から名前・開始年・終了年を抽出するパターンで比較します。
|
|
143
|
-
|
|
144
|
-
### ビジネスロジック
|
|
145
|
-
|
|
146
|
-
```
|
|
147
|
-
"Breaking Bad (2008-2013)" →
|
|
148
|
-
extractName → Some("Breaking Bad")
|
|
149
|
-
extractYearStart → Some(2008)
|
|
150
|
-
extractYearEnd → Some(2013)
|
|
151
|
-
→ Some(TvShow("Breaking Bad", 2008, 2013))
|
|
152
|
-
|
|
153
|
-
"Invalid" →
|
|
154
|
-
extractName → None
|
|
155
|
-
→ None(以降の処理はスキップ)
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
### 代表 3 言語の比較
|
|
159
|
-
|
|
160
|
-
**Haskell**: do 記法
|
|
161
|
-
|
|
162
|
-
```haskell
|
|
163
|
-
parseShow :: String -> Maybe TvShow
|
|
164
|
-
parseShow rawShow = do
|
|
165
|
-
name <- extractName rawShow
|
|
166
|
-
yearStart <- extractYearStart rawShow `orElse` extractSingleYear rawShow
|
|
167
|
-
yearEnd <- extractYearEnd rawShow `orElse` extractSingleYear rawShow
|
|
168
|
-
return $ TvShow name yearStart yearEnd
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
**Scala**: for 内包表記
|
|
172
|
-
|
|
173
|
-
```scala
|
|
174
|
-
def parseShow(rawShow: String): Option[TvShow] =
|
|
175
|
-
for {
|
|
176
|
-
name <- extractName(rawShow)
|
|
177
|
-
yearStart <- extractYearStart(rawShow).orElse(extractSingleYear(rawShow))
|
|
178
|
-
yearEnd <- extractYearEnd(rawShow).orElse(extractSingleYear(rawShow))
|
|
179
|
-
} yield TvShow(name, yearStart, yearEnd)
|
|
180
|
-
```
|
|
181
|
-
|
|
182
|
-
**Rust**: ? 演算子
|
|
183
|
-
|
|
184
|
-
```rust
|
|
185
|
-
pub fn parse_show(raw_show: &str) -> Option<TvShow> {
|
|
186
|
-
let name = extract_name(raw_show)?;
|
|
187
|
-
let year_start = extract_year_start(raw_show)
|
|
188
|
-
.or_else(|| extract_single_year(raw_show))?;
|
|
189
|
-
let year_end = extract_year_end(raw_show)
|
|
190
|
-
.or_else(|| extract_single_year(raw_show))?;
|
|
191
|
-
|
|
192
|
-
Some(TvShow::new(&name, year_start, year_end))
|
|
193
|
-
}
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
**共通パターン**: どの言語でも、1 つでも `None` / `Nothing` が返れば、以降の処理はスキップされ全体が `None` になります。これが**モナド的合成**(短絡評価)です。
|
|
197
|
-
|
|
198
|
-
### 全 11 言語の実装
|
|
199
|
-
|
|
200
|
-
#### 関数型ファースト言語
|
|
201
|
-
|
|
202
|
-
<details>
|
|
203
|
-
<summary>Haskell 実装</summary>
|
|
204
|
-
|
|
205
|
-
```haskell
|
|
206
|
-
data TvShow = TvShow
|
|
207
|
-
{ showTitle :: String
|
|
208
|
-
, startYear :: Int
|
|
209
|
-
, endYear :: Int
|
|
210
|
-
}
|
|
211
|
-
|
|
212
|
-
orElse :: Maybe a -> Maybe a -> Maybe a
|
|
213
|
-
orElse (Just x) _ = Just x
|
|
214
|
-
orElse Nothing y = y
|
|
215
|
-
|
|
216
|
-
parseShow :: String -> Maybe TvShow
|
|
217
|
-
parseShow rawShow = do
|
|
218
|
-
name <- extractName rawShow
|
|
219
|
-
yearStart <- extractYearStart rawShow `orElse` extractSingleYear rawShow
|
|
220
|
-
yearEnd <- extractYearEnd rawShow `orElse` extractSingleYear rawShow
|
|
221
|
-
return $ TvShow name yearStart yearEnd
|
|
222
|
-
```
|
|
223
|
-
|
|
224
|
-
Haskell の do 記法は `Maybe` モナドに対して自動的に短絡評価を行います。`<|>` 演算子(`Alternative` 型クラス)でも `orElse` を表現できます。
|
|
225
|
-
|
|
226
|
-
</details>
|
|
227
|
-
|
|
228
|
-
<details>
|
|
229
|
-
<summary>Clojure 実装</summary>
|
|
230
|
-
|
|
231
|
-
```clojure
|
|
232
|
-
(defn parse-show [raw-show]
|
|
233
|
-
(when-let [name (extract-name raw-show)]
|
|
234
|
-
(when-let [year-start (or (extract-year-start raw-show)
|
|
235
|
-
(extract-single-year raw-show))]
|
|
236
|
-
(when-let [year-end (or (extract-year-end raw-show)
|
|
237
|
-
(extract-single-year raw-show))]
|
|
238
|
-
{:title name :start year-start :end year-end}))))
|
|
239
|
-
|
|
240
|
-
;; some-> マクロによる簡潔な nil チェーンも可能
|
|
241
|
-
(some-> {:user {:profile {:name "Alice"}}}
|
|
242
|
-
:user
|
|
243
|
-
:profile
|
|
244
|
-
:name)
|
|
245
|
-
; => "Alice"
|
|
246
|
-
```
|
|
247
|
-
|
|
248
|
-
Clojure は型レベルの Option を持ちませんが、`when-let` と `or` の組み合わせで同等の安全性を実現します。`some->` マクロは nil で自動停止するパイプラインです。
|
|
249
|
-
|
|
250
|
-
</details>
|
|
251
|
-
|
|
252
|
-
<details>
|
|
253
|
-
<summary>Elixir 実装</summary>
|
|
254
|
-
|
|
255
|
-
```elixir
|
|
256
|
-
def parse_show(raw_show) do
|
|
257
|
-
with name when not is_nil(name) <- extract_name(raw_show),
|
|
258
|
-
year_start when not is_nil(year_start) <-
|
|
259
|
-
or_else(extract_year_start(raw_show), fn -> extract_single_year(raw_show) end),
|
|
260
|
-
year_end when not is_nil(year_end) <-
|
|
261
|
-
or_else(extract_year_end(raw_show), fn -> extract_single_year(raw_show) end) do
|
|
262
|
-
%TvShow{title: name, start_year: year_start, end_year: year_end}
|
|
263
|
-
else
|
|
264
|
-
_ -> nil
|
|
265
|
-
end
|
|
266
|
-
end
|
|
267
|
-
|
|
268
|
-
def or_else(nil, fallback), do: fallback.()
|
|
269
|
-
def or_else(value, _fallback), do: value
|
|
270
|
-
```
|
|
271
|
-
|
|
272
|
-
Elixir の `with` 式は、各ステップでパターンマッチが失敗した場合に `else` 節に移行します。
|
|
273
|
-
|
|
274
|
-
</details>
|
|
275
|
-
|
|
276
|
-
<details>
|
|
277
|
-
<summary>F# 実装</summary>
|
|
278
|
-
|
|
279
|
-
```fsharp
|
|
280
|
-
type TvShow = { Title: string; Start: int; End: int }
|
|
281
|
-
|
|
282
|
-
let parseShow (rawShow: string) : TvShow option =
|
|
283
|
-
match extractName rawShow with
|
|
284
|
-
| None -> None
|
|
285
|
-
| Some name ->
|
|
286
|
-
let yearStart =
|
|
287
|
-
extractYearStart rawShow
|
|
288
|
-
|> Option.orElse (extractSingleYear rawShow)
|
|
289
|
-
let yearEnd =
|
|
290
|
-
extractYearEnd rawShow
|
|
291
|
-
|> Option.orElse (extractSingleYear rawShow)
|
|
292
|
-
match yearStart, yearEnd with
|
|
293
|
-
| Some start, Some endYear ->
|
|
294
|
-
Some { Title = name; Start = start; End = endYear }
|
|
295
|
-
| _ -> None
|
|
296
|
-
```
|
|
297
|
-
|
|
298
|
-
F# ではパターンマッチとパイプ演算子 `|>` を組み合わせます。`Option.orElse` で代替値を指定できます。
|
|
299
|
-
|
|
300
|
-
</details>
|
|
301
|
-
|
|
302
|
-
#### マルチパラダイム言語
|
|
303
|
-
|
|
304
|
-
<details>
|
|
305
|
-
<summary>Scala 実装</summary>
|
|
306
|
-
|
|
307
|
-
```scala
|
|
308
|
-
case class TvShow(name: String, yearStart: Int, yearEnd: Int)
|
|
309
|
-
|
|
310
|
-
def parseShow(rawShow: String): Option[TvShow] =
|
|
311
|
-
for {
|
|
312
|
-
name <- extractName(rawShow)
|
|
313
|
-
yearStart <- extractYearStart(rawShow).orElse(extractSingleYear(rawShow))
|
|
314
|
-
yearEnd <- extractYearEnd(rawShow).orElse(extractSingleYear(rawShow))
|
|
315
|
-
} yield TvShow(name, yearStart, yearEnd)
|
|
316
|
-
```
|
|
317
|
-
|
|
318
|
-
Scala の for 内包表記は `flatMap` / `map` に脱糖され、Option のモナド的合成を最も読みやすく表現します。
|
|
319
|
-
|
|
320
|
-
</details>
|
|
321
|
-
|
|
322
|
-
<details>
|
|
323
|
-
<summary>Rust 実装</summary>
|
|
324
|
-
|
|
325
|
-
```rust
|
|
326
|
-
pub struct TvShow {
|
|
327
|
-
pub name: String,
|
|
328
|
-
pub year_start: i32,
|
|
329
|
-
pub year_end: i32,
|
|
330
|
-
}
|
|
331
|
-
|
|
332
|
-
pub fn parse_show(raw_show: &str) -> Option<TvShow> {
|
|
333
|
-
let name = extract_name(raw_show)?;
|
|
334
|
-
let year_start = extract_year_start(raw_show)
|
|
335
|
-
.or_else(|| extract_single_year(raw_show))?;
|
|
336
|
-
let year_end = extract_year_end(raw_show)
|
|
337
|
-
.or_else(|| extract_single_year(raw_show))?;
|
|
338
|
-
|
|
339
|
-
Some(TvShow::new(&name, year_start, year_end))
|
|
340
|
-
}
|
|
341
|
-
```
|
|
342
|
-
|
|
343
|
-
Rust の `?` 演算子は `None` に遭遇すると即座に `None` を返します。全言語中で最も簡潔な短絡評価構文です。
|
|
344
|
-
|
|
345
|
-
</details>
|
|
346
|
-
|
|
347
|
-
<details>
|
|
348
|
-
<summary>TypeScript (fp-ts) 実装</summary>
|
|
349
|
-
|
|
350
|
-
```typescript
|
|
351
|
-
interface TvShow {
|
|
352
|
-
readonly title: string
|
|
353
|
-
readonly start: number
|
|
354
|
-
readonly end: number
|
|
355
|
-
}
|
|
356
|
-
|
|
357
|
-
const parseShow = (rawShow: string): O.Option<TvShow> =>
|
|
358
|
-
pipe(
|
|
359
|
-
O.Do,
|
|
360
|
-
O.bind('title', () => extractName(rawShow)),
|
|
361
|
-
O.bind('start', () =>
|
|
362
|
-
pipe(
|
|
363
|
-
extractYearStart(rawShow),
|
|
364
|
-
O.orElse(() => extractSingleYear(rawShow))
|
|
365
|
-
)
|
|
366
|
-
),
|
|
367
|
-
O.bind('end', () =>
|
|
368
|
-
pipe(
|
|
369
|
-
extractYearEnd(rawShow),
|
|
370
|
-
O.orElse(() => extractSingleYear(rawShow))
|
|
371
|
-
)
|
|
372
|
-
),
|
|
373
|
-
O.map(({ title, start, end }) => ({ title, start, end }))
|
|
374
|
-
)
|
|
375
|
-
```
|
|
376
|
-
|
|
377
|
-
fp-ts の `O.Do` + `O.bind` は Haskell の do 記法を模倣した構文です。
|
|
378
|
-
|
|
379
|
-
</details>
|
|
380
|
-
|
|
381
|
-
#### OOP + FP ライブラリ言語
|
|
382
|
-
|
|
383
|
-
<details>
|
|
384
|
-
<summary>Java (Vavr) 実装</summary>
|
|
385
|
-
|
|
386
|
-
```java
|
|
387
|
-
record TvShow(String name, int yearStart, int yearEnd) {}
|
|
388
|
-
|
|
389
|
-
Option<TvShow> parseShow(String rawShow) {
|
|
390
|
-
return extractName(rawShow).flatMap(name ->
|
|
391
|
-
extractYearStart(rawShow).orElse(() -> extractSingleYear(rawShow))
|
|
392
|
-
.flatMap(yearStart ->
|
|
393
|
-
extractYearEnd(rawShow).orElse(() -> extractSingleYear(rawShow))
|
|
394
|
-
.map(yearEnd -> new TvShow(name, yearStart, yearEnd))
|
|
395
|
-
)
|
|
396
|
-
);
|
|
397
|
-
}
|
|
398
|
-
```
|
|
399
|
-
|
|
400
|
-
Java は for 内包表記を持たないため、`flatMap` のネストが深くなります。
|
|
401
|
-
|
|
402
|
-
</details>
|
|
403
|
-
|
|
404
|
-
<details>
|
|
405
|
-
<summary>C# (LanguageExt) 実装</summary>
|
|
406
|
-
|
|
407
|
-
```csharp
|
|
408
|
-
record TvShow(string Name, int YearStart, int YearEnd);
|
|
409
|
-
|
|
410
|
-
Option<TvShow> ParseShow(string rawShow) =>
|
|
411
|
-
from name in ExtractName(rawShow)
|
|
412
|
-
from yearStart in ExtractYearStart(rawShow) || ExtractSingleYear(rawShow)
|
|
413
|
-
from yearEnd in ExtractYearEnd(rawShow) || ExtractSingleYear(rawShow)
|
|
414
|
-
select new TvShow(name, yearStart, yearEnd);
|
|
415
|
-
```
|
|
416
|
-
|
|
417
|
-
C# の LINQ クエリ式と LanguageExt の `||` 演算子(orElse)の組み合わせで、Scala の for 内包表記に匹敵する簡潔さを実現しています。
|
|
418
|
-
|
|
419
|
-
</details>
|
|
420
|
-
|
|
421
|
-
<details>
|
|
422
|
-
<summary>Python (returns) 実装</summary>
|
|
423
|
-
|
|
424
|
-
```python
|
|
425
|
-
from returns.maybe import Maybe, Nothing, Some
|
|
426
|
-
|
|
427
|
-
def parse_show(raw_show: str) -> Maybe[TvShow]:
|
|
428
|
-
name = extract_name(raw_show)
|
|
429
|
-
year_start = extract_year_start(raw_show).lash(
|
|
430
|
-
lambda _: extract_single_year(raw_show)
|
|
431
|
-
)
|
|
432
|
-
year_end = extract_year_end(raw_show).lash(
|
|
433
|
-
lambda _: extract_single_year(raw_show)
|
|
434
|
-
)
|
|
435
|
-
|
|
436
|
-
return name.bind(
|
|
437
|
-
lambda n: year_start.bind(
|
|
438
|
-
lambda s: year_end.map(lambda e: TvShow(n, s, e))
|
|
439
|
-
)
|
|
440
|
-
)
|
|
441
|
-
```
|
|
442
|
-
|
|
443
|
-
Python の `returns` ライブラリでは `lash` が `orElse` に相当します。
|
|
444
|
-
|
|
445
|
-
</details>
|
|
446
|
-
|
|
447
|
-
<details>
|
|
448
|
-
<summary>Ruby (dry-monads) 実装</summary>
|
|
449
|
-
|
|
450
|
-
```ruby
|
|
451
|
-
require 'dry/monads'
|
|
452
|
-
include Dry::Monads[:maybe]
|
|
453
|
-
|
|
454
|
-
TvShow = Struct.new(:title, :start_year, :end_year, keyword_init: true)
|
|
455
|
-
|
|
456
|
-
def self.parse_show(raw_show)
|
|
457
|
-
name = extract_name(raw_show)
|
|
458
|
-
year_start = extract_year_start(raw_show).or(extract_single_year(raw_show))
|
|
459
|
-
year_end = extract_year_end(raw_show).or(extract_single_year(raw_show))
|
|
460
|
-
|
|
461
|
-
name.bind do |n|
|
|
462
|
-
year_start.bind do |ys|
|
|
463
|
-
year_end.fmap do |ye|
|
|
464
|
-
TvShow.new(title: n, start_year: ys, end_year: ye)
|
|
465
|
-
end
|
|
466
|
-
end
|
|
467
|
-
end
|
|
468
|
-
end
|
|
469
|
-
```
|
|
470
|
-
|
|
471
|
-
Ruby の `dry-monads` では `fmap`(map)と `bind`(flatMap)を使います。
|
|
472
|
-
|
|
473
|
-
</details>
|
|
474
|
-
|
|
475
|
-
---
|
|
476
|
-
|
|
477
|
-
## 6.5 合成構文の比較
|
|
478
|
-
|
|
479
|
-
Option のモナド的合成を表現する構文は言語ごとに大きく異なります。
|
|
480
|
-
|
|
481
|
-
| 言語 | 合成構文 | 可読性 |
|
|
482
|
-
|------|---------|--------|
|
|
483
|
-
| **Scala** | `for { x <- f1; y <- f2 } yield ...` | 高い |
|
|
484
|
-
| **Haskell** | `do { x <- f1; y <- f2; return ... }` | 高い |
|
|
485
|
-
| **Rust** | `let x = f1?; let y = f2?;` | 非常に高い |
|
|
486
|
-
| **C#** | `from x in f1 from y in f2 select ...` | 高い |
|
|
487
|
-
| **F#** | パターンマッチ + パイプ | 中程度 |
|
|
488
|
-
| **Clojure** | `(when-let [x f1] (when-let [y f2] ...))` | 中程度 |
|
|
489
|
-
| **Elixir** | `with x <- f1, y <- f2 do ... end` | 中程度 |
|
|
490
|
-
| **TypeScript** | `pipe(O.Do, O.bind('x', () => f1), ...)` | 中程度 |
|
|
491
|
-
| **Java** | `f1.flatMap(x -> f2.flatMap(y -> ...))` | 低い |
|
|
492
|
-
| **Python** | `f1.bind(lambda x: f2.bind(lambda y: ...))` | 低い |
|
|
493
|
-
| **Ruby** | `f1.bind { \|x\| f2.fmap { \|y\| ... } }` | 低い |
|
|
494
|
-
|
|
495
|
-
**発見**: Rust の `?` 演算子は全言語中で最も簡潔な短絡評価構文です。通常のコードに `?` を付けるだけで None 伝播を実現し、専用の糖衣構文や do 記法が不要です。
|
|
496
|
-
|
|
497
|
-
---
|
|
498
|
-
|
|
499
|
-
## 6.6 フォールバック(orElse)の比較
|
|
500
|
-
|
|
501
|
-
「最初の操作が失敗したら、別の操作を試す」パターンの言語別実装:
|
|
502
|
-
|
|
503
|
-
| 言語 | 構文 | 例 |
|
|
504
|
-
|------|------|-----|
|
|
505
|
-
| **Haskell** | `` `orElse` `` / `<\|>` | `extractYearStart raw \`orElse\` extractSingleYear raw` |
|
|
506
|
-
| **Scala** | `.orElse(...)` | `extractYearStart(raw).orElse(extractSingleYear(raw))` |
|
|
507
|
-
| **Rust** | `.or_else(\|\| ...)` | `extract_year_start(raw).or_else(\|\| extract_single_year(raw))` |
|
|
508
|
-
| **F#** | `\|> Option.orElse` | `extractYearStart raw \|> Option.orElse (extractSingleYear raw)` |
|
|
509
|
-
| **C#** | `\|\|` | `ExtractYearStart(raw) \|\| ExtractSingleYear(raw)` |
|
|
510
|
-
| **Clojure** | `(or ...)` | `(or (extract-year-start raw) (extract-single-year raw))` |
|
|
511
|
-
| **Elixir** | `or_else(val, fn)` | `or_else(extract_year_start(raw), fn -> extract_single_year(raw) end)` |
|
|
512
|
-
| **Java** | `.orElse(() -> ...)` | `extractYearStart(raw).orElse(() -> extractSingleYear(raw))` |
|
|
513
|
-
| **TypeScript** | `O.orElse(() -> ...)` | `pipe(extractYearStart(raw), O.orElse(() => extractSingleYear(raw)))` |
|
|
514
|
-
| **Python** | `.lash(lambda _: ...)` | `extract_year_start(raw).lash(lambda _: extract_single_year(raw))` |
|
|
515
|
-
| **Ruby** | `.or(...)` | `extract_year_start(raw).or(extract_single_year(raw))` |
|
|
516
|
-
|
|
517
|
-
C# の `||` 演算子は最も簡潔で、ブーリアンの `or` と同じ感覚で Option のフォールバックを記述できます。
|
|
518
|
-
|
|
519
|
-
---
|
|
520
|
-
|
|
521
|
-
## 6.7 エラーハンドリング戦略:2 つのアプローチ
|
|
522
|
-
|
|
523
|
-
複数の入力をパースする際、2 つの戦略があります。
|
|
524
|
-
|
|
525
|
-
### Best-effort(できるだけ多く成功)
|
|
526
|
-
|
|
527
|
-
パースに成功したものだけを返し、失敗したものは静かに無視します。
|
|
528
|
-
|
|
529
|
-
```scala
|
|
530
|
-
// Scala
|
|
531
|
-
val shows: List[TvShow] = rawShows.flatMap(parseShow)
|
|
532
|
-
```
|
|
533
|
-
|
|
534
|
-
```haskell
|
|
535
|
-
-- Haskell: catMaybes が Maybe のリストから Just の値だけを抽出
|
|
536
|
-
parseShowsBestEffort :: [String] -> [TvShow]
|
|
537
|
-
parseShowsBestEffort = catMaybes . map parseShow
|
|
538
|
-
```
|
|
539
|
-
|
|
540
|
-
```clojure
|
|
541
|
-
;; Clojure: keep は nil でない結果のみを返す
|
|
542
|
-
(keep parse-show raw-shows)
|
|
543
|
-
```
|
|
544
|
-
|
|
545
|
-
```python
|
|
546
|
-
# Python: Some の値だけを抽出
|
|
547
|
-
[show.unwrap() for show in map(parse_show, raw_shows) if isinstance(show, Some)]
|
|
548
|
-
```
|
|
549
|
-
|
|
550
|
-
### All-or-nothing(全て成功 or 全て失敗)
|
|
551
|
-
|
|
552
|
-
1 つでも失敗したら全体を失敗とします。
|
|
553
|
-
|
|
554
|
-
```scala
|
|
555
|
-
// Scala: traverse(リストの各要素に Option 関数を適用し、全て Some なら Some[List] を返す)
|
|
556
|
-
def parseShows(rawShows: List[String]): Option[List[TvShow]] =
|
|
557
|
-
rawShows.traverse(parseShow)
|
|
558
|
-
```
|
|
559
|
-
|
|
560
|
-
```haskell
|
|
561
|
-
-- Haskell: mapM は traverse と同等
|
|
562
|
-
parseShowsAllOrNothing :: [String] -> Maybe [TvShow]
|
|
563
|
-
parseShowsAllOrNothing = mapM parseShow
|
|
564
|
-
```
|
|
565
|
-
|
|
566
|
-
```typescript
|
|
567
|
-
// TypeScript (fp-ts): traverse
|
|
568
|
-
const parseShows = (rawShows: readonly string[]): O.Option<readonly TvShow[]> =>
|
|
569
|
-
pipe(rawShows, RA.traverse(O.Applicative)(parseShow))
|
|
570
|
-
```
|
|
571
|
-
|
|
572
|
-
### 戦略比較表
|
|
573
|
-
|
|
574
|
-
| 戦略 | Scala | Haskell | Clojure | Elixir | Rust | Python | TypeScript | Ruby |
|
|
575
|
-
|------|-------|---------|---------|--------|------|--------|------------|------|
|
|
576
|
-
| Best-effort | `flatMap` | `catMaybes` | `keep` | `Enum.reject(&is_nil/1)` | `filter_map` | `isinstance` | `RA.compact` | `select(&:some?)` |
|
|
577
|
-
| All-or-nothing | `traverse` | `mapM` | 手動実装 | 手動実装 | `collect()` | 手動実装 | `RA.traverse` | 手動実装 |
|
|
578
|
-
|
|
579
|
-
---
|
|
580
|
-
|
|
581
|
-
## 6.8 比較分析:3 つの発見
|
|
582
|
-
|
|
583
|
-
### 発見 1: Option の実装方式は安全性のレベルを決定する
|
|
584
|
-
|
|
585
|
-
```plantuml
|
|
586
|
-
@startuml
|
|
587
|
-
!theme plain
|
|
588
|
-
left to right direction
|
|
589
|
-
|
|
590
|
-
rectangle "Level 1: null が存在しない" #LightGreen {
|
|
591
|
-
card "Haskell (Maybe)" as h
|
|
592
|
-
card "Rust (Option)" as rs
|
|
593
|
-
}
|
|
594
|
-
|
|
595
|
-
rectangle "Level 2: 型で Option を強制" #LightBlue {
|
|
596
|
-
card "Scala (Option)" as sc
|
|
597
|
-
card "F# (option)" as fs
|
|
598
|
-
}
|
|
599
|
-
|
|
600
|
-
rectangle "Level 3: ライブラリで Option を提供" #LightYellow {
|
|
601
|
-
card "Java + Vavr" as jv
|
|
602
|
-
card "C# + LanguageExt" as cs
|
|
603
|
-
card "TypeScript + fp-ts" as ts
|
|
604
|
-
card "Python + returns" as py
|
|
605
|
-
card "Ruby + dry-monads" as rb
|
|
606
|
-
}
|
|
607
|
-
|
|
608
|
-
rectangle "Level 4: nil ベース + 言語機能" #LightCoral {
|
|
609
|
-
card "Clojure (nil + when-let)" as clj
|
|
610
|
-
card "Elixir (nil + with)" as ex
|
|
611
|
-
}
|
|
612
|
-
|
|
613
|
-
@enduml
|
|
614
|
-
```
|
|
615
|
-
|
|
616
|
-
| レベル | 言語 | 安全性 | 特徴 |
|
|
617
|
-
|--------|------|--------|------|
|
|
618
|
-
| **null なし** | Haskell, Rust | 最高 | コンパイラが Option の処理を強制 |
|
|
619
|
-
| **型で強制** | Scala, F# | 高い | null は存在するが Option 使用が慣習 |
|
|
620
|
-
| **ライブラリ** | Java, C#, TypeScript, Python, Ruby | 中程度 | null を使う旧コードとの共存が必要 |
|
|
621
|
-
| **nil ベース** | Clojure, Elixir | 慣習依存 | 言語機能で安全にサポートするが型保証はない |
|
|
622
|
-
|
|
623
|
-
### 発見 2: 合成構文は 4 系統に分類できる
|
|
624
|
-
|
|
625
|
-
1. **内包表記系**: Scala (for), Haskell (do), C# (LINQ), Clojure (when-let)
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
- ネストが平坦化され、最も可読性が高い
|
|
629
|
-
2. **演算子系**: Rust (`?`)
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
- 最も簡潔で、通常のコードに自然に溶け込む
|
|
633
|
-
3. **パイプ系**: F# (`|>`), Elixir (`with`), TypeScript (`pipe`)
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
- データの流れが明確
|
|
637
|
-
4. **flatMap チェーン系**: Java, Python, Ruby
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
- 糖衣構文がなく、ネストが深くなりやすい
|
|
641
|
-
|
|
642
|
-
### 発見 3: Option は Part II の flatMap の延長線上にある
|
|
643
|
-
|
|
644
|
-
Part II 第 5 章で学んだ `flatMap` のパターンがそのまま適用されています:
|
|
645
|
-
|
|
646
|
-
```
|
|
647
|
-
List.flatMap: List[A] → (A → List[B]) → List[B]
|
|
648
|
-
Option.flatMap: Option[A] → (A → Option[B]) → Option[B]
|
|
649
|
-
```
|
|
650
|
-
|
|
651
|
-
`List` の `flatMap` が「0 個以上の結果」を扱うのに対し、`Option` の `flatMap` は「0 個か 1 個の結果」を扱います。for 内包表記や do 記法が両方で使えるのは、同じモナドインターフェースを共有しているからです。
|
|
652
|
-
|
|
653
|
-
---
|
|
654
|
-
|
|
655
|
-
## 6.9 言語固有の特徴
|
|
656
|
-
|
|
657
|
-
### Rust: ? 演算子の簡潔さ
|
|
658
|
-
|
|
659
|
-
Rust の `?` 演算子は Option だけでなく `Result` 型にも使える汎用的な短絡評価構文です。
|
|
660
|
-
|
|
661
|
-
```rust
|
|
662
|
-
// ? なし(冗長)
|
|
663
|
-
fn parse_show(raw: &str) -> Option<TvShow> {
|
|
664
|
-
match extract_name(raw) {
|
|
665
|
-
None => None,
|
|
666
|
-
Some(name) => match extract_year_start(raw) {
|
|
667
|
-
None => None,
|
|
668
|
-
Some(start) => match extract_year_end(raw) {
|
|
669
|
-
None => None,
|
|
670
|
-
Some(end) => Some(TvShow::new(&name, start, end)),
|
|
671
|
-
}
|
|
672
|
-
}
|
|
673
|
-
}
|
|
674
|
-
}
|
|
675
|
-
|
|
676
|
-
// ? あり(簡潔)
|
|
677
|
-
fn parse_show(raw: &str) -> Option<TvShow> {
|
|
678
|
-
let name = extract_name(raw)?;
|
|
679
|
-
let start = extract_year_start(raw)?;
|
|
680
|
-
let end = extract_year_end(raw)?;
|
|
681
|
-
Some(TvShow::new(&name, start, end))
|
|
682
|
-
}
|
|
683
|
-
```
|
|
684
|
-
|
|
685
|
-
### Clojure: some-> マクロ
|
|
686
|
-
|
|
687
|
-
Clojure の `some->` は nil で自動停止するパイプラインマクロです。ネストした Map のアクセスに特に有効です。
|
|
688
|
-
|
|
689
|
-
```clojure
|
|
690
|
-
;; nil が出たら即座に nil を返す
|
|
691
|
-
(some-> {:user {:profile {:name "Alice"}}}
|
|
692
|
-
:user
|
|
693
|
-
:profile
|
|
694
|
-
:name
|
|
695
|
-
clojure.string/upper-case)
|
|
696
|
-
; => "ALICE"
|
|
697
|
-
|
|
698
|
-
(some-> {:user {:profile nil}}
|
|
699
|
-
:user
|
|
700
|
-
:profile
|
|
701
|
-
:name)
|
|
702
|
-
; => nil(:profile が nil なので停止)
|
|
703
|
-
```
|
|
704
|
-
|
|
705
|
-
### C#: || 演算子による OrElse
|
|
706
|
-
|
|
707
|
-
LanguageExt の `||` 演算子は、ブーリアン論理和と同じ感覚で Option のフォールバックを記述できます。
|
|
708
|
-
|
|
709
|
-
```csharp
|
|
710
|
-
// ブーリアンと同じ構文
|
|
711
|
-
var result = ExtractYearStart(raw) || ExtractSingleYear(raw);
|
|
712
|
-
```
|
|
713
|
-
|
|
714
|
-
### Haskell: catMaybes と mapMaybe
|
|
715
|
-
|
|
716
|
-
Haskell は `Maybe` のリスト操作に特化した関数群を持ちます。
|
|
717
|
-
|
|
718
|
-
```haskell
|
|
719
|
-
catMaybes [Just 1, Nothing, Just 3, Nothing] -- [1, 3]
|
|
720
|
-
|
|
721
|
-
mapMaybe safeHead [[1,2], [], [3]] -- [1, 3]
|
|
722
|
-
```
|
|
723
|
-
|
|
724
|
-
---
|
|
725
|
-
|
|
726
|
-
## 6.10 実践的な選択指針
|
|
727
|
-
|
|
728
|
-
### プロジェクト要件別の推奨
|
|
729
|
-
|
|
730
|
-
| 要件 | 推奨言語 | 理由 |
|
|
731
|
-
|------|---------|------|
|
|
732
|
-
| 完全な null 安全性 | Haskell, Rust | 言語レベルで null が存在しない |
|
|
733
|
-
| 合成構文の可読性 | Scala, C# | for 内包表記 / LINQ が読みやすい |
|
|
734
|
-
| 最も簡潔な短絡評価 | Rust | `?` 演算子 |
|
|
735
|
-
| 既存の Java/C# 資産との共存 | Java + Vavr, C# + LanguageExt | 段階的な Option 導入が可能 |
|
|
736
|
-
| 動的型付け + FP | Clojure | `some->` / `when-let` が強力 |
|
|
737
|
-
|
|
738
|
-
### Option 導入の段階的アプローチ
|
|
739
|
-
|
|
740
|
-
1. **まず**: `null` を返す関数を `Option` を返すように変更
|
|
741
|
-
2. **次に**: `map` / `flatMap` で Option を変換(`null` チェックの `if` 文を排除)
|
|
742
|
-
3. **そして**: `orElse` でフォールバックを宣言的に記述
|
|
743
|
-
4. **最後に**: 糖衣構文(for / do / LINQ / `?`)で合成を平坦化
|
|
744
|
-
|
|
745
|
-
---
|
|
746
|
-
|
|
747
|
-
## 6.11 まとめ
|
|
748
|
-
|
|
749
|
-
本章では、11 言語での Option/Maybe の実装を比較し、以下を確認しました:
|
|
750
|
-
|
|
751
|
-
**共通の原則**:
|
|
752
|
-
|
|
753
|
-
- Option = Some | None の 2 値構造は全言語で共通
|
|
754
|
-
- モナド的合成(1 つでも None なら全体が None)は同じ短絡評価パターン
|
|
755
|
-
- Best-effort と All-or-nothing の 2 つのエラーハンドリング戦略
|
|
756
|
-
|
|
757
|
-
**言語間の差異**:
|
|
758
|
-
|
|
759
|
-
- 実装方式は 4 段階(null なし → 型で強制 → ライブラリ → nil ベース)
|
|
760
|
-
- 合成構文は 4 系統(内包表記、? 演算子、パイプ、flatMap チェーン)
|
|
761
|
-
- フォールバックの構文は `orElse` / `||` / `or` / `lash` / `<|>` と多様
|
|
762
|
-
|
|
763
|
-
**学び**:
|
|
764
|
-
|
|
765
|
-
- Option は Part II の `flatMap` と同じモナドパターンの応用
|
|
766
|
-
- Rust の `?` 演算子は最も簡潔な短絡評価を実現
|
|
767
|
-
- 次章の Either/Result 型は、Option の「None に理由を持たせた」拡張
|
|
768
|
-
|
|
769
|
-
---
|
|
770
|
-
|
|
771
|
-
### 各言語の詳細記事
|
|
772
|
-
|
|
773
|
-
| 言語 | 記事リンク |
|
|
774
|
-
|------|-----------|
|
|
775
|
-
| Scala | [Part III: エラーハンドリング](../scala/part-3.md) |
|
|
776
|
-
| Java | [Part III: エラーハンドリング](../java/part-3.md) |
|
|
777
|
-
| F# | [Part III: エラーハンドリング](../fsharp/part-3.md) |
|
|
778
|
-
| C# | [Part III: エラーハンドリング](../csharp/part-3.md) |
|
|
779
|
-
| Haskell | [Part III: エラーハンドリング](../haskell/part-3.md) |
|
|
780
|
-
| Clojure | [Part III: エラーハンドリング](../clojure/part-3.md) |
|
|
781
|
-
| Elixir | [Part III: エラーハンドリング](../elixir/part-3.md) |
|
|
782
|
-
| Rust | [Part III: エラーハンドリング](../rust/part-3.md) |
|
|
783
|
-
| Python | [Part III: エラーハンドリング](../python/part-3.md) |
|
|
784
|
-
| TypeScript | [Part III: エラーハンドリング](../typescript/part-3.md) |
|
|
785
|
-
| Ruby | [Part III: エラーハンドリング](../ruby/part-3.md) |
|
|
1
|
+
# Part III - 第 6 章:Option 型による安全なエラーハンドリング
|
|
2
|
+
|
|
3
|
+
## 6.1 はじめに:null の問題
|
|
4
|
+
|
|
5
|
+
`null` は「10 億ドルの過ち」と呼ばれるほど、ソフトウェア開発に多大なバグをもたらしてきました。値が「ない」ことを `null` で表現すると、コンパイラはその検査を強制できず、実行時に `NullPointerException` や `TypeError` が発生します。
|
|
6
|
+
|
|
7
|
+
関数型プログラミングでは、値の有無を**型**で表現します。`Option`(Haskell では `Maybe`)型は、「値があるかもしれないし、ないかもしれない」を型レベルで表し、コンパイラによる安全性検査を可能にします。
|
|
8
|
+
|
|
9
|
+
本章では、11 言語での Option/Maybe の実装を横断的に比較し、以下を明らかにします:
|
|
10
|
+
|
|
11
|
+
- Option 型の実装方式(言語組み込み vs ライブラリ vs nil ベース)の違い
|
|
12
|
+
- 複数の Option を合成する方法(for / do / LINQ / ? 演算子)の多様性
|
|
13
|
+
- フォールバック(orElse)と 2 つのエラーハンドリング戦略
|
|
14
|
+
|
|
15
|
+
```plantuml
|
|
16
|
+
@startuml
|
|
17
|
+
!theme plain
|
|
18
|
+
|
|
19
|
+
rectangle "null の世界" #LightCoral {
|
|
20
|
+
card "値がある: \"hello\"" as v1
|
|
21
|
+
card "値がない: null" as v2
|
|
22
|
+
card "実行時エラー: NullPointerException" as err
|
|
23
|
+
v2 -right-> err : アクセス
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
rectangle "Option の世界" #LightGreen {
|
|
27
|
+
card "値がある: Some(\"hello\")" as o1
|
|
28
|
+
card "値がない: None" as o2
|
|
29
|
+
card "コンパイル時に検査" as safe
|
|
30
|
+
o2 -right-> safe : パターンマッチ必須
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
@enduml
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## 6.2 共通の本質:Option = Some | None
|
|
39
|
+
|
|
40
|
+
11 言語すべてで共通する Option の構造は、**2 つのケース**の判別共用体です:
|
|
41
|
+
|
|
42
|
+
1. **Some(value)**: 値が存在する
|
|
43
|
+
2. **None**: 値が存在しない
|
|
44
|
+
|
|
45
|
+
```plantuml
|
|
46
|
+
@startuml
|
|
47
|
+
!theme plain
|
|
48
|
+
|
|
49
|
+
rectangle "Option[A]" #LightBlue {
|
|
50
|
+
card "Some(value: A)" as some #LightGreen
|
|
51
|
+
card "None" as none #LightCoral
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
rectangle "操作" #LightYellow {
|
|
55
|
+
card "map: 中身を変換" as m
|
|
56
|
+
card "flatMap: 中身から新しい Option を生成" as fm
|
|
57
|
+
card "getOrElse: None ならデフォルト値" as goe
|
|
58
|
+
card "orElse: None なら別の Option を試す" as oe
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
some --> m
|
|
62
|
+
some --> fm
|
|
63
|
+
none --> goe
|
|
64
|
+
none --> oe
|
|
65
|
+
|
|
66
|
+
@enduml
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
3 つの言語グループから代表例を見てみましょう:
|
|
70
|
+
|
|
71
|
+
```haskell
|
|
72
|
+
-- Haskell: Maybe 型(言語組み込み)
|
|
73
|
+
data Maybe a = Nothing | Just a
|
|
74
|
+
|
|
75
|
+
-- 使用例
|
|
76
|
+
Just 42 :: Maybe Int -- 値がある
|
|
77
|
+
Nothing :: Maybe Int -- 値がない
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
```rust
|
|
81
|
+
// Rust: Option 型(言語組み込み)
|
|
82
|
+
let some_value: Option<i32> = Some(42);
|
|
83
|
+
let no_value: Option<i32> = None;
|
|
84
|
+
|
|
85
|
+
// パターンマッチでの取り出し(コンパイラが網羅性を検査)
|
|
86
|
+
match some_value {
|
|
87
|
+
Some(v) => println!("Value: {}", v),
|
|
88
|
+
None => println!("No value"),
|
|
89
|
+
}
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
```scala
|
|
93
|
+
// Scala: Option 型(標準ライブラリ)
|
|
94
|
+
val some: Option[Int] = Some(42)
|
|
95
|
+
val none: Option[Int] = None
|
|
96
|
+
|
|
97
|
+
// map で変換
|
|
98
|
+
some.map(_ * 2) // Some(84)
|
|
99
|
+
none.map(_ * 2) // None(安全に伝播)
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## 6.3 Option の実装方式:3 つのアプローチ
|
|
105
|
+
|
|
106
|
+
### アプローチ 1: 言語組み込み
|
|
107
|
+
|
|
108
|
+
型システムで `null` の使用自体を排除し、Option/Maybe を唯一の「値の不在」表現とします。
|
|
109
|
+
|
|
110
|
+
| 言語 | 型名 | Some | None | 特徴 |
|
|
111
|
+
|------|------|------|------|------|
|
|
112
|
+
| **Haskell** | `Maybe a` | `Just a` | `Nothing` | 完全な型安全性、`null` が存在しない |
|
|
113
|
+
| **Rust** | `Option<T>` | `Some(T)` | `None` | `null` が存在しない、`?` 演算子 |
|
|
114
|
+
| **F#** | `'a option` | `Some a` | `None` | .NET 上だが Option がファーストクラス |
|
|
115
|
+
|
|
116
|
+
### アプローチ 2: ライブラリ提供
|
|
117
|
+
|
|
118
|
+
言語自体には `null` が存在するが、FP ライブラリで Option 型を提供します。
|
|
119
|
+
|
|
120
|
+
| 言語 | ライブラリ | 型名 | Some | None |
|
|
121
|
+
|------|-----------|------|------|------|
|
|
122
|
+
| **Scala** | 標準ライブラリ | `Option[A]` | `Some(a)` | `None` |
|
|
123
|
+
| **Java** | Vavr | `Option<T>` | `Option.some(t)` | `Option.none()` |
|
|
124
|
+
| **C#** | LanguageExt | `Option<T>` | `Some(t)` | `None` |
|
|
125
|
+
| **TypeScript** | fp-ts | `Option<A>` | `O.some(a)` | `O.none` |
|
|
126
|
+
| **Python** | returns | `Maybe[A]` | `Some(a)` | `Nothing` |
|
|
127
|
+
| **Ruby** | dry-monads | `Maybe` | `Some(a)` | `None()` |
|
|
128
|
+
|
|
129
|
+
### アプローチ 3: nil ベース + マクロ / パターンマッチ
|
|
130
|
+
|
|
131
|
+
専用の型を持たず、`nil` を「値がない」として扱い、言語機能でサポートします。
|
|
132
|
+
|
|
133
|
+
| 言語 | 不在の表現 | サポート機構 |
|
|
134
|
+
|------|-----------|------------|
|
|
135
|
+
| **Clojure** | `nil` | `some->` / `some->>` マクロ、`when-let` |
|
|
136
|
+
| **Elixir** | `nil` | `with` 式、パターンマッチ |
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 6.4 TV 番組パース:Option の合成パターン
|
|
141
|
+
|
|
142
|
+
Option の真価は、複数の「失敗するかもしれない」操作を安全に連鎖させることです。TV 番組文字列 `"Breaking Bad (2008-2013)"` から名前・開始年・終了年を抽出するパターンで比較します。
|
|
143
|
+
|
|
144
|
+
### ビジネスロジック
|
|
145
|
+
|
|
146
|
+
```
|
|
147
|
+
"Breaking Bad (2008-2013)" →
|
|
148
|
+
extractName → Some("Breaking Bad")
|
|
149
|
+
extractYearStart → Some(2008)
|
|
150
|
+
extractYearEnd → Some(2013)
|
|
151
|
+
→ Some(TvShow("Breaking Bad", 2008, 2013))
|
|
152
|
+
|
|
153
|
+
"Invalid" →
|
|
154
|
+
extractName → None
|
|
155
|
+
→ None(以降の処理はスキップ)
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
### 代表 3 言語の比較
|
|
159
|
+
|
|
160
|
+
**Haskell**: do 記法
|
|
161
|
+
|
|
162
|
+
```haskell
|
|
163
|
+
parseShow :: String -> Maybe TvShow
|
|
164
|
+
parseShow rawShow = do
|
|
165
|
+
name <- extractName rawShow
|
|
166
|
+
yearStart <- extractYearStart rawShow `orElse` extractSingleYear rawShow
|
|
167
|
+
yearEnd <- extractYearEnd rawShow `orElse` extractSingleYear rawShow
|
|
168
|
+
return $ TvShow name yearStart yearEnd
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
**Scala**: for 内包表記
|
|
172
|
+
|
|
173
|
+
```scala
|
|
174
|
+
def parseShow(rawShow: String): Option[TvShow] =
|
|
175
|
+
for {
|
|
176
|
+
name <- extractName(rawShow)
|
|
177
|
+
yearStart <- extractYearStart(rawShow).orElse(extractSingleYear(rawShow))
|
|
178
|
+
yearEnd <- extractYearEnd(rawShow).orElse(extractSingleYear(rawShow))
|
|
179
|
+
} yield TvShow(name, yearStart, yearEnd)
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
**Rust**: ? 演算子
|
|
183
|
+
|
|
184
|
+
```rust
|
|
185
|
+
pub fn parse_show(raw_show: &str) -> Option<TvShow> {
|
|
186
|
+
let name = extract_name(raw_show)?;
|
|
187
|
+
let year_start = extract_year_start(raw_show)
|
|
188
|
+
.or_else(|| extract_single_year(raw_show))?;
|
|
189
|
+
let year_end = extract_year_end(raw_show)
|
|
190
|
+
.or_else(|| extract_single_year(raw_show))?;
|
|
191
|
+
|
|
192
|
+
Some(TvShow::new(&name, year_start, year_end))
|
|
193
|
+
}
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
**共通パターン**: どの言語でも、1 つでも `None` / `Nothing` が返れば、以降の処理はスキップされ全体が `None` になります。これが**モナド的合成**(短絡評価)です。
|
|
197
|
+
|
|
198
|
+
### 全 11 言語の実装
|
|
199
|
+
|
|
200
|
+
#### 関数型ファースト言語
|
|
201
|
+
|
|
202
|
+
<details>
|
|
203
|
+
<summary>Haskell 実装</summary>
|
|
204
|
+
|
|
205
|
+
```haskell
|
|
206
|
+
data TvShow = TvShow
|
|
207
|
+
{ showTitle :: String
|
|
208
|
+
, startYear :: Int
|
|
209
|
+
, endYear :: Int
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
orElse :: Maybe a -> Maybe a -> Maybe a
|
|
213
|
+
orElse (Just x) _ = Just x
|
|
214
|
+
orElse Nothing y = y
|
|
215
|
+
|
|
216
|
+
parseShow :: String -> Maybe TvShow
|
|
217
|
+
parseShow rawShow = do
|
|
218
|
+
name <- extractName rawShow
|
|
219
|
+
yearStart <- extractYearStart rawShow `orElse` extractSingleYear rawShow
|
|
220
|
+
yearEnd <- extractYearEnd rawShow `orElse` extractSingleYear rawShow
|
|
221
|
+
return $ TvShow name yearStart yearEnd
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
Haskell の do 記法は `Maybe` モナドに対して自動的に短絡評価を行います。`<|>` 演算子(`Alternative` 型クラス)でも `orElse` を表現できます。
|
|
225
|
+
|
|
226
|
+
</details>
|
|
227
|
+
|
|
228
|
+
<details>
|
|
229
|
+
<summary>Clojure 実装</summary>
|
|
230
|
+
|
|
231
|
+
```clojure
|
|
232
|
+
(defn parse-show [raw-show]
|
|
233
|
+
(when-let [name (extract-name raw-show)]
|
|
234
|
+
(when-let [year-start (or (extract-year-start raw-show)
|
|
235
|
+
(extract-single-year raw-show))]
|
|
236
|
+
(when-let [year-end (or (extract-year-end raw-show)
|
|
237
|
+
(extract-single-year raw-show))]
|
|
238
|
+
{:title name :start year-start :end year-end}))))
|
|
239
|
+
|
|
240
|
+
;; some-> マクロによる簡潔な nil チェーンも可能
|
|
241
|
+
(some-> {:user {:profile {:name "Alice"}}}
|
|
242
|
+
:user
|
|
243
|
+
:profile
|
|
244
|
+
:name)
|
|
245
|
+
; => "Alice"
|
|
246
|
+
```
|
|
247
|
+
|
|
248
|
+
Clojure は型レベルの Option を持ちませんが、`when-let` と `or` の組み合わせで同等の安全性を実現します。`some->` マクロは nil で自動停止するパイプラインです。
|
|
249
|
+
|
|
250
|
+
</details>
|
|
251
|
+
|
|
252
|
+
<details>
|
|
253
|
+
<summary>Elixir 実装</summary>
|
|
254
|
+
|
|
255
|
+
```elixir
|
|
256
|
+
def parse_show(raw_show) do
|
|
257
|
+
with name when not is_nil(name) <- extract_name(raw_show),
|
|
258
|
+
year_start when not is_nil(year_start) <-
|
|
259
|
+
or_else(extract_year_start(raw_show), fn -> extract_single_year(raw_show) end),
|
|
260
|
+
year_end when not is_nil(year_end) <-
|
|
261
|
+
or_else(extract_year_end(raw_show), fn -> extract_single_year(raw_show) end) do
|
|
262
|
+
%TvShow{title: name, start_year: year_start, end_year: year_end}
|
|
263
|
+
else
|
|
264
|
+
_ -> nil
|
|
265
|
+
end
|
|
266
|
+
end
|
|
267
|
+
|
|
268
|
+
def or_else(nil, fallback), do: fallback.()
|
|
269
|
+
def or_else(value, _fallback), do: value
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
Elixir の `with` 式は、各ステップでパターンマッチが失敗した場合に `else` 節に移行します。
|
|
273
|
+
|
|
274
|
+
</details>
|
|
275
|
+
|
|
276
|
+
<details>
|
|
277
|
+
<summary>F# 実装</summary>
|
|
278
|
+
|
|
279
|
+
```fsharp
|
|
280
|
+
type TvShow = { Title: string; Start: int; End: int }
|
|
281
|
+
|
|
282
|
+
let parseShow (rawShow: string) : TvShow option =
|
|
283
|
+
match extractName rawShow with
|
|
284
|
+
| None -> None
|
|
285
|
+
| Some name ->
|
|
286
|
+
let yearStart =
|
|
287
|
+
extractYearStart rawShow
|
|
288
|
+
|> Option.orElse (extractSingleYear rawShow)
|
|
289
|
+
let yearEnd =
|
|
290
|
+
extractYearEnd rawShow
|
|
291
|
+
|> Option.orElse (extractSingleYear rawShow)
|
|
292
|
+
match yearStart, yearEnd with
|
|
293
|
+
| Some start, Some endYear ->
|
|
294
|
+
Some { Title = name; Start = start; End = endYear }
|
|
295
|
+
| _ -> None
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
F# ではパターンマッチとパイプ演算子 `|>` を組み合わせます。`Option.orElse` で代替値を指定できます。
|
|
299
|
+
|
|
300
|
+
</details>
|
|
301
|
+
|
|
302
|
+
#### マルチパラダイム言語
|
|
303
|
+
|
|
304
|
+
<details>
|
|
305
|
+
<summary>Scala 実装</summary>
|
|
306
|
+
|
|
307
|
+
```scala
|
|
308
|
+
case class TvShow(name: String, yearStart: Int, yearEnd: Int)
|
|
309
|
+
|
|
310
|
+
def parseShow(rawShow: String): Option[TvShow] =
|
|
311
|
+
for {
|
|
312
|
+
name <- extractName(rawShow)
|
|
313
|
+
yearStart <- extractYearStart(rawShow).orElse(extractSingleYear(rawShow))
|
|
314
|
+
yearEnd <- extractYearEnd(rawShow).orElse(extractSingleYear(rawShow))
|
|
315
|
+
} yield TvShow(name, yearStart, yearEnd)
|
|
316
|
+
```
|
|
317
|
+
|
|
318
|
+
Scala の for 内包表記は `flatMap` / `map` に脱糖され、Option のモナド的合成を最も読みやすく表現します。
|
|
319
|
+
|
|
320
|
+
</details>
|
|
321
|
+
|
|
322
|
+
<details>
|
|
323
|
+
<summary>Rust 実装</summary>
|
|
324
|
+
|
|
325
|
+
```rust
|
|
326
|
+
pub struct TvShow {
|
|
327
|
+
pub name: String,
|
|
328
|
+
pub year_start: i32,
|
|
329
|
+
pub year_end: i32,
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
pub fn parse_show(raw_show: &str) -> Option<TvShow> {
|
|
333
|
+
let name = extract_name(raw_show)?;
|
|
334
|
+
let year_start = extract_year_start(raw_show)
|
|
335
|
+
.or_else(|| extract_single_year(raw_show))?;
|
|
336
|
+
let year_end = extract_year_end(raw_show)
|
|
337
|
+
.or_else(|| extract_single_year(raw_show))?;
|
|
338
|
+
|
|
339
|
+
Some(TvShow::new(&name, year_start, year_end))
|
|
340
|
+
}
|
|
341
|
+
```
|
|
342
|
+
|
|
343
|
+
Rust の `?` 演算子は `None` に遭遇すると即座に `None` を返します。全言語中で最も簡潔な短絡評価構文です。
|
|
344
|
+
|
|
345
|
+
</details>
|
|
346
|
+
|
|
347
|
+
<details>
|
|
348
|
+
<summary>TypeScript (fp-ts) 実装</summary>
|
|
349
|
+
|
|
350
|
+
```typescript
|
|
351
|
+
interface TvShow {
|
|
352
|
+
readonly title: string
|
|
353
|
+
readonly start: number
|
|
354
|
+
readonly end: number
|
|
355
|
+
}
|
|
356
|
+
|
|
357
|
+
const parseShow = (rawShow: string): O.Option<TvShow> =>
|
|
358
|
+
pipe(
|
|
359
|
+
O.Do,
|
|
360
|
+
O.bind('title', () => extractName(rawShow)),
|
|
361
|
+
O.bind('start', () =>
|
|
362
|
+
pipe(
|
|
363
|
+
extractYearStart(rawShow),
|
|
364
|
+
O.orElse(() => extractSingleYear(rawShow))
|
|
365
|
+
)
|
|
366
|
+
),
|
|
367
|
+
O.bind('end', () =>
|
|
368
|
+
pipe(
|
|
369
|
+
extractYearEnd(rawShow),
|
|
370
|
+
O.orElse(() => extractSingleYear(rawShow))
|
|
371
|
+
)
|
|
372
|
+
),
|
|
373
|
+
O.map(({ title, start, end }) => ({ title, start, end }))
|
|
374
|
+
)
|
|
375
|
+
```
|
|
376
|
+
|
|
377
|
+
fp-ts の `O.Do` + `O.bind` は Haskell の do 記法を模倣した構文です。
|
|
378
|
+
|
|
379
|
+
</details>
|
|
380
|
+
|
|
381
|
+
#### OOP + FP ライブラリ言語
|
|
382
|
+
|
|
383
|
+
<details>
|
|
384
|
+
<summary>Java (Vavr) 実装</summary>
|
|
385
|
+
|
|
386
|
+
```java
|
|
387
|
+
record TvShow(String name, int yearStart, int yearEnd) {}
|
|
388
|
+
|
|
389
|
+
Option<TvShow> parseShow(String rawShow) {
|
|
390
|
+
return extractName(rawShow).flatMap(name ->
|
|
391
|
+
extractYearStart(rawShow).orElse(() -> extractSingleYear(rawShow))
|
|
392
|
+
.flatMap(yearStart ->
|
|
393
|
+
extractYearEnd(rawShow).orElse(() -> extractSingleYear(rawShow))
|
|
394
|
+
.map(yearEnd -> new TvShow(name, yearStart, yearEnd))
|
|
395
|
+
)
|
|
396
|
+
);
|
|
397
|
+
}
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
Java は for 内包表記を持たないため、`flatMap` のネストが深くなります。
|
|
401
|
+
|
|
402
|
+
</details>
|
|
403
|
+
|
|
404
|
+
<details>
|
|
405
|
+
<summary>C# (LanguageExt) 実装</summary>
|
|
406
|
+
|
|
407
|
+
```csharp
|
|
408
|
+
record TvShow(string Name, int YearStart, int YearEnd);
|
|
409
|
+
|
|
410
|
+
Option<TvShow> ParseShow(string rawShow) =>
|
|
411
|
+
from name in ExtractName(rawShow)
|
|
412
|
+
from yearStart in ExtractYearStart(rawShow) || ExtractSingleYear(rawShow)
|
|
413
|
+
from yearEnd in ExtractYearEnd(rawShow) || ExtractSingleYear(rawShow)
|
|
414
|
+
select new TvShow(name, yearStart, yearEnd);
|
|
415
|
+
```
|
|
416
|
+
|
|
417
|
+
C# の LINQ クエリ式と LanguageExt の `||` 演算子(orElse)の組み合わせで、Scala の for 内包表記に匹敵する簡潔さを実現しています。
|
|
418
|
+
|
|
419
|
+
</details>
|
|
420
|
+
|
|
421
|
+
<details>
|
|
422
|
+
<summary>Python (returns) 実装</summary>
|
|
423
|
+
|
|
424
|
+
```python
|
|
425
|
+
from returns.maybe import Maybe, Nothing, Some
|
|
426
|
+
|
|
427
|
+
def parse_show(raw_show: str) -> Maybe[TvShow]:
|
|
428
|
+
name = extract_name(raw_show)
|
|
429
|
+
year_start = extract_year_start(raw_show).lash(
|
|
430
|
+
lambda _: extract_single_year(raw_show)
|
|
431
|
+
)
|
|
432
|
+
year_end = extract_year_end(raw_show).lash(
|
|
433
|
+
lambda _: extract_single_year(raw_show)
|
|
434
|
+
)
|
|
435
|
+
|
|
436
|
+
return name.bind(
|
|
437
|
+
lambda n: year_start.bind(
|
|
438
|
+
lambda s: year_end.map(lambda e: TvShow(n, s, e))
|
|
439
|
+
)
|
|
440
|
+
)
|
|
441
|
+
```
|
|
442
|
+
|
|
443
|
+
Python の `returns` ライブラリでは `lash` が `orElse` に相当します。
|
|
444
|
+
|
|
445
|
+
</details>
|
|
446
|
+
|
|
447
|
+
<details>
|
|
448
|
+
<summary>Ruby (dry-monads) 実装</summary>
|
|
449
|
+
|
|
450
|
+
```ruby
|
|
451
|
+
require 'dry/monads'
|
|
452
|
+
include Dry::Monads[:maybe]
|
|
453
|
+
|
|
454
|
+
TvShow = Struct.new(:title, :start_year, :end_year, keyword_init: true)
|
|
455
|
+
|
|
456
|
+
def self.parse_show(raw_show)
|
|
457
|
+
name = extract_name(raw_show)
|
|
458
|
+
year_start = extract_year_start(raw_show).or(extract_single_year(raw_show))
|
|
459
|
+
year_end = extract_year_end(raw_show).or(extract_single_year(raw_show))
|
|
460
|
+
|
|
461
|
+
name.bind do |n|
|
|
462
|
+
year_start.bind do |ys|
|
|
463
|
+
year_end.fmap do |ye|
|
|
464
|
+
TvShow.new(title: n, start_year: ys, end_year: ye)
|
|
465
|
+
end
|
|
466
|
+
end
|
|
467
|
+
end
|
|
468
|
+
end
|
|
469
|
+
```
|
|
470
|
+
|
|
471
|
+
Ruby の `dry-monads` では `fmap`(map)と `bind`(flatMap)を使います。
|
|
472
|
+
|
|
473
|
+
</details>
|
|
474
|
+
|
|
475
|
+
---
|
|
476
|
+
|
|
477
|
+
## 6.5 合成構文の比較
|
|
478
|
+
|
|
479
|
+
Option のモナド的合成を表現する構文は言語ごとに大きく異なります。
|
|
480
|
+
|
|
481
|
+
| 言語 | 合成構文 | 可読性 |
|
|
482
|
+
|------|---------|--------|
|
|
483
|
+
| **Scala** | `for { x <- f1; y <- f2 } yield ...` | 高い |
|
|
484
|
+
| **Haskell** | `do { x <- f1; y <- f2; return ... }` | 高い |
|
|
485
|
+
| **Rust** | `let x = f1?; let y = f2?;` | 非常に高い |
|
|
486
|
+
| **C#** | `from x in f1 from y in f2 select ...` | 高い |
|
|
487
|
+
| **F#** | パターンマッチ + パイプ | 中程度 |
|
|
488
|
+
| **Clojure** | `(when-let [x f1] (when-let [y f2] ...))` | 中程度 |
|
|
489
|
+
| **Elixir** | `with x <- f1, y <- f2 do ... end` | 中程度 |
|
|
490
|
+
| **TypeScript** | `pipe(O.Do, O.bind('x', () => f1), ...)` | 中程度 |
|
|
491
|
+
| **Java** | `f1.flatMap(x -> f2.flatMap(y -> ...))` | 低い |
|
|
492
|
+
| **Python** | `f1.bind(lambda x: f2.bind(lambda y: ...))` | 低い |
|
|
493
|
+
| **Ruby** | `f1.bind { \|x\| f2.fmap { \|y\| ... } }` | 低い |
|
|
494
|
+
|
|
495
|
+
**発見**: Rust の `?` 演算子は全言語中で最も簡潔な短絡評価構文です。通常のコードに `?` を付けるだけで None 伝播を実現し、専用の糖衣構文や do 記法が不要です。
|
|
496
|
+
|
|
497
|
+
---
|
|
498
|
+
|
|
499
|
+
## 6.6 フォールバック(orElse)の比較
|
|
500
|
+
|
|
501
|
+
「最初の操作が失敗したら、別の操作を試す」パターンの言語別実装:
|
|
502
|
+
|
|
503
|
+
| 言語 | 構文 | 例 |
|
|
504
|
+
|------|------|-----|
|
|
505
|
+
| **Haskell** | `` `orElse` `` / `<\|>` | `extractYearStart raw \`orElse\` extractSingleYear raw` |
|
|
506
|
+
| **Scala** | `.orElse(...)` | `extractYearStart(raw).orElse(extractSingleYear(raw))` |
|
|
507
|
+
| **Rust** | `.or_else(\|\| ...)` | `extract_year_start(raw).or_else(\|\| extract_single_year(raw))` |
|
|
508
|
+
| **F#** | `\|> Option.orElse` | `extractYearStart raw \|> Option.orElse (extractSingleYear raw)` |
|
|
509
|
+
| **C#** | `\|\|` | `ExtractYearStart(raw) \|\| ExtractSingleYear(raw)` |
|
|
510
|
+
| **Clojure** | `(or ...)` | `(or (extract-year-start raw) (extract-single-year raw))` |
|
|
511
|
+
| **Elixir** | `or_else(val, fn)` | `or_else(extract_year_start(raw), fn -> extract_single_year(raw) end)` |
|
|
512
|
+
| **Java** | `.orElse(() -> ...)` | `extractYearStart(raw).orElse(() -> extractSingleYear(raw))` |
|
|
513
|
+
| **TypeScript** | `O.orElse(() -> ...)` | `pipe(extractYearStart(raw), O.orElse(() => extractSingleYear(raw)))` |
|
|
514
|
+
| **Python** | `.lash(lambda _: ...)` | `extract_year_start(raw).lash(lambda _: extract_single_year(raw))` |
|
|
515
|
+
| **Ruby** | `.or(...)` | `extract_year_start(raw).or(extract_single_year(raw))` |
|
|
516
|
+
|
|
517
|
+
C# の `||` 演算子は最も簡潔で、ブーリアンの `or` と同じ感覚で Option のフォールバックを記述できます。
|
|
518
|
+
|
|
519
|
+
---
|
|
520
|
+
|
|
521
|
+
## 6.7 エラーハンドリング戦略:2 つのアプローチ
|
|
522
|
+
|
|
523
|
+
複数の入力をパースする際、2 つの戦略があります。
|
|
524
|
+
|
|
525
|
+
### Best-effort(できるだけ多く成功)
|
|
526
|
+
|
|
527
|
+
パースに成功したものだけを返し、失敗したものは静かに無視します。
|
|
528
|
+
|
|
529
|
+
```scala
|
|
530
|
+
// Scala
|
|
531
|
+
val shows: List[TvShow] = rawShows.flatMap(parseShow)
|
|
532
|
+
```
|
|
533
|
+
|
|
534
|
+
```haskell
|
|
535
|
+
-- Haskell: catMaybes が Maybe のリストから Just の値だけを抽出
|
|
536
|
+
parseShowsBestEffort :: [String] -> [TvShow]
|
|
537
|
+
parseShowsBestEffort = catMaybes . map parseShow
|
|
538
|
+
```
|
|
539
|
+
|
|
540
|
+
```clojure
|
|
541
|
+
;; Clojure: keep は nil でない結果のみを返す
|
|
542
|
+
(keep parse-show raw-shows)
|
|
543
|
+
```
|
|
544
|
+
|
|
545
|
+
```python
|
|
546
|
+
# Python: Some の値だけを抽出
|
|
547
|
+
[show.unwrap() for show in map(parse_show, raw_shows) if isinstance(show, Some)]
|
|
548
|
+
```
|
|
549
|
+
|
|
550
|
+
### All-or-nothing(全て成功 or 全て失敗)
|
|
551
|
+
|
|
552
|
+
1 つでも失敗したら全体を失敗とします。
|
|
553
|
+
|
|
554
|
+
```scala
|
|
555
|
+
// Scala: traverse(リストの各要素に Option 関数を適用し、全て Some なら Some[List] を返す)
|
|
556
|
+
def parseShows(rawShows: List[String]): Option[List[TvShow]] =
|
|
557
|
+
rawShows.traverse(parseShow)
|
|
558
|
+
```
|
|
559
|
+
|
|
560
|
+
```haskell
|
|
561
|
+
-- Haskell: mapM は traverse と同等
|
|
562
|
+
parseShowsAllOrNothing :: [String] -> Maybe [TvShow]
|
|
563
|
+
parseShowsAllOrNothing = mapM parseShow
|
|
564
|
+
```
|
|
565
|
+
|
|
566
|
+
```typescript
|
|
567
|
+
// TypeScript (fp-ts): traverse
|
|
568
|
+
const parseShows = (rawShows: readonly string[]): O.Option<readonly TvShow[]> =>
|
|
569
|
+
pipe(rawShows, RA.traverse(O.Applicative)(parseShow))
|
|
570
|
+
```
|
|
571
|
+
|
|
572
|
+
### 戦略比較表
|
|
573
|
+
|
|
574
|
+
| 戦略 | Scala | Haskell | Clojure | Elixir | Rust | Python | TypeScript | Ruby |
|
|
575
|
+
|------|-------|---------|---------|--------|------|--------|------------|------|
|
|
576
|
+
| Best-effort | `flatMap` | `catMaybes` | `keep` | `Enum.reject(&is_nil/1)` | `filter_map` | `isinstance` | `RA.compact` | `select(&:some?)` |
|
|
577
|
+
| All-or-nothing | `traverse` | `mapM` | 手動実装 | 手動実装 | `collect()` | 手動実装 | `RA.traverse` | 手動実装 |
|
|
578
|
+
|
|
579
|
+
---
|
|
580
|
+
|
|
581
|
+
## 6.8 比較分析:3 つの発見
|
|
582
|
+
|
|
583
|
+
### 発見 1: Option の実装方式は安全性のレベルを決定する
|
|
584
|
+
|
|
585
|
+
```plantuml
|
|
586
|
+
@startuml
|
|
587
|
+
!theme plain
|
|
588
|
+
left to right direction
|
|
589
|
+
|
|
590
|
+
rectangle "Level 1: null が存在しない" #LightGreen {
|
|
591
|
+
card "Haskell (Maybe)" as h
|
|
592
|
+
card "Rust (Option)" as rs
|
|
593
|
+
}
|
|
594
|
+
|
|
595
|
+
rectangle "Level 2: 型で Option を強制" #LightBlue {
|
|
596
|
+
card "Scala (Option)" as sc
|
|
597
|
+
card "F# (option)" as fs
|
|
598
|
+
}
|
|
599
|
+
|
|
600
|
+
rectangle "Level 3: ライブラリで Option を提供" #LightYellow {
|
|
601
|
+
card "Java + Vavr" as jv
|
|
602
|
+
card "C# + LanguageExt" as cs
|
|
603
|
+
card "TypeScript + fp-ts" as ts
|
|
604
|
+
card "Python + returns" as py
|
|
605
|
+
card "Ruby + dry-monads" as rb
|
|
606
|
+
}
|
|
607
|
+
|
|
608
|
+
rectangle "Level 4: nil ベース + 言語機能" #LightCoral {
|
|
609
|
+
card "Clojure (nil + when-let)" as clj
|
|
610
|
+
card "Elixir (nil + with)" as ex
|
|
611
|
+
}
|
|
612
|
+
|
|
613
|
+
@enduml
|
|
614
|
+
```
|
|
615
|
+
|
|
616
|
+
| レベル | 言語 | 安全性 | 特徴 |
|
|
617
|
+
|--------|------|--------|------|
|
|
618
|
+
| **null なし** | Haskell, Rust | 最高 | コンパイラが Option の処理を強制 |
|
|
619
|
+
| **型で強制** | Scala, F# | 高い | null は存在するが Option 使用が慣習 |
|
|
620
|
+
| **ライブラリ** | Java, C#, TypeScript, Python, Ruby | 中程度 | null を使う旧コードとの共存が必要 |
|
|
621
|
+
| **nil ベース** | Clojure, Elixir | 慣習依存 | 言語機能で安全にサポートするが型保証はない |
|
|
622
|
+
|
|
623
|
+
### 発見 2: 合成構文は 4 系統に分類できる
|
|
624
|
+
|
|
625
|
+
1. **内包表記系**: Scala (for), Haskell (do), C# (LINQ), Clojure (when-let)
|
|
626
|
+
|
|
627
|
+
|
|
628
|
+
- ネストが平坦化され、最も可読性が高い
|
|
629
|
+
2. **演算子系**: Rust (`?`)
|
|
630
|
+
|
|
631
|
+
|
|
632
|
+
- 最も簡潔で、通常のコードに自然に溶け込む
|
|
633
|
+
3. **パイプ系**: F# (`|>`), Elixir (`with`), TypeScript (`pipe`)
|
|
634
|
+
|
|
635
|
+
|
|
636
|
+
- データの流れが明確
|
|
637
|
+
4. **flatMap チェーン系**: Java, Python, Ruby
|
|
638
|
+
|
|
639
|
+
|
|
640
|
+
- 糖衣構文がなく、ネストが深くなりやすい
|
|
641
|
+
|
|
642
|
+
### 発見 3: Option は Part II の flatMap の延長線上にある
|
|
643
|
+
|
|
644
|
+
Part II 第 5 章で学んだ `flatMap` のパターンがそのまま適用されています:
|
|
645
|
+
|
|
646
|
+
```
|
|
647
|
+
List.flatMap: List[A] → (A → List[B]) → List[B]
|
|
648
|
+
Option.flatMap: Option[A] → (A → Option[B]) → Option[B]
|
|
649
|
+
```
|
|
650
|
+
|
|
651
|
+
`List` の `flatMap` が「0 個以上の結果」を扱うのに対し、`Option` の `flatMap` は「0 個か 1 個の結果」を扱います。for 内包表記や do 記法が両方で使えるのは、同じモナドインターフェースを共有しているからです。
|
|
652
|
+
|
|
653
|
+
---
|
|
654
|
+
|
|
655
|
+
## 6.9 言語固有の特徴
|
|
656
|
+
|
|
657
|
+
### Rust: ? 演算子の簡潔さ
|
|
658
|
+
|
|
659
|
+
Rust の `?` 演算子は Option だけでなく `Result` 型にも使える汎用的な短絡評価構文です。
|
|
660
|
+
|
|
661
|
+
```rust
|
|
662
|
+
// ? なし(冗長)
|
|
663
|
+
fn parse_show(raw: &str) -> Option<TvShow> {
|
|
664
|
+
match extract_name(raw) {
|
|
665
|
+
None => None,
|
|
666
|
+
Some(name) => match extract_year_start(raw) {
|
|
667
|
+
None => None,
|
|
668
|
+
Some(start) => match extract_year_end(raw) {
|
|
669
|
+
None => None,
|
|
670
|
+
Some(end) => Some(TvShow::new(&name, start, end)),
|
|
671
|
+
}
|
|
672
|
+
}
|
|
673
|
+
}
|
|
674
|
+
}
|
|
675
|
+
|
|
676
|
+
// ? あり(簡潔)
|
|
677
|
+
fn parse_show(raw: &str) -> Option<TvShow> {
|
|
678
|
+
let name = extract_name(raw)?;
|
|
679
|
+
let start = extract_year_start(raw)?;
|
|
680
|
+
let end = extract_year_end(raw)?;
|
|
681
|
+
Some(TvShow::new(&name, start, end))
|
|
682
|
+
}
|
|
683
|
+
```
|
|
684
|
+
|
|
685
|
+
### Clojure: some-> マクロ
|
|
686
|
+
|
|
687
|
+
Clojure の `some->` は nil で自動停止するパイプラインマクロです。ネストした Map のアクセスに特に有効です。
|
|
688
|
+
|
|
689
|
+
```clojure
|
|
690
|
+
;; nil が出たら即座に nil を返す
|
|
691
|
+
(some-> {:user {:profile {:name "Alice"}}}
|
|
692
|
+
:user
|
|
693
|
+
:profile
|
|
694
|
+
:name
|
|
695
|
+
clojure.string/upper-case)
|
|
696
|
+
; => "ALICE"
|
|
697
|
+
|
|
698
|
+
(some-> {:user {:profile nil}}
|
|
699
|
+
:user
|
|
700
|
+
:profile
|
|
701
|
+
:name)
|
|
702
|
+
; => nil(:profile が nil なので停止)
|
|
703
|
+
```
|
|
704
|
+
|
|
705
|
+
### C#: || 演算子による OrElse
|
|
706
|
+
|
|
707
|
+
LanguageExt の `||` 演算子は、ブーリアン論理和と同じ感覚で Option のフォールバックを記述できます。
|
|
708
|
+
|
|
709
|
+
```csharp
|
|
710
|
+
// ブーリアンと同じ構文
|
|
711
|
+
var result = ExtractYearStart(raw) || ExtractSingleYear(raw);
|
|
712
|
+
```
|
|
713
|
+
|
|
714
|
+
### Haskell: catMaybes と mapMaybe
|
|
715
|
+
|
|
716
|
+
Haskell は `Maybe` のリスト操作に特化した関数群を持ちます。
|
|
717
|
+
|
|
718
|
+
```haskell
|
|
719
|
+
catMaybes [Just 1, Nothing, Just 3, Nothing] -- [1, 3]
|
|
720
|
+
|
|
721
|
+
mapMaybe safeHead [[1,2], [], [3]] -- [1, 3]
|
|
722
|
+
```
|
|
723
|
+
|
|
724
|
+
---
|
|
725
|
+
|
|
726
|
+
## 6.10 実践的な選択指針
|
|
727
|
+
|
|
728
|
+
### プロジェクト要件別の推奨
|
|
729
|
+
|
|
730
|
+
| 要件 | 推奨言語 | 理由 |
|
|
731
|
+
|------|---------|------|
|
|
732
|
+
| 完全な null 安全性 | Haskell, Rust | 言語レベルで null が存在しない |
|
|
733
|
+
| 合成構文の可読性 | Scala, C# | for 内包表記 / LINQ が読みやすい |
|
|
734
|
+
| 最も簡潔な短絡評価 | Rust | `?` 演算子 |
|
|
735
|
+
| 既存の Java/C# 資産との共存 | Java + Vavr, C# + LanguageExt | 段階的な Option 導入が可能 |
|
|
736
|
+
| 動的型付け + FP | Clojure | `some->` / `when-let` が強力 |
|
|
737
|
+
|
|
738
|
+
### Option 導入の段階的アプローチ
|
|
739
|
+
|
|
740
|
+
1. **まず**: `null` を返す関数を `Option` を返すように変更
|
|
741
|
+
2. **次に**: `map` / `flatMap` で Option を変換(`null` チェックの `if` 文を排除)
|
|
742
|
+
3. **そして**: `orElse` でフォールバックを宣言的に記述
|
|
743
|
+
4. **最後に**: 糖衣構文(for / do / LINQ / `?`)で合成を平坦化
|
|
744
|
+
|
|
745
|
+
---
|
|
746
|
+
|
|
747
|
+
## 6.11 まとめ
|
|
748
|
+
|
|
749
|
+
本章では、11 言語での Option/Maybe の実装を比較し、以下を確認しました:
|
|
750
|
+
|
|
751
|
+
**共通の原則**:
|
|
752
|
+
|
|
753
|
+
- Option = Some | None の 2 値構造は全言語で共通
|
|
754
|
+
- モナド的合成(1 つでも None なら全体が None)は同じ短絡評価パターン
|
|
755
|
+
- Best-effort と All-or-nothing の 2 つのエラーハンドリング戦略
|
|
756
|
+
|
|
757
|
+
**言語間の差異**:
|
|
758
|
+
|
|
759
|
+
- 実装方式は 4 段階(null なし → 型で強制 → ライブラリ → nil ベース)
|
|
760
|
+
- 合成構文は 4 系統(内包表記、? 演算子、パイプ、flatMap チェーン)
|
|
761
|
+
- フォールバックの構文は `orElse` / `||` / `or` / `lash` / `<|>` と多様
|
|
762
|
+
|
|
763
|
+
**学び**:
|
|
764
|
+
|
|
765
|
+
- Option は Part II の `flatMap` と同じモナドパターンの応用
|
|
766
|
+
- Rust の `?` 演算子は最も簡潔な短絡評価を実現
|
|
767
|
+
- 次章の Either/Result 型は、Option の「None に理由を持たせた」拡張
|
|
768
|
+
|
|
769
|
+
---
|
|
770
|
+
|
|
771
|
+
### 各言語の詳細記事
|
|
772
|
+
|
|
773
|
+
| 言語 | 記事リンク |
|
|
774
|
+
|------|-----------|
|
|
775
|
+
| Scala | [Part III: エラーハンドリング](../scala/part-3.md) |
|
|
776
|
+
| Java | [Part III: エラーハンドリング](../java/part-3.md) |
|
|
777
|
+
| F# | [Part III: エラーハンドリング](../fsharp/part-3.md) |
|
|
778
|
+
| C# | [Part III: エラーハンドリング](../csharp/part-3.md) |
|
|
779
|
+
| Haskell | [Part III: エラーハンドリング](../haskell/part-3.md) |
|
|
780
|
+
| Clojure | [Part III: エラーハンドリング](../clojure/part-3.md) |
|
|
781
|
+
| Elixir | [Part III: エラーハンドリング](../elixir/part-3.md) |
|
|
782
|
+
| Rust | [Part III: エラーハンドリング](../rust/part-3.md) |
|
|
783
|
+
| Python | [Part III: エラーハンドリング](../python/part-3.md) |
|
|
784
|
+
| TypeScript | [Part III: エラーハンドリング](../typescript/part-3.md) |
|
|
785
|
+
| Ruby | [Part III: エラーハンドリング](../ruby/part-3.md) |
|