Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Narazaka/shiorijk
SHIORI/3.x Parser/Container
https://github.com/Narazaka/shiorijk
shiori ukagaka
Last synced: 28 days ago
JSON representation
SHIORI/3.x Parser/Container
- Host: GitHub
- URL: https://github.com/Narazaka/shiorijk
- Owner: Narazaka
- License: zlib
- Created: 2014-04-18T17:30:46.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-05-02T13:06:46.000Z (over 3 years ago)
- Last Synced: 2023-10-20T08:42:07.000Z (about 1 year ago)
- Topics: shiori, ukagaka
- Language: TypeScript
- Homepage:
- Size: 830 KB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.ja.md
- License: LICENSE
Awesome Lists containing this project
README
# ShioriJK - SHIORI/3.x パーサ/コンテナ
[](https://www.npmjs.com/package/shiorijk)
[](https://www.npmjs.com/package/shiorijk)
[](https://www.npmjs.com/package/shiorijk)
[](https://www.npmjs.com/package/shiorijk)
[](https://github.com/Narazaka/shiorijk)
[](https://github.com/Narazaka/shiorijk)
[](https://david-dm.org/Narazaka/shiorijk)
[](https://david-dm.org/Narazaka/shiorijk?type=dev)
[](https://travis-ci.org/Narazaka/shiorijk)
[](https://ci.appveyor.com/project/Narazaka/shiorijk)
[](https://codecov.io/github/Narazaka/shiorijk?branch=master)
[](https://www.codacy.com/app/narazaka/shiorijk?utm_source=github.com&utm_medium=referral&utm_content=Narazaka/shiorijk&utm_campaign=Badge_Grade)
**つまるところ、栞は JK である**
## インストール
npm install shiorijk
or
bower install shiorijk
## ShioriJK とは何か?
伺かの SHIORI サブシステム構築のための SHIORI プロトコルパーサとコンテナの JavaScript(TypeScript)による実装です。
JavaScript で栞を組みたくなった場合にお使いください。
## ShioriJK とは何でないか?
ShioriJK は SHIORI プロトコルパーサとコンテナのみを実装しているライブラリであり、これ単体で栞とすることは出来ません。
## 利用方法概要
SHIORI リクエスト/レスポンスあるいはその断片を渡すとてきとうに解釈してコンテナに入れて返します。
またコンテナからリクエスト/レスポンス文字列を生成することも出来ます。
現在のところ SHIORI/3.x のみを扱えます。（SHIORI/2.x にも対応していますが、同一ヘッダが複数存在する一部リクエストを正しくパースできません。）
[example/example.ts](example/example.ts)
```typescript
import * as ShioriJK from "shiorijk";
// const ShioriJK = require("shiorijk"); // also OK
// ---------- リクエストのパース ----------
// 1つのトランザクションをパース
const requestParser = new ShioriJK.Shiori.Request.Parser();
const requestStr =
"GET SHIORI/3.0\r\n" +
"Charset: UTF-8\r\n" +
"Sender: embryo\r\n" +
"ID: OnBIFFComplete\r\n" +
"Reference0: 2\r\n" +
"Reference1: 1024\r\n" +
"Reference2: mail.example.com\r\n" +
"Reference3: 1\r\n" +
"Reference4: Subject: foo\x01X-Mailer: sendmail\x02Subject: bar\x01X-Mailer: Sylpheed\r\n" +
"Reference5: 512\x01512\r\n" +
"Reference6: [email protected]\[email protected]\r\n" +
"\r\n";
const request = requestParser.parse(requestStr);
console.log(request.request_line.method === "GET"); // リクエスト行の情報
console.log(request.headers.get("ID") === "OnBIFFComplete"); // ヘッダ値を取得
console.log(request.headers.ID === "OnBIFFComplete"); // よく使うヘッダへのショートカット
console.log(request.headers.Reference(1) === "1024"); // Reference*へのショートカット
console.log(request.headers.references().length === 7); // 全てのReference*の値を取得
console.log((request.headers.get_separated("Reference6") || [])[0] === "[email protected]"); // \x01で区切られた値の取得
console.log((request.headers.get_separated2("Reference4") || [])[1][0] === "Subject: bar"); // \x01と\x02で区切られた値の取得
// チャンクを元にパース(HTTPのように)
let parseResult;
parseResult = requestParser.parse_chunk("GET SHIORI/3.0\r\nCharset: UTF-8\r\n");
console.log(parseResult.state === "continue");
parseResult = requestParser.parse_chunk("ID: version\r\n\r\n");
console.log(parseResult.state === "end");
console.log(parseResult.results.length === 1);
console.log(parseResult.results[0].headers.ID === "version");
// 行ごとにパース
parseResult = requestParser.parse_lines(["GET SHIORI/3.0", "Charset: UTF-8"]);
console.log(parseResult.state === "continue");
parseResult = requestParser.parse_lines(["ID: version", ""]);
console.log(parseResult.state === "end");
console.log(parseResult.results[0].headers.ID === "version");
// ---------- レスポンスのパース ----------
const responseParser = new ShioriJK.Shiori.Response.Parser();
const responseStr = "SHIORI/3.0 200 OK\r\n" + "Sender: ikaga\r\n" + "Charset: UTF-8\r\n" + "Value: 8.2.8\r\n" + "\r\n";
const response = responseParser.parse(responseStr);
console.log(response.headers.Value === "8.2.8");
// チャンクや行を元にしたパースも対応
// ---------- リクエストのビルド ----------
const request2 = new ShioriJK.Message.Request({
request_line: { method: "GET", version: "3.0" },
headers: {
Charset: "UTF-8",
Sender: "embryo",
},
});
// 初期化後にも値をセット
request2.headers.set("ID", "version");
console.log(request2.toString() === "GET SHIORI/3.0\r\nCharset: UTF-8\r\nSender: embryo\r\nID: version\r\n\r\n");
// ---------- レスポンスのビルド ----------
const response2 = new ShioriJK.Message.Response({
status_line: { code: 200, version: "3.0" },
headers: {
Charset: "UTF-8",
Sender: "ikaga",
Value: "8.2.8",
},
});
console.log(response2.toString() === "SHIORI/3.0 200 OK\r\nCharset: UTF-8\r\nSender: ikaga\r\nValue: 8.2.8\r\n\r\n");
```
さらに見る: このライブラリを使用した栞の実装である[SanaJK](https://github.com/Narazaka/sanajk)や、ベースウェアの実装である[イカガカ](https://github.com/Ikagaka/Ikagaka.demo)をご参照ください。
## API ドキュメント
[http://narazaka.github.io/shiorijk/](http://narazaka.github.io/shiorijk/)か、[lib/](lib)にあるコメント付きのソースをご覧ください。
ドキュメントがルーズだと感じたら、ライブラリや[テストコード](test)の中身を読んでいただいたほうがわかりやすいかもしれません。
## 履歴
### v1.0.0
- CoffeeScript -> TypeScript
- 基本的な JavaScript API に変化はありません。
- null 結合型は次のように変更されました : `Foo | null | undefined` -> `Foo | undefined`
- いくつかの API に存在した文字列 throw は Error を継承したクラスを throw するように変更されました。
- ES5 以上を要求します（つまり IE8 以下で動作させるには shim が必要です）。
## ライセンス
[Zlib ライセンス](LICENSE)の元で配布いたします。