オープンソース開発で見えてくる世界

オープンソース開発で見えてくる世界 2024.11.11

Call me “Nori”. Noritaka IZUMI @IzumiNoritaka(X / Twitter) def profile()
-> Dict[str, str]: return { “company”: “株式会社トラストバンク”, “product”: “LoGoフォーム”, “team”: “プロダクトチーム”, } 2

データベースマイグレーションツール「chronovoyage」 Raw SQL を記述してマイグレーション・ロールバックが実行できるツール pip 経由でインストールし、接続情報と SQL を書いてコマンドを実行するだけ chronovoyage
migrate 3

なんで、私が Snyk に。脆弱性診断ツール「Snyk」の Open Source Advisor にもデビューしました 🎉
4

Python パッケージ開発に必要なこと 5

Python パッケージ開発に必要なこと 6 コーディングドキュメント類の整備静的解析・テストパッケージのビルド・プッシュ

コーディング • パッケージをいろんな人に使ってもらうため、複数バージョンに対応する必要がある ◦ Python 3.8 以上に対応させたいなら基本的に Python 3.8
で記述 • コミットログはわかりやすく ◦ Conventional Commits に沿ったやり方 ▪ 「build(core): update version to 0.1.6」 ◦ 絵文字を記載する形式 ▪ 「🐛 verbose オプションで設定されるログレベルが間違っていたので修正」 8

静的解析・テスト • 静的解析のエラーは基本的にバグ ◦ エラーを常に検出できる環境を整備しておく • パッケージをいろんな人に使ってもらうため、複数バージョンでテストを実施 ◦ Python
3.8 以上に対応させたいなら Python 3.8 以上のバージョンすべてでテストする ◦ tox や hatch などのツールを使うと簡単にできる 10

複数バージョンでのテストは、バージョンアップ対応へのコストを下げる 11

• リポジトリ ◦ README.md：簡単な使い方と資料へのリンク等 ◦ ライセンス条項 LICENSE：二次利用や再配布に関する規定 ◦ 行動規範 CODE_OF_CONDUCT.md：オープンソースコミュニ
ティ参加者心得 ◦ 貢献マニュアル CONTRIBUTING.md：バグ報告、コミットのやり方など ◦ セキュリティポリシー (SECURITY.md)：セキュリティ対応方針 ◦ Issue テンプレート (バグ報告・機能リクエスト) ◦ Pull Request テンプレート ◦ ロードマップ：中長期戦略 ◦ スポンサーリンク (寄付をもらいたい人向け) ◦ セキュリティアドバイザリー (脆弱性の報告フォーム) ◦ 脆弱性アラート (Dependabot / Code scanning / Secret scanning) ◦ 不適切なコンテンツの報告を有効化 (GitHub の全ユーザー / Contributor から) ドキュメント類の整備 13 • Documentation ◦ チュートリアルや詳しい使い方などを記載 ◦ リポジトリ内に docs ディレクトリを用意、Wiki を利用するなど ◦ 自動デプロイ ◦ GitHub Actions でビルド -> S3 にアップロード -> Amplify で公開 • その他 ◦ SNS での共有時に表示される画像の設定 ◦ マニュアル用に独自ドメインを取得 ◦ GitHub Organization を設定し、リポジトリを移行 ◦ Organization 用ロゴを作成 ▪ brandmark.io なら組織名とスローガン、カラーテーマを指定するだけでデザイン案を出してくれる

多い 14 不特定多数のエンジニアを束ねるには、これくらいのドキュメントが必要

かいつまんで紹介 15

LICENSE 16 • ライセンス条項 • 二次利用や再配布に関する規定 ◦ 自由に使っていいよ ◦ 著作権を表示してね
◦ 作者への謝辞を載せてね ◦ 作者を宣伝するのは禁止だよ

外部ライブラリのライセンスに気を付けよう 17

CONTRIBUTING.md 18 • 貢献マニュアル • 開発を始めるための環境構築方法 • バグ報告、コミットのやり方

オンボーディング資料の一部として使える 19

SECURITY.md 20 • セキュリティポリシー • 脆弱性対応を行うバージョンの明記

セキュリティ品質を保つもの 21

Python パッケージ開発に必要なこと 22 コーディングドキュメント類の整備静的解析・テストパッケージのビルド・リリース

パッケージのビルド・プッシュ • TestPyPI/PyPI へアカウント登録 • 以下の情報を設定ファイルへ記載 ◦ パッケージ名・バージョン番号・説明・README ファイルの場所・対応
Python バージョン・ライセンス・作者・キーワード・タグ・各種 URL など • ビルドして TestPyPI へプッシュして見た目を確認 • 確認後、PyPI へプッシュ ◦ GitHub Actions 経由でプッシュすると GitHub へのリンクが認証済みとして表示される • リポジトリにタグを付与 • リリースノートを作成 23

お決まりの作業自動化して楽しよう 24

まとめ 25

オープンソースには、たくさんのドキュメント・ルールが設けられている 26

オープンソースの多くは、テストやリリースなどの定期作業を極力自動化するよう努力している 27

オープンソース開発者の大半が仕事の片手間でやっている😌 28

感謝して利用しよう🙏 29

30 おわり

オープンソース開発で見えてくる世界

オープンソース開発で見えてくる世界

Noritaka IZUMI

More Decks by Noritaka IZUMI

Featured

Transcript