Lycolog

シェルスクリプトでオプションパラメーターを解析するやつ
基本shiftと合わせて使う

サンプルコード

とりあえず最低限の動作サンプル的なやつ

#!/bin/bash

usage_exit () {
    echo "Usage: $0 [-p piyo] [-f] <foo> <bar>"
    exit 1
}

# オプション名の後ろに `:` をつけるとパラメーターを取れる、つけないと取れない
# オプション先頭に `:` をつけるとエラーハンドリングを自動でしなくなる
#  e.g. `getopts :p:fh`
while getopts p:fh OPT
do
    case $OPT in
            p) piyo=$OPTARG
            ;;
            f) fuga=1
            ;;
            h) usage_exit
            ;;
            \?) usage_exit
            ;;
    esac
done

# オプション分の引数をずらす
# これがないとオプションが `$1` とかに入ってくる
shift $((OPTIND - 1))

# オプションを抜いた引数を取る
foo=$1
bar=$2

echo $foo
echo $bar
echo $piyo
echo $fuga

pull_requestイベントの公式リファレンスが手薄くイベントの意味を明示してないので動きを実際に確認したものをメモ程度に。基本は意味のままだと思いますが…

opened: PRが開いたとき
reopened: PRが開き直されたとき
synchronize: PRに対してPushが走ったとき

• 公式リファレンス
  • pull_request
  • pullrequestevent

特定ブランチから特定ブランチへのPRを阻止する

• サンプルで作っただけなので中身は適当
  • pull_requestはbranchesを先頭に書かないと、指定ブランチ以外でも走るので注意

name: testing on opend PR to main
on:
  pull_request:
    branches:
      - main
    types:
      - opened
      - reopened
      - synchronize
jobs:
  # 事前ブランチチェック
  before-check:
    runs-on: ubuntu-latest
    steps:
      - name: fail case
        if: startsWith(github.head_ref, 'test/') && github.base_ref == 'main'
        # test/* ブランチから main ブランチ宛である場合
        # exit 1で終了することで Workflow を failure 扱いにする
        # https://docs.github.com/ja/actions/creating-actions/setting-exit-codes-for-actions
        run: exit 1
        # 前の if に入らなければ、そのまま次のジョブにつながる
  after-exec:
    # 指定されたジョブの成功を要求、失敗している場合、このジョブを実行しない
    # 必然的に線形実行になる（並列では走らない）
    needs: [before-check]
    runs-on: ubuntu-latest
    steps:
      - name: TEST!
        run: echo "RUN after-exec"

シェルスクリプトが設置されているパスを取得する

• cwd=$(cd $(dirname $0); pwd)
  • $0はシェルスクリプトのフルパス
  • dirnameでスラッシュから始まるファイル名を除去
  • cdで移動
  • pwdで表示

現在のパスを移動せずにシェルスクリプト内でパスを移動する

これはサブシェルを使うと出来る
サブシェルとは()で囲まれた部分で、この中では別のシェルが動いている
例えば次のスクリプトはfoo/に移動し中のファイルリストを表示するが、2行目では現在の位置にあるファイルリストを表示するため移動していない
コマンド展開記法$()もサブシェルが動いている

(cd foo/; ls -la)
ls -la

複数コマンドをワンライナーで実行する

;

• 以下のように書くと連続で線形実行される。手前が異常終了しても続く
  • curl; echo 2;

&

コマンドの末尾に&をつけるとバックグラウンドで実行される

• 以下の例では左がバックグラウンド、右がフォアグラウンドで実行される
  • echo 1 & echo 2

&&

AndAlso的な動きをする

• 以下のように書くと連続で線形実行される。手前が異常終了すると続かない
  • curl && echo 2

|

コマンドの末尾に|をつけると標準出力が次にリダイレクトされる

• 以下のように書くと連続で線形実行される。手前の標準出力が次にリダイレクトされる
  • echo 1 | xargs -I{} echo {}2

||

OrElse的な動きをする

• 以下のように書くと連続で線形実行される。手前が異常終了した場合のみ次が動く
  • curl || echo 1

HTTPを始めFTPやLDAPなど多様なプロトコルに対応したクライアント

curl [options...] <url>

Options

ヘルプが充実してるのでヘルプ見たほうが早い

• -X method
  • -X POSTとかするとそのメソッドを投げられる
  • -XPOST形式でも動く
• -s
  • 通信の進捗を表示しない
  • 通信エラーも表示しない
• -S
  • -sが指定されている時にエラーを表示する
• -L
  • location headersを読む
  • 3xx系のコードの追従する(302 redirectとか)
  • -sSLでセットにして使うことが多い
• -v
  • --verbose
  • レスポンス内容が全部出る
    • レスポンスヘッダを見る時に使える(-Iでも見れるがHEAD methodを投げてるだけなので-Xと併用できない)
    • エラー出力されるのでgrepしたい時などは標準出力にリダイレクトが必要
      • 2>&1
• -H
  • ヘッダを投げられる
  • -H 'Content-Type: application/json'
  • -H 'User-Agent:' -H 'Accept:' -H 'Host:'でcurl自身の既定ヘッダを消せる。但しHostヘッダーのないリクエストはRFC違反であるため受け付けられる保証はない
• -d
  • x-www-form-urlencodedを投げる時に使う
  • -d key=value
    • 複数あるときは複数指定する
  • 暗黙的に-X POST扱いになる
• --data-urlencode
  • -dと同じだが中身がURLエンコードされる
• -o <path>
  • ファイルを保存する
  • ダウンロード目当てならwgetのほうが使いやすい

例

JSONのPOST

curl -v -H 'Content-Type: application/json' -d '{ "hoge": "piyo" }' -- 'https://example.com'

参考

• 公式のマニュアル

確認環境

サンプルコード

• ~で正規表現を書けるので後は普通に書くだけ
  • ポイントとしては/foo/のような正規表現リテラルではなく、grepのような書き方をする

location ~ (/foo|/bar) {