はじめに

競技プログラミングを始め前々から気になっていたatcoder-toolsを導入しました。革命です。より使いやすくやるようVSCodeによるショートカット作成までの備忘録です。atcoder-toolsには様々なコマンドがありますが、最低限の内容でまとめています。
また、pythonの言語仕様に合わせて多少の改造をしました。

導入〜基本的な理解

こちらの記事を参考にしました。このセクションではその際につまづいた点をまとめているので、本記事に軽く目を通した後にあちらの記事を見ていただけるとわかりやすいかと思います。

インストールについて

公式のREADMEにもありますが、atcoder-toolsはpython3系で動作するためpip3(python3系用のpip)によるインストールが望ましいです。

$ pip3 install atcoder-tools

使用する際の流れについて

atcoder-toolsは以下の流れで使用します。意識しておくと理解しやすいはずです。

コンテストのディレクトリを作成する
解く問題のフォルダに移動する
コードテストや提出を行う
次の問題へ進む(2に戻る)

設定ファイル`.atcodertools.toml`について

~/.atcodertools.toml(=Macなら /Users/username/.atcodertools.toml)を作成します。最初から存在してるわけではありません。

より使いやすくする

私的感覚でより使いやすするために行ったことを残します。

atcoder-tools genのオプション省略

先ほどの記事と内容が被りますが、~/.atcodertools.tomlを編集し、デフォルトのオプションを変更しました。

.atcodertools.toml

[codestyle]
workspace_dir = '~/Your/atcoder/dir/'
lang = 'python'

これで以下のコマンドでディレクトリを作成できます。

$ atcoder-tools gen abc000

templateを自作

今まで使っていた自作のテンプレートと、atcoder-toolsのテンプレートを合わせました。テンプレートの詳しい仕様はREADMEを読むとわかりやすいです。

~/Your/atcoder/dir/template.pyを作成しました。

template.py

#!/usr/bin/env python3
{% if prediction_success %}
from sys import stdin
{% else %}
Integer = lambda:int(input())
Ints = lambda :map(int,input().split())
IntsList=lambda :list(map(int,input().split()))
String = lambda :input()
Strings = lambda :input().split()
StringsList = lambda : list(input().split())
{% endif %}
{% if yes_str %}
yes = lambda : print("{{ yes_str }}")
{% endif %}
{% if no_str %}
no = lambda : print("{{ no_str }}")
{% endif %}
{% if yes_str and no_str %}
yesno = lambda ans:print("{{ yes_str }}" if ans else "{{ no_str }}")
{% endif %}
{% if mod %}
MOD = {{ mod }}  # type: int
{% endif %}
from sys import setrecursionlimit
from collections import defaultdict
setrecursionlimit(10**6)
{% if prediction_success %}

def solve({{ formal_arguments }}):
    
{% endif %}


def main():
    {% if prediction_success %}
    def iterate_tokens():
        for line in stdin:
            for word in line.split():
                yield word
    tokens = iterate_tokens()
    {{ input_part }}
    solve({{ actual_arguments }})
    {% else %}
    # Failed to predict input format
    pass
    {% endif %}

if __name__ == '__main__':
    main()

注意点として、ファイルの先頭に

#!/usr/bin/env python3

を記述しないと、atcoder-toolsが実行可能ファイルとして判定できずエラーが起きます。

これをテンプレートとして使用するので~/.atcodertools.tomlに追記します。

.atcodertools.toml

[codestyle]
workspace_dir = '~/Your/atcoder/dir/'
lang = 'python' 

#追記部分
template_file='~/Your/atcoder/dir/template.py'

ショートカットの作成

現在使うコマンドを確かめてみます。

# どうにもならなそう
$ atcoder-tools gen abc000

#ショートカットがあると便利そう
$ cd problem/dir
$ atcoder-tools test
$ atcoder-tools submit

ショートカットの機能は

編集中のファイルを保存
problemのディレクトリに移動
コマンドを入力・実行する

というものにします。ファイルの保存を忘れてエラーが出るのはなんとも無駄です。

1. multi-commandのインストール

VSCodeの標準機能では一つのショートカットで複数のコマンドを連続で実行できないため、multi-commandという拡張機能をインストールします。

2. コマンドの設定

cmd+shift+pでコマンドパレットを開きます。Preferences: Open User Settings(JSON)と入力して出てきたファイルを選択し、以下の内容を追記します。

{
    //追記ここから
    "multiCommand.commands": [
        {
            "command": "multiCommand.saveAndRun",
            "sequence": [
                "workbench.action.files.save",
                {
                    "command": "workbench.action.terminal.sendSequence",
                    "args": {
                        "text": "cd ${fileDirname}\u000Datcoder-tools test\u000D"
                    }
                }
            ]
        },
        {
            "command": "multiCommand.saveAndSubmit",
            "sequence": [
                "workbench.action.files.save",
                {
                    "command": "workbench.action.terminal.sendSequence",
                    "args": {
                        "text": "cd ${fileDirname}\u000Datcoder-tools submit -u\u000D"
                    }
                }
            ]
        }
    ],
    //追記ここまで
}

3. ショートカットの設定

押しやすいという安直な理由でcmd+d,cmd+shift+dにショートカットを追加します。
コマンドパレットからPreferences: Open Keyboard Shortcuts(JSON)を開き、リストに以下の内容を追加します

[
    //追記ここから
    {
        "key": "cmd+d",
        "command":"multiCommand.saveAndRun"
    },
    {
        "key": "cmd+shift+d",
        "command": "multiCommand.saveAndSubmit"
    },
    //追記ここまで
]

これでショートカットの作成が終わりました。
atcoder-tools submitはコードテストを行いACならば提出してくれます。逆に言えばWAやTLEがあれば提出しないので、天邪鬼にこちらを使う気がします。
ちなみにA問題を解いた後は次のコマンドでB問題のソースを開けます。有用な気もしますが、VSCode使ってる時点である程度マウス操作前提でもあるので使うかどうかわかっていません。

$ cd ../b
$ open main.py

ここからの変更はファイルを直接編集するため、次の可能性があります

atcoder-toolsの更新時に元に戻る（きっとCPythonで提出することになる）
プルダウンの言語名変更時に提出できなくなる

自動inputの型推定を修正

list[int]のような型が、 "List[int]"のように表記されています。なんとも不思議です。
PRしようか迷いましたが、恐らくpythonのより多くのバージョンに対応させるためこの状態なのだろう（調べていない）と考え自分の環境でのみ修正します。

atcoder-toolsがインストールされているディレクトリを開きます(これはpyenvなどの環境によって違うのでご自身で調べてください)。atcodertoolsというフォルダ名のはずです

以下のファイルを開きます

/atcodertools/codegen/code_generators/universal_generator/python.toml

\"List[{type}]\"をlist[{type}]に置換します。VSCodeの置換機能を使うと楽です
\"List[List[{type}]]\"をlist[list[{type}]]に置換します

これで型の修正ができました。コーディング時に型をしっかり定義してあると楽な場合も多いので、よりストレスフリーになりました。

提出の際の言語をPyPyに変更

こちらのサイトを参考に変更しました。しかしサイト通りだとCpythonが先にマッチしうまくいきません。

以下のファイルを開きます
```
atcodertools/common/language.py
```
次のように編集します

PYTHON = Language(
    name="python",
    display_name="Python",
    extension="py",
-   submission_lang_pattern=re.compile(".*Python \\(3.*|.*Python \\(CPython 3.*"),
+   submission_lang_pattern=re.compile(".*Python \\(PyPy.*"),
    default_code_generator=python.main,
    default_template_path=get_default_template_path('py'),
    compile_command="python3 -mpy_compile {filename}.py",
    test_command="python3 {filename}.py",
    exec_fi

最後に

コードテストと提出の自動化が最大のメリットのように感じます。自動inputは今後使い続けるかわかりませんが、とりあえず使ってみようと思います。

atcoder-toolsとVSCodeでPythonのAtCoder環境を整えた話