bitshift
1.0.0
bitshift は、Benjamin Attal、Ben Kurtovic、Severyn Kozak によって開発されたソース コードのセマンティック検索エンジンです。この README は開発者のみを対象としています。プロジェクトのユーザー概要については、次を参照してください。
master
: 動作し、テストされ、バージョン番号が付けられたコード - 直接コミットはありません。リリースの準備ができた場合にのみdevelop
からのマージを受け入れる必要がありますdevelop
: 未リリースだがほとんど機能するコードを含む統合ブランチ - 直接コミットは許可されますが、マイナーである必要がありますfeature/*
: テストされておらず、ひどく壊れている可能性が高いコードを含むプロジェクトの個々のコンポーネント - 完了したら、 develop
から分岐してマージします。 bitshift はスタイル設定に SASS を使用します。 sass --watch static/sass/:static/css
を使用してスタイルシートを CSS にコンパイルします。
ドキュメントを構築するには、 docs
サブディレクトリからmake html
を実行します。その後、 docs/build/html/index.html
から参照できます。
API ドキュメント構造を自動的に更新するには (新しいモジュールまたはパッケージを追加する場合は必要ですが、関数を追加したりドキュメント文字列を変更する場合は必要ありません)、プロジェクト ルートからsphinx-apidoc -fo docs/source/api bitshift
実行します。これにより、 docs/source/api
内のファイルに加えられたカスタム変更がすべて元に戻されるため、代わりに手動で更新することをお勧めします。
bitshift/__init__.py
の__version__
、 setup.py
のversion
、 docs/conf.py
のversion
とrelease
を更新します。