@k2works/claude-code-booster 3.6.1 → 3.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +42 -42
- package/bin/claude-code-booster +90 -90
- package/lib/assets/.claude/README.md +258 -239
- package/lib/assets/.claude/agent-memory/xp-programmer/MEMORY.md +6 -0
- package/lib/assets/.claude/agent-memory/xp-programmer/project_cargo_tracker.md +11 -0
- package/lib/assets/.claude/agent-memory/xp-programmer/project_ddd_patterns.md +27 -0
- package/lib/assets/.claude/agent-memory/xp-programmer/project_us07_route_assignment.md +19 -0
- package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
- package/lib/assets/.claude/settings.json +11 -11
- package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +111 -111
- package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +83 -83
- package/lib/assets/.claude/skills/analyzing-business/SKILL.md +95 -95
- package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +77 -77
- package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +117 -117
- package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +84 -84
- package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +95 -95
- package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +95 -95
- package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +91 -91
- package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +101 -101
- package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +89 -89
- package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +80 -80
- package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +72 -72
- package/lib/assets/.claude/skills/creating-adr/SKILL.md +113 -113
- package/lib/assets/.claude/skills/developing-backend/SKILL.md +100 -100
- package/lib/assets/.claude/skills/developing-frontend/SKILL.md +93 -93
- package/lib/assets/.claude/skills/developing-release/SKILL.md +120 -120
- package/lib/assets/.claude/skills/generating-bmc/SKILL.md +97 -0
- package/lib/assets/.claude/skills/generating-slides/SKILL.md +94 -94
- package/lib/assets/.claude/skills/git-commit/SKILL.md +81 -81
- package/lib/assets/.claude/skills/killing-processes/SKILL.md +44 -44
- package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -59
- package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -54
- package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -67
- package/lib/assets/.claude/skills/operating-docs/SKILL.md +219 -219
- package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -77
- package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -63
- package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +104 -104
- package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +162 -162
- package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +158 -158
- package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +144 -144
- package/lib/assets/.claude/skills/planning-releases/SKILL.md +119 -119
- package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +151 -151
- package/lib/assets/.claude/skills/tracking-progress/SKILL.md +91 -91
- package/lib/assets/.claude/skills/validating-iteration-plan/SKILL.md +215 -215
- package/lib/assets/.devcontainer/devcontainer.json +34 -34
- package/lib/assets/.env.example +17 -17
- package/lib/assets/.gitattributes +4 -4
- package/lib/assets/.github/workflows/docker-publish.yml +77 -77
- package/lib/assets/.github/workflows/mkdocs.yml +39 -39
- package/lib/assets/AGENTS.md +94 -94
- package/lib/assets/CLAUDE.md +1 -0
- package/lib/assets/README.md +254 -254
- package/lib/assets/docker-compose.yml +33 -33
- package/lib/assets/docs/adr/index.md +10 -10
- package/lib/assets/docs/article/functional-desgin-ppp/all/01-immutability-and-data-transformation.md +475 -475
- package/lib/assets/docs/article/functional-desgin-ppp/all/02-function-composition.md +519 -519
- package/lib/assets/docs/article/functional-desgin-ppp/all/03-polymorphism.md +537 -537
- package/lib/assets/docs/article/functional-desgin-ppp/all/04-data-validation.md +300 -300
- package/lib/assets/docs/article/functional-desgin-ppp/all/05-property-based-testing.md +320 -320
- package/lib/assets/docs/article/functional-desgin-ppp/all/06-tdd-and-functional.md +498 -498
- package/lib/assets/docs/article/functional-desgin-ppp/all/07-composite-pattern.md +298 -298
- package/lib/assets/docs/article/functional-desgin-ppp/all/08-decorator-pattern.md +291 -291
- package/lib/assets/docs/article/functional-desgin-ppp/all/09-adapter-pattern.md +336 -336
- package/lib/assets/docs/article/functional-desgin-ppp/all/10-strategy-pattern.md +303 -303
- package/lib/assets/docs/article/functional-desgin-ppp/all/11-command-pattern.md +286 -286
- package/lib/assets/docs/article/functional-desgin-ppp/all/12-visitor-pattern.md +322 -322
- package/lib/assets/docs/article/functional-desgin-ppp/all/13-abstract-factory-pattern.md +319 -319
- package/lib/assets/docs/article/functional-desgin-ppp/all/14-abstract-server-pattern.md +365 -365
- package/lib/assets/docs/article/functional-desgin-ppp/all/15-gossiping-bus-drivers.md +156 -156
- package/lib/assets/docs/article/functional-desgin-ppp/all/16-payroll-system.md +178 -178
- package/lib/assets/docs/article/functional-desgin-ppp/all/17-video-rental-system.md +312 -312
- package/lib/assets/docs/article/functional-desgin-ppp/all/18-concurrency-system.md +287 -287
- package/lib/assets/docs/article/functional-desgin-ppp/all/19-wa-tor-simulation.md +286 -286
- package/lib/assets/docs/article/functional-desgin-ppp/all/20-pattern-interactions.md +274 -274
- package/lib/assets/docs/article/functional-desgin-ppp/all/21-best-practices.md +294 -294
- package/lib/assets/docs/article/functional-desgin-ppp/all/22-oo-to-fp-migration.md +337 -337
- package/lib/assets/docs/article/functional-desgin-ppp/all/index.md +388 -388
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/01-immutability-and-data-transformation.md +273 -273
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/02-function-composition.md +380 -380
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/03-polymorphism.md +384 -384
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/04-clojure-spec.md +350 -350
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/05-property-based-testing.md +352 -352
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/06-tdd-in-functional.md +383 -383
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/07-composite-pattern.md +529 -529
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/08-decorator-pattern.md +395 -395
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/09-adapter-pattern.md +399 -399
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/10-strategy-pattern.md +485 -485
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/11-command-pattern.md +566 -566
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/12-visitor-pattern.md +567 -567
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/13-abstract-factory-pattern.md +475 -475
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/14-abstract-server-pattern.md +462 -462
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/15-gossiping-bus-drivers.md +325 -325
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/16-payroll-system.md +401 -401
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/17-video-rental-system.md +450 -450
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/18-concurrency-system.md +475 -475
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/19-wator-simulation.md +739 -739
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/20-pattern-interactions.md +567 -567
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/21-best-practices.md +518 -518
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/22-oo-to-fp-migration.md +532 -532
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/index.md +241 -241
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/01-immutability-and-data-transformation.md +383 -383
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/02-function-composition.md +374 -374
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/03-polymorphism.md +375 -375
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/04-data-validation.md +195 -195
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/05-property-based-testing.md +268 -268
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/06-tdd-and-fp.md +294 -294
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/07-effects-and-pure-functions.md +164 -164
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/08-error-handling-strategies.md +168 -168
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/09-io-and-external-systems.md +254 -254
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/10-concurrency-patterns.md +269 -269
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/11-command-pattern.md +148 -148
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/12-visitor-pattern.md +176 -176
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/13-abstract-factory-pattern.md +604 -604
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/14-abstract-server-pattern.md +729 -729
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/15-gossiping-bus-drivers.md +291 -291
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/16-payroll-system.md +420 -420
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/17-video-rental-system.md +319 -319
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/18-concurrency-system.md +466 -466
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/19-wator-simulation.md +523 -523
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/20-pattern-interactions.md +287 -287
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/21-best-practices.md +340 -340
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/22-oo-to-fp-migration.md +395 -395
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/index.md +248 -248
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/01-immutability-and-data-transformation.md +384 -384
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/02-function-composition.md +452 -452
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/03-polymorphism.md +495 -495
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/04-data-validation.md +416 -416
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/05-property-based-testing.md +382 -382
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/06-tdd-functional.md +687 -687
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/07-composite-pattern.md +442 -442
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/08-decorator-pattern.md +479 -479
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/09-adapter-pattern.md +479 -479
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/10-strategy-pattern.md +427 -427
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/11-command-pattern.md +428 -428
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/12-visitor-pattern.md +339 -339
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/13-abstract-factory-pattern.md +309 -309
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/14-abstract-server-pattern.md +596 -596
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/15-gossiping-bus-drivers.md +355 -355
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/16-payroll-system.md +350 -350
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/17-video-rental-system.md +414 -414
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/18-concurrency-system.md +367 -367
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/19-wator-simulation.md +403 -403
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/20-pattern-interactions.md +291 -291
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/21-best-practices.md +324 -324
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/22-oo-to-fp-migration.md +332 -332
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/index.md +274 -274
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/01-immutability-and-data-transformation.md +298 -298
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/02-function-composition.md +304 -304
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/03-polymorphism.md +362 -362
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/04-data-validation.md +257 -257
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/05-property-based-testing.md +254 -254
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/06-tdd-functional.md +283 -283
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/07-composite-pattern.md +395 -395
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/08-decorator-pattern.md +319 -319
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/09-adapter-pattern.md +382 -382
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/10-strategy-pattern.md +287 -287
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/11-command-pattern.md +303 -303
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/12-visitor-pattern.md +326 -326
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/13-abstract-factory-pattern.md +332 -332
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/14-abstract-server-pattern.md +379 -379
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/15-gossiping-bus-drivers.md +177 -177
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/16-payroll-system.md +219 -219
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/17-video-rental-system.md +244 -244
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/18-concurrency-system.md +363 -363
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/19-wator-simulation.md +438 -438
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/20-pattern-interactions.md +325 -325
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/21-best-practices.md +403 -403
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/22-oo-to-fp-migration.md +469 -469
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/index.md +174 -174
- package/lib/assets/docs/article/functional-desgin-ppp/index.md +90 -90
- package/lib/assets/docs/article/functional-desgin-ppp/rust/01-immutability-and-data-transformation.md +450 -450
- package/lib/assets/docs/article/functional-desgin-ppp/rust/02-function-composition.md +463 -463
- package/lib/assets/docs/article/functional-desgin-ppp/rust/03-polymorphism.md +425 -425
- package/lib/assets/docs/article/functional-desgin-ppp/rust/04-data-validation.md +273 -273
- package/lib/assets/docs/article/functional-desgin-ppp/rust/05-property-based-testing.md +247 -247
- package/lib/assets/docs/article/functional-desgin-ppp/rust/06-tdd-and-functional.md +841 -841
- package/lib/assets/docs/article/functional-desgin-ppp/rust/07-composite-pattern.md +384 -384
- package/lib/assets/docs/article/functional-desgin-ppp/rust/08-decorator-pattern.md +383 -383
- package/lib/assets/docs/article/functional-desgin-ppp/rust/09-adapter-pattern.md +339 -339
- package/lib/assets/docs/article/functional-desgin-ppp/rust/10-strategy-pattern.md +331 -331
- package/lib/assets/docs/article/functional-desgin-ppp/rust/11-command-pattern.md +356 -356
- package/lib/assets/docs/article/functional-desgin-ppp/rust/12-visitor-pattern.md +379 -379
- package/lib/assets/docs/article/functional-desgin-ppp/rust/13-abstract-factory-pattern.md +361 -361
- package/lib/assets/docs/article/functional-desgin-ppp/rust/14-abstract-server-pattern.md +392 -392
- package/lib/assets/docs/article/functional-desgin-ppp/rust/15-gossiping-bus-drivers.md +300 -300
- package/lib/assets/docs/article/functional-desgin-ppp/rust/16-payroll-system.md +297 -297
- package/lib/assets/docs/article/functional-desgin-ppp/rust/17-video-rental-system.md +304 -304
- package/lib/assets/docs/article/functional-desgin-ppp/rust/18-concurrency-system.md +315 -315
- package/lib/assets/docs/article/functional-desgin-ppp/rust/19-wator-simulation.md +311 -311
- package/lib/assets/docs/article/functional-desgin-ppp/rust/20-pattern-interactions.md +304 -304
- package/lib/assets/docs/article/functional-desgin-ppp/rust/21-best-practices.md +336 -336
- package/lib/assets/docs/article/functional-desgin-ppp/rust/22-oo-to-fp-migration.md +349 -349
- package/lib/assets/docs/article/functional-desgin-ppp/rust/index.md +243 -243
- package/lib/assets/docs/article/functional-desgin-ppp/scala/01-immutability-and-data-transformation.md +328 -328
- package/lib/assets/docs/article/functional-desgin-ppp/scala/02-function-composition.md +348 -348
- package/lib/assets/docs/article/functional-desgin-ppp/scala/03-polymorphism.md +357 -357
- package/lib/assets/docs/article/functional-desgin-ppp/scala/04-data-validation.md +364 -364
- package/lib/assets/docs/article/functional-desgin-ppp/scala/05-property-based-testing.md +515 -515
- package/lib/assets/docs/article/functional-desgin-ppp/scala/06-tdd-functional.md +557 -557
- package/lib/assets/docs/article/functional-desgin-ppp/scala/07-composite-pattern.md +363 -363
- package/lib/assets/docs/article/functional-desgin-ppp/scala/08-decorator-pattern.md +327 -327
- package/lib/assets/docs/article/functional-desgin-ppp/scala/09-adapter-pattern.md +517 -517
- package/lib/assets/docs/article/functional-desgin-ppp/scala/10-strategy-pattern.md +441 -441
- package/lib/assets/docs/article/functional-desgin-ppp/scala/11-command-pattern.md +407 -407
- package/lib/assets/docs/article/functional-desgin-ppp/scala/12-visitor-pattern.md +379 -379
- package/lib/assets/docs/article/functional-desgin-ppp/scala/13-abstract-factory-pattern.md +398 -398
- package/lib/assets/docs/article/functional-desgin-ppp/scala/14-abstract-server-pattern.md +476 -476
- package/lib/assets/docs/article/functional-desgin-ppp/scala/15-gossiping-bus-drivers.md +391 -391
- package/lib/assets/docs/article/functional-desgin-ppp/scala/16-payroll-system.md +342 -342
- package/lib/assets/docs/article/functional-desgin-ppp/scala/17-video-rental-system.md +324 -324
- package/lib/assets/docs/article/functional-desgin-ppp/scala/18-concurrency-system.md +730 -730
- package/lib/assets/docs/article/functional-desgin-ppp/scala/19-wator-simulation.md +624 -624
- package/lib/assets/docs/article/functional-desgin-ppp/scala/20-pattern-interactions.md +512 -512
- package/lib/assets/docs/article/functional-desgin-ppp/scala/21-best-practices.md +433 -433
- package/lib/assets/docs/article/functional-desgin-ppp/scala/22-oo-to-fp-migration.md +688 -688
- package/lib/assets/docs/article/functional-desgin-ppp/scala/index.md +243 -243
- package/lib/assets/docs/article/getting-start-tdd/clojure/01-todo-list-and-first-test.md +166 -166
- package/lib/assets/docs/article/getting-start-tdd/clojure/02-fake-it-and-triangulation.md +162 -162
- package/lib/assets/docs/article/getting-start-tdd/clojure/03-obvious-implementation-and-refactoring.md +135 -135
- package/lib/assets/docs/article/getting-start-tdd/clojure/04-version-control-and-conventional-commits.md +88 -88
- package/lib/assets/docs/article/getting-start-tdd/clojure/05-package-management-and-static-analysis.md +299 -299
- package/lib/assets/docs/article/getting-start-tdd/clojure/06-task-runner-and-ci-cd.md +241 -241
- package/lib/assets/docs/article/getting-start-tdd/clojure/07-protocols-and-records.md +131 -131
- package/lib/assets/docs/article/getting-start-tdd/clojure/08-multimethods-and-design-patterns.md +130 -130
- package/lib/assets/docs/article/getting-start-tdd/clojure/09-namespaces-and-module-design.md +127 -127
- package/lib/assets/docs/article/getting-start-tdd/clojure/10-higher-order-functions-and-composition.md +114 -114
- package/lib/assets/docs/article/getting-start-tdd/clojure/11-persistent-data-and-pipeline.md +138 -138
- package/lib/assets/docs/article/getting-start-tdd/clojure/12-error-handling-and-spec.md +161 -161
- package/lib/assets/docs/article/getting-start-tdd/clojure/index.md +65 -65
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter01.md +232 -232
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter02.md +244 -244
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter03.md +202 -202
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter04.md +92 -92
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter05.md +256 -256
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter06.md +195 -195
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter07.md +214 -214
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter08.md +249 -249
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter09.md +174 -174
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter10.md +166 -166
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter11.md +192 -192
- package/lib/assets/docs/article/getting-start-tdd/csharp/chapter12.md +211 -211
- package/lib/assets/docs/article/getting-start-tdd/csharp/index.md +83 -83
- package/lib/assets/docs/article/getting-start-tdd/elixir/01-todo-list-and-first-test.md +87 -87
- package/lib/assets/docs/article/getting-start-tdd/elixir/02-fake-it-and-triangulation.md +95 -95
- package/lib/assets/docs/article/getting-start-tdd/elixir/03-obvious-implementation-and-refactoring.md +109 -109
- package/lib/assets/docs/article/getting-start-tdd/elixir/04-version-control-and-conventional-commits.md +96 -96
- package/lib/assets/docs/article/getting-start-tdd/elixir/05-package-management-and-static-analysis.md +88 -88
- package/lib/assets/docs/article/getting-start-tdd/elixir/06-task-runner-and-ci-cd.md +71 -71
- package/lib/assets/docs/article/getting-start-tdd/elixir/07-structs-and-protocols.md +110 -110
- package/lib/assets/docs/article/getting-start-tdd/elixir/08-pattern-matching-and-guards.md +108 -108
- package/lib/assets/docs/article/getting-start-tdd/elixir/09-module-design-and-behaviours.md +104 -104
- package/lib/assets/docs/article/getting-start-tdd/elixir/10-higher-order-functions-and-pipeline.md +178 -178
- package/lib/assets/docs/article/getting-start-tdd/elixir/11-stream-and-lazy-evaluation.md +142 -142
- package/lib/assets/docs/article/getting-start-tdd/elixir/12-error-handling-and-with.md +145 -145
- package/lib/assets/docs/article/getting-start-tdd/elixir/index.md +35 -35
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter01.md +202 -202
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter02.md +246 -246
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter03.md +218 -218
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter04.md +179 -179
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter05.md +267 -267
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter06.md +190 -190
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter07.md +161 -161
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter08.md +175 -175
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter09.md +222 -222
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter10.md +189 -189
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter11.md +212 -212
- package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter12.md +215 -215
- package/lib/assets/docs/article/getting-start-tdd/fsharp/index.md +71 -71
- package/lib/assets/docs/article/getting-start-tdd/go/01-todo-list-and-first-test.md +213 -213
- package/lib/assets/docs/article/getting-start-tdd/go/02-fake-it-and-triangulation.md +302 -302
- package/lib/assets/docs/article/getting-start-tdd/go/03-obvious-implementation-and-refactoring.md +339 -339
- package/lib/assets/docs/article/getting-start-tdd/go/04-version-control-and-conventional-commits.md +112 -112
- package/lib/assets/docs/article/getting-start-tdd/go/05-package-management-and-static-analysis.md +272 -272
- package/lib/assets/docs/article/getting-start-tdd/go/06-task-runner-and-ci-cd.md +233 -233
- package/lib/assets/docs/article/getting-start-tdd/go/07-encapsulation-and-polymorphism.md +394 -394
- package/lib/assets/docs/article/getting-start-tdd/go/08-design-patterns.md +422 -422
- package/lib/assets/docs/article/getting-start-tdd/go/09-solid-principles-and-module-design.md +400 -400
- package/lib/assets/docs/article/getting-start-tdd/go/10-higher-order-functions-and-composition.md +226 -226
- package/lib/assets/docs/article/getting-start-tdd/go/11-immutable-data-and-pipeline.md +296 -296
- package/lib/assets/docs/article/getting-start-tdd/go/12-error-handling-and-type-safety.md +411 -411
- package/lib/assets/docs/article/getting-start-tdd/go/index.md +83 -83
- package/lib/assets/docs/article/getting-start-tdd/haskell/01-todo-list-and-first-test.md +279 -279
- package/lib/assets/docs/article/getting-start-tdd/haskell/02-fake-it-and-triangulation.md +337 -337
- package/lib/assets/docs/article/getting-start-tdd/haskell/03-obvious-implementation-and-refactoring.md +257 -257
- package/lib/assets/docs/article/getting-start-tdd/haskell/04-version-control-and-conventional-commits.md +182 -182
- package/lib/assets/docs/article/getting-start-tdd/haskell/05-package-management-and-static-analysis.md +313 -313
- package/lib/assets/docs/article/getting-start-tdd/haskell/06-task-runner-and-ci-cd.md +309 -309
- package/lib/assets/docs/article/getting-start-tdd/haskell/07-algebraic-data-types-and-type-classes.md +412 -412
- package/lib/assets/docs/article/getting-start-tdd/haskell/08-pattern-matching-and-guards.md +390 -390
- package/lib/assets/docs/article/getting-start-tdd/haskell/09-module-design-and-smart-constructors.md +461 -461
- package/lib/assets/docs/article/getting-start-tdd/haskell/10-higher-order-functions-and-currying.md +434 -434
- package/lib/assets/docs/article/getting-start-tdd/haskell/11-function-composition-and-point-free.md +392 -392
- package/lib/assets/docs/article/getting-start-tdd/haskell/12-monad-and-error-handling.md +631 -631
- package/lib/assets/docs/article/getting-start-tdd/haskell/index.md +49 -49
- package/lib/assets/docs/article/getting-start-tdd/index.md +93 -93
- package/lib/assets/docs/article/getting-start-tdd/integration/01-language-overview.md +375 -375
- package/lib/assets/docs/article/getting-start-tdd/integration/02-test-framework-comparison.md +349 -349
- package/lib/assets/docs/article/getting-start-tdd/integration/03-tdd-pattern-comparison.md +445 -445
- package/lib/assets/docs/article/getting-start-tdd/integration/04-type-system-comparison.md +409 -409
- package/lib/assets/docs/article/getting-start-tdd/integration/05-dev-environment-comparison.md +330 -330
- package/lib/assets/docs/article/getting-start-tdd/integration/06-learning-roadmap.md +290 -290
- package/lib/assets/docs/article/getting-start-tdd/integration/index.md +69 -69
- package/lib/assets/docs/article/getting-start-tdd/java/01-todo-list-and-first-test.md +234 -234
- package/lib/assets/docs/article/getting-start-tdd/java/02-fake-it-and-triangulation.md +261 -261
- package/lib/assets/docs/article/getting-start-tdd/java/03-obvious-implementation-and-refactoring.md +185 -185
- package/lib/assets/docs/article/getting-start-tdd/java/04-version-control-and-conventional-commits.md +115 -115
- package/lib/assets/docs/article/getting-start-tdd/java/05-package-management-and-static-analysis.md +382 -382
- package/lib/assets/docs/article/getting-start-tdd/java/06-task-runner-and-ci-cd.md +272 -272
- package/lib/assets/docs/article/getting-start-tdd/java/07-encapsulation-and-polymorphism.md +626 -626
- package/lib/assets/docs/article/getting-start-tdd/java/08-design-patterns.md +393 -393
- package/lib/assets/docs/article/getting-start-tdd/java/09-solid-principles-and-module-design.md +310 -310
- package/lib/assets/docs/article/getting-start-tdd/java/10-higher-order-functions-and-composition.md +188 -188
- package/lib/assets/docs/article/getting-start-tdd/java/11-immutable-data-and-pipeline.md +167 -167
- package/lib/assets/docs/article/getting-start-tdd/java/12-error-handling-and-type-safety.md +205 -205
- package/lib/assets/docs/article/getting-start-tdd/java/index.md +61 -61
- package/lib/assets/docs/article/getting-start-tdd/node/01-todo-list-and-first-test.md +244 -244
- package/lib/assets/docs/article/getting-start-tdd/node/02-fake-it-and-triangulation.md +262 -262
- package/lib/assets/docs/article/getting-start-tdd/node/03-obvious-implementation-and-refactoring.md +169 -169
- package/lib/assets/docs/article/getting-start-tdd/node/04-version-control-and-conventional-commits.md +112 -112
- package/lib/assets/docs/article/getting-start-tdd/node/05-package-management-and-static-analysis.md +314 -314
- package/lib/assets/docs/article/getting-start-tdd/node/06-task-runner-and-ci-cd.md +235 -235
- package/lib/assets/docs/article/getting-start-tdd/node/07-encapsulation-and-polymorphism.md +327 -327
- package/lib/assets/docs/article/getting-start-tdd/node/08-design-patterns.md +322 -322
- package/lib/assets/docs/article/getting-start-tdd/node/09-solid-principles-and-module-design.md +285 -285
- package/lib/assets/docs/article/getting-start-tdd/node/10-higher-order-functions-and-composition.md +199 -199
- package/lib/assets/docs/article/getting-start-tdd/node/11-immutable-data-and-pipeline.md +207 -207
- package/lib/assets/docs/article/getting-start-tdd/node/12-error-handling-and-type-safety.md +295 -295
- package/lib/assets/docs/article/getting-start-tdd/node/index.md +56 -56
- package/lib/assets/docs/article/getting-start-tdd/php/01-todo-list-and-first-test.md +259 -259
- package/lib/assets/docs/article/getting-start-tdd/php/02-fake-it-and-triangulation.md +200 -200
- package/lib/assets/docs/article/getting-start-tdd/php/03-obvious-implementation-and-refactoring.md +248 -248
- package/lib/assets/docs/article/getting-start-tdd/php/04-version-control-and-conventional-commits.md +141 -141
- package/lib/assets/docs/article/getting-start-tdd/php/05-package-management-and-static-analysis.md +410 -410
- package/lib/assets/docs/article/getting-start-tdd/php/06-task-runner-and-ci-cd.md +321 -321
- package/lib/assets/docs/article/getting-start-tdd/php/07-encapsulation-and-polymorphism.md +372 -372
- package/lib/assets/docs/article/getting-start-tdd/php/08-design-patterns.md +453 -453
- package/lib/assets/docs/article/getting-start-tdd/php/09-solid-principles-and-module-design.md +460 -460
- package/lib/assets/docs/article/getting-start-tdd/php/10-higher-order-functions-and-composition.md +182 -182
- package/lib/assets/docs/article/getting-start-tdd/php/11-immutable-data-and-pipeline.md +266 -266
- package/lib/assets/docs/article/getting-start-tdd/php/12-error-handling-and-type-safety.md +308 -308
- package/lib/assets/docs/article/getting-start-tdd/php/index.md +84 -84
- package/lib/assets/docs/article/getting-start-tdd/python/01-todo-list-and-first-test.md +201 -201
- package/lib/assets/docs/article/getting-start-tdd/python/02-fake-it-and-triangulation.md +247 -247
- package/lib/assets/docs/article/getting-start-tdd/python/03-obvious-implementation-and-refactoring.md +199 -199
- package/lib/assets/docs/article/getting-start-tdd/python/04-version-control-and-conventional-commits.md +87 -87
- package/lib/assets/docs/article/getting-start-tdd/python/05-package-management-and-static-analysis.md +274 -274
- package/lib/assets/docs/article/getting-start-tdd/python/06-task-runner-and-ci-cd.md +190 -190
- package/lib/assets/docs/article/getting-start-tdd/python/07-encapsulation-and-polymorphism.md +208 -208
- package/lib/assets/docs/article/getting-start-tdd/python/08-design-patterns.md +172 -172
- package/lib/assets/docs/article/getting-start-tdd/python/09-solid-principles-and-module-design.md +130 -130
- package/lib/assets/docs/article/getting-start-tdd/python/10-higher-order-functions-and-composition.md +122 -122
- package/lib/assets/docs/article/getting-start-tdd/python/11-immutable-data-and-pipeline.md +116 -116
- package/lib/assets/docs/article/getting-start-tdd/python/12-error-handling-and-type-safety.md +126 -126
- package/lib/assets/docs/article/getting-start-tdd/python/index.md +55 -55
- package/lib/assets/docs/article/getting-start-tdd/ruby/01-todo-list-and-first-test.md +231 -231
- package/lib/assets/docs/article/getting-start-tdd/ruby/02-fake-it-and-triangulation.md +238 -238
- package/lib/assets/docs/article/getting-start-tdd/ruby/03-obvious-implementation-and-refactoring.md +228 -228
- package/lib/assets/docs/article/getting-start-tdd/ruby/04-version-control-and-conventional-commits.md +112 -112
- package/lib/assets/docs/article/getting-start-tdd/ruby/05-package-management-and-static-analysis.md +287 -287
- package/lib/assets/docs/article/getting-start-tdd/ruby/06-task-runner-and-ci-cd.md +248 -248
- package/lib/assets/docs/article/getting-start-tdd/ruby/07-encapsulation-and-polymorphism.md +279 -279
- package/lib/assets/docs/article/getting-start-tdd/ruby/08-design-patterns.md +329 -329
- package/lib/assets/docs/article/getting-start-tdd/ruby/09-solid-principles-and-module-design.md +196 -196
- package/lib/assets/docs/article/getting-start-tdd/ruby/10-higher-order-functions-and-composition.md +175 -175
- package/lib/assets/docs/article/getting-start-tdd/ruby/11-immutable-data-and-pipeline.md +237 -237
- package/lib/assets/docs/article/getting-start-tdd/ruby/12-error-handling-and-type-safety.md +398 -398
- package/lib/assets/docs/article/getting-start-tdd/ruby/index.md +83 -83
- package/lib/assets/docs/article/getting-start-tdd/rust/01-todo-list-and-first-test.md +211 -211
- package/lib/assets/docs/article/getting-start-tdd/rust/02-fake-it-and-triangulation.md +264 -264
- package/lib/assets/docs/article/getting-start-tdd/rust/03-obvious-implementation-and-refactoring.md +233 -233
- package/lib/assets/docs/article/getting-start-tdd/rust/04-version-control-and-conventional-commits.md +92 -92
- package/lib/assets/docs/article/getting-start-tdd/rust/05-package-management-and-static-analysis.md +212 -212
- package/lib/assets/docs/article/getting-start-tdd/rust/06-task-runner-and-ci-cd.md +164 -164
- package/lib/assets/docs/article/getting-start-tdd/rust/07-encapsulation-and-polymorphism.md +142 -142
- package/lib/assets/docs/article/getting-start-tdd/rust/08-design-patterns.md +145 -145
- package/lib/assets/docs/article/getting-start-tdd/rust/09-solid-principles-and-module-design.md +110 -110
- package/lib/assets/docs/article/getting-start-tdd/rust/10-higher-order-functions-and-composition.md +94 -94
- package/lib/assets/docs/article/getting-start-tdd/rust/11-immutable-data-and-pipeline.md +105 -105
- package/lib/assets/docs/article/getting-start-tdd/rust/12-error-handling-and-type-safety.md +112 -112
- package/lib/assets/docs/article/getting-start-tdd/rust/index.md +83 -83
- package/lib/assets/docs/article/getting-start-tdd/scala/01-todo-list-and-first-test.md +111 -111
- package/lib/assets/docs/article/getting-start-tdd/scala/02-fake-it-and-triangulation.md +107 -107
- package/lib/assets/docs/article/getting-start-tdd/scala/03-obvious-implementation-and-refactoring.md +99 -99
- package/lib/assets/docs/article/getting-start-tdd/scala/04-version-control-and-conventional-commits.md +123 -123
- package/lib/assets/docs/article/getting-start-tdd/scala/05-package-management-and-static-analysis.md +196 -196
- package/lib/assets/docs/article/getting-start-tdd/scala/06-task-runner-and-ci-cd.md +186 -186
- package/lib/assets/docs/article/getting-start-tdd/scala/07-case-classes-and-traits.md +139 -139
- package/lib/assets/docs/article/getting-start-tdd/scala/08-pattern-matching-and-sealed-traits.md +106 -106
- package/lib/assets/docs/article/getting-start-tdd/scala/09-packages-and-module-design.md +75 -75
- package/lib/assets/docs/article/getting-start-tdd/scala/10-higher-order-functions-and-composition.md +104 -104
- package/lib/assets/docs/article/getting-start-tdd/scala/11-collections-and-lazy-evaluation.md +94 -94
- package/lib/assets/docs/article/getting-start-tdd/scala/12-error-handling-and-type-safety.md +92 -92
- package/lib/assets/docs/article/getting-start-tdd/scala/index.md +65 -65
- package/lib/assets/docs/article/grokking-concurrency/all/index.md +404 -404
- package/lib/assets/docs/article/grokking-concurrency/all/part-1-ch02-sequential.md +554 -554
- package/lib/assets/docs/article/grokking-concurrency/all/part-2-ch04-05-threads.md +469 -469
- package/lib/assets/docs/article/grokking-concurrency/all/part-3-ch06-multitasking.md +520 -520
- package/lib/assets/docs/article/grokking-concurrency/all/part-4-ch07-parallel-patterns.md +420 -420
- package/lib/assets/docs/article/grokking-concurrency/all/part-5-ch08-09-synchronization.md +510 -510
- package/lib/assets/docs/article/grokking-concurrency/all/part-6-ch10-11-nonblocking-io.md +435 -435
- package/lib/assets/docs/article/grokking-concurrency/all/part-7-ch12-async.md +465 -465
- package/lib/assets/docs/article/grokking-concurrency/all/part-8-ch13-mapreduce.md +377 -377
- package/lib/assets/docs/article/grokking-concurrency/clojure/index.md +116 -116
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-1.md +108 -108
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-2.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-3.md +122 -122
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-4.md +123 -123
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-5.md +118 -118
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-6.md +89 -89
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-7.md +100 -100
- package/lib/assets/docs/article/grokking-concurrency/clojure/part-8.md +120 -120
- package/lib/assets/docs/article/grokking-concurrency/csharp/index.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-1.md +97 -97
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-2.md +123 -123
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-3.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-4.md +112 -112
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-5.md +99 -99
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-6.md +61 -61
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-7.md +84 -84
- package/lib/assets/docs/article/grokking-concurrency/csharp/part-8.md +92 -92
- package/lib/assets/docs/article/grokking-concurrency/fsharp/index.md +65 -65
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-1.md +80 -80
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-2.md +103 -103
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-3.md +94 -94
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-4.md +110 -110
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-5.md +104 -104
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-6.md +93 -93
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-7.md +121 -121
- package/lib/assets/docs/article/grokking-concurrency/fsharp/part-8.md +107 -107
- package/lib/assets/docs/article/grokking-concurrency/haskell/index.md +248 -248
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-1.md +96 -96
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-2.md +96 -96
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-3.md +91 -91
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-4.md +106 -106
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-5.md +99 -99
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-6.md +95 -95
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-7.md +111 -111
- package/lib/assets/docs/article/grokking-concurrency/haskell/part-8.md +118 -118
- package/lib/assets/docs/article/grokking-concurrency/index.md +66 -66
- package/lib/assets/docs/article/grokking-concurrency/java/index.md +102 -102
- package/lib/assets/docs/article/grokking-concurrency/java/part-1.md +308 -308
- package/lib/assets/docs/article/grokking-concurrency/java/part-2.md +334 -334
- package/lib/assets/docs/article/grokking-concurrency/java/part-3.md +221 -221
- package/lib/assets/docs/article/grokking-concurrency/java/part-4.md +213 -213
- package/lib/assets/docs/article/grokking-concurrency/java/part-5.md +112 -112
- package/lib/assets/docs/article/grokking-concurrency/java/part-6.md +69 -69
- package/lib/assets/docs/article/grokking-concurrency/java/part-7.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/java/part-8.md +101 -101
- package/lib/assets/docs/article/grokking-concurrency/python/index.md +313 -313
- package/lib/assets/docs/article/grokking-concurrency/python/part-1.md +239 -239
- package/lib/assets/docs/article/grokking-concurrency/python/part-2.md +418 -418
- package/lib/assets/docs/article/grokking-concurrency/python/part-3.md +227 -227
- package/lib/assets/docs/article/grokking-concurrency/python/part-4.md +299 -299
- package/lib/assets/docs/article/grokking-concurrency/python/part-5.md +315 -315
- package/lib/assets/docs/article/grokking-concurrency/python/part-6.md +297 -297
- package/lib/assets/docs/article/grokking-concurrency/python/part-7.md +314 -314
- package/lib/assets/docs/article/grokking-concurrency/python/part-8.md +360 -360
- package/lib/assets/docs/article/grokking-concurrency/rust/index.md +270 -270
- package/lib/assets/docs/article/grokking-concurrency/rust/part-1.md +108 -108
- package/lib/assets/docs/article/grokking-concurrency/rust/part-2.md +120 -120
- package/lib/assets/docs/article/grokking-concurrency/rust/part-3.md +126 -126
- package/lib/assets/docs/article/grokking-concurrency/rust/part-4.md +175 -175
- package/lib/assets/docs/article/grokking-concurrency/rust/part-5.md +158 -158
- package/lib/assets/docs/article/grokking-concurrency/rust/part-6.md +94 -94
- package/lib/assets/docs/article/grokking-concurrency/rust/part-7.md +133 -133
- package/lib/assets/docs/article/grokking-concurrency/rust/part-8.md +155 -155
- package/lib/assets/docs/article/grokking-concurrency/scala/index.md +69 -69
- package/lib/assets/docs/article/grokking-concurrency/scala/part-1.md +78 -78
- package/lib/assets/docs/article/grokking-concurrency/scala/part-2.md +112 -112
- package/lib/assets/docs/article/grokking-concurrency/scala/part-3.md +93 -93
- package/lib/assets/docs/article/grokking-concurrency/scala/part-4.md +110 -110
- package/lib/assets/docs/article/grokking-concurrency/scala/part-5.md +119 -119
- package/lib/assets/docs/article/grokking-concurrency/scala/part-6.md +83 -83
- package/lib/assets/docs/article/grokking-concurrency/scala/part-7.md +131 -131
- package/lib/assets/docs/article/grokking-concurrency/scala/part-8.md +129 -129
- package/lib/assets/docs/article/grokkingfp/all/index.md +368 -368
- package/lib/assets/docs/article/grokkingfp/all/part-1-ch01-fp-introduction.md +530 -530
- package/lib/assets/docs/article/grokkingfp/all/part-1-ch02-pure-functions.md +923 -923
- package/lib/assets/docs/article/grokkingfp/all/part-2-ch03-immutable-data.md +1128 -1128
- package/lib/assets/docs/article/grokkingfp/all/part-2-ch04-higher-order-functions.md +1104 -1104
- package/lib/assets/docs/article/grokkingfp/all/part-2-ch05-flatmap.md +1026 -1026
- package/lib/assets/docs/article/grokkingfp/all/part-3-ch06-option.md +785 -785
- package/lib/assets/docs/article/grokkingfp/all/part-3-ch07-either-adt.md +871 -871
- package/lib/assets/docs/article/grokkingfp/all/part-4-ch08-io-monad.md +972 -972
- package/lib/assets/docs/article/grokkingfp/all/part-4-ch09-streams.md +926 -926
- package/lib/assets/docs/article/grokkingfp/all/part-5-ch10-concurrency.md +870 -870
- package/lib/assets/docs/article/grokkingfp/all/part-6-ch11-application.md +715 -715
- package/lib/assets/docs/article/grokkingfp/all/part-6-ch12-testing.md +626 -626
- package/lib/assets/docs/article/grokkingfp/all/writing-plan.md +712 -712
- package/lib/assets/docs/article/grokkingfp/clojure/index.md +276 -276
- package/lib/assets/docs/article/grokkingfp/clojure/part-1.md +667 -667
- package/lib/assets/docs/article/grokkingfp/clojure/part-2.md +643 -643
- package/lib/assets/docs/article/grokkingfp/clojure/part-3.md +620 -620
- package/lib/assets/docs/article/grokkingfp/clojure/part-4.md +697 -697
- package/lib/assets/docs/article/grokkingfp/clojure/part-5.md +751 -751
- package/lib/assets/docs/article/grokkingfp/clojure/part-6.md +721 -721
- package/lib/assets/docs/article/grokkingfp/csharp/index.md +246 -246
- package/lib/assets/docs/article/grokkingfp/csharp/part-1.md +811 -811
- package/lib/assets/docs/article/grokkingfp/csharp/part-2.md +971 -971
- package/lib/assets/docs/article/grokkingfp/csharp/part-3.md +981 -981
- package/lib/assets/docs/article/grokkingfp/csharp/part-4.md +949 -949
- package/lib/assets/docs/article/grokkingfp/csharp/part-5.md +947 -947
- package/lib/assets/docs/article/grokkingfp/csharp/part-6.md +739 -739
- package/lib/assets/docs/article/grokkingfp/elixir/index.md +203 -203
- package/lib/assets/docs/article/grokkingfp/elixir/part-1.md +712 -712
- package/lib/assets/docs/article/grokkingfp/elixir/part-2.md +838 -838
- package/lib/assets/docs/article/grokkingfp/elixir/part-3.md +985 -985
- package/lib/assets/docs/article/grokkingfp/elixir/part-4.md +974 -974
- package/lib/assets/docs/article/grokkingfp/elixir/part-5.md +1286 -1286
- package/lib/assets/docs/article/grokkingfp/elixir/part-6.md +1049 -1049
- package/lib/assets/docs/article/grokkingfp/fsharp/index.md +210 -210
- package/lib/assets/docs/article/grokkingfp/fsharp/part-1.md +714 -714
- package/lib/assets/docs/article/grokkingfp/fsharp/part-2.md +961 -961
- package/lib/assets/docs/article/grokkingfp/fsharp/part-3.md +972 -972
- package/lib/assets/docs/article/grokkingfp/fsharp/part-4.md +832 -832
- package/lib/assets/docs/article/grokkingfp/fsharp/part-5.md +911 -911
- package/lib/assets/docs/article/grokkingfp/fsharp/part-6.md +922 -922
- package/lib/assets/docs/article/grokkingfp/haskell/index.md +234 -234
- package/lib/assets/docs/article/grokkingfp/haskell/part-1.md +591 -591
- package/lib/assets/docs/article/grokkingfp/haskell/part-2.md +866 -866
- package/lib/assets/docs/article/grokkingfp/haskell/part-3.md +915 -915
- package/lib/assets/docs/article/grokkingfp/haskell/part-4.md +878 -878
- package/lib/assets/docs/article/grokkingfp/haskell/part-5.md +845 -845
- package/lib/assets/docs/article/grokkingfp/haskell/part-6.md +844 -844
- package/lib/assets/docs/article/grokkingfp/index.md +143 -143
- package/lib/assets/docs/article/grokkingfp/java/index.md +211 -211
- package/lib/assets/docs/article/grokkingfp/java/part-1.md +648 -648
- package/lib/assets/docs/article/grokkingfp/java/part-2.md +675 -675
- package/lib/assets/docs/article/grokkingfp/java/part-3.md +672 -672
- package/lib/assets/docs/article/grokkingfp/java/part-4.md +771 -771
- package/lib/assets/docs/article/grokkingfp/java/part-5.md +959 -959
- package/lib/assets/docs/article/grokkingfp/java/part-6.md +1328 -1328
- package/lib/assets/docs/article/grokkingfp/python/index.md +258 -258
- package/lib/assets/docs/article/grokkingfp/python/part-1.md +443 -443
- package/lib/assets/docs/article/grokkingfp/python/part-2.md +958 -958
- package/lib/assets/docs/article/grokkingfp/python/part-3.md +1004 -1004
- package/lib/assets/docs/article/grokkingfp/python/part-4.md +765 -765
- package/lib/assets/docs/article/grokkingfp/python/part-5.md +747 -747
- package/lib/assets/docs/article/grokkingfp/python/part-6.md +861 -861
- package/lib/assets/docs/article/grokkingfp/ruby/index.md +330 -330
- package/lib/assets/docs/article/grokkingfp/ruby/part-1.md +755 -755
- package/lib/assets/docs/article/grokkingfp/ruby/part-2.md +938 -938
- package/lib/assets/docs/article/grokkingfp/ruby/part-3.md +946 -946
- package/lib/assets/docs/article/grokkingfp/ruby/part-4.md +921 -921
- package/lib/assets/docs/article/grokkingfp/ruby/part-5.md +908 -908
- package/lib/assets/docs/article/grokkingfp/ruby/part-6.md +1412 -1412
- package/lib/assets/docs/article/grokkingfp/rust/index.md +242 -242
- package/lib/assets/docs/article/grokkingfp/rust/part-1.md +634 -634
- package/lib/assets/docs/article/grokkingfp/rust/part-2.md +1060 -1060
- package/lib/assets/docs/article/grokkingfp/rust/part-3.md +994 -994
- package/lib/assets/docs/article/grokkingfp/rust/part-4.md +573 -573
- package/lib/assets/docs/article/grokkingfp/rust/part-5.md +705 -705
- package/lib/assets/docs/article/grokkingfp/rust/part-6.md +508 -508
- package/lib/assets/docs/article/grokkingfp/scala/index.md +171 -171
- package/lib/assets/docs/article/grokkingfp/scala/part-1.md +543 -543
- package/lib/assets/docs/article/grokkingfp/scala/part-2.md +946 -946
- package/lib/assets/docs/article/grokkingfp/scala/part-3.md +919 -919
- package/lib/assets/docs/article/grokkingfp/scala/part-4.md +742 -742
- package/lib/assets/docs/article/grokkingfp/scala/part-5.md +722 -722
- package/lib/assets/docs/article/grokkingfp/scala/part-6.md +867 -867
- package/lib/assets/docs/article/grokkingfp/typescript/index.md +273 -273
- package/lib/assets/docs/article/grokkingfp/typescript/part-1.md +561 -561
- package/lib/assets/docs/article/grokkingfp/typescript/part-2.md +1129 -1129
- package/lib/assets/docs/article/grokkingfp/typescript/part-3.md +842 -842
- package/lib/assets/docs/article/grokkingfp/typescript/part-4.md +1087 -1087
- package/lib/assets/docs/article/grokkingfp/typescript/part-5.md +717 -717
- package/lib/assets/docs/article/grokkingfp/typescript/part-6.md +982 -982
- package/lib/assets/docs/article/practical-database-design/index.md +121 -121
- package/lib/assets/docs/article/practical-database-design/part1/chapter01.md +288 -288
- package/lib/assets/docs/article/practical-database-design/part1/chapter02.md +518 -518
- package/lib/assets/docs/article/practical-database-design/part1/chapter03.md +557 -557
- package/lib/assets/docs/article/practical-database-design/part2/chapter04.md +924 -924
- package/lib/assets/docs/article/practical-database-design/part2/chapter05.md +1627 -1627
- package/lib/assets/docs/article/practical-database-design/part2/chapter06.md +2716 -2716
- package/lib/assets/docs/article/practical-database-design/part2/chapter07.md +2082 -2082
- package/lib/assets/docs/article/practical-database-design/part2/chapter08.md +2105 -2105
- package/lib/assets/docs/article/practical-database-design/part2/chapter09.md +2031 -2031
- package/lib/assets/docs/article/practical-database-design/part2/chapter10.md +1387 -1387
- package/lib/assets/docs/article/practical-database-design/part2/chapter11.md +1677 -1677
- package/lib/assets/docs/article/practical-database-design/part2/chapter12.md +1417 -1417
- package/lib/assets/docs/article/practical-database-design/part2/chapter13.md +1434 -1434
- package/lib/assets/docs/article/practical-database-design/part3/chapter14.md +667 -667
- package/lib/assets/docs/article/practical-database-design/part3/chapter15.md +1625 -1625
- package/lib/assets/docs/article/practical-database-design/part3/chapter16.md +1915 -1915
- package/lib/assets/docs/article/practical-database-design/part3/chapter17.md +1708 -1708
- package/lib/assets/docs/article/practical-database-design/part3/chapter18.md +2095 -2095
- package/lib/assets/docs/article/practical-database-design/part3/chapter19.md +1123 -1123
- package/lib/assets/docs/article/practical-database-design/part3/chapter20.md +1031 -1031
- package/lib/assets/docs/article/practical-database-design/part3/chapter21.md +1382 -1382
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter14-orm.md +991 -991
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter15-orm.md +1300 -1300
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter16-orm.md +1166 -1166
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter17-orm.md +1584 -1584
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter18-orm.md +1183 -1183
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter19-orm.md +1016 -1016
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter20-orm.md +1753 -1753
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter21-orm.md +1447 -1447
- package/lib/assets/docs/article/practical-database-design/part3-orm/chapter22-orm.md +1878 -1878
- package/lib/assets/docs/article/practical-database-design/part4/chapter22.md +965 -965
- package/lib/assets/docs/article/practical-database-design/part4/chapter23.md +2069 -2069
- package/lib/assets/docs/article/practical-database-design/part4/chapter24.md +2439 -2439
- package/lib/assets/docs/article/practical-database-design/part4/chapter25.md +3661 -3661
- package/lib/assets/docs/article/practical-database-design/part4/chapter26.md +2916 -2916
- package/lib/assets/docs/article/practical-database-design/part4/chapter27.md +3105 -3105
- package/lib/assets/docs/article/practical-database-design/part4/chapter28.md +2697 -2697
- package/lib/assets/docs/article/practical-database-design/part4/chapter29.md +2544 -2544
- package/lib/assets/docs/article/practical-database-design/part4/chapter30.md +2180 -2180
- package/lib/assets/docs/article/practical-database-design/part4/chapter31.md +1192 -1192
- package/lib/assets/docs/article/practical-database-design/part4/chapter32.md +2101 -2101
- package/lib/assets/docs/article/practical-database-design/part5/chapter33.md +1032 -1032
- package/lib/assets/docs/article/practical-database-design/part5/chapter34.md +1609 -1609
- package/lib/assets/docs/article/practical-database-design/part5/chapter35.md +1453 -1453
- package/lib/assets/docs/article/practical-database-design/part5/chapter36.md +1292 -1292
- package/lib/assets/docs/article/practical-database-design/part5/chapter37.md +1470 -1470
- package/lib/assets/docs/article/practical-database-design/part5/chapter38.md +1698 -1698
- package/lib/assets/docs/article/practical-database-design/part5/chapter39.md +2334 -2334
- package/lib/assets/docs/article/practical-database-design/study/study2-1.md +1693 -1693
- package/lib/assets/docs/article/practical-database-design/study/study2-2.md +1347 -1347
- package/lib/assets/docs/article/practical-database-design/study/study2-3.md +2044 -2044
- package/lib/assets/docs/article/practical-database-design/study/study2-4.md +2229 -2229
- package/lib/assets/docs/article/practical-database-design/study/study2-5.md +2418 -2418
- package/lib/assets/docs/article/practical-database-design/study/study3-1.md +2205 -2205
- package/lib/assets/docs/article/practical-database-design/study/study3-2.md +2221 -2221
- package/lib/assets/docs/article/practical-database-design/study/study3-3.md +2253 -2253
- package/lib/assets/docs/article/practical-database-design/study/study3-4.md +2106 -2106
- package/lib/assets/docs/article/practical-database-design/study/study3-5.md +2507 -2507
- package/lib/assets/docs/article/practical-database-design/study/study4-1.md +2587 -2587
- package/lib/assets/docs/article/practical-database-design/study/study4-2.md +2075 -2075
- package/lib/assets/docs/article/practical-database-design/study/study4-3.md +1805 -1805
- package/lib/assets/docs/article/practical-database-design/study/study4-4.md +1895 -1895
- package/lib/assets/docs/article/practical-database-design/study/study4-5.md +2878 -2878
- package/lib/assets/docs/assets/css/extra.css +29 -29
- package/lib/assets/docs/assets/js/extra.js +44 -44
- package/lib/assets/docs/development/index.md +39 -39
- package/lib/assets/docs/operation/index.md +11 -11
- package/lib/assets/docs/reference/CodexCLIMCP/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/343/203/225/343/203/255/343/203/274.md +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 -581
- package/lib/assets/docs/reference/SonarQube/343/203/255/343/203/274/343/202/253/343/203/253/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +642 -642
- package/lib/assets/docs/reference/TypeScript/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +465 -465
- package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +450 -450
- package/lib/assets/docs/reference/images/Ansoff.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandBasicStrategy.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandCategorization.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandRecurutementStrategy.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandValue.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BusinessActivitiy.svg +3 -3
- package/lib/assets/docs/reference/images/HRM.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/MarketingStructure.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/OrganizationElemnts.svg +3 -3
- package/lib/assets/docs/reference/images/PPM.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/PositioningMap.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ProductLayer.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ProductMix.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/SWOT.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/TargetMarket.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ThreeGenericStrategies.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/VRIO.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ValueChain.drawio.svg +3 -3
- package/lib/assets/docs/reference/index.md +52 -52
- package/lib/assets/docs/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md +250 -250
- package/lib/assets/docs/reference//343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +2216 -2216
- package/lib/assets/docs/reference//343/202/244/343/203/263/343/203/225/343/203/251/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +1878 -1878
- package/lib/assets/docs/reference//343/202/250/343/202/257/343/202/271/343/203/210/343/203/252/343/203/274/343/203/240/343/203/227/343/203/255/343/202/260/343/203/251/343/203/237/343/203/263/343/202/260.md +550 -550
- package/lib/assets/docs/reference//343/202/263/343/203/274/343/203/207/343/202/243/343/203/263/343/202/260/343/201/250/343/203/206/343/202/271/343/203/210/343/202/254/343/202/244/343/203/211.md +705 -705
- package/lib/assets/docs/reference//343/203/206/343/202/271/343/203/210/346/210/246/347/225/245/343/202/254/343/202/244/343/203/211.md +1313 -1313
- package/lib/assets/docs/reference//343/203/207/343/203/274/343/202/277/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +311 -311
- package/lib/assets/docs/reference//343/203/211/343/203/241/343/202/244/343/203/263/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +599 -599
- package/lib/assets/docs/reference//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +528 -528
- package/lib/assets/docs/reference//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +689 -689
- package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/202/254/343/202/244/343/203/211.md +461 -461
- package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/203/273/343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273/343/202/254/343/202/244/343/203/211.md +580 -580
- package/lib/assets/docs/reference//343/203/255/343/202/270/343/202/253/343/203/253/343/202/267/343/203/263/343/202/255/343/203/263/343/202/260.md +1367 -1367
- package/lib/assets/docs/reference//344/274/201/346/245/255/347/265/214/345/226/266/350/253/226.md +2637 -2637
- package/lib/assets/docs/reference//347/222/260/345/242/203/345/244/211/346/225/260/347/256/241/347/220/206/343/202/254/343/202/244/343/203/211.md +665 -665
- package/lib/assets/docs/reference//350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1248 -1248
- package/lib/assets/docs/reference//350/250/200/350/252/236/345/210/245/351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +518 -518
- package/lib/assets/docs/reference//351/201/213/345/226/266/347/256/241/347/220/206.md +1482 -1482
- package/lib/assets/docs/reference//351/201/213/347/224/250/343/202/271/343/202/257/343/203/252/343/203/227/343/203/210/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +421 -421
- package/lib/assets/docs/reference//351/201/213/347/224/250/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +392 -392
- package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +299 -299
- package/lib/assets/docs/reference//351/235/236/346/251/237/350/203/275/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1236 -1236
- package/lib/assets/docs/review/index.md +5 -5
- package/lib/assets/docs/strategy/index.md +1 -1
- package/lib/assets/docs/template/ADR.md +30 -30
- package/lib/assets/docs/template/AWS/343/202/271/343/203/206/343/203/274/343/202/270/343/203/263/343/202/260/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +1366 -1366
- package/lib/assets/docs/template/AWS/343/203/227/343/203/255/343/203/200/343/202/257/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +634 -634
- package/lib/assets/docs/template/README.md +50 -50
- package/lib/assets/docs/template/index.md +23 -23
- package/lib/assets/docs/template//343/201/276/343/201/232/343/201/223/343/202/214/343/202/222/350/252/255/343/202/202/343/201/206/343/203/252/343/202/271/343/203/210.md +12 -12
- package/lib/assets/docs/template//343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +547 -547
- package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +58 -58
- package/lib/assets/docs/template//343/202/244/343/203/263/343/202/273/343/203/227/343/202/267/343/203/247/343/203/263/343/203/207/343/203/203/343/202/255.md +13 -13
- package/lib/assets/docs/template//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243.md +379 -379
- package/lib/assets/docs/template//344/274/201/346/245/255/345/210/206/346/236/220.md +573 -573
- package/lib/assets/docs/template//345/256/214/345/205/250/345/275/242/345/274/217/343/201/256/343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271.md +69 -69
- package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
- package/lib/assets/docs/template//350/250/255/350/250/210.md +173 -173
- package/lib/assets/docs/template//351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +688 -688
- package/lib/assets/gulpfile.js +25 -25
- package/lib/assets/mkdocs.yml +136 -136
- package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
- package/lib/assets/ops/scripts/journal.js +180 -180
- package/lib/assets/ops/scripts/mkdocs.js +82 -82
- package/lib/assets/ops/scripts/release.js +431 -431
- package/lib/assets/ops/scripts/sonar_local.js +726 -726
- package/lib/assets/ops/scripts/ssh.js +190 -190
- package/lib/assets/ops/scripts/vault.js +299 -299
- package/lib/assets/package-lock.json +1653 -1653
- package/lib/assets/package.json +40 -40
- package/lib/gulpfile.js +37 -37
- package/package.json +41 -41
|
@@ -1,958 +1,958 @@
|
|
|
1
|
-
# Part II: 関数型スタイルのプログラミング
|
|
2
|
-
|
|
3
|
-
本章では、関数型プログラミングの核心となるテクニックを学びます。イミュータブルなデータ操作、高階関数、そしてリスト内包表記による複雑なデータ変換を習得します。
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## 第3章: イミュータブルなデータ操作
|
|
8
|
-
|
|
9
|
-
### 3.1 イミュータブルとは
|
|
10
|
-
|
|
11
|
-
イミュータブル(不変)とは、一度作成されたデータが変更されないことを意味します。データを「変更」する代わりに、新しいデータを「作成」します。
|
|
12
|
-
|
|
13
|
-
```plantuml
|
|
14
|
-
@startuml
|
|
15
|
-
!theme plain
|
|
16
|
-
|
|
17
|
-
rectangle "ミュータブル(可変)" as mut {
|
|
18
|
-
card "lst = ['A', 'B']" as m1
|
|
19
|
-
card "lst.append('C')" as m2
|
|
20
|
-
card "lst = ['A', 'B', 'C']" as m3
|
|
21
|
-
m1 --> m2 : 変更
|
|
22
|
-
m2 --> m3 : 同じリストが変わる
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
rectangle "イミュータブル(不変)" as immut {
|
|
26
|
-
card "lst1 = ['A', 'B']" as i1
|
|
27
|
-
card "lst2 = lst1 + ['C']" as i2
|
|
28
|
-
card "lst1 = ['A', 'B']\nlst2 = ['A', 'B', 'C']" as i3
|
|
29
|
-
i1 --> i2 : 新規作成
|
|
30
|
-
i2 --> i3 : 両方が存在
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
@enduml
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
### 3.2 List の基本操作
|
|
37
|
-
|
|
38
|
-
**ソースファイル**: `app/python/src/grokking_fp/ch03_immutable_data.py`
|
|
39
|
-
|
|
40
|
-
#### appended - 要素の追加
|
|
41
|
-
|
|
42
|
-
```python
|
|
43
|
-
def appended(lst: list[str], element: str) -> list[str]:
|
|
44
|
-
"""リストに要素を追加した新しいリストを返す。"""
|
|
45
|
-
return lst + [element]
|
|
46
|
-
|
|
47
|
-
original = ["Apple", "Book"]
|
|
48
|
-
new_list = appended(original, "Mango")
|
|
49
|
-
|
|
50
|
-
assert original == ["Apple", "Book"] # 元のリストは変わらない
|
|
51
|
-
assert new_list == ["Apple", "Book", "Mango"] # 新しいリストが作成される
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
#### スライス - リストの切り出し
|
|
55
|
-
|
|
56
|
-
Python ではスライス記法 `[start:end]` を使います。
|
|
57
|
-
|
|
58
|
-
```python
|
|
59
|
-
def first_two(lst: list[str]) -> list[str]:
|
|
60
|
-
return lst[:2]
|
|
61
|
-
|
|
62
|
-
def last_two(lst: list[str]) -> list[str]:
|
|
63
|
-
if len(lst) < 2:
|
|
64
|
-
return lst[:]
|
|
65
|
-
return lst[-2:]
|
|
66
|
-
|
|
67
|
-
assert first_two(["a", "b", "c"]) == ["a", "b"]
|
|
68
|
-
assert last_two(["a", "b", "c"]) == ["b", "c"]
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
```plantuml
|
|
72
|
-
@startuml
|
|
73
|
-
!theme plain
|
|
74
|
-
|
|
75
|
-
rectangle "スライス記法" {
|
|
76
|
-
card "lst = ['a', 'b', 'c', 'd']" as orig
|
|
77
|
-
card "lst[1:3]" as op
|
|
78
|
-
card "['b', 'c']" as result
|
|
79
|
-
|
|
80
|
-
orig --> op
|
|
81
|
-
op --> result
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
note bottom of result
|
|
85
|
-
インデックス 1 から 3 の手前まで
|
|
86
|
-
(end は含まない)
|
|
87
|
-
end note
|
|
88
|
-
|
|
89
|
-
@enduml
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
### 3.3 リストの変換例
|
|
93
|
-
|
|
94
|
-
**ソースファイル**: `app/python/src/grokking_fp/ch03_immutable_data.py`
|
|
95
|
-
|
|
96
|
-
```python
|
|
97
|
-
# 最初の2要素を末尾に移動
|
|
98
|
-
def move_first_two_to_end(lst: list[str]) -> list[str]:
|
|
99
|
-
first = lst[:2]
|
|
100
|
-
rest = lst[2:]
|
|
101
|
-
return rest + first
|
|
102
|
-
|
|
103
|
-
assert move_first_two_to_end(["a", "b", "c"]) == ["c", "a", "b"]
|
|
104
|
-
|
|
105
|
-
# 最後の要素の前に挿入
|
|
106
|
-
def insert_before_last(lst: list[str], element: str) -> list[str]:
|
|
107
|
-
if not lst:
|
|
108
|
-
return [element]
|
|
109
|
-
return lst[:-1] + [element] + lst[-1:]
|
|
110
|
-
|
|
111
|
-
assert insert_before_last(["a", "b"], "c") == ["a", "c", "b"]
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### 3.4 旅程の再計画
|
|
115
|
-
|
|
116
|
-
**ソースファイル**: `app/python/src/grokking_fp/ch03_immutable_data.py`
|
|
117
|
-
|
|
118
|
-
旅行の計画変更をイミュータブルに行う例です。
|
|
119
|
-
|
|
120
|
-
```python
|
|
121
|
-
def replan(plan: list[str], new_city: str, before_city: str) -> list[str]:
|
|
122
|
-
"""指定した都市の前に新しい都市を挿入した旅程を返す。"""
|
|
123
|
-
try:
|
|
124
|
-
index = plan.index(before_city)
|
|
125
|
-
return plan[:index] + [new_city] + plan[index:]
|
|
126
|
-
except ValueError:
|
|
127
|
-
return plan + [new_city]
|
|
128
|
-
|
|
129
|
-
plan_a = ["Paris", "Berlin", "Kraków"]
|
|
130
|
-
plan_b = replan(plan_a, "Vienna", "Kraków")
|
|
131
|
-
|
|
132
|
-
assert plan_b == ["Paris", "Berlin", "Vienna", "Kraków"]
|
|
133
|
-
assert plan_a == ["Paris", "Berlin", "Kraków"] # 元の計画は変わらない!
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
```plantuml
|
|
137
|
-
@startuml
|
|
138
|
-
!theme plain
|
|
139
|
-
|
|
140
|
-
rectangle "旅程の再計画" {
|
|
141
|
-
card "Plan A:\nParis → Berlin → Kraków" as planA
|
|
142
|
-
card "replan(plan_a, 'Vienna', 'Kraków')" as op
|
|
143
|
-
card "Plan B:\nParis → Berlin → Vienna → Kraków" as planB
|
|
144
|
-
|
|
145
|
-
planA --> op
|
|
146
|
-
op --> planB
|
|
147
|
-
}
|
|
148
|
-
|
|
149
|
-
note right of planA
|
|
150
|
-
Plan A は変更されない
|
|
151
|
-
(イミュータブル)
|
|
152
|
-
end note
|
|
153
|
-
|
|
154
|
-
@enduml
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
### 3.5 String と List の類似性
|
|
158
|
-
|
|
159
|
-
Python では String と List は似た操作ができます。
|
|
160
|
-
|
|
161
|
-
| 操作 | List | String |
|
|
162
|
-
|------|------|--------|
|
|
163
|
-
| 結合 | `+` | `+` |
|
|
164
|
-
| 切り出し | `[start:end]` | `[start:end]` |
|
|
165
|
-
| サイズ | `len()` | `len()` |
|
|
166
|
-
|
|
167
|
-
```python
|
|
168
|
-
# List の操作
|
|
169
|
-
ab_list = ["a", "b"]
|
|
170
|
-
cd_list = ["c", "d"]
|
|
171
|
-
abcd_list = ab_list + cd_list
|
|
172
|
-
assert abcd_list == ["a", "b", "c", "d"]
|
|
173
|
-
|
|
174
|
-
# String の操作
|
|
175
|
-
ab_str = "ab"
|
|
176
|
-
cd_str = "cd"
|
|
177
|
-
abcd_str = ab_str + cd_str
|
|
178
|
-
assert abcd_str == "abcd"
|
|
179
|
-
```
|
|
180
|
-
|
|
181
|
-
### 3.6 名前の省略
|
|
182
|
-
|
|
183
|
-
**ソースファイル**: `app/python/src/grokking_fp/ch03_immutable_data.py`
|
|
184
|
-
|
|
185
|
-
```python
|
|
186
|
-
def abbreviate(name: str) -> str:
|
|
187
|
-
"""名前を省略形にする。"""
|
|
188
|
-
separator = name.find(" ")
|
|
189
|
-
if separator == -1:
|
|
190
|
-
return name
|
|
191
|
-
initial = name[0]
|
|
192
|
-
last_name = name[separator + 1:]
|
|
193
|
-
return f"{initial}. {last_name}"
|
|
194
|
-
|
|
195
|
-
assert abbreviate("Alonzo Church") == "A. Church"
|
|
196
|
-
assert abbreviate("A. Church") == "A. Church"
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
### 3.7 NamedTuple によるイミュータブルなデータ構造
|
|
200
|
-
|
|
201
|
-
Python では `NamedTuple` を使ってイミュータブルなデータ構造を定義できます。
|
|
202
|
-
|
|
203
|
-
```python
|
|
204
|
-
from typing import NamedTuple
|
|
205
|
-
|
|
206
|
-
class City(NamedTuple):
|
|
207
|
-
name: str
|
|
208
|
-
population: int
|
|
209
|
-
|
|
210
|
-
def with_population(city: City, new_population: int) -> City:
|
|
211
|
-
"""人口を更新した新しい City を返す。"""
|
|
212
|
-
return City(city.name, new_population)
|
|
213
|
-
|
|
214
|
-
tokyo = City("Tokyo", 13960000)
|
|
215
|
-
tokyo_updated = with_population(tokyo, 14000000)
|
|
216
|
-
|
|
217
|
-
assert tokyo.population == 13960000 # 元の都市は変わらない
|
|
218
|
-
assert tokyo_updated.population == 14000000
|
|
219
|
-
```
|
|
220
|
-
|
|
221
|
-
### 3.8 frozenset と 辞書のイミュータブル操作
|
|
222
|
-
|
|
223
|
-
```python
|
|
224
|
-
# frozenset - イミュータブルな集合
|
|
225
|
-
def add_to_set(s: frozenset[str], element: str) -> frozenset[str]:
|
|
226
|
-
return s | {element}
|
|
227
|
-
|
|
228
|
-
s = frozenset({"a", "b"})
|
|
229
|
-
s2 = add_to_set(s, "c")
|
|
230
|
-
assert "c" not in s # 元の集合は変わらない
|
|
231
|
-
assert "c" in s2
|
|
232
|
-
|
|
233
|
-
# 辞書のイミュータブル操作
|
|
234
|
-
def update_dict(d: dict[str, int], key: str, value: int) -> dict[str, int]:
|
|
235
|
-
return {**d, key: value}
|
|
236
|
-
|
|
237
|
-
d = {"a": 1, "b": 2}
|
|
238
|
-
d2 = update_dict(d, "c", 3)
|
|
239
|
-
assert d == {"a": 1, "b": 2} # 元の辞書は変わらない
|
|
240
|
-
assert d2 == {"a": 1, "b": 2, "c": 3}
|
|
241
|
-
```
|
|
242
|
-
|
|
243
|
-
---
|
|
244
|
-
|
|
245
|
-
## 第4章: 関数を値として扱う
|
|
246
|
-
|
|
247
|
-
### 4.1 高階関数とは
|
|
248
|
-
|
|
249
|
-
高階関数(Higher-Order Function)とは、以下のいずれかを満たす関数です:
|
|
250
|
-
|
|
251
|
-
1. 関数を引数として受け取る
|
|
252
|
-
2. 関数を戻り値として返す
|
|
253
|
-
|
|
254
|
-
Python では関数は第一級オブジェクトなので、変数に代入したり引数として渡したりできます。
|
|
255
|
-
|
|
256
|
-
```plantuml
|
|
257
|
-
@startuml
|
|
258
|
-
!theme plain
|
|
259
|
-
|
|
260
|
-
rectangle "高階関数" {
|
|
261
|
-
rectangle "関数を引数に取る" as arg {
|
|
262
|
-
card "sorted(key=score)" as sortBy
|
|
263
|
-
card "map(transform, lst)" as map
|
|
264
|
-
card "filter(predicate, lst)" as filter
|
|
265
|
-
}
|
|
266
|
-
|
|
267
|
-
rectangle "関数を返す" as ret {
|
|
268
|
-
card "larger_than(n)" as larger
|
|
269
|
-
card "divisible_by(n)" as divisible
|
|
270
|
-
}
|
|
271
|
-
}
|
|
272
|
-
|
|
273
|
-
@enduml
|
|
274
|
-
```
|
|
275
|
-
|
|
276
|
-
### 4.2 関数を引数として渡す
|
|
277
|
-
|
|
278
|
-
**ソースファイル**: `app/python/src/grokking_fp/ch04_higher_order.py`
|
|
279
|
-
|
|
280
|
-
#### sorted と key - ソート基準を関数で指定
|
|
281
|
-
|
|
282
|
-
```python
|
|
283
|
-
def score(word: str) -> int:
|
|
284
|
-
"""'a' を除いた文字数をスコアとする。"""
|
|
285
|
-
return len(word.replace("a", ""))
|
|
286
|
-
|
|
287
|
-
words = ["rust", "java"]
|
|
288
|
-
sorted_words = sorted(words, key=score)
|
|
289
|
-
|
|
290
|
-
assert sorted_words == ["java", "rust"]
|
|
291
|
-
# java: 2文字 (j, v), rust: 4文字 (r, u, s, t)
|
|
292
|
-
```
|
|
293
|
-
|
|
294
|
-
```plantuml
|
|
295
|
-
@startuml
|
|
296
|
-
!theme plain
|
|
297
|
-
|
|
298
|
-
rectangle "sorted の動作" {
|
|
299
|
-
card "['rust', 'java']" as input
|
|
300
|
-
card "score('rust') = 4\nscore('java') = 2" as scores
|
|
301
|
-
card "['java', 'rust']" as output
|
|
302
|
-
|
|
303
|
-
input --> scores : score関数を適用
|
|
304
|
-
scores --> output : スコア順にソート
|
|
305
|
-
}
|
|
306
|
-
|
|
307
|
-
@enduml
|
|
308
|
-
```
|
|
309
|
-
|
|
310
|
-
#### リスト内包表記による map
|
|
311
|
-
|
|
312
|
-
Python では `map()` よりもリスト内包表記が一般的です。
|
|
313
|
-
|
|
314
|
-
```python
|
|
315
|
-
# 各要素の長さを取得
|
|
316
|
-
lengths = [len(word) for word in ["scala", "rust", "ada"]]
|
|
317
|
-
assert lengths == [5, 4, 3]
|
|
318
|
-
|
|
319
|
-
# 各要素を2倍
|
|
320
|
-
doubles = [n * 2 for n in [5, 1, 2, 4, 0]]
|
|
321
|
-
assert doubles == [10, 2, 4, 8, 0]
|
|
322
|
-
```
|
|
323
|
-
|
|
324
|
-
```plantuml
|
|
325
|
-
@startuml
|
|
326
|
-
!theme plain
|
|
327
|
-
|
|
328
|
-
rectangle "リスト内包表記の動作" {
|
|
329
|
-
card "['scala', 'rust', 'ada']" as input
|
|
330
|
-
card "[len(w) for w in words]" as op
|
|
331
|
-
card "[5, 4, 3]" as output
|
|
332
|
-
|
|
333
|
-
input --> op
|
|
334
|
-
op --> output
|
|
335
|
-
}
|
|
336
|
-
|
|
337
|
-
@enduml
|
|
338
|
-
```
|
|
339
|
-
|
|
340
|
-
#### filter - 条件に合う要素を抽出
|
|
341
|
-
|
|
342
|
-
```python
|
|
343
|
-
# 奇数のみを抽出
|
|
344
|
-
odds = [n for n in [5, 1, 2, 4, 0] if n % 2 == 1]
|
|
345
|
-
assert odds == [5, 1]
|
|
346
|
-
|
|
347
|
-
# 4より大きい数のみ
|
|
348
|
-
large = [n for n in [5, 1, 2, 4, 0] if n > 4]
|
|
349
|
-
assert large == [5]
|
|
350
|
-
```
|
|
351
|
-
|
|
352
|
-
#### reduce - 畳み込み
|
|
353
|
-
|
|
354
|
-
```python
|
|
355
|
-
from functools import reduce
|
|
356
|
-
|
|
357
|
-
# 合計を計算
|
|
358
|
-
total = reduce(lambda acc, n: acc + n, [5, 1, 2, 4, 100], 0)
|
|
359
|
-
assert total == 112
|
|
360
|
-
|
|
361
|
-
# 最大値を見つける
|
|
362
|
-
numbers = [5, 1, 2, 4, 15]
|
|
363
|
-
max_val = reduce(lambda acc, n: n if n > acc else acc, numbers)
|
|
364
|
-
assert max_val == 15
|
|
365
|
-
```
|
|
366
|
-
|
|
367
|
-
```plantuml
|
|
368
|
-
@startuml
|
|
369
|
-
!theme plain
|
|
370
|
-
|
|
371
|
-
rectangle "reduce の動作" {
|
|
372
|
-
card "初期値: 0" as init
|
|
373
|
-
card "0 + 5 = 5" as s1
|
|
374
|
-
card "5 + 1 = 6" as s2
|
|
375
|
-
card "6 + 2 = 8" as s3
|
|
376
|
-
card "8 + 4 = 12" as s4
|
|
377
|
-
card "12 + 100 = 112" as s5
|
|
378
|
-
|
|
379
|
-
init --> s1
|
|
380
|
-
s1 --> s2
|
|
381
|
-
s2 --> s3
|
|
382
|
-
s3 --> s4
|
|
383
|
-
s4 --> s5
|
|
384
|
-
}
|
|
385
|
-
|
|
386
|
-
@enduml
|
|
387
|
-
```
|
|
388
|
-
|
|
389
|
-
### 4.3 dataclass によるデータ構造
|
|
390
|
-
|
|
391
|
-
```python
|
|
392
|
-
from dataclasses import dataclass
|
|
393
|
-
|
|
394
|
-
@dataclass(frozen=True)
|
|
395
|
-
class ProgrammingLanguage:
|
|
396
|
-
name: str
|
|
397
|
-
year: int
|
|
398
|
-
|
|
399
|
-
java = ProgrammingLanguage("Java", 1995)
|
|
400
|
-
scala = ProgrammingLanguage("Scala", 2004)
|
|
401
|
-
|
|
402
|
-
languages = [java, scala]
|
|
403
|
-
|
|
404
|
-
# フィールドにアクセス
|
|
405
|
-
names = [lang.name for lang in languages]
|
|
406
|
-
assert names == ["Java", "Scala"]
|
|
407
|
-
|
|
408
|
-
# 条件でフィルタ
|
|
409
|
-
young = [lang for lang in languages if lang.year > 2000]
|
|
410
|
-
assert young == [scala]
|
|
411
|
-
```
|
|
412
|
-
|
|
413
|
-
### 4.4 関数を返す関数
|
|
414
|
-
|
|
415
|
-
**ソースファイル**: `app/python/src/grokking_fp/ch04_higher_order.py`
|
|
416
|
-
|
|
417
|
-
```python
|
|
418
|
-
from collections.abc import Callable
|
|
419
|
-
|
|
420
|
-
def larger_than(n: int) -> Callable[[int], bool]:
|
|
421
|
-
"""n より大きいかを判定する関数を返す。"""
|
|
422
|
-
return lambda i: i > n
|
|
423
|
-
|
|
424
|
-
large = list(filter(larger_than(4), [5, 1, 2, 4, 0]))
|
|
425
|
-
assert large == [5]
|
|
426
|
-
|
|
427
|
-
medium = list(filter(larger_than(1), [5, 1, 2, 4, 0]))
|
|
428
|
-
assert medium == [5, 2, 4]
|
|
429
|
-
```
|
|
430
|
-
|
|
431
|
-
```plantuml
|
|
432
|
-
@startuml
|
|
433
|
-
!theme plain
|
|
434
|
-
|
|
435
|
-
rectangle "関数を返す関数" {
|
|
436
|
-
card "larger_than(4)" as call
|
|
437
|
-
card "lambda i: i > 4" as fn
|
|
438
|
-
card "filter に渡す" as filter
|
|
439
|
-
|
|
440
|
-
call --> fn : 関数を生成
|
|
441
|
-
fn --> filter : 生成された関数を使用
|
|
442
|
-
}
|
|
443
|
-
|
|
444
|
-
note bottom
|
|
445
|
-
larger_than(4) は
|
|
446
|
-
「4より大きいか判定する関数」を返す
|
|
447
|
-
end note
|
|
448
|
-
|
|
449
|
-
@enduml
|
|
450
|
-
```
|
|
451
|
-
|
|
452
|
-
### 4.5 クロージャとカリー化
|
|
453
|
-
|
|
454
|
-
Python ではクロージャを使ってカリー化のような機能を実現できます。
|
|
455
|
-
|
|
456
|
-
```python
|
|
457
|
-
def high_scoring_words_with_threshold(
|
|
458
|
-
word_score_fn: Callable[[str], int],
|
|
459
|
-
) -> Callable[[int], Callable[[list[str]], list[str]]]:
|
|
460
|
-
"""カリー化された関数。スコア関数、閾値、単語リストを順番に受け取る。"""
|
|
461
|
-
def with_threshold(higher_than: int) -> Callable[[list[str]], list[str]]:
|
|
462
|
-
def filter_words(words: list[str]) -> list[str]:
|
|
463
|
-
return [word for word in words if word_score_fn(word) > higher_than]
|
|
464
|
-
return filter_words
|
|
465
|
-
return with_threshold
|
|
466
|
-
|
|
467
|
-
# 使用例
|
|
468
|
-
words = ["ada", "haskell", "scala", "java", "rust"]
|
|
469
|
-
scorer = high_scoring_words_with_threshold(word_score_with_bonus_and_penalty)
|
|
470
|
-
assert scorer(1)(words) == ["java"]
|
|
471
|
-
assert scorer(0)(words) == ["ada", "scala", "java"]
|
|
472
|
-
```
|
|
473
|
-
|
|
474
|
-
```plantuml
|
|
475
|
-
@startuml
|
|
476
|
-
!theme plain
|
|
477
|
-
|
|
478
|
-
rectangle "カリー化" {
|
|
479
|
-
rectangle "通常の関数" as normal {
|
|
480
|
-
card "f(a, b, c)" as n1
|
|
481
|
-
}
|
|
482
|
-
|
|
483
|
-
rectangle "カリー化された関数" as curried {
|
|
484
|
-
card "f(a)(b)(c)" as c1
|
|
485
|
-
}
|
|
486
|
-
|
|
487
|
-
normal --> curried : カリー化
|
|
488
|
-
}
|
|
489
|
-
|
|
490
|
-
note bottom of curried
|
|
491
|
-
部分適用が可能
|
|
492
|
-
f(a) → 関数を返す
|
|
493
|
-
f(a)(b) → 関数を返す
|
|
494
|
-
f(a)(b)(c) → 結果を返す
|
|
495
|
-
end note
|
|
496
|
-
|
|
497
|
-
@enduml
|
|
498
|
-
```
|
|
499
|
-
|
|
500
|
-
### 4.6 ワードスコアリングの例
|
|
501
|
-
|
|
502
|
-
**ソースファイル**: `app/python/src/grokking_fp/ch04_higher_order.py`
|
|
503
|
-
|
|
504
|
-
複数のスコアリングロジックを組み合わせる例です。
|
|
505
|
-
|
|
506
|
-
```python
|
|
507
|
-
def score(word: str) -> int:
|
|
508
|
-
return len(word.replace("a", ""))
|
|
509
|
-
|
|
510
|
-
def bonus(word: str) -> int:
|
|
511
|
-
return 5 if "c" in word else 0
|
|
512
|
-
|
|
513
|
-
def penalty(word: str) -> int:
|
|
514
|
-
return 7 if "s" in word else 0
|
|
515
|
-
|
|
516
|
-
words = ["ada", "haskell", "scala", "java", "rust"]
|
|
517
|
-
|
|
518
|
-
# 関数を引数として渡す
|
|
519
|
-
def ranked_words(words: list[str], word_score: Callable[[str], int]) -> list[str]:
|
|
520
|
-
return sorted(words, key=word_score, reverse=True)
|
|
521
|
-
|
|
522
|
-
# 基本スコアでランキング
|
|
523
|
-
ranking1 = ranked_words(words, score)
|
|
524
|
-
assert ranking1 == ["haskell", "rust", "scala", "java", "ada"]
|
|
525
|
-
|
|
526
|
-
# ボーナス付きスコアでランキング
|
|
527
|
-
ranking2 = ranked_words(words, lambda w: score(w) + bonus(w))
|
|
528
|
-
|
|
529
|
-
# ボーナスとペナルティ付き
|
|
530
|
-
ranking3 = ranked_words(words, lambda w: score(w) + bonus(w) - penalty(w))
|
|
531
|
-
```
|
|
532
|
-
|
|
533
|
-
---
|
|
534
|
-
|
|
535
|
-
## 第5章: flatMap とネスト構造
|
|
536
|
-
|
|
537
|
-
### 5.1 flatten と flat_map
|
|
538
|
-
|
|
539
|
-
**ソースファイル**: `app/python/src/grokking_fp/ch05_flatmap.py`
|
|
540
|
-
|
|
541
|
-
#### flatten - ネストしたリストを平坦化
|
|
542
|
-
|
|
543
|
-
```python
|
|
544
|
-
def flatten(nested: list[list[T]]) -> list[T]:
|
|
545
|
-
"""ネストしたリストを平坦化する。"""
|
|
546
|
-
return [item for sublist in nested for item in sublist]
|
|
547
|
-
|
|
548
|
-
# ネストしたリストを平坦化
|
|
549
|
-
author_lists = [["Chiusano", "Bjarnason"], ["Tolkien"]]
|
|
550
|
-
authors = flatten(author_lists)
|
|
551
|
-
assert authors == ["Chiusano", "Bjarnason", "Tolkien"]
|
|
552
|
-
```
|
|
553
|
-
|
|
554
|
-
```plantuml
|
|
555
|
-
@startuml
|
|
556
|
-
!theme plain
|
|
557
|
-
|
|
558
|
-
rectangle "flatten の動作" {
|
|
559
|
-
card "[['A', 'B'], ['C']]" as nested
|
|
560
|
-
card "flatten" as op
|
|
561
|
-
card "['A', 'B', 'C']" as flat
|
|
562
|
-
|
|
563
|
-
nested --> op
|
|
564
|
-
op --> flat
|
|
565
|
-
}
|
|
566
|
-
|
|
567
|
-
@enduml
|
|
568
|
-
```
|
|
569
|
-
|
|
570
|
-
#### flat_map = map + flatten
|
|
571
|
-
|
|
572
|
-
```python
|
|
573
|
-
def flat_map(func: Callable[[T], list[U]], lst: list[T]) -> list[U]:
|
|
574
|
-
"""map してから flatten する。"""
|
|
575
|
-
return [item for x in lst for item in func(x)]
|
|
576
|
-
|
|
577
|
-
# 使用例
|
|
578
|
-
result = flat_map(lambda x: [x, x * 2], [1, 2, 3])
|
|
579
|
-
assert result == [1, 2, 2, 4, 3, 6]
|
|
580
|
-
```
|
|
581
|
-
|
|
582
|
-
### 5.2 リスト内包表記による flat_map
|
|
583
|
-
|
|
584
|
-
Python ではリスト内包表記で flat_map の動作を実現できます。
|
|
585
|
-
|
|
586
|
-
```python
|
|
587
|
-
from dataclasses import dataclass
|
|
588
|
-
|
|
589
|
-
@dataclass(frozen=True)
|
|
590
|
-
class Book:
|
|
591
|
-
title: str
|
|
592
|
-
authors: list[str]
|
|
593
|
-
|
|
594
|
-
books = [
|
|
595
|
-
Book("FP in Scala", ["Chiusano", "Bjarnason"]),
|
|
596
|
-
Book("The Hobbit", ["Tolkien"])
|
|
597
|
-
]
|
|
598
|
-
|
|
599
|
-
# ネストしたループで flat_map を実現
|
|
600
|
-
authors = [author for book in books for author in book.authors]
|
|
601
|
-
assert authors == ["Chiusano", "Bjarnason", "Tolkien"]
|
|
602
|
-
```
|
|
603
|
-
|
|
604
|
-
### 5.3 flat_map によるリストサイズの変化
|
|
605
|
-
|
|
606
|
-
```python
|
|
607
|
-
# 要素数が増える
|
|
608
|
-
result1 = [x for n in [1, 2, 3] for x in [n, n + 10]]
|
|
609
|
-
assert result1 == [1, 11, 2, 12, 3, 13] # 6要素
|
|
610
|
-
|
|
611
|
-
# 要素数が同じ
|
|
612
|
-
result2 = [n * 2 for n in [1, 2, 3]]
|
|
613
|
-
assert result2 == [2, 4, 6] # 3要素
|
|
614
|
-
|
|
615
|
-
# 要素数が減る(フィルタリング効果)
|
|
616
|
-
result3 = [n for n in [1, 2, 3] if n % 2 == 0]
|
|
617
|
-
assert result3 == [2] # 1要素
|
|
618
|
-
```
|
|
619
|
-
|
|
620
|
-
```plantuml
|
|
621
|
-
@startuml
|
|
622
|
-
!theme plain
|
|
623
|
-
|
|
624
|
-
rectangle "リスト内包表記とサイズの変化" {
|
|
625
|
-
rectangle "増加" as inc {
|
|
626
|
-
card "[1, 2, 3]" as i1
|
|
627
|
-
card "[x for n in nums for x in [n, n+10]]" as f1
|
|
628
|
-
card "[1, 11, 2, 12, 3, 13]" as r1
|
|
629
|
-
i1 --> f1
|
|
630
|
-
f1 --> r1
|
|
631
|
-
}
|
|
632
|
-
|
|
633
|
-
rectangle "減少(フィルタ)" as dec {
|
|
634
|
-
card "[1, 2, 3]" as i2
|
|
635
|
-
card "[n for n in nums if n % 2 == 0]" as f2
|
|
636
|
-
card "[2]" as r2
|
|
637
|
-
i2 --> f2
|
|
638
|
-
f2 --> r2
|
|
639
|
-
}
|
|
640
|
-
}
|
|
641
|
-
|
|
642
|
-
@enduml
|
|
643
|
-
```
|
|
644
|
-
|
|
645
|
-
### 5.4 ネストしたリスト内包表記
|
|
646
|
-
|
|
647
|
-
複数のリストを組み合わせる場合、ネストしたリスト内包表記を使います。
|
|
648
|
-
|
|
649
|
-
```python
|
|
650
|
-
@dataclass(frozen=True)
|
|
651
|
-
class Movie:
|
|
652
|
-
title: str
|
|
653
|
-
|
|
654
|
-
def book_adaptations(author: str) -> list[Movie]:
|
|
655
|
-
if author == "Tolkien":
|
|
656
|
-
return [Movie("An Unexpected Journey"), Movie("The Desolation of Smaug")]
|
|
657
|
-
return []
|
|
658
|
-
|
|
659
|
-
books = [
|
|
660
|
-
Book("FP in Scala", ["Chiusano", "Bjarnason"]),
|
|
661
|
-
Book("The Hobbit", ["Tolkien"])
|
|
662
|
-
]
|
|
663
|
-
|
|
664
|
-
# ネストしたリスト内包表記
|
|
665
|
-
recommendations = [
|
|
666
|
-
f"You may like {movie.title}, because you liked {author}'s {book.title}"
|
|
667
|
-
for book in books
|
|
668
|
-
for author in book.authors
|
|
669
|
-
for movie in book_adaptations(author)
|
|
670
|
-
]
|
|
671
|
-
|
|
672
|
-
# 結果:
|
|
673
|
-
# [
|
|
674
|
-
# "You may like An Unexpected Journey, because you liked Tolkien's The Hobbit",
|
|
675
|
-
# "You may like The Desolation of Smaug, because you liked Tolkien's The Hobbit"
|
|
676
|
-
# ]
|
|
677
|
-
```
|
|
678
|
-
|
|
679
|
-
```plantuml
|
|
680
|
-
@startuml
|
|
681
|
-
!theme plain
|
|
682
|
-
|
|
683
|
-
rectangle "ネストしたリスト内包表記のフロー" {
|
|
684
|
-
card "books" as books
|
|
685
|
-
card "book.authors" as authors
|
|
686
|
-
card "book_adaptations(author)" as movies
|
|
687
|
-
card "recommendation string" as result
|
|
688
|
-
|
|
689
|
-
books --> authors : for book
|
|
690
|
-
authors --> movies : for author
|
|
691
|
-
movies --> result : for movie
|
|
692
|
-
}
|
|
693
|
-
|
|
694
|
-
note bottom
|
|
695
|
-
ネストした for は
|
|
696
|
-
外側から内側へ評価される
|
|
697
|
-
end note
|
|
698
|
-
|
|
699
|
-
@enduml
|
|
700
|
-
```
|
|
701
|
-
|
|
702
|
-
### 5.5 2D/3D ポイントの生成
|
|
703
|
-
|
|
704
|
-
**ソースファイル**: `app/python/src/grokking_fp/ch05_flatmap.py`
|
|
705
|
-
|
|
706
|
-
```python
|
|
707
|
-
@dataclass(frozen=True)
|
|
708
|
-
class Point:
|
|
709
|
-
x: int
|
|
710
|
-
y: int
|
|
711
|
-
|
|
712
|
-
@dataclass(frozen=True)
|
|
713
|
-
class Point3d:
|
|
714
|
-
x: int
|
|
715
|
-
y: int
|
|
716
|
-
z: int
|
|
717
|
-
|
|
718
|
-
def generate_points(xs: list[int], ys: list[int]) -> list[Point]:
|
|
719
|
-
return [Point(x, y) for x in xs for y in ys]
|
|
720
|
-
|
|
721
|
-
def generate_points_3d(xs: list[int], ys: list[int], zs: list[int]) -> list[Point3d]:
|
|
722
|
-
return [Point3d(x, y, z) for x in xs for y in ys for z in zs]
|
|
723
|
-
|
|
724
|
-
# 使用例
|
|
725
|
-
points = generate_points([1], [-2, 7])
|
|
726
|
-
assert points == [Point(1, -2), Point(1, 7)]
|
|
727
|
-
|
|
728
|
-
points_3d = generate_points_3d([1], [-2, 7], [3, 4])
|
|
729
|
-
assert points_3d == [
|
|
730
|
-
Point3d(1, -2, 3), Point3d(1, -2, 4),
|
|
731
|
-
Point3d(1, 7, 3), Point3d(1, 7, 4)
|
|
732
|
-
]
|
|
733
|
-
```
|
|
734
|
-
|
|
735
|
-
### 5.6 ジェネレータによる遅延評価
|
|
736
|
-
|
|
737
|
-
Python のジェネレータ式を使うと、遅延評価が可能です。
|
|
738
|
-
|
|
739
|
-
```python
|
|
740
|
-
from collections.abc import Iterator
|
|
741
|
-
|
|
742
|
-
def generate_points_lazy(xs: list[int], ys: list[int]) -> Iterator[Point]:
|
|
743
|
-
"""ジェネレータを使って遅延評価で Point を生成する。"""
|
|
744
|
-
return (Point(x, y) for x in xs for y in ys)
|
|
745
|
-
|
|
746
|
-
def infinite_sequence(start: int = 0) -> Iterator[int]:
|
|
747
|
-
"""無限シーケンスを生成する。"""
|
|
748
|
-
n = start
|
|
749
|
-
while True:
|
|
750
|
-
yield n
|
|
751
|
-
n += 1
|
|
752
|
-
|
|
753
|
-
# 無限シーケンスから最初の3つを取得
|
|
754
|
-
from itertools import islice
|
|
755
|
-
result = list(islice(infinite_sequence(5), 3))
|
|
756
|
-
assert result == [5, 6, 7]
|
|
757
|
-
```
|
|
758
|
-
|
|
759
|
-
### 5.7 itertools を使った高度な操作
|
|
760
|
-
|
|
761
|
-
```python
|
|
762
|
-
from itertools import product, chain, groupby
|
|
763
|
-
|
|
764
|
-
# デカルト積
|
|
765
|
-
pairs = list(product([1, 2], [3, 4]))
|
|
766
|
-
assert pairs == [(1, 3), (1, 4), (2, 3), (2, 4)]
|
|
767
|
-
|
|
768
|
-
# リストの連結
|
|
769
|
-
combined = list(chain.from_iterable([[1, 2], [3], [4, 5, 6]]))
|
|
770
|
-
assert combined == [1, 2, 3, 4, 5, 6]
|
|
771
|
-
|
|
772
|
-
# グループ化
|
|
773
|
-
words = ["apple", "apricot", "banana", "blueberry"]
|
|
774
|
-
sorted_words = sorted(words, key=lambda w: w[0])
|
|
775
|
-
grouped = {
|
|
776
|
-
key: list(group)
|
|
777
|
-
for key, group in groupby(sorted_words, key=lambda w: w[0])
|
|
778
|
-
}
|
|
779
|
-
assert grouped == {"a": ["apple", "apricot"], "b": ["banana", "blueberry"]}
|
|
780
|
-
```
|
|
781
|
-
|
|
782
|
-
---
|
|
783
|
-
|
|
784
|
-
## まとめ
|
|
785
|
-
|
|
786
|
-
### Part II で学んだこと
|
|
787
|
-
|
|
788
|
-
```plantuml
|
|
789
|
-
@startuml
|
|
790
|
-
!theme plain
|
|
791
|
-
|
|
792
|
-
rectangle "Part II: 関数型スタイルのプログラミング" {
|
|
793
|
-
rectangle "第3章" as ch3 {
|
|
794
|
-
card "イミュータブルデータ"
|
|
795
|
-
card "スライス / リスト結合"
|
|
796
|
-
card "NamedTuple / dataclass"
|
|
797
|
-
}
|
|
798
|
-
|
|
799
|
-
rectangle "第4章" as ch4 {
|
|
800
|
-
card "高階関数"
|
|
801
|
-
card "リスト内包表記"
|
|
802
|
-
card "関数を返す関数"
|
|
803
|
-
card "クロージャ"
|
|
804
|
-
}
|
|
805
|
-
|
|
806
|
-
rectangle "第5章" as ch5 {
|
|
807
|
-
card "flatten / flat_map"
|
|
808
|
-
card "ネストしたリスト内包表記"
|
|
809
|
-
card "ジェネレータ"
|
|
810
|
-
card "itertools"
|
|
811
|
-
}
|
|
812
|
-
}
|
|
813
|
-
|
|
814
|
-
ch3 --> ch4
|
|
815
|
-
ch4 --> ch5
|
|
816
|
-
|
|
817
|
-
@enduml
|
|
818
|
-
```
|
|
819
|
-
|
|
820
|
-
### キーポイント
|
|
821
|
-
|
|
822
|
-
| 章 | 主要概念 | Python での実現方法 |
|
|
823
|
-
|----|----------|---------------------|
|
|
824
|
-
| 第3章 | イミュータブル | `+`, スライス, `NamedTuple`, `frozenset` |
|
|
825
|
-
| 第4章 | 高階関数 | リスト内包表記, `filter()`, `reduce()`, `sorted()` |
|
|
826
|
-
| 第5章 | 平坦化 | ネストしたリスト内包表記, ジェネレータ, `itertools` |
|
|
827
|
-
|
|
828
|
-
### 重要な法則
|
|
829
|
-
|
|
830
|
-
1. **イミュータブルデータ**: 元のデータは変更せず、新しいデータを作成する
|
|
831
|
-
2. **関数は値**: 関数を引数として渡したり、戻り値として返したりできる
|
|
832
|
-
3. **リスト内包表記**: Python における flat_map の主要な表現方法
|
|
833
|
-
4. **ジェネレータ**: 遅延評価でメモリ効率の良い処理が可能
|
|
834
|
-
|
|
835
|
-
### Python 特有のポイント
|
|
836
|
-
|
|
837
|
-
- **リスト内包表記**: Scala の `for` 内包表記に相当
|
|
838
|
-
- **ジェネレータ式**: `()` で囲むと遅延評価になる
|
|
839
|
-
- **`@dataclass(frozen=True)`**: イミュータブルなデータクラスを定義
|
|
840
|
-
- **`NamedTuple`**: 軽量なイミュータブルデータ構造
|
|
841
|
-
|
|
842
|
-
### 次のステップ
|
|
843
|
-
|
|
844
|
-
Part III では、以下のトピックを学びます:
|
|
845
|
-
|
|
846
|
-
- `returns` ライブラリによる関数型プログラミング
|
|
847
|
-
- `Maybe` 型による安全なエラーハンドリング
|
|
848
|
-
- `Result` 型と複合的なエラー処理
|
|
849
|
-
|
|
850
|
-
---
|
|
851
|
-
|
|
852
|
-
## 演習問題
|
|
853
|
-
|
|
854
|
-
### 問題 1: イミュータブルな操作
|
|
855
|
-
|
|
856
|
-
以下の関数を実装してください。リストの中央に要素を挿入する関数です。
|
|
857
|
-
|
|
858
|
-
```python
|
|
859
|
-
def insert_at_middle(lst: list[str], element: str) -> list[str]:
|
|
860
|
-
...
|
|
861
|
-
|
|
862
|
-
# 期待される動作
|
|
863
|
-
assert insert_at_middle(["a", "b", "c", "d"], "X") == ["a", "b", "X", "c", "d"]
|
|
864
|
-
assert insert_at_middle(["a", "b"], "X") == ["a", "X", "b"]
|
|
865
|
-
```
|
|
866
|
-
|
|
867
|
-
<details>
|
|
868
|
-
<summary>解答</summary>
|
|
869
|
-
|
|
870
|
-
```python
|
|
871
|
-
def insert_at_middle(lst: list[str], element: str) -> list[str]:
|
|
872
|
-
middle = len(lst) // 2
|
|
873
|
-
return lst[:middle] + [element] + lst[middle:]
|
|
874
|
-
```
|
|
875
|
-
|
|
876
|
-
</details>
|
|
877
|
-
|
|
878
|
-
### 問題 2: 高階関数
|
|
879
|
-
|
|
880
|
-
以下の関数を実装してください。条件を満たす要素の数をカウントする関数です。
|
|
881
|
-
|
|
882
|
-
```python
|
|
883
|
-
from collections.abc import Callable
|
|
884
|
-
from typing import TypeVar
|
|
885
|
-
|
|
886
|
-
T = TypeVar("T")
|
|
887
|
-
|
|
888
|
-
def count_where(lst: list[T], predicate: Callable[[T], bool]) -> int:
|
|
889
|
-
...
|
|
890
|
-
|
|
891
|
-
# 期待される動作
|
|
892
|
-
assert count_where([1, 2, 3, 4, 5], lambda i: i > 3) == 2
|
|
893
|
-
assert count_where(["a", "bb", "ccc"], lambda s: len(s) > 1) == 2
|
|
894
|
-
```
|
|
895
|
-
|
|
896
|
-
<details>
|
|
897
|
-
<summary>解答</summary>
|
|
898
|
-
|
|
899
|
-
```python
|
|
900
|
-
def count_where(lst: list[T], predicate: Callable[[T], bool]) -> int:
|
|
901
|
-
return len([x for x in lst if predicate(x)])
|
|
902
|
-
|
|
903
|
-
# または reduce を使って
|
|
904
|
-
from functools import reduce
|
|
905
|
-
|
|
906
|
-
def count_where2(lst: list[T], predicate: Callable[[T], bool]) -> int:
|
|
907
|
-
return reduce(lambda acc, x: acc + 1 if predicate(x) else acc, lst, 0)
|
|
908
|
-
```
|
|
909
|
-
|
|
910
|
-
</details>
|
|
911
|
-
|
|
912
|
-
### 問題 3: ネストしたリスト内包表記
|
|
913
|
-
|
|
914
|
-
以下のネストした処理をリスト内包表記で書いてください。
|
|
915
|
-
|
|
916
|
-
```python
|
|
917
|
-
result = []
|
|
918
|
-
for x in [1, 2]:
|
|
919
|
-
for y in [10, 20]:
|
|
920
|
-
for z in [100, 200]:
|
|
921
|
-
result.append(x + y + z)
|
|
922
|
-
```
|
|
923
|
-
|
|
924
|
-
<details>
|
|
925
|
-
<summary>解答</summary>
|
|
926
|
-
|
|
927
|
-
```python
|
|
928
|
-
result = [x + y + z for x in [1, 2] for y in [10, 20] for z in [100, 200]]
|
|
929
|
-
|
|
930
|
-
# 結果: [111, 211, 121, 221, 112, 212, 122, 222]
|
|
931
|
-
```
|
|
932
|
-
|
|
933
|
-
</details>
|
|
934
|
-
|
|
935
|
-
### 問題 4: リスト内包表記によるフィルタリング
|
|
936
|
-
|
|
937
|
-
`if` 条件を使わずに、リスト内包表記だけで偶数のみを抽出するコードを書いてください(flat_map パターン)。
|
|
938
|
-
|
|
939
|
-
```python
|
|
940
|
-
numbers = [1, 2, 3, 4, 5, 6]
|
|
941
|
-
# 偶数のみを抽出: [2, 4, 6]
|
|
942
|
-
```
|
|
943
|
-
|
|
944
|
-
<details>
|
|
945
|
-
<summary>解答</summary>
|
|
946
|
-
|
|
947
|
-
```python
|
|
948
|
-
# flat_map パターン: 空リストを返すことでフィルタリング
|
|
949
|
-
even_numbers = [x for n in numbers for x in ([n] if n % 2 == 0 else [])]
|
|
950
|
-
|
|
951
|
-
# または関数に分離
|
|
952
|
-
def even_filter(n: int) -> list[int]:
|
|
953
|
-
return [n] if n % 2 == 0 else []
|
|
954
|
-
|
|
955
|
-
even_numbers2 = [x for n in numbers for x in even_filter(n)]
|
|
956
|
-
```
|
|
957
|
-
|
|
958
|
-
</details>
|
|
1
|
+
# Part II: 関数型スタイルのプログラミング
|
|
2
|
+
|
|
3
|
+
本章では、関数型プログラミングの核心となるテクニックを学びます。イミュータブルなデータ操作、高階関数、そしてリスト内包表記による複雑なデータ変換を習得します。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 第3章: イミュータブルなデータ操作
|
|
8
|
+
|
|
9
|
+
### 3.1 イミュータブルとは
|
|
10
|
+
|
|
11
|
+
イミュータブル(不変)とは、一度作成されたデータが変更されないことを意味します。データを「変更」する代わりに、新しいデータを「作成」します。
|
|
12
|
+
|
|
13
|
+
```plantuml
|
|
14
|
+
@startuml
|
|
15
|
+
!theme plain
|
|
16
|
+
|
|
17
|
+
rectangle "ミュータブル(可変)" as mut {
|
|
18
|
+
card "lst = ['A', 'B']" as m1
|
|
19
|
+
card "lst.append('C')" as m2
|
|
20
|
+
card "lst = ['A', 'B', 'C']" as m3
|
|
21
|
+
m1 --> m2 : 変更
|
|
22
|
+
m2 --> m3 : 同じリストが変わる
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
rectangle "イミュータブル(不変)" as immut {
|
|
26
|
+
card "lst1 = ['A', 'B']" as i1
|
|
27
|
+
card "lst2 = lst1 + ['C']" as i2
|
|
28
|
+
card "lst1 = ['A', 'B']\nlst2 = ['A', 'B', 'C']" as i3
|
|
29
|
+
i1 --> i2 : 新規作成
|
|
30
|
+
i2 --> i3 : 両方が存在
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
@enduml
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### 3.2 List の基本操作
|
|
37
|
+
|
|
38
|
+
**ソースファイル**: `app/python/src/grokking_fp/ch03_immutable_data.py`
|
|
39
|
+
|
|
40
|
+
#### appended - 要素の追加
|
|
41
|
+
|
|
42
|
+
```python
|
|
43
|
+
def appended(lst: list[str], element: str) -> list[str]:
|
|
44
|
+
"""リストに要素を追加した新しいリストを返す。"""
|
|
45
|
+
return lst + [element]
|
|
46
|
+
|
|
47
|
+
original = ["Apple", "Book"]
|
|
48
|
+
new_list = appended(original, "Mango")
|
|
49
|
+
|
|
50
|
+
assert original == ["Apple", "Book"] # 元のリストは変わらない
|
|
51
|
+
assert new_list == ["Apple", "Book", "Mango"] # 新しいリストが作成される
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
#### スライス - リストの切り出し
|
|
55
|
+
|
|
56
|
+
Python ではスライス記法 `[start:end]` を使います。
|
|
57
|
+
|
|
58
|
+
```python
|
|
59
|
+
def first_two(lst: list[str]) -> list[str]:
|
|
60
|
+
return lst[:2]
|
|
61
|
+
|
|
62
|
+
def last_two(lst: list[str]) -> list[str]:
|
|
63
|
+
if len(lst) < 2:
|
|
64
|
+
return lst[:]
|
|
65
|
+
return lst[-2:]
|
|
66
|
+
|
|
67
|
+
assert first_two(["a", "b", "c"]) == ["a", "b"]
|
|
68
|
+
assert last_two(["a", "b", "c"]) == ["b", "c"]
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
```plantuml
|
|
72
|
+
@startuml
|
|
73
|
+
!theme plain
|
|
74
|
+
|
|
75
|
+
rectangle "スライス記法" {
|
|
76
|
+
card "lst = ['a', 'b', 'c', 'd']" as orig
|
|
77
|
+
card "lst[1:3]" as op
|
|
78
|
+
card "['b', 'c']" as result
|
|
79
|
+
|
|
80
|
+
orig --> op
|
|
81
|
+
op --> result
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
note bottom of result
|
|
85
|
+
インデックス 1 から 3 の手前まで
|
|
86
|
+
(end は含まない)
|
|
87
|
+
end note
|
|
88
|
+
|
|
89
|
+
@enduml
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### 3.3 リストの変換例
|
|
93
|
+
|
|
94
|
+
**ソースファイル**: `app/python/src/grokking_fp/ch03_immutable_data.py`
|
|
95
|
+
|
|
96
|
+
```python
|
|
97
|
+
# 最初の2要素を末尾に移動
|
|
98
|
+
def move_first_two_to_end(lst: list[str]) -> list[str]:
|
|
99
|
+
first = lst[:2]
|
|
100
|
+
rest = lst[2:]
|
|
101
|
+
return rest + first
|
|
102
|
+
|
|
103
|
+
assert move_first_two_to_end(["a", "b", "c"]) == ["c", "a", "b"]
|
|
104
|
+
|
|
105
|
+
# 最後の要素の前に挿入
|
|
106
|
+
def insert_before_last(lst: list[str], element: str) -> list[str]:
|
|
107
|
+
if not lst:
|
|
108
|
+
return [element]
|
|
109
|
+
return lst[:-1] + [element] + lst[-1:]
|
|
110
|
+
|
|
111
|
+
assert insert_before_last(["a", "b"], "c") == ["a", "c", "b"]
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### 3.4 旅程の再計画
|
|
115
|
+
|
|
116
|
+
**ソースファイル**: `app/python/src/grokking_fp/ch03_immutable_data.py`
|
|
117
|
+
|
|
118
|
+
旅行の計画変更をイミュータブルに行う例です。
|
|
119
|
+
|
|
120
|
+
```python
|
|
121
|
+
def replan(plan: list[str], new_city: str, before_city: str) -> list[str]:
|
|
122
|
+
"""指定した都市の前に新しい都市を挿入した旅程を返す。"""
|
|
123
|
+
try:
|
|
124
|
+
index = plan.index(before_city)
|
|
125
|
+
return plan[:index] + [new_city] + plan[index:]
|
|
126
|
+
except ValueError:
|
|
127
|
+
return plan + [new_city]
|
|
128
|
+
|
|
129
|
+
plan_a = ["Paris", "Berlin", "Kraków"]
|
|
130
|
+
plan_b = replan(plan_a, "Vienna", "Kraków")
|
|
131
|
+
|
|
132
|
+
assert plan_b == ["Paris", "Berlin", "Vienna", "Kraków"]
|
|
133
|
+
assert plan_a == ["Paris", "Berlin", "Kraków"] # 元の計画は変わらない!
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
```plantuml
|
|
137
|
+
@startuml
|
|
138
|
+
!theme plain
|
|
139
|
+
|
|
140
|
+
rectangle "旅程の再計画" {
|
|
141
|
+
card "Plan A:\nParis → Berlin → Kraków" as planA
|
|
142
|
+
card "replan(plan_a, 'Vienna', 'Kraków')" as op
|
|
143
|
+
card "Plan B:\nParis → Berlin → Vienna → Kraków" as planB
|
|
144
|
+
|
|
145
|
+
planA --> op
|
|
146
|
+
op --> planB
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
note right of planA
|
|
150
|
+
Plan A は変更されない
|
|
151
|
+
(イミュータブル)
|
|
152
|
+
end note
|
|
153
|
+
|
|
154
|
+
@enduml
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### 3.5 String と List の類似性
|
|
158
|
+
|
|
159
|
+
Python では String と List は似た操作ができます。
|
|
160
|
+
|
|
161
|
+
| 操作 | List | String |
|
|
162
|
+
|------|------|--------|
|
|
163
|
+
| 結合 | `+` | `+` |
|
|
164
|
+
| 切り出し | `[start:end]` | `[start:end]` |
|
|
165
|
+
| サイズ | `len()` | `len()` |
|
|
166
|
+
|
|
167
|
+
```python
|
|
168
|
+
# List の操作
|
|
169
|
+
ab_list = ["a", "b"]
|
|
170
|
+
cd_list = ["c", "d"]
|
|
171
|
+
abcd_list = ab_list + cd_list
|
|
172
|
+
assert abcd_list == ["a", "b", "c", "d"]
|
|
173
|
+
|
|
174
|
+
# String の操作
|
|
175
|
+
ab_str = "ab"
|
|
176
|
+
cd_str = "cd"
|
|
177
|
+
abcd_str = ab_str + cd_str
|
|
178
|
+
assert abcd_str == "abcd"
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
### 3.6 名前の省略
|
|
182
|
+
|
|
183
|
+
**ソースファイル**: `app/python/src/grokking_fp/ch03_immutable_data.py`
|
|
184
|
+
|
|
185
|
+
```python
|
|
186
|
+
def abbreviate(name: str) -> str:
|
|
187
|
+
"""名前を省略形にする。"""
|
|
188
|
+
separator = name.find(" ")
|
|
189
|
+
if separator == -1:
|
|
190
|
+
return name
|
|
191
|
+
initial = name[0]
|
|
192
|
+
last_name = name[separator + 1:]
|
|
193
|
+
return f"{initial}. {last_name}"
|
|
194
|
+
|
|
195
|
+
assert abbreviate("Alonzo Church") == "A. Church"
|
|
196
|
+
assert abbreviate("A. Church") == "A. Church"
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
### 3.7 NamedTuple によるイミュータブルなデータ構造
|
|
200
|
+
|
|
201
|
+
Python では `NamedTuple` を使ってイミュータブルなデータ構造を定義できます。
|
|
202
|
+
|
|
203
|
+
```python
|
|
204
|
+
from typing import NamedTuple
|
|
205
|
+
|
|
206
|
+
class City(NamedTuple):
|
|
207
|
+
name: str
|
|
208
|
+
population: int
|
|
209
|
+
|
|
210
|
+
def with_population(city: City, new_population: int) -> City:
|
|
211
|
+
"""人口を更新した新しい City を返す。"""
|
|
212
|
+
return City(city.name, new_population)
|
|
213
|
+
|
|
214
|
+
tokyo = City("Tokyo", 13960000)
|
|
215
|
+
tokyo_updated = with_population(tokyo, 14000000)
|
|
216
|
+
|
|
217
|
+
assert tokyo.population == 13960000 # 元の都市は変わらない
|
|
218
|
+
assert tokyo_updated.population == 14000000
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
### 3.8 frozenset と 辞書のイミュータブル操作
|
|
222
|
+
|
|
223
|
+
```python
|
|
224
|
+
# frozenset - イミュータブルな集合
|
|
225
|
+
def add_to_set(s: frozenset[str], element: str) -> frozenset[str]:
|
|
226
|
+
return s | {element}
|
|
227
|
+
|
|
228
|
+
s = frozenset({"a", "b"})
|
|
229
|
+
s2 = add_to_set(s, "c")
|
|
230
|
+
assert "c" not in s # 元の集合は変わらない
|
|
231
|
+
assert "c" in s2
|
|
232
|
+
|
|
233
|
+
# 辞書のイミュータブル操作
|
|
234
|
+
def update_dict(d: dict[str, int], key: str, value: int) -> dict[str, int]:
|
|
235
|
+
return {**d, key: value}
|
|
236
|
+
|
|
237
|
+
d = {"a": 1, "b": 2}
|
|
238
|
+
d2 = update_dict(d, "c", 3)
|
|
239
|
+
assert d == {"a": 1, "b": 2} # 元の辞書は変わらない
|
|
240
|
+
assert d2 == {"a": 1, "b": 2, "c": 3}
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
---
|
|
244
|
+
|
|
245
|
+
## 第4章: 関数を値として扱う
|
|
246
|
+
|
|
247
|
+
### 4.1 高階関数とは
|
|
248
|
+
|
|
249
|
+
高階関数(Higher-Order Function)とは、以下のいずれかを満たす関数です:
|
|
250
|
+
|
|
251
|
+
1. 関数を引数として受け取る
|
|
252
|
+
2. 関数を戻り値として返す
|
|
253
|
+
|
|
254
|
+
Python では関数は第一級オブジェクトなので、変数に代入したり引数として渡したりできます。
|
|
255
|
+
|
|
256
|
+
```plantuml
|
|
257
|
+
@startuml
|
|
258
|
+
!theme plain
|
|
259
|
+
|
|
260
|
+
rectangle "高階関数" {
|
|
261
|
+
rectangle "関数を引数に取る" as arg {
|
|
262
|
+
card "sorted(key=score)" as sortBy
|
|
263
|
+
card "map(transform, lst)" as map
|
|
264
|
+
card "filter(predicate, lst)" as filter
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
rectangle "関数を返す" as ret {
|
|
268
|
+
card "larger_than(n)" as larger
|
|
269
|
+
card "divisible_by(n)" as divisible
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
@enduml
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
### 4.2 関数を引数として渡す
|
|
277
|
+
|
|
278
|
+
**ソースファイル**: `app/python/src/grokking_fp/ch04_higher_order.py`
|
|
279
|
+
|
|
280
|
+
#### sorted と key - ソート基準を関数で指定
|
|
281
|
+
|
|
282
|
+
```python
|
|
283
|
+
def score(word: str) -> int:
|
|
284
|
+
"""'a' を除いた文字数をスコアとする。"""
|
|
285
|
+
return len(word.replace("a", ""))
|
|
286
|
+
|
|
287
|
+
words = ["rust", "java"]
|
|
288
|
+
sorted_words = sorted(words, key=score)
|
|
289
|
+
|
|
290
|
+
assert sorted_words == ["java", "rust"]
|
|
291
|
+
# java: 2文字 (j, v), rust: 4文字 (r, u, s, t)
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
```plantuml
|
|
295
|
+
@startuml
|
|
296
|
+
!theme plain
|
|
297
|
+
|
|
298
|
+
rectangle "sorted の動作" {
|
|
299
|
+
card "['rust', 'java']" as input
|
|
300
|
+
card "score('rust') = 4\nscore('java') = 2" as scores
|
|
301
|
+
card "['java', 'rust']" as output
|
|
302
|
+
|
|
303
|
+
input --> scores : score関数を適用
|
|
304
|
+
scores --> output : スコア順にソート
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
@enduml
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
#### リスト内包表記による map
|
|
311
|
+
|
|
312
|
+
Python では `map()` よりもリスト内包表記が一般的です。
|
|
313
|
+
|
|
314
|
+
```python
|
|
315
|
+
# 各要素の長さを取得
|
|
316
|
+
lengths = [len(word) for word in ["scala", "rust", "ada"]]
|
|
317
|
+
assert lengths == [5, 4, 3]
|
|
318
|
+
|
|
319
|
+
# 各要素を2倍
|
|
320
|
+
doubles = [n * 2 for n in [5, 1, 2, 4, 0]]
|
|
321
|
+
assert doubles == [10, 2, 4, 8, 0]
|
|
322
|
+
```
|
|
323
|
+
|
|
324
|
+
```plantuml
|
|
325
|
+
@startuml
|
|
326
|
+
!theme plain
|
|
327
|
+
|
|
328
|
+
rectangle "リスト内包表記の動作" {
|
|
329
|
+
card "['scala', 'rust', 'ada']" as input
|
|
330
|
+
card "[len(w) for w in words]" as op
|
|
331
|
+
card "[5, 4, 3]" as output
|
|
332
|
+
|
|
333
|
+
input --> op
|
|
334
|
+
op --> output
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
@enduml
|
|
338
|
+
```
|
|
339
|
+
|
|
340
|
+
#### filter - 条件に合う要素を抽出
|
|
341
|
+
|
|
342
|
+
```python
|
|
343
|
+
# 奇数のみを抽出
|
|
344
|
+
odds = [n for n in [5, 1, 2, 4, 0] if n % 2 == 1]
|
|
345
|
+
assert odds == [5, 1]
|
|
346
|
+
|
|
347
|
+
# 4より大きい数のみ
|
|
348
|
+
large = [n for n in [5, 1, 2, 4, 0] if n > 4]
|
|
349
|
+
assert large == [5]
|
|
350
|
+
```
|
|
351
|
+
|
|
352
|
+
#### reduce - 畳み込み
|
|
353
|
+
|
|
354
|
+
```python
|
|
355
|
+
from functools import reduce
|
|
356
|
+
|
|
357
|
+
# 合計を計算
|
|
358
|
+
total = reduce(lambda acc, n: acc + n, [5, 1, 2, 4, 100], 0)
|
|
359
|
+
assert total == 112
|
|
360
|
+
|
|
361
|
+
# 最大値を見つける
|
|
362
|
+
numbers = [5, 1, 2, 4, 15]
|
|
363
|
+
max_val = reduce(lambda acc, n: n if n > acc else acc, numbers)
|
|
364
|
+
assert max_val == 15
|
|
365
|
+
```
|
|
366
|
+
|
|
367
|
+
```plantuml
|
|
368
|
+
@startuml
|
|
369
|
+
!theme plain
|
|
370
|
+
|
|
371
|
+
rectangle "reduce の動作" {
|
|
372
|
+
card "初期値: 0" as init
|
|
373
|
+
card "0 + 5 = 5" as s1
|
|
374
|
+
card "5 + 1 = 6" as s2
|
|
375
|
+
card "6 + 2 = 8" as s3
|
|
376
|
+
card "8 + 4 = 12" as s4
|
|
377
|
+
card "12 + 100 = 112" as s5
|
|
378
|
+
|
|
379
|
+
init --> s1
|
|
380
|
+
s1 --> s2
|
|
381
|
+
s2 --> s3
|
|
382
|
+
s3 --> s4
|
|
383
|
+
s4 --> s5
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
@enduml
|
|
387
|
+
```
|
|
388
|
+
|
|
389
|
+
### 4.3 dataclass によるデータ構造
|
|
390
|
+
|
|
391
|
+
```python
|
|
392
|
+
from dataclasses import dataclass
|
|
393
|
+
|
|
394
|
+
@dataclass(frozen=True)
|
|
395
|
+
class ProgrammingLanguage:
|
|
396
|
+
name: str
|
|
397
|
+
year: int
|
|
398
|
+
|
|
399
|
+
java = ProgrammingLanguage("Java", 1995)
|
|
400
|
+
scala = ProgrammingLanguage("Scala", 2004)
|
|
401
|
+
|
|
402
|
+
languages = [java, scala]
|
|
403
|
+
|
|
404
|
+
# フィールドにアクセス
|
|
405
|
+
names = [lang.name for lang in languages]
|
|
406
|
+
assert names == ["Java", "Scala"]
|
|
407
|
+
|
|
408
|
+
# 条件でフィルタ
|
|
409
|
+
young = [lang for lang in languages if lang.year > 2000]
|
|
410
|
+
assert young == [scala]
|
|
411
|
+
```
|
|
412
|
+
|
|
413
|
+
### 4.4 関数を返す関数
|
|
414
|
+
|
|
415
|
+
**ソースファイル**: `app/python/src/grokking_fp/ch04_higher_order.py`
|
|
416
|
+
|
|
417
|
+
```python
|
|
418
|
+
from collections.abc import Callable
|
|
419
|
+
|
|
420
|
+
def larger_than(n: int) -> Callable[[int], bool]:
|
|
421
|
+
"""n より大きいかを判定する関数を返す。"""
|
|
422
|
+
return lambda i: i > n
|
|
423
|
+
|
|
424
|
+
large = list(filter(larger_than(4), [5, 1, 2, 4, 0]))
|
|
425
|
+
assert large == [5]
|
|
426
|
+
|
|
427
|
+
medium = list(filter(larger_than(1), [5, 1, 2, 4, 0]))
|
|
428
|
+
assert medium == [5, 2, 4]
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
```plantuml
|
|
432
|
+
@startuml
|
|
433
|
+
!theme plain
|
|
434
|
+
|
|
435
|
+
rectangle "関数を返す関数" {
|
|
436
|
+
card "larger_than(4)" as call
|
|
437
|
+
card "lambda i: i > 4" as fn
|
|
438
|
+
card "filter に渡す" as filter
|
|
439
|
+
|
|
440
|
+
call --> fn : 関数を生成
|
|
441
|
+
fn --> filter : 生成された関数を使用
|
|
442
|
+
}
|
|
443
|
+
|
|
444
|
+
note bottom
|
|
445
|
+
larger_than(4) は
|
|
446
|
+
「4より大きいか判定する関数」を返す
|
|
447
|
+
end note
|
|
448
|
+
|
|
449
|
+
@enduml
|
|
450
|
+
```
|
|
451
|
+
|
|
452
|
+
### 4.5 クロージャとカリー化
|
|
453
|
+
|
|
454
|
+
Python ではクロージャを使ってカリー化のような機能を実現できます。
|
|
455
|
+
|
|
456
|
+
```python
|
|
457
|
+
def high_scoring_words_with_threshold(
|
|
458
|
+
word_score_fn: Callable[[str], int],
|
|
459
|
+
) -> Callable[[int], Callable[[list[str]], list[str]]]:
|
|
460
|
+
"""カリー化された関数。スコア関数、閾値、単語リストを順番に受け取る。"""
|
|
461
|
+
def with_threshold(higher_than: int) -> Callable[[list[str]], list[str]]:
|
|
462
|
+
def filter_words(words: list[str]) -> list[str]:
|
|
463
|
+
return [word for word in words if word_score_fn(word) > higher_than]
|
|
464
|
+
return filter_words
|
|
465
|
+
return with_threshold
|
|
466
|
+
|
|
467
|
+
# 使用例
|
|
468
|
+
words = ["ada", "haskell", "scala", "java", "rust"]
|
|
469
|
+
scorer = high_scoring_words_with_threshold(word_score_with_bonus_and_penalty)
|
|
470
|
+
assert scorer(1)(words) == ["java"]
|
|
471
|
+
assert scorer(0)(words) == ["ada", "scala", "java"]
|
|
472
|
+
```
|
|
473
|
+
|
|
474
|
+
```plantuml
|
|
475
|
+
@startuml
|
|
476
|
+
!theme plain
|
|
477
|
+
|
|
478
|
+
rectangle "カリー化" {
|
|
479
|
+
rectangle "通常の関数" as normal {
|
|
480
|
+
card "f(a, b, c)" as n1
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
rectangle "カリー化された関数" as curried {
|
|
484
|
+
card "f(a)(b)(c)" as c1
|
|
485
|
+
}
|
|
486
|
+
|
|
487
|
+
normal --> curried : カリー化
|
|
488
|
+
}
|
|
489
|
+
|
|
490
|
+
note bottom of curried
|
|
491
|
+
部分適用が可能
|
|
492
|
+
f(a) → 関数を返す
|
|
493
|
+
f(a)(b) → 関数を返す
|
|
494
|
+
f(a)(b)(c) → 結果を返す
|
|
495
|
+
end note
|
|
496
|
+
|
|
497
|
+
@enduml
|
|
498
|
+
```
|
|
499
|
+
|
|
500
|
+
### 4.6 ワードスコアリングの例
|
|
501
|
+
|
|
502
|
+
**ソースファイル**: `app/python/src/grokking_fp/ch04_higher_order.py`
|
|
503
|
+
|
|
504
|
+
複数のスコアリングロジックを組み合わせる例です。
|
|
505
|
+
|
|
506
|
+
```python
|
|
507
|
+
def score(word: str) -> int:
|
|
508
|
+
return len(word.replace("a", ""))
|
|
509
|
+
|
|
510
|
+
def bonus(word: str) -> int:
|
|
511
|
+
return 5 if "c" in word else 0
|
|
512
|
+
|
|
513
|
+
def penalty(word: str) -> int:
|
|
514
|
+
return 7 if "s" in word else 0
|
|
515
|
+
|
|
516
|
+
words = ["ada", "haskell", "scala", "java", "rust"]
|
|
517
|
+
|
|
518
|
+
# 関数を引数として渡す
|
|
519
|
+
def ranked_words(words: list[str], word_score: Callable[[str], int]) -> list[str]:
|
|
520
|
+
return sorted(words, key=word_score, reverse=True)
|
|
521
|
+
|
|
522
|
+
# 基本スコアでランキング
|
|
523
|
+
ranking1 = ranked_words(words, score)
|
|
524
|
+
assert ranking1 == ["haskell", "rust", "scala", "java", "ada"]
|
|
525
|
+
|
|
526
|
+
# ボーナス付きスコアでランキング
|
|
527
|
+
ranking2 = ranked_words(words, lambda w: score(w) + bonus(w))
|
|
528
|
+
|
|
529
|
+
# ボーナスとペナルティ付き
|
|
530
|
+
ranking3 = ranked_words(words, lambda w: score(w) + bonus(w) - penalty(w))
|
|
531
|
+
```
|
|
532
|
+
|
|
533
|
+
---
|
|
534
|
+
|
|
535
|
+
## 第5章: flatMap とネスト構造
|
|
536
|
+
|
|
537
|
+
### 5.1 flatten と flat_map
|
|
538
|
+
|
|
539
|
+
**ソースファイル**: `app/python/src/grokking_fp/ch05_flatmap.py`
|
|
540
|
+
|
|
541
|
+
#### flatten - ネストしたリストを平坦化
|
|
542
|
+
|
|
543
|
+
```python
|
|
544
|
+
def flatten(nested: list[list[T]]) -> list[T]:
|
|
545
|
+
"""ネストしたリストを平坦化する。"""
|
|
546
|
+
return [item for sublist in nested for item in sublist]
|
|
547
|
+
|
|
548
|
+
# ネストしたリストを平坦化
|
|
549
|
+
author_lists = [["Chiusano", "Bjarnason"], ["Tolkien"]]
|
|
550
|
+
authors = flatten(author_lists)
|
|
551
|
+
assert authors == ["Chiusano", "Bjarnason", "Tolkien"]
|
|
552
|
+
```
|
|
553
|
+
|
|
554
|
+
```plantuml
|
|
555
|
+
@startuml
|
|
556
|
+
!theme plain
|
|
557
|
+
|
|
558
|
+
rectangle "flatten の動作" {
|
|
559
|
+
card "[['A', 'B'], ['C']]" as nested
|
|
560
|
+
card "flatten" as op
|
|
561
|
+
card "['A', 'B', 'C']" as flat
|
|
562
|
+
|
|
563
|
+
nested --> op
|
|
564
|
+
op --> flat
|
|
565
|
+
}
|
|
566
|
+
|
|
567
|
+
@enduml
|
|
568
|
+
```
|
|
569
|
+
|
|
570
|
+
#### flat_map = map + flatten
|
|
571
|
+
|
|
572
|
+
```python
|
|
573
|
+
def flat_map(func: Callable[[T], list[U]], lst: list[T]) -> list[U]:
|
|
574
|
+
"""map してから flatten する。"""
|
|
575
|
+
return [item for x in lst for item in func(x)]
|
|
576
|
+
|
|
577
|
+
# 使用例
|
|
578
|
+
result = flat_map(lambda x: [x, x * 2], [1, 2, 3])
|
|
579
|
+
assert result == [1, 2, 2, 4, 3, 6]
|
|
580
|
+
```
|
|
581
|
+
|
|
582
|
+
### 5.2 リスト内包表記による flat_map
|
|
583
|
+
|
|
584
|
+
Python ではリスト内包表記で flat_map の動作を実現できます。
|
|
585
|
+
|
|
586
|
+
```python
|
|
587
|
+
from dataclasses import dataclass
|
|
588
|
+
|
|
589
|
+
@dataclass(frozen=True)
|
|
590
|
+
class Book:
|
|
591
|
+
title: str
|
|
592
|
+
authors: list[str]
|
|
593
|
+
|
|
594
|
+
books = [
|
|
595
|
+
Book("FP in Scala", ["Chiusano", "Bjarnason"]),
|
|
596
|
+
Book("The Hobbit", ["Tolkien"])
|
|
597
|
+
]
|
|
598
|
+
|
|
599
|
+
# ネストしたループで flat_map を実現
|
|
600
|
+
authors = [author for book in books for author in book.authors]
|
|
601
|
+
assert authors == ["Chiusano", "Bjarnason", "Tolkien"]
|
|
602
|
+
```
|
|
603
|
+
|
|
604
|
+
### 5.3 flat_map によるリストサイズの変化
|
|
605
|
+
|
|
606
|
+
```python
|
|
607
|
+
# 要素数が増える
|
|
608
|
+
result1 = [x for n in [1, 2, 3] for x in [n, n + 10]]
|
|
609
|
+
assert result1 == [1, 11, 2, 12, 3, 13] # 6要素
|
|
610
|
+
|
|
611
|
+
# 要素数が同じ
|
|
612
|
+
result2 = [n * 2 for n in [1, 2, 3]]
|
|
613
|
+
assert result2 == [2, 4, 6] # 3要素
|
|
614
|
+
|
|
615
|
+
# 要素数が減る(フィルタリング効果)
|
|
616
|
+
result3 = [n for n in [1, 2, 3] if n % 2 == 0]
|
|
617
|
+
assert result3 == [2] # 1要素
|
|
618
|
+
```
|
|
619
|
+
|
|
620
|
+
```plantuml
|
|
621
|
+
@startuml
|
|
622
|
+
!theme plain
|
|
623
|
+
|
|
624
|
+
rectangle "リスト内包表記とサイズの変化" {
|
|
625
|
+
rectangle "増加" as inc {
|
|
626
|
+
card "[1, 2, 3]" as i1
|
|
627
|
+
card "[x for n in nums for x in [n, n+10]]" as f1
|
|
628
|
+
card "[1, 11, 2, 12, 3, 13]" as r1
|
|
629
|
+
i1 --> f1
|
|
630
|
+
f1 --> r1
|
|
631
|
+
}
|
|
632
|
+
|
|
633
|
+
rectangle "減少(フィルタ)" as dec {
|
|
634
|
+
card "[1, 2, 3]" as i2
|
|
635
|
+
card "[n for n in nums if n % 2 == 0]" as f2
|
|
636
|
+
card "[2]" as r2
|
|
637
|
+
i2 --> f2
|
|
638
|
+
f2 --> r2
|
|
639
|
+
}
|
|
640
|
+
}
|
|
641
|
+
|
|
642
|
+
@enduml
|
|
643
|
+
```
|
|
644
|
+
|
|
645
|
+
### 5.4 ネストしたリスト内包表記
|
|
646
|
+
|
|
647
|
+
複数のリストを組み合わせる場合、ネストしたリスト内包表記を使います。
|
|
648
|
+
|
|
649
|
+
```python
|
|
650
|
+
@dataclass(frozen=True)
|
|
651
|
+
class Movie:
|
|
652
|
+
title: str
|
|
653
|
+
|
|
654
|
+
def book_adaptations(author: str) -> list[Movie]:
|
|
655
|
+
if author == "Tolkien":
|
|
656
|
+
return [Movie("An Unexpected Journey"), Movie("The Desolation of Smaug")]
|
|
657
|
+
return []
|
|
658
|
+
|
|
659
|
+
books = [
|
|
660
|
+
Book("FP in Scala", ["Chiusano", "Bjarnason"]),
|
|
661
|
+
Book("The Hobbit", ["Tolkien"])
|
|
662
|
+
]
|
|
663
|
+
|
|
664
|
+
# ネストしたリスト内包表記
|
|
665
|
+
recommendations = [
|
|
666
|
+
f"You may like {movie.title}, because you liked {author}'s {book.title}"
|
|
667
|
+
for book in books
|
|
668
|
+
for author in book.authors
|
|
669
|
+
for movie in book_adaptations(author)
|
|
670
|
+
]
|
|
671
|
+
|
|
672
|
+
# 結果:
|
|
673
|
+
# [
|
|
674
|
+
# "You may like An Unexpected Journey, because you liked Tolkien's The Hobbit",
|
|
675
|
+
# "You may like The Desolation of Smaug, because you liked Tolkien's The Hobbit"
|
|
676
|
+
# ]
|
|
677
|
+
```
|
|
678
|
+
|
|
679
|
+
```plantuml
|
|
680
|
+
@startuml
|
|
681
|
+
!theme plain
|
|
682
|
+
|
|
683
|
+
rectangle "ネストしたリスト内包表記のフロー" {
|
|
684
|
+
card "books" as books
|
|
685
|
+
card "book.authors" as authors
|
|
686
|
+
card "book_adaptations(author)" as movies
|
|
687
|
+
card "recommendation string" as result
|
|
688
|
+
|
|
689
|
+
books --> authors : for book
|
|
690
|
+
authors --> movies : for author
|
|
691
|
+
movies --> result : for movie
|
|
692
|
+
}
|
|
693
|
+
|
|
694
|
+
note bottom
|
|
695
|
+
ネストした for は
|
|
696
|
+
外側から内側へ評価される
|
|
697
|
+
end note
|
|
698
|
+
|
|
699
|
+
@enduml
|
|
700
|
+
```
|
|
701
|
+
|
|
702
|
+
### 5.5 2D/3D ポイントの生成
|
|
703
|
+
|
|
704
|
+
**ソースファイル**: `app/python/src/grokking_fp/ch05_flatmap.py`
|
|
705
|
+
|
|
706
|
+
```python
|
|
707
|
+
@dataclass(frozen=True)
|
|
708
|
+
class Point:
|
|
709
|
+
x: int
|
|
710
|
+
y: int
|
|
711
|
+
|
|
712
|
+
@dataclass(frozen=True)
|
|
713
|
+
class Point3d:
|
|
714
|
+
x: int
|
|
715
|
+
y: int
|
|
716
|
+
z: int
|
|
717
|
+
|
|
718
|
+
def generate_points(xs: list[int], ys: list[int]) -> list[Point]:
|
|
719
|
+
return [Point(x, y) for x in xs for y in ys]
|
|
720
|
+
|
|
721
|
+
def generate_points_3d(xs: list[int], ys: list[int], zs: list[int]) -> list[Point3d]:
|
|
722
|
+
return [Point3d(x, y, z) for x in xs for y in ys for z in zs]
|
|
723
|
+
|
|
724
|
+
# 使用例
|
|
725
|
+
points = generate_points([1], [-2, 7])
|
|
726
|
+
assert points == [Point(1, -2), Point(1, 7)]
|
|
727
|
+
|
|
728
|
+
points_3d = generate_points_3d([1], [-2, 7], [3, 4])
|
|
729
|
+
assert points_3d == [
|
|
730
|
+
Point3d(1, -2, 3), Point3d(1, -2, 4),
|
|
731
|
+
Point3d(1, 7, 3), Point3d(1, 7, 4)
|
|
732
|
+
]
|
|
733
|
+
```
|
|
734
|
+
|
|
735
|
+
### 5.6 ジェネレータによる遅延評価
|
|
736
|
+
|
|
737
|
+
Python のジェネレータ式を使うと、遅延評価が可能です。
|
|
738
|
+
|
|
739
|
+
```python
|
|
740
|
+
from collections.abc import Iterator
|
|
741
|
+
|
|
742
|
+
def generate_points_lazy(xs: list[int], ys: list[int]) -> Iterator[Point]:
|
|
743
|
+
"""ジェネレータを使って遅延評価で Point を生成する。"""
|
|
744
|
+
return (Point(x, y) for x in xs for y in ys)
|
|
745
|
+
|
|
746
|
+
def infinite_sequence(start: int = 0) -> Iterator[int]:
|
|
747
|
+
"""無限シーケンスを生成する。"""
|
|
748
|
+
n = start
|
|
749
|
+
while True:
|
|
750
|
+
yield n
|
|
751
|
+
n += 1
|
|
752
|
+
|
|
753
|
+
# 無限シーケンスから最初の3つを取得
|
|
754
|
+
from itertools import islice
|
|
755
|
+
result = list(islice(infinite_sequence(5), 3))
|
|
756
|
+
assert result == [5, 6, 7]
|
|
757
|
+
```
|
|
758
|
+
|
|
759
|
+
### 5.7 itertools を使った高度な操作
|
|
760
|
+
|
|
761
|
+
```python
|
|
762
|
+
from itertools import product, chain, groupby
|
|
763
|
+
|
|
764
|
+
# デカルト積
|
|
765
|
+
pairs = list(product([1, 2], [3, 4]))
|
|
766
|
+
assert pairs == [(1, 3), (1, 4), (2, 3), (2, 4)]
|
|
767
|
+
|
|
768
|
+
# リストの連結
|
|
769
|
+
combined = list(chain.from_iterable([[1, 2], [3], [4, 5, 6]]))
|
|
770
|
+
assert combined == [1, 2, 3, 4, 5, 6]
|
|
771
|
+
|
|
772
|
+
# グループ化
|
|
773
|
+
words = ["apple", "apricot", "banana", "blueberry"]
|
|
774
|
+
sorted_words = sorted(words, key=lambda w: w[0])
|
|
775
|
+
grouped = {
|
|
776
|
+
key: list(group)
|
|
777
|
+
for key, group in groupby(sorted_words, key=lambda w: w[0])
|
|
778
|
+
}
|
|
779
|
+
assert grouped == {"a": ["apple", "apricot"], "b": ["banana", "blueberry"]}
|
|
780
|
+
```
|
|
781
|
+
|
|
782
|
+
---
|
|
783
|
+
|
|
784
|
+
## まとめ
|
|
785
|
+
|
|
786
|
+
### Part II で学んだこと
|
|
787
|
+
|
|
788
|
+
```plantuml
|
|
789
|
+
@startuml
|
|
790
|
+
!theme plain
|
|
791
|
+
|
|
792
|
+
rectangle "Part II: 関数型スタイルのプログラミング" {
|
|
793
|
+
rectangle "第3章" as ch3 {
|
|
794
|
+
card "イミュータブルデータ"
|
|
795
|
+
card "スライス / リスト結合"
|
|
796
|
+
card "NamedTuple / dataclass"
|
|
797
|
+
}
|
|
798
|
+
|
|
799
|
+
rectangle "第4章" as ch4 {
|
|
800
|
+
card "高階関数"
|
|
801
|
+
card "リスト内包表記"
|
|
802
|
+
card "関数を返す関数"
|
|
803
|
+
card "クロージャ"
|
|
804
|
+
}
|
|
805
|
+
|
|
806
|
+
rectangle "第5章" as ch5 {
|
|
807
|
+
card "flatten / flat_map"
|
|
808
|
+
card "ネストしたリスト内包表記"
|
|
809
|
+
card "ジェネレータ"
|
|
810
|
+
card "itertools"
|
|
811
|
+
}
|
|
812
|
+
}
|
|
813
|
+
|
|
814
|
+
ch3 --> ch4
|
|
815
|
+
ch4 --> ch5
|
|
816
|
+
|
|
817
|
+
@enduml
|
|
818
|
+
```
|
|
819
|
+
|
|
820
|
+
### キーポイント
|
|
821
|
+
|
|
822
|
+
| 章 | 主要概念 | Python での実現方法 |
|
|
823
|
+
|----|----------|---------------------|
|
|
824
|
+
| 第3章 | イミュータブル | `+`, スライス, `NamedTuple`, `frozenset` |
|
|
825
|
+
| 第4章 | 高階関数 | リスト内包表記, `filter()`, `reduce()`, `sorted()` |
|
|
826
|
+
| 第5章 | 平坦化 | ネストしたリスト内包表記, ジェネレータ, `itertools` |
|
|
827
|
+
|
|
828
|
+
### 重要な法則
|
|
829
|
+
|
|
830
|
+
1. **イミュータブルデータ**: 元のデータは変更せず、新しいデータを作成する
|
|
831
|
+
2. **関数は値**: 関数を引数として渡したり、戻り値として返したりできる
|
|
832
|
+
3. **リスト内包表記**: Python における flat_map の主要な表現方法
|
|
833
|
+
4. **ジェネレータ**: 遅延評価でメモリ効率の良い処理が可能
|
|
834
|
+
|
|
835
|
+
### Python 特有のポイント
|
|
836
|
+
|
|
837
|
+
- **リスト内包表記**: Scala の `for` 内包表記に相当
|
|
838
|
+
- **ジェネレータ式**: `()` で囲むと遅延評価になる
|
|
839
|
+
- **`@dataclass(frozen=True)`**: イミュータブルなデータクラスを定義
|
|
840
|
+
- **`NamedTuple`**: 軽量なイミュータブルデータ構造
|
|
841
|
+
|
|
842
|
+
### 次のステップ
|
|
843
|
+
|
|
844
|
+
Part III では、以下のトピックを学びます:
|
|
845
|
+
|
|
846
|
+
- `returns` ライブラリによる関数型プログラミング
|
|
847
|
+
- `Maybe` 型による安全なエラーハンドリング
|
|
848
|
+
- `Result` 型と複合的なエラー処理
|
|
849
|
+
|
|
850
|
+
---
|
|
851
|
+
|
|
852
|
+
## 演習問題
|
|
853
|
+
|
|
854
|
+
### 問題 1: イミュータブルな操作
|
|
855
|
+
|
|
856
|
+
以下の関数を実装してください。リストの中央に要素を挿入する関数です。
|
|
857
|
+
|
|
858
|
+
```python
|
|
859
|
+
def insert_at_middle(lst: list[str], element: str) -> list[str]:
|
|
860
|
+
...
|
|
861
|
+
|
|
862
|
+
# 期待される動作
|
|
863
|
+
assert insert_at_middle(["a", "b", "c", "d"], "X") == ["a", "b", "X", "c", "d"]
|
|
864
|
+
assert insert_at_middle(["a", "b"], "X") == ["a", "X", "b"]
|
|
865
|
+
```
|
|
866
|
+
|
|
867
|
+
<details>
|
|
868
|
+
<summary>解答</summary>
|
|
869
|
+
|
|
870
|
+
```python
|
|
871
|
+
def insert_at_middle(lst: list[str], element: str) -> list[str]:
|
|
872
|
+
middle = len(lst) // 2
|
|
873
|
+
return lst[:middle] + [element] + lst[middle:]
|
|
874
|
+
```
|
|
875
|
+
|
|
876
|
+
</details>
|
|
877
|
+
|
|
878
|
+
### 問題 2: 高階関数
|
|
879
|
+
|
|
880
|
+
以下の関数を実装してください。条件を満たす要素の数をカウントする関数です。
|
|
881
|
+
|
|
882
|
+
```python
|
|
883
|
+
from collections.abc import Callable
|
|
884
|
+
from typing import TypeVar
|
|
885
|
+
|
|
886
|
+
T = TypeVar("T")
|
|
887
|
+
|
|
888
|
+
def count_where(lst: list[T], predicate: Callable[[T], bool]) -> int:
|
|
889
|
+
...
|
|
890
|
+
|
|
891
|
+
# 期待される動作
|
|
892
|
+
assert count_where([1, 2, 3, 4, 5], lambda i: i > 3) == 2
|
|
893
|
+
assert count_where(["a", "bb", "ccc"], lambda s: len(s) > 1) == 2
|
|
894
|
+
```
|
|
895
|
+
|
|
896
|
+
<details>
|
|
897
|
+
<summary>解答</summary>
|
|
898
|
+
|
|
899
|
+
```python
|
|
900
|
+
def count_where(lst: list[T], predicate: Callable[[T], bool]) -> int:
|
|
901
|
+
return len([x for x in lst if predicate(x)])
|
|
902
|
+
|
|
903
|
+
# または reduce を使って
|
|
904
|
+
from functools import reduce
|
|
905
|
+
|
|
906
|
+
def count_where2(lst: list[T], predicate: Callable[[T], bool]) -> int:
|
|
907
|
+
return reduce(lambda acc, x: acc + 1 if predicate(x) else acc, lst, 0)
|
|
908
|
+
```
|
|
909
|
+
|
|
910
|
+
</details>
|
|
911
|
+
|
|
912
|
+
### 問題 3: ネストしたリスト内包表記
|
|
913
|
+
|
|
914
|
+
以下のネストした処理をリスト内包表記で書いてください。
|
|
915
|
+
|
|
916
|
+
```python
|
|
917
|
+
result = []
|
|
918
|
+
for x in [1, 2]:
|
|
919
|
+
for y in [10, 20]:
|
|
920
|
+
for z in [100, 200]:
|
|
921
|
+
result.append(x + y + z)
|
|
922
|
+
```
|
|
923
|
+
|
|
924
|
+
<details>
|
|
925
|
+
<summary>解答</summary>
|
|
926
|
+
|
|
927
|
+
```python
|
|
928
|
+
result = [x + y + z for x in [1, 2] for y in [10, 20] for z in [100, 200]]
|
|
929
|
+
|
|
930
|
+
# 結果: [111, 211, 121, 221, 112, 212, 122, 222]
|
|
931
|
+
```
|
|
932
|
+
|
|
933
|
+
</details>
|
|
934
|
+
|
|
935
|
+
### 問題 4: リスト内包表記によるフィルタリング
|
|
936
|
+
|
|
937
|
+
`if` 条件を使わずに、リスト内包表記だけで偶数のみを抽出するコードを書いてください(flat_map パターン)。
|
|
938
|
+
|
|
939
|
+
```python
|
|
940
|
+
numbers = [1, 2, 3, 4, 5, 6]
|
|
941
|
+
# 偶数のみを抽出: [2, 4, 6]
|
|
942
|
+
```
|
|
943
|
+
|
|
944
|
+
<details>
|
|
945
|
+
<summary>解答</summary>
|
|
946
|
+
|
|
947
|
+
```python
|
|
948
|
+
# flat_map パターン: 空リストを返すことでフィルタリング
|
|
949
|
+
even_numbers = [x for n in numbers for x in ([n] if n % 2 == 0 else [])]
|
|
950
|
+
|
|
951
|
+
# または関数に分離
|
|
952
|
+
def even_filter(n: int) -> list[int]:
|
|
953
|
+
return [n] if n % 2 == 0 else []
|
|
954
|
+
|
|
955
|
+
even_numbers2 = [x for n in numbers for x in even_filter(n)]
|
|
956
|
+
```
|
|
957
|
+
|
|
958
|
+
</details>
|