これは「SATySFi Advent Caleandar 2022」の5日目の記事です。
（4日目は yozu さん、6日目は yozu さんです。）
SATySFiパッケージ1のインストールは重いことで知られています。この原因として以下の2点が考えられます。
- ソースコードで配布されているため、ダウンロード容量が大きく、またコンパイルするのに時間がかかるため。
- 上記のコンパイルを行うためにはocaml-compilerやdune等、ocamlの世界で使われているツールが多数必要となり、それらをダウンロード＆コンパイル＆インストールする必要があるため。
これを解決するためにバイナリファイル版のパッケージリポジトリを作成しました。
使用方法
opam repository add コマンドで追加します。 --rank オプションで優先度を指定することで、 satyrographos-repo-bin を優先して使うようになります。(satyrographos-repoの方はsatyrographos-repo-binにパッケージが存在しない場合のフォールバックとして機能する)
# creating local switch (optional)
opam switch create . --empty
eval $(opam env)
# Add repositories
opam repository add satysfi-external https://github.com/gfngfn/satysfi-external-repo.git
opam repository add satyrographos-repo-bin https://github.com/yasuo-ozu/satyrographos-repo-bin.git
opam repository add satyrographos-repo --rank 2 https://github.com/na4zagin3/satyrographos-repo.git
# List installable packages
opam list --all-versions --installable satysfi -o satyrographos
# install satysfi and satyrographos
opam install satysfi.0.8.0 satyrographos
注意点
- 今の所なぜだかMac版のパッケージは生成できていません。(本来はできるはず)
- satyrographos のwin64版はコンパイルに失敗しています。(ローカルで試せる環境がないのでデバッグできていない)
リポジトリの構造
以下の2つのブランチから構成されます。
main ブランチ
デフォルトブランチであり、opamコマンドから見えるファイルツリーです。後述するbuild.shによって生成され自動的にコミットされます。以下のものを含みます。
-
packagesディレクトリ ... opamが参照するパッケージデータベース -
storeディレクトリ ... バイナリを配布するためのアーカイブファイルがos, アーキテクチャ毎に分かれて入っている。 -
.github/workflowsディレクトリ ... 作成したパッケージを実際にインストールするテストが含まれる
パッケージファイについて
packageディレクトリ内のパッケージデータベースを構成するopamという名前のファイルで、例えばpackages/satysfi/satysfi.0.0.7+bin_x86_64_linux/opamは以下のようになっています。
opam-version: "2.0"
synopsis: "A statically-typed, functional typesetting system"
description:
"SATySFi is a typesetting system equipped with a statically-typed, functional programming language. It consists mainly of two “layers” ― the text layer and the program layer. The former is for writing documents in LaTeX-like syntax. The latter, which has OCaml-like syntax, is for defining functions and commands. SATySFi enables you to write documents markuped with flexible commands of your own making. In addition, its informative type error reporting will be a good help to your writing."
maintainer: "gfngfn"
authors: "gfngfn"
homepage: "https://github.com/gfngfn/SATySFi"
bug-reports: "https://github.com/gfngfn/SATySFi/issues"
depends: []
dev-repo: "git+https://github.com/gfngfn/SATySFi.git"
url {
archive: "https://github.com/yasuo-ozu/satyrographos-repo-bin/raw/main/store/archives/satysfi.0.0.7%2Bbin_x86_64_linux.tar.gz"
checksum: "eccb0693521e3330d0ebe517ff197946"
}
available: [ os = "linux" & arch = "x86_64" ]
これは、satyrographos-repoの対応するファイル
opam-version: "2.0"
maintainer: "gfngfn"
authors: [
"gfngfn"
]
homepage: "https://github.com/gfngfn/SATySFi"
dev-repo: "git+https://github.com/gfngfn/SATySFi.git"
bug-reports: "https://github.com/gfngfn/SATySFi/issues"
build: [
["mkdir" "-p" "temp"]
[make "-f" "Makefile" "PREFIX=%{prefix}%"]
]
install: [
[make "-f" "Makefile" "install" "PREFIX=%{prefix}%"]
]
remove: [
[make "-f" "Makefile" "uninstall" "PREFIX=%{prefix}%"]
]
# Packages whose version suffix is "+satysfi" are distributed on satysfi-external-repo.
depends: [
"ocaml" {>= "4.10.0"}
"batteries"
"camlimages" {>= "5.0.1"}
"camlpdf" {= "2.3.1+satysfi"}
"core_kernel" {>= "v0.13" & < "v0.15"}
"cppo" {build & >= "1.6.4" & < "1.7.0"}
"dune" {build}
"menhir"
"ocamlfind" {build}
"otfm" {= "0.3.7+satysfi"}
"ppx_deriving"
"re" {build}
"uutf"
"yojson-with-position" {= "1.4.2+satysfi"}
"omd" {< "2.0.0~"}
]
synopsis: "A statically-typed, functional typesetting system"
description: """
SATySFi is a typesetting system equipped with a statically-typed, functional programming language. It consists mainly of two “layers” ― the text layer and the program layer. The former is for writing documents in LaTeX-like syntax. The latter, which has OCaml-like syntax, is for defining functions and commands. SATySFi enables you to write documents markuped with flexible commands of your own making. In addition, its informative type error reporting will be a good help to your writing."""
url {
src: "https://github.com/gfngfn/SATySFi/archive/refs/tags/v0.0.7.tar.gz"
checksum: [
"sha512=807868e20b5b27e1e84a50d14af9e03bfd0ffdc5bac7635c58b416e369b7da56bf6f8e16df06b517a7ab586dbdac41fe32d36fe7bf0c036a7d845515425ab7ab"
]
}
から一部の項目(install, build, remove)を除き、依存関係dependsを空にし、urlを追加した形式となっています。このファイルは以下のスクリプトで生成されています2。
$OPAM show --raw --no-lint "$PKGNAME" | $SED -e '/^name:/d' -e '/^version:/d' | \
$SED -ze 's/url\s*{[^}]*}//' | $SED -ze 's/depends:\s*\[[^]]*\]/depends: []/' | \
$SED -ze 's/build:\s*\[[^]]*\(\[[^]]*\][^]]*\)*\]//' | \
$SED -ze 's/install:\s*\[[^]]*\(\[[^]]*\][^]]*\)*\]//' | \
$SED -ze 's/remove:\s*\[[^]]*\(\[[^]]*\][^]]*\)*\]//' > "$DEST_OPAM_PATH"
echo "url {" >> "$DEST_OPAM_PATH"
echo " archive: \"https://github.com/yasuo-ozu/satyrographos-repo-bin/raw/main/store/archives/${URL}.tar.gz\"" >> "$DEST_OPAM_PATH"
echo " checksum: \"$MD5SUM\"" >> "$DEST_OPAM_PATH"
echo "}" >> "$DEST_OPAM_PATH"
echo "available: [ os = \"$TARGET_OS\" & arch = \"$TARGET_ARCH\" ]" >> "$DEST_OPAM_PATH"
opamでは、インストール方法が指定されていないパッケージの場合は、 url.src に指定されたアーカイブファイルを展開してファイルを配置するという挙動を行います3。そのため、別に用意しておいたアーカイブファイルをインストールさせることができています。
develop ブランチ
本リポジトリを管理している人が主に編集するファイルです。
-
update.sh... メインのスクリプト。satyrographos-repoに含まれるsatyrographos,satysfiパッケージのうち、まだバイナリパッケージが生成されていないものを探してパッケージの生成を行う。 -
.github/workflows...update.shを実行するためのCI
まとめ
パッケージ、OS, アーキテクチャによってはまだ対応できていないものもありますが、とりあえず本リポジトリを設定しておけば、場合によってはインストールが早くなるでしょう。
不完全な部分が多いですが、ぜひコントリビューションを検討いただけると幸いです。