elm embed下载 - elm embed源码下载

elm embed

其他类别

0.1.0

下载

该工具正处于早期开发阶段
重大变更和错误是预料之中的

榆树嵌入

读取、解析环境变量和文件内容并将其嵌入到您的 Elm 代码中。

核心理念

数据通过嵌入器嵌入。嵌入器位于一个特殊文件夹elm-embed-scripts中，它们是带有Embed.Task签名的任何 Elm 声明。使用嵌入器与使用 JSON 解码器类似，例如，您可以使用Embed.File.read读取文件，并使用Embed.andThen解析它。如果解析成功，您可以使用Embed.succeed嵌入该值，如果解析失败，您可以使用Embed.fail报告原因。如果所有嵌入器都成功，则将生成结果值并将其作为 Elm 代码放置在src/generated中，供代码库的其余部分使用。

示例

环境变量

开发时，您可能希望使用本地服务器而不是生产服务器。为了实现这一点，可以嵌入一个环境变量，其中包含要使用的服务器的 url。

elm-embed-scripts/Server.elm ：

 import Embed
import Embed.Environment

server : Embed . Task String
server =
    Embed . Environment . string " server_url "

当环境变量server_url设置为localhost:8080时运行elm-embed run将在src/Generated/Server.elm中提供以下内容：

 server : String
server =
    " localhost:8080 "

Markdown解析

您可能想从 Markdown 文档而不是 Elm 代码创建页面。正常的方法是将文档作为字符串包含在内，然后在运行时解析并呈现它。这有几个缺点。解析需要时间。手动将 Markdown 嵌入 Elm 字符串也很烦人且容易出错。最后，您必须处理解析失败的情况，并向用户提供某种错误页面。使用elm-embed您可以读取.md文件，在构建时对其进行解析，如果解析失败，您将在构建时以开发人员的身份而不是在运行时以用户的身份收到错误。

此示例使用 dillonkearns/elm-markdown 解析 Markdown 文档

 -- elm-embed-scripts/Markdown.elm
import Embed
import Embed.File
import Markdown.Block exposing ( Block (..) , HeadingLevel (..) , Inline (..) )
import Markdown.Parser

document : Embed . Task ( List Block )
document =
    Embed . andThen
        (  markdown ->
            case Markdown . Parser . parse markdown of
                Ok blocks ->
                    Embed . succeed blocks

                Err _ ->
                    Embed . fail " Parse error "
        )
        ( Embed . File . read " markdown.md " )

注意：如果您对此感兴趣，也可能值得查看 elm-pages。它可以在构建时进行降价解析和许多其他很酷的东西，包括电池。 elm-embed是一个用于特定事物的工具，而elm-pages则更像是一种框架性的交易。

API文档

elm-embed将它自己的一些模块放在elm-embed-scripts中以供嵌入器使用。您可以在此处查看这些模块的完整 API。

安装

Linux

运行下面的代码将下载 64 位 Linux 的预编译二进制文件，使其可执行并将其放置在/usr/local/bin中。这适用于大多数 Linux 发行版。

curl -L -o elm-embed.gz https://github.com/emmabastas/elm-embed/releases/download/0.1.0/elm-embed-0.1.0-linux-x64.gz
gunzip elm-embed.gz
chmod +x elm-embed
sudo mv elm-embed /usr/local/bin/

现在elm-embed应该可以从命令行调用。

使用sudo rm /usr/local/bin/elm-embed卸载