青木です。

  In mail "[ruby-reference-manual:309] Re: requireするライブラリの存在について"
  sheepman <sheepman@s...> wrote:

> こんばんは、sheepman です。

> > 例えばわたしは BitChannel で webrick/httpstatus を require したことが
> > ありますし、require 'test/unit/testcase' はググるとけっこうひっかかります。
> 
> webrick に関しては、webrick か webrick/cgi のどちらかを require すれば
> 済むと思うんですが。それに、require 'test/unit/testcase' しているのは、test/unit

そうは思いません。WEBrick で 200 でないステータスを発行するときに
webrick/httpstatus の定数が必要なんですが、それを投げるのはリクエスト
ハンドラです。BitChannel のリクエストハンドラは CGI, FastCGI, mod_ruby,
サーブレットをサポートしているので、webrick/cgi を require するのは
筋に合いません。かといって、require 'webrick' して HTTP サーバごと
ついてくるのってどうよ、と思いますし。

# webrick/webapplication てのがあったらちょうどいいんですが。

あとは net/http でも WEBrick::Cookie が使いたいなあ〜と思ってたり
するわけですが、そういうとき net/http から require 'webrick' とか
require 'webrick/cgi' するってのは、やっぱり変な気がします。


> 済むと思うんですが。それに、require 'test/unit/testcase' しているのは、test/unit
> が at_exit でテストを実行してしまうのを回避するためなんだろうと思います。

それなら、test/unit/testcase がインターフェイス「じゃないとまずい」
のではないでしょうか。test/unit でテストを実行してしまわずに TestCase
クラスを得るには test/unit/testcase を require しなければいけない
わけですよね。それで test/unit/testcase がインターフェイスではない
と言われてしまったら、回避方法がないですよね。そうすると、現実的には
作者はそっちをインターフェイスにするしかないと思います。

それで作者が使うなと言ったとしても、一つしか手段がないのなら「作者は
サポートしないって言ってるけどこれしかないんでいちおう書いときました
あとは自己責任でよろしく」と書いとくあたりが落とし所でしょう。


> で、しつこいようですが、思いついた問題点がひとつあります。
> 
> webrick と webrick/cgi はともに webrick/httprequest を require 
> しています。もし、webrick の作者が、「webrick/httprequest は公開を目的としていない」と
> 言ったとします。このとき、リファレンスにはどのように書けば良いでしょうか。
> webrick.rd と webrick/cgi.rd に「require webrick/httprequest」とは
> 書けないわけですよね。

いえ。ライブラリは分けて、require も書いて、そのうえで、そのライブラリ
のドキュメントに「このライブラリは内部用なので require するな」と書い
てください。提供元ライブラリが 1 つに決まらないとデータベースの設計上
非常に困るので、そこは多少問題があっても入れてしまいます。

そういうライブラリが (自動リンクとかで) いろんなところに露出してしまう
可能性はありますが、内部用ライブラリが自動計算でルートに出てくることは
現実的には少ないので、さほど大きな問題にはならないと考えています。また
実際にやってみて大きな問題になるようなら、ライブラリのエントリに非公開
属性を追加して対応します。

# そういえば net/protocol って……うあ、入れてなかったかー

--
青木峰郎

--
ML: ruby-reference-manual@m...
使い方: http://QuickML.com/