第6回:自作ライブラリの公開とJavaScriptライブラリの今後 (1/2)

まるごとJavaScript&Ajax!
JSライブラリ・ラボ - これで君もライブラリ開発者だ!

第6回:自作ライブラリの公開とJavaScriptライブラリの今後
著者:川崎 有亮   2007/4/11
1   2  次のページ
自作ライブラリをJSANで公開!

   JSAN(JavaScript Archive Network、図7)は、2005年7月にオープンしたJavaScriptライブラリの共有・公開サイトです。ユーザー登録すれば、誰でも無料で自作JavaScriptライブラリをアップロード・公開することができます。
JSAN
図7:JSAN


   JSANはもともとPerlエンジニアを中心として、Perlモジュールの共有・公開サイトであるCPAN(Comprehensive Perl Archive Network)を参考に構築されました。JSANではJavaScriptソースコード本体に加えて、表6のようなファイルを添付した.tar.gz形式アーカイブとしてライブラリを配布します。

ファイル名内容
JSAN-0.10/lib/JSAN.jsJavaScriptライブラリ本体
JSAN-0.10/Changes更新履歴
JSAN-0.10/MANIFESTアーカイブに含まれるファイル一覧
JSAN-0.10/META.yml管理用メタファイル(YAML形式)
JSAN-0.10/READMEお読み下さい
JSAN-0.10/doc/html/JSAN.htmlドキュメント
JSAN-0.10/tests/index.htmlテスト用Webページ
JSAN-0.10/tests/lib/Test/Builder.jsテスト用JavaScriptライブラリ(JSANで公開されているもの)
JSAN-0.10/tests/lib/Test/Harness.js
JSAN-0.10/tests/lib/Test/Harness/Browser.js
JSAN-0.10/tests/lib/Test/Harness/Director.js
JSAN-0.10/tests/lib/Test/More.js
JSAN-0.10/tests/lib/Test/Simple.js

表6:JSAN配布用パッケージの構成ファイル例

   JavaScriptソースファイル本体は、アーカイブのlibディレクトリ内に配置します。ライブラリの正式名称やバージョン番号、作者連絡先などはリスト11のようなメタファイルに記述します。このMETA.ymlはYAML形式のテキストファイルで、ライセンスや他ライブラリの依存関係なども記載できます。

リスト11:META.ymlファイルの例
---
name: JSAN
version: 0.10
author:
   - Casey West <casey@geeknest.com>
abstract: JavaScript Archive Network
license: artistic
build_requires:
   Test.Simple: 0.11
provides:
   JSAN:
      file: lib/JSAN.js
      version: 0.10
generated_by: Module::Build version 0.2701
keywords:
   - jsan
   - use
   - import
   - libraries

   JSANでは、テスト用のJavaScriptライブラリが提供されている点も大きな特徴です。少々使い方にクセがありますが、自作ライブラリを公開する前にテストできるのはライブラリ作者としても不具合や副作用の心配がなく、ライブラリ利用者にとっても安心でしょう。

   また現在のJSAN仕様では、ライブラリ使用方法などのドキュメントをJavaScriptソースファイル中にPOD形式(Perlモジュールのドキュメント記述書式)で記述するのが標準です。ただし、実際にはPODを利用していないライブラリも多いですし、形式にはこだわらずにHTMLなど記述しやすいフォーマットで分かりやすいドキュメントファイルが添付されていれば良いのではないでしょうか。


ユーザー登録とライブラリのアップロード

   自作したJavaScriptライブラリをJSANで公開するには、ユーザー登録が必要です。JSANのサイト上の表記は英語のみで日本語メニューなどは用意されていませんが、手順は簡単ですからぜひトライしてみてください。まずは、トップページ左側の「Contribute」のリンクをクリックし、「Register」からユーザー登録を行います。

   JAUSE ID欄には、自分につけるユーザー名を入力します。筆者は「kawasaki」というIDを利用しています(注11)。


   Password・Verify Password欄は、認証用パスワードを入力します。

   Name欄は名前を入力します。ローマ字で記述した方が無難です。加えてEmail Address欄、Website URL欄を入力したら、「Create」ボタンを押すだけでユーザー登録が完了します。

   「Login」メニューから登録したJAUSE IDおよびパスワードを入力してログインしてください。

   最後に「Upload」メニューでJavaScriptライブラリの.tar.gz形式の配布アーカイブをアップロードすれば、ライブラリがJSAN上で公開されます。

   なお、執筆時点のJSANでは、ユーザー登録やアップロード関係の画面でSSL証明書の警告が表示されます。少々不安感はありますが、気にせずそのまま進めてください。

   また、JSANのシステム自体にバグがあるのか、アップロードライブラリが即時には公開されずにサーバー内部で留まってしまう事例も多数報告されています。数日待っても公開されない場合は、メーリングリストで問い合わせてみるのが良いでしょう。

1   2  次のページ

川崎 有亮
著者プロフィール
川崎 有亮
1977年東京生まれ。AjaxなどWeb技術のアーキテクト。株式会社かっぺを経て、現在は株式会社リクルート事業開発室に所属。技術評論社「Ajax/実装のための基礎テクニック」(共著)など書籍・雑誌記事の執筆も多数。

Kawa.net xp:http://www.kawa.net/


INDEX
第6回:自作ライブラリの公開とJavaScriptライブラリの今後
自作ライブラリをJSANで公開!
 Kawa.net XPで公開されるJavaScriptライブラリの裏側
JSライブラリ・ラボ - これで君もライブラリ開発者だ!
第1回Prototypeライブラリの内部
第2回jQueryライブラリの内部とonloadイベント記法
第3回YUIライブラリと外部JSの呼び出し手法
第4回JavaScriptライブラリの作成
第5回グローバル変数の制御と更新履歴ファイル
第6回自作ライブラリの公開とJavaScriptライブラリの今後

人気記事トップ10

人気記事ランキングをもっと見る

企画広告も役立つ情報バッチリ! Sponsored

サーバやOSの保守期限、VMware環境の見直しといった節目に考える、Oracle AI Databaseの次期基盤。オンプレ継続・AWS・OCIそれぞれの特性と留意点を整理するWebセミナー 11月19日 16:00 AIエージェントの“見えないリスク”に備えてアイデンティティを「関係」で統制する 11月17日 6:25 AI生成コードをどう安全に使うか――決定論的検証とAutoFixで築く品質保証ワークフロー 11月16日 6:30 デジタル主権時代、データとモデルの持ち方は企業が主体的に定める 11月13日 6:25 ClickHouse Cloudが実現した広告運用SaaS「ATOM」のデータ基盤革新、パフォーマンスを向上しながら、運用負荷とコストを削減 11月11日 6:20 AIで開発が加速する時代、品質保証はどう変わる? Tricentisが示すAIエージェント活用の実像 11月9日 6:45 悪用までの猶予が「1分」に迫るフロンティアAI時代に開発と本番を貫く脆弱性管理が必要 10月29日 8:30 欧州CRA対応とSBOM運用。AI生成コードのOSS混入問題の対策とは ――スニペット単位で検出する「FossID」「Insignary Clarity」によるSBOM運用 9月16日 6:40 PostgreSQLからTiDBへ、稼働中SaaSで進める段階的DB移行の実践と再設計への展望 9月7日 6:30 機能安全開発におけるGoogleTestの活用を支援!「Parasoft C/C++test CT」で実現する効率化&AI連携 4月14日 6:30