imi-enrichment-date ES

入力となる JSON-LD に含まれる 表記 をもつ 日付型 に対して 標準型日付 を付与するESモジュールです。

利用者向け情報

API

<script type="module">
import IMIEnrichmentDate from "https://code4sabae.github.io/imi-enrichment-date-es/IMIEnrichmentDate.mjs";
console.log(IMIEnrichmentDate("R1-1-1"));
</script>

この IMIEnrichmentDate に String あるいは JSON を渡すことで、変換結果を取得できます。

• 入力 (input) : 変換対象となる JSON または日付文字列
• 出力 : 変換結果の JSON-LD オブジェクト ※ 変換は同期で行うため Promise でないことに注意

input.json

{
  "@type": "日付型",
  "表記": "令和元年5月1日"
}

output.json

{
  "@type": "日付型",
  "表記": "令和元年5月1日",
  "標準型日付": "2019-05-01"
}

• ルート直下の 日付型 に限らず、JSON-LD に含まれるすべての 日付型 に対して作用します
• すでに 標準型日付 が付与されている 日付型 に対しては作用しません
• 表記 をパースできなかった場合には メタデータ プロパティにメッセージが記述されます

output_with_error.json

{
  "@type": "日付型",
  "表記": "X01-12-31",
  "メタデータ": {
    "@type": "文書型",
    "説明": "正規化できない日付表記です"
  }
}

開発者向け情報

環境構築

以下の手順で環境を構築します。

$ git clone https://github.com/code4sabae/imi-enrichment-date-es.git

Web API

Web API を提供するサーバプログラムが同梱されています。

サーバの起動方法

bin/server.mjs がサーバの実体です。 以下のように bin/server.mjs を実行することで起動できます。

$ bin
$ deno run -A server.mjs
Usage: deno run -A server.mjs [port number]

$ deno run -A server.mjs 8080
imi-enrichment-date-server is running on port 8080

なお、実行時にはポート番号の指定が必要です。指定しなかった場合にはエラーが表示されて終了します。 サーバを停止するには Ctrl-C を入力してください。

利用方法

WebAPI は POST された JSON または テキストを入力として JSON を返します。

$ curl -X POST -H 'Content-Type: application/json' -d '{"@type":"日付型","表記":"令和元年一月一日"}' localhost:8080
{
  "@type": "日付型",
  "表記": "令和元年一月一日",
  "標準型日付": "2019-01-01"
}

$ curl -X POST -H 'Content-Type: text/plain' -d 'R2-1-1' localhost:8080
{
  "@context": "https://imi.go.jp/ns/core/context.jsonld",
  "@type": "日付型",
  "表記": "R2-1-1",
  "標準型日付": "2020-01-01"
}

• WebAPI の URL に GET メソッドでアクセスした場合には HTML ページが表示され、WebAPI の動作を確認することができます
• POST,GET 以外のメソッドでアクセスした場合には 405 Method Not Allowed エラーが返されます
• Content-Type: application/json ヘッダが設定されている場合は、POST Body を JSON として扱い、JSON に対しての変換結果を返します
• Content-Type: application/json ヘッダが設定されているが POST Body が JSON としてパースできない場合は 400 Bad Request エラーが返されます
• Content-Type: application/json ヘッダが設定されていない場合は、POST Body を日付文字列として扱い、日付文字列を日付型に整形・正規化した結果を返します

コマンドラインインターフェイス

コマンドラインインターフェイスのファイルの実体は bin/cli.mjs です。
(一部動作しません！！)

$ cd bin

# ヘルプの表示
$ deno run cli.mjs -h

# JSON ファイルの変換
$ deno run cli.mjs input.json > output.json

# 標準入力からの変換
$ cat input.json | deno run cli.mjs > output.json

# 文字列からの変換
$ deno run cli.mjs -s R2-1-1 > output.json

テスト

以下の手順でテストを実行します

$ deno test

依存関係

なし

出典

本ライブラリは IMI 情報共有基盤 コンポーネントツール https://info.gbiz.go.jp/tools/imi_tools/ の「IMI 日付型正規化パッケージ一式」をESモジュール対応したものです。

関連記事

Deno対応ESモジュール対応、IMIコンポーネントツールx4とDenoバッジ
https://fukuno.jig.jp/2866

日本政府発のJavaScriptライブラリを勝手にweb標準化するプロジェクト、全角-半角統一コンポーネントのESモジュール/Deno対応版公開
https://fukuno.jig.jp/2865