おかげさまでSnippetsのコミッタも大分増えてきましたが、前々から「個人名でディレクトリを切ってるのがオープンソースっぽくない」という意見を頂いていて、「確かに閉鎖的で良くないなぁ」と思っていたので、今回思い切ってリポジトリのレイアウトを変更しようと思います。
具体的には、CodeReposのように、ルート直下は「as2」「as3」「mxp」といった言語ディレクトリを作り、その下にプロジェクトごとにディレクトリを切る方式に変えようと思います。例えば次のようになります。
- 今まで:/yossy/as3/src/org/libspark/utils/ForcibleLoader.as
- 新方式:/as3/ForcibleLoader/src/org/libspark/utils/ForcibleLoader.as
ついでに、UtilsプロジェクトもSnippetsに統合し、より皆さんがコミットし易い体制にしようと考えています。
特に反対意見や問題が無ければ、次の作業を来週12/7(金),12/8(土)辺りで行いたいと思っています。
作業内容:
- リポジトリのレイアウトを以下のように変更します。
- /dada/as2/ -> /as2/SoundManager/
- /dada/mxp/ -> /mxp/ColorPicker/
- /doke/as2/ -> /as2/Apollocreate/
- /fladdict/study/BookmarkletBuilder/ -> /as3/study/BookmarkletBuilder/
- /fladdict/study/isometrics/ -> /as3/study/Isometrics/
- /fladdict/study/RegExpChecker/ -> /as3/study/RegExpChecker/
- /fladdict/study/SoundStudy/ -> /as3/study/SoundStudy/
- /fladdict/as3/src/commands/ -> /as3/Commands/src/
- /fladdict/as3/src/net/ -> /as3/AVM2Loader/src/net/
- /fladdict/as3/src/ActionQueue.as -> /as3/ActionQueue/ActionQueue.as
- /fladdict/as3/src/Calculator.as -> /as3/Calculator/Calculator.as
- /gen/as2/ -> /as2/Emzah/
- /hbkr/as3/src/ -> /as3/CountDown/src/
- /ido/as2/ -> /as2/Ojos/
- /jirox/as3/ -> /as3/CrossDomainBridge/
- /kujirahand/as3/ -> /as3/CSVUtils/src/
- /kuy/as2/ -> /as2/Endflow/
- /michi/as2/ -> /as2/Seyself/
- /Mk-10/as2/ -> /as2/Cellfusion/
- /mmlemon/as3/ -> /as3/Detect/
- /munegon/as3/src/com/voidelement/display/RepeatButton.as -> /as3/RepeatButton/src/com/voidelement/display/RepeatButton.as
- /munegon/as3/src/com/voidelement/images/psd/ -> /as3/PSDParser/src/com/voidelement/images/psd/
- /munegon/as3/src/com/voidelement/images/BMPDecoder.as -> /as3/BMPDecoder/src/com/voidelement/images/BMPDecoder.as
- /munegon/as3/src/com/voidelement/manager/DepthManager.as -> /as3/DepthManager/src/com/voidelement/manager/DepthManager.as
- /muta/as3/src/com/ -> /as3/ColorMatrix/src/com/
- /muta/as3/src/net/ -> /as3/Unbland/src/net/
- /nitoyon/as3/src/com/nitoyon/binding/ -> /as3/TwoWayBinding/src/com/nitoyon/binding/
- /nitoyon/as3/src/com/nitoyon/potras/ -> /as3/PotrAs/src/com/nitoyon/potras/
- /nitoyon/as3/samples/potras/ -> /as3/PotrAs/samples/
- /nium/as3/ -> /as3/Nium/
- /rch850/as3/src/org/libspark/display/SeamCarving.as -> /as3/SeamCarving/src/org/libspark/display/SeamCarving.as
- /rch850/as3/src/org/libspark/pv3d/ -> /as3/Metasequoia/src/org/libspark/prv3d/
- /yoshiweb/as2/src/ -> /as2/Yoshiweb/src/
- /yoshiweb/as2/sample/ -> /as2/Yoshiweb/samples/
- /yossy/as3/src/org/libspark/util/overload/ -> /as3/OverloadSupport/src/org/libspark/utils/overload/
- /yossy/as3/tests/org/libspark/util/overload/ -> /as3/OverloadSupport/tests/org/libspark/utils/overload/
- /yossy/as3/src/org/libspark/utils/ForcibleLoader.as -> /as3/ForcibleLoader/src/org/libspark/utils/ForcibleLoader.as
- Utilsプロジェクトから
- /as2/ -> /as2/Utils/src/
- /as3/ -> /as3/Utils/src/
- Wikiのトップページを次のように変更します。
- Snippetsプロジェクトの説明を変更します
- コミッタ-プロジェクトの順で記述していたものを、プロジェクト一覧という形でプロジェクトのみのリストにまとめます
- コミッタ-プロジェクトの順で記述していたものを、コミッタ紹介という形でコミッタのみのリストにまとめます
以上、ご意見やご要望、「俺のリポジトリはこういう風に変更してくれ」等ありましたら、コメントやメールをお願い致します。
11月 30, 2007 2:52 pm |
特に問題ございません。
こちらで作業することはなにかありますか?
11月 30, 2007 3:11 pm |
ありがとうございます。作業は特に無いですね。
12月 2, 2007 12:02 am |
いっそのこと src の中身をまとめたらどうでしょう。
as2とas3は分けて、その中のsrcをまとめてasdocで一覧できたら見やすいかと。
12月 2, 2007 12:23 am |
全部まとめてしまうとちょっとカオスになりすぎる気が。
ただ、とりあえず何も考えずに突っ込んで、皆でガンガン弄っていく寄せ鍋フォルダ的なものはあっても面白いかも。
12月 2, 2007 12:37 am |
Snippets自体 寄せ鍋みたいなものだと思いますが、今後人数がふえると確かにカオスになりますね。
12月 2, 2007 2:24 am |
ども。
src以下でまとめて各ユーザーディレクトリでわけるのもありかなぁとも思うんですが、ただSnippetsが単体として使われるものだと考えると、みんなで弄くるフォルダを別に設けるいうことで解決しますかね?
12月 2, 2007 2:59 pm |
今更すみません。
自分のやつなんですけど、これは文字コード系っていう考えで作ってたので、
/as3/Detect/
よりは、
/as3/Charset/Detect/
の方がいいかも?
と思ったのですが、いかがでしょう。
後、これを移動する際に、package指定とかこれに併せて変更した方がいいんでしょうか??
12月 2, 2007 4:04 pm |
as3 の直下にプロジェクト名大量と src, tests などが等価に並ぶのがちょっと気持ち悪いところ…。
それと、yoshiweb さんもおっしゃってますが、細かなパーツは各人のドメイン空間の下に置くより、com.libspark.snippets の下に置いたほうがよさそうかな。
カオスになりそうだけど、CPAN もそれで何とかなってるわけだし…!!!
12月 2, 2007 5:25 pm |
あ、パッケージまでかえるつもりはなくドメイン空間は残した状態でも src にまとめれるかなって思って書きました。現状のコミットされてるソースは com や jp とか、みんなパッケージ分けしてあるみたいだからクラスがぶつかることはなさそうなので。
プロジェクトごとにわけても自分の作ったプロジェクト以外は触りにくいし、大した内容でもないのにプロジェクトディレクトリを新規で作るのは気が引けるから、新規コミッタさんとかが自分のソースをコミットするのを躊躇してしまうかと。
とりあえず寄せ鍋にみんなの今使ってるソースをコミットしてもらって、カオスになりそうなくらいソースが集まったら使えるソースを集めてsparkライブラリを作るのもアリかと。
12月 3, 2007 11:43 am |
あまりまとめすぎると、今度は使う人がチェックアウトしにくくなると思うんですよね。
ディレクトリを切ってあるのは、「プロジェクトごとに分ける」とかいう堅いイメージよりかは、「使う人が使い易いように分けてある」という感じです。
CPANで言えば、「好きなモジュールを選択してインストール出来るようにしてある」というとこかな。
1ファイルに何クラスでも書けるのであれば、各自作った物は1ファイルにまとめて全部同じディレクトリに置く、とかでもいいと思うんですが、そうもいかないので…。
全コードをorg.libsparkパッケージに入れてしまう案ですが、CodeReposのようにコード公開の場にしたいと思っているのでちょっと抵抗があります。パッケージの切り方も人それぞれで難しいだろうし、クラスがコンフリクトしないように気を使う必要も出てくると思うし。
というわけで、なんとなくある程度のジャンル的なまとまりでディレクトリ作ってもらって、寄せ鍋したい人はそれ用のディレクトリを作るなり、Utilsディレクトリにガンガン突っ込んでもらうってのはどうでしょう?
Utilsは、特に1クラスで完結するようなユーティリティ系のものをまとめてみるとか。
12月 3, 2007 12:08 pm |
SnippetsからSnippetsのコードを利用したいなぁなんて思ったときには、まとまってたほうが使いやすいんじゃないかなと思います。個人的にはMetasequoiaからBMPDecoderとか使いたかったりするので。
12月 3, 2007 12:30 pm |
うーん、なるほど。そういう要望もあるかー。
多数決でも取ってみた方が良いのかしら。というか、普通に「ソース全部一カ所にまとめる」派が多そうだけど。
12月 8, 2007 4:28 am |
[…] Blog – Spark project Spark project 公式blog « [議論] Snippetsのリポジトリレイアウトを変更しようと思います […]