弊社のはてなブログ移行を記念に、python3で記事本文と画像の投稿スクリプトを書いてみました
記事目安...10分
投稿スクリプトについて
投稿スクリプトは、2つのpythonスクリプトで構成されます。
要点をざっくり解説します。
Post_hatena.py
はてなブログに、記事本文と画像をアップロードする処理を定義したモジュールです。
大きく以下2クラスで構成されます。
"PostHatena"クラス
はてなブログに、マークダウン形式で記述された記事をアップロードします。
認証はBasic認証を使用します。
"PostHatenaPhoto"クラス
はてなフォトライフに、PNG形式の画像ファイルをアップロードします。
認証にはWSSE認証を使用します(*1)。
*1. Oauth認証を使いたかったのですが、どうしてもCLIで完結できなかったため、WSSE認証を使用しています。
execution.py
"Post_hatena"モジュールを読み込み、実際にアップロード処理を行うpythonスクリプトです。
実行時は、第2引数にアップロードしたい記事と画像ファイルが格納された "フォルダパス" を指定します。(*2)
$ python3 execution.py <フォルダパス>
*2. スクリプトの仕様上、指定したフォルダ構成は以下である必要があります。
$ cd ~/blog_folder $ tree . ├── assets │ ├── aaa.png │ ├── bbb.png │ └── ... └── xxx.md
スクリプトは、大きく以下3つの関数から構成されます。
main()
他の関数を呼び出すメイン関数です。
upload_text()
はてなブログに記事本文をアップロードする関数です。
"post_hatena"モジュールから"PostHatena"クラスをインポートしています。
upload_images()
はてなフォトライフに画像ファイルをアップロードする関数です。
"post_hatena"モジュールから"PostHatenaPhoto"クラスをインポートしています。
使い方デモ
使い方をデモ形式でお伝えします。
Python3が実行できる環境で行ってください。(*1)
*1. 以下環境で実行できました。
| Key | Value |
|---|---|
| EC2 | AmazonLinux2 |
| Python | 3.7.8 |
事前準備
以下モジュールをインストールしてください。
$ sudo pip3 install bs4 $ sudo pip3 install lxml $ sudo pip3 install requests
以下の値(*2)を環境変数に登録します。
| Key | Value |
|---|---|
| HATENA_ID | 自分のはてなID |
| BLOG_ID | 対象ブログのブログID |
| API_KEY | 対象ブログのAPIキー |
*2. 各値については、"各ブログダッシュボード" の "設定" にて "詳細設定" タブを選択後、"AtomPub" にて確認できます。
毎回読み込まれるよう、".bash_profile" に追記してください。
$ vi ~/.bash_profile --- export HATENA_ID='<自分のはてなID>' (以下略) --- $ source ~/.bash_profile
フォルダを作成して、投稿スクリプトを実行環境に保存しましょう。
$ mkdir ~/hatena_src $ cd ~/hatena_src $ tree . ├── execution.py └──post_hatena.py
これで準備は完了です。
はてなブログへのアップロード
では、アップロードを行います。
今回はデモ用に用意したファイルをアップロードしましょう。
アップロード対象は以下です。
- 記事本文
- 画像ファイル
これらを以下フォルダ構成で保存してください。
$ mkdir ~/hatena_demo $ cd ~/hatena_demo $ tree . ├── assets │ ├── test-image-green.png │ └── test-image-red.PNG └── test.md
ここのフォルダ構成が崩れると正しくアップロードできないので注意してください。
pythonスクリプトを実行します。
実行後は、プロンプトに従ってファイルをアップロードしてください。
$ cd ~/hatena_src $ python3 execution.py ~/hatena_demo
〇凡例
$ python3 execution.py ~/hatena_demo ---Upload the following file--- /home/ec2-user/blog/TF/automating-hatena-blog/hatena_demo/test.md If everything is OK, enter "yes" or "y". If you don't like it, enter "no" or "n". y ----- Success! URL: "アップロード先のURL" ----- Want to uploading images? If you want, enter "yes" or "y". If you don't want it, enter "no" or "n". y ---Upload the following file--- /home/ec2-user/hatena_demo/assets/test-image-green.png /home/ec2-user/hatena_demo/assets/test-image-red.PNG If everything is OK, enter "yes" or "y". If you don't like it, enter "no" or "n". y ----- Success! URL: "アップロード先のURL" ----- ----- Success! URL: "アップロード先のURL" ----- All Done. Good bye!
確認
アップロード先のはてなブログにアクセスして、"下書き" 一覧を確認してください。
"test.md" という記事が見えるはずです。
続いてはてなフォトライフにアクセスして、画像ファイルのアップロードを確認しましょう。
はてなフォトライフへは、以下のURLでアクセスいただけます。
https://f.hatena.ne.jp/"Your_Hatena_ID"
"hatena_demo"フォルダが出来ているので、開いてください。
中身が以下になっていれば、アップロード成功です!
後片付け
投稿した記事/画像の削除
今回アップロードした記事/画像を削除しましょう。
やり方がわからない方は、以下参考にしていただけると幸いです。
ローカル環境の後片付け
作成したフォルダを削除しましょう。
$ rm -r ~/hatena_demo $ rm -r ~/hatena_src
".bash_profile" に記述した部分も消しましょう。
$ vi .bash_profile
今回入れたモジュールも必要なければアンインストールしてください。
$ sudo pip3 uninstall bs4 $ sudo pip3 uninstall lxml $ sudo pip3 uninstall requests
まとめ
最低限の機能しか実装できていないので、暇なときに改修したいと思います。
菅谷 歩 (記事一覧)
