PureScript Spork 项目教程

1. 项目的目录结构及介绍

PureScript Spork 项目的目录结构如下：

purescript-spork/
├── examples/
│   ├── counter/
│   └── ...
├── src/
│   └── Spork/
│       ├── App.purs
│       ├── Batch.purs
│       ├── EventQueue.purs
│       ├── Html.purs
│       ├── Html/
│       │   ├── Core.purs
│       │   ├── Elements.purs
│       │   ├── Elements/
│       │   │   └── Keyed.purs
│       │   ├── Events.purs
│       │   ├── Properties.purs
│       │   └── Thunk.purs
│       ├── Interpreter.purs
│       ├── PureApp.purs
│       ├── Scheduler.purs
│       └── Transition.purs
├── .gitignore
├── .travis.yml
├── LICENSE
├── README.md
├── bower.json
└── package.json

目录结构介绍

• examples/: 包含项目的示例代码，如 counter 示例。
• src/Spork/: 包含项目的主要源代码文件，如 App.purs、Batch.purs 等。
• .gitignore: Git 忽略文件配置。
• .travis.yml: Travis CI 配置文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• bower.json: Bower 依赖管理配置文件。
• package.json: npm 依赖管理配置文件。

2. 项目的启动文件介绍

项目的启动文件通常位于 src/Spork/App.purs。该文件定义了 Spork 应用的基本结构和初始化逻辑。

App.purs 文件介绍

module Spork.App where

import Prelude
import Spork.Html (Html)
import Spork.Batch (Batch)
import Spork.Transition (Transition)

type AppEffects eff = (dom :: DOM, exception :: EXCEPTION, ref :: REF | eff)

type App effects subs model action =
  { init :: Transition effects model action
  , render :: model -> Html action
  , subs :: model -> Batch subs action
  , update :: model -> action -> Transition effects model action
  }

• AppEffects: 定义了应用的副作用类型。
• App: 定义了应用的基本结构，包括初始化、渲染、订阅和更新逻辑。

3. 项目的配置文件介绍

bower.json

bower.json 文件用于管理项目的 Bower 依赖。

{
  "name": "purescript-spork",
  "license": "MIT",
  "repository": "natefaubion/purescript-spork",
  "dependencies": {
    "purescript-aff": "^4.0.0",
    "purescript-arrays": "^4.1.0",
    "purescript-console": "^3.0.0",
    "purescript-dom": "^4.15.0",
    "purescript-dom-indexed": "^4.0.0",
    "purescript-foldable-traversable": "^3.4.0",
    "purescript-halogen-vdom": "^2.0.0",
    "purescript-maybe": "^3.0.0",
    "purescript-prelude": "^3.1.0",
    "purescript-refs": "^3.0.0",
    "purescript-tailrec": "^3.3.0",
    "purescript-unsafe-reference": "^2.0.0"
  }
}

package.json

package.json 文件用于管理项目的 npm 依赖和脚本。

{
  "name": "purescript-spork",
  "version": "1.0.0",
  "scripts": {
    "example:all": "npm install && bower install && npm run example:all"
  },
  "dependencies": {
    "bower": "^1.8.8"
  }
}

• scripts: 定义了项目的脚本命令，如 example:all。
• dependencies: