[議論] Snippetsのリポジトリレイアウトを変更しようと思います

by

おかげさまで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(土)辺りで行いたいと思っています。

作業内容:

  1. リポジトリのレイアウトを以下のように変更します。
    • /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/
  2. Wikiのトップページを次のように変更します。
    • Snippetsプロジェクトの説明を変更します
    • コミッタ-プロジェクトの順で記述していたものを、プロジェクト一覧という形でプロジェクトのみのリストにまとめます
    • コミッタ-プロジェクトの順で記述していたものを、コミッタ紹介という形でコミッタのみのリストにまとめます

以上、ご意見やご要望、「俺のリポジトリはこういう風に変更してくれ」等ありましたら、コメントやメールをお願い致します。

13件のフィードバック to “[議論] Snippetsのリポジトリレイアウトを変更しようと思います”

  1. dada Says:

    特に問題ございません。
    こちらで作業することはなにかありますか?

  2. beinteractive Says:

    ありがとうございます。作業は特に無いですね。

  3. yoshiweb Says:

    いっそのこと src の中身をまとめたらどうでしょう。
    as2とas3は分けて、その中のsrcをまとめてasdocで一覧できたら見やすいかと。

  4. beinteractive Says:

    全部まとめてしまうとちょっとカオスになりすぎる気が。
    ただ、とりあえず何も考えずに突っ込んで、皆でガンガン弄っていく寄せ鍋フォルダ的なものはあっても面白いかも。

  5. yoshiweb Says:

    Snippets自体 寄せ鍋みたいなものだと思いますが、今後人数がふえると確かにカオスになりますね。

  6. gen:emzah Says:

    ども。
    src以下でまとめて各ユーザーディレクトリでわけるのもありかなぁとも思うんですが、ただSnippetsが単体として使われるものだと考えると、みんなで弄くるフォルダを別に設けるいうことで解決しますかね?

  7. mmlemon Says:

    今更すみません。
    自分のやつなんですけど、これは文字コード系っていう考えで作ってたので、
    /as3/Detect/
    よりは、
    /as3/Charset/Detect/
    の方がいいかも?
    と思ったのですが、いかがでしょう。

    後、これを移動する際に、package指定とかこれに併せて変更した方がいいんでしょうか??

  8. nitoyon Says:

    as3 の直下にプロジェクト名大量と src, tests などが等価に並ぶのがちょっと気持ち悪いところ…。

    それと、yoshiweb さんもおっしゃってますが、細かなパーツは各人のドメイン空間の下に置くより、com.libspark.snippets の下に置いたほうがよさそうかな。
    カオスになりそうだけど、CPAN もそれで何とかなってるわけだし…!!!

  9. yoshiweb Says:

    あ、パッケージまでかえるつもりはなくドメイン空間は残した状態でも src にまとめれるかなって思って書きました。現状のコミットされてるソースは com や jp とか、みんなパッケージ分けしてあるみたいだからクラスがぶつかることはなさそうなので。

    プロジェクトごとにわけても自分の作ったプロジェクト以外は触りにくいし、大した内容でもないのにプロジェクトディレクトリを新規で作るのは気が引けるから、新規コミッタさんとかが自分のソースをコミットするのを躊躇してしまうかと。

    とりあえず寄せ鍋にみんなの今使ってるソースをコミットしてもらって、カオスになりそうなくらいソースが集まったら使えるソースを集めてsparkライブラリを作るのもアリかと。

  10. beinteractive Says:

    あまりまとめすぎると、今度は使う人がチェックアウトしにくくなると思うんですよね。

    ディレクトリを切ってあるのは、「プロジェクトごとに分ける」とかいう堅いイメージよりかは、「使う人が使い易いように分けてある」という感じです。

    CPANで言えば、「好きなモジュールを選択してインストール出来るようにしてある」というとこかな。

    1ファイルに何クラスでも書けるのであれば、各自作った物は1ファイルにまとめて全部同じディレクトリに置く、とかでもいいと思うんですが、そうもいかないので…。

    全コードをorg.libsparkパッケージに入れてしまう案ですが、CodeReposのようにコード公開の場にしたいと思っているのでちょっと抵抗があります。パッケージの切り方も人それぞれで難しいだろうし、クラスがコンフリクトしないように気を使う必要も出てくると思うし。

    というわけで、なんとなくある程度のジャンル的なまとまりでディレクトリ作ってもらって、寄せ鍋したい人はそれ用のディレクトリを作るなり、Utilsディレクトリにガンガン突っ込んでもらうってのはどうでしょう?

    Utilsは、特に1クラスで完結するようなユーティリティ系のものをまとめてみるとか。

  11. rch850 Says:

    SnippetsからSnippetsのコードを利用したいなぁなんて思ったときには、まとまってたほうが使いやすいんじゃないかなと思います。個人的にはMetasequoiaからBMPDecoderとか使いたかったりするので。

  12. beinteractive Says:

    うーん、なるほど。そういう要望もあるかー。

    多数決でも取ってみた方が良いのかしら。というか、普通に「ソース全部一カ所にまとめる」派が多そうだけど。

  13. Snippetsのリポジトリ変更+Utils統合完了しました « Blog - Spark project Says:

    […] Blog – Spark project Spark project 公式blog « [議論] Snippetsのリポジトリレイアウトを変更しようと思います […]

dada への返信 コメントをキャンセル