PyPIパッケージ作成＆更新自動化プラン

　必要そうな項目を網羅。

項目

• Author
  • 著者名
  • メアド
• Copyright
  • Copyright (C) {yyyy} {author_name}
  • Copyright (C) {yyyy} {author_name} <{author_email}>
• License
  • 候補一覧
  • SPDX license identifiers
    • https://www.skyarch.net/blog/?p=15940
  • GitHub
• PackageName
  • 以下文脈において使用可能な文字列であることを確認する
    • ファイルシステム: /は使わない等
    • GitHubリポジトリ名: .くらいしか記号が使えない等
    • PyPIパッケージ名: [a-zA-Z0-9]+（_が-に強制変換されてしまう等）
    • Pythonパッケージ名: [a-zA-Z0-9]+
  • PyPI API
    • https://pypi.org/pypi/{package_name}/json
      • HTTP 404 error なら未だこのパッケージ名が存在しないことを意味する
• RepoName
  • 言語ごとに異なるリポジトリになりうる（パッケージは大抵言語独自のため自然と言語別になる）
    • リポジトリ名は{package_name}.{language}のような書式にする
      • 記号は.くらいしか使えない
        • スペースは-に変換されるかも？
• 公開API名
  • package, module, class, function, ...
    • 静的チェックツールが欲しい
• version
  • SemVerに従う
  • git tag（v+SemVer）
  • __init__.py
    • __version__
  • setup.py
    • version
    • download_url
    • classifiers
      • Development Status
  • CHANGELOG.md
• メタデータ設定ファイル
  • 初回作成（必須入力）
    • package_name(repo_name)
    • description
    • version初期値(0.0.1)
  • 変更
    • package_name（PyPI上では名前変更不可）
    • repo_name
    • description
    • homepage
  • パッケージ検索
    • keywords
    • classifiers
      • Development Status
      • Environment
      • Framework
      • Intended Audience
      • License
      • Natural Language
      • Operating System
      • Programming Language
      • Topic
      • Typing
  • README.md
    • Common
      • PakageName
      • Description(summary,overview)
      • Requirement
      • Installation
      • Author
      • License
    • Origin
      • DEMO
      • Features
      • Usage
      • Note
  • LICENSE.txt
  • CHANGES.md
  • MANIFEST.in
  • .gitignore
  • これらが変更されたらそれらを埋めるべき箇所を変更する
    • いつ、どんなときやる？
      • コミット時に、対応箇所が、設定ファイル値と、異なるとき
• 秘密データ（アカウント情報）
  • GitHub, PyPI
    • ユーザ名
    • パスワード
    • AccessToken
• Gitワークフロー
  • ブランチ切替
    • https://tracpath.com/bootcamp/learning_git_git_flow.html
  • init, add, commit, push
  • tag
  • mv
  • diff
• GitHubAPI
  • https://developer.github.com/v3/repos/#create
• 翻訳
  • trans -b en:ja 'some.'

コマンド

git init

json='{"name":"'${REPO_NAME}'","description":"'${REPO_DESC}'","homepage":"'${REPO_HOME}'"}'it
#echo "$json" | curl -u "${username}:${password}" https://api.github.com/user/repos -d @-
echo "$json" | curl -H "Authorization: token ${token}" https://api.github.com/user/repos -d @-

git add -n .
git add .
git commit -m 'メッセージ'
git remote add origin ...
git push origin master

version='v0.0.1'
message='first commit'
git tag -a "$version" -m "$message"
git push origin "$version"
git tag | sort -Vr 

rm -rf build
rm -rf dist
rm -rf ${package_name}.egg-info
python setup.py sdist
python setup.py bdist_wheel

UN=ユーザ名
PW=パスワード
twine upload -u $UN -p $PW --repository-url https://upload.pypi.org/legacy/ dist/*
twine upload -u $UN -p $PW --repository-url https://test.pypi.org/legacy/ dist/*

curl https://pypi.org/pypi/${package_name}/json

trans -b en:ja 'some.'

対象環境

• 2020-01-14
• Raspbierry pi 4 Model B
• Raspbian buster 10.0 2019-09-26 ※
• bash 5.0.3(1)-release

$ uname -a
Linux raspberrypi 4.19.75-v7l+ #1270 SMP Tue Sep 24 18:51:41 BST 2019 armv7l GNU/Linux