AtCoderStudyBooster 0.3.3__py3-none-any.whl → 0.4.1__py3-none-any.whl

atcoderstudybooster-0.4.1.dist-info/METADATA

@@ -0,0 +1,248 @@
+Metadata-Version: 2.3
+Name: AtCoderStudyBooster
+Version: 0.4.1
+Summary: A tool to download and manage AtCoder problems.
+Project-URL: Homepage, https://github.com/yuta6/AtCoderStudyBooster
+Author-email: yuta6 <46110512+yuta6@users.noreply.github.com>
+License: MIT
+Requires-Python: >=3.8
+Requires-Dist: beautifulsoup4
+Requires-Dist: click-aliases>=1.0.5
+Requires-Dist: markdownify==0.13.1
+Requires-Dist: pywebview>=5.4
+Requires-Dist: questionary>=2.0.1
+Requires-Dist: requests
+Requires-Dist: rich-click>=1.8.8
+Requires-Dist: rich>=13.7.1
+Requires-Dist: tiktoken
+Requires-Dist: types-beautifulsoup4>=4.12.0.20240511
+Requires-Dist: types-requests>=2.32.0.20240712
+Description-Content-Type: text/markdown
+
+# AtCoderStudyBooster
+
+[日本語版 README はこちら](README.ja.md)
+
+## Overview
+
+🚧 This project is still in experimental stage. We are continuously adding features to help with daily AtCoder practice.
+
+![demo image](./.images/demo0.gif)
+
+AtCoderStudyBooster is a CLI tool designed to accelerate your AtCoder learning journey. It supports downloading problems locally, testing, submitting, and generating solutions. Python installation is required. If you have Python installed, you can install this tool with:
+
+```sh
+pip install AtCoderStudyBooster
+```
+
+(Python 3.8 or higher is required)
+
+Even after CAPTCHA authentication was introduced, you can still login and submit semi-automatically from CLI. However, you need to manually solve the CAPTCHA through GUI. This tool does not bypass CAPTCHA authentication.
+
+This project is strongly influenced by:
+- [online-judge-tools](https://github.com/online-judge-tools)
+- [atcoder-cli](https://github.com/Tatamo/atcoder-cli)
+
+## Use Cases
+
+Let's start by using the `download` command to download problems locally.
+
+### 1. Download a Specific Contest
+
+Examples for downloading problems from a single contest.
+
+#### Download all problems from ABC350
+```sh
+❯ atcdr download abc350
+```
+
+#### Download problems A-D from ABC350
+```sh
+❯ atcdr download abc350 {A..D}
+```
+
+#### Download Typical 90 Problems
+```sh
+❯ atcdr download typical90
+```
+
+### 2. Batch Download Multiple Contests
+
+Examples for downloading multiple contests at once. Utilizes bash brace expansion.
+
+#### All problems from ABC001 to ABC010
+```sh
+❯ atcdr download abc{001..010}
+```
+
+#### Specific problems from multiple contests
+```sh
+❯ atcdr download abc{301..310} {A..C}
+```
+
+### 3. Download Specific Difficulty Problems
+
+Examples for collecting problems of the same difficulty across different contests.
+
+#### Download all A problems from ABC301-310
+```sh
+❯ atcdr download A abc{301..310}
+```
+
+This creates the following directory structure:
+```
+A/
+├── abc301/
+│   ├── Problem.html
+│   └── Problem.md
+├── abc302/
+│   ├── Problem.html
+│   └── Problem.md
+└── ...
+```
+
+#### Download all B problems from ABC300-302
+```sh
+❯ atcdr download B abc{300..302}
+```
+
+Creates:
+```
+B/
+├── abc300/
+│   ├── Problem.html
+│   └── Problem.md
+├── abc301/
+│   ├── Problem.html
+│   └── Problem.md
+└── abc302/
+    ├── Problem.html
+    └── Problem.md
+```
+This directory structure allows you to efficiently practice problems of the same difficulty level in one place.
+
+### Solving Problems
+
+You can view problems by opening Markdown or HTML files with VS Code's HTML Preview or Markdown Preview. In VS Code, you can display the text editor on the left and work on problems while viewing them on the right.
+
+### Testing Samples Locally
+
+Navigate to the folder where you downloaded the problem.
+
+```sh
+❯ cd abc224/B
+```
+
+After creating your solution file in the folder, run the test command to test against sample cases.
+
+```sh
+~/.../abc224/B
+❯ atcdr t
+```
+
+For Wrong Answer (WA) cases, the display looks like this:
+
+### Submitting Solutions
+
+```sh
+~/.../abc224/B
+❯ atcdr s
+```
+
+Running this command will submit your solution. Login to AtCoder website is required for submission.
+
+### Generating Solutions with GPT
+
+```sh
+~/.../abc224/B
+❯ atcdr g
+```
+
+This command generates a solution using OpenAI's GPT model. An OpenAI API key is required. On first run, you'll be prompted to input your API key.
+
+### Login to AtCoder
+
+```sh
+❯ atcdr login
+```
+
+Logs into AtCoder. A browser window will open for CAPTCHA verification. After solving the CAPTCHA, login completes automatically.
+
+### Create Markdown File
+
+```sh
+~/.../abc224/B
+❯ atcdr m
+```
+
+Creates a Markdown file from the HTML file in the current directory. This command is automatically executed during `atcdr download`.
+
+### Open Problem in Browser
+
+```sh
+~/.../abc224/B
+❯ atcdr o
+```
+
+Opens the problem page in your browser. Convenient for checking detailed problem statements or constraints.
+
+## Commands
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `atcdr download` | `atcdr d` | Download problems |
+| `atcdr test` | `atcdr t` | Test with sample cases |
+| `atcdr submit` | `atcdr s` | Submit solution |
+| `atcdr generate` | `atcdr g` | Generate solution with GPT |
+| `atcdr login` | - | Login to AtCoder |
+| `atcdr logout` | - | Logout from AtCoder |
+| `atcdr markdown` | `atcdr m` | Create Markdown file |
+| `atcdr open` | `atcdr o` | Open problem in browser |
+
+## GPT Code Generation
+
+`atcdr generate` command uses GPT to generate solutions. It requires an OpenAI API key.
+
+### Generate Solution with Test
+
+By default, generated code is tested against sample cases:
+
+```sh
+~/.../abc224/B
+❯ atcdr generate
+```
+
+### Specify Language
+
+Specify the programming language for generation. Default is Python.
+
+```sh
+~/.../abc224/B
+❯ atcdr generate --lang cpp
+```
+
+Supported languages:
+- `python` (default)
+- `cpp`
+- `java`
+- `rust`
+
+### Specify GPT Model
+
+```sh
+~/.../abc224/B
+❯ atcdr generate --gpt gpt-4o
+```
+
+Available models:
+- `gpt-4o-mini` (default) - Fast and cost-effective
+- `gpt-4o` - More accurate but slower
+
+### Generate Code Only Without Testing
+
+To generate code without testing:
+
+```sh
+~/.../abc224/B
+❯ atcdr generate --lang rust --without_test
+```

atcoderstudybooster-0.4.1.dist-info/RECORD

@@ -0,0 +1,22 @@
+atcdr/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+atcdr/cli.py,sha256=xiCnGf14VHtLcRlVHXNpLKW3FIxOHS2duTRDTsG8a5w,2595
+atcdr/download.py,sha256=sMILF_FKLTe3OBk_ZnA8pzvnlGz68jrHaU-lxDAy6pA,7678
+atcdr/generate.py,sha256=FBOPJ2wU827GzkmYxsFrZKJYKXVC_h675_9-mZ7wRdc,7899
+atcdr/login.py,sha256=3lyuo19EKOj3eaiOcOUnrkkgEEqWO0D1EnjLPKNxkPU,4655
+atcdr/logout.py,sha256=XwyR5oSipg-iQzfdfkx4Cs0Q88ZWJ548FmdhlIhpUL8,777
+atcdr/markdown.py,sha256=x0OORs1eun14c0XZWUap6HljTHhJ6UM6OfkJlDXeeSo,1587
+atcdr/open.py,sha256=bxfoUGO0yo3BK1C9iswuN65GW_wp6OEa58IX7JgWAFU,1319
+atcdr/submit.py,sha256=vVGZ-04K7NtjL5jv79Wx8IWosVK44XwEDCK19QAkKAo,9604
+atcdr/test.py,sha256=tbjkBETQG48AuH1F_hBlla3lpfcQiVvFO1YjZ2QDB9A,13518
+atcdr/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+atcdr/util/fileops.py,sha256=kvQDO85Ii5n__Wo8KmoE6Ecgbxx9MfmF7BDYz1sL5Sk,3200
+atcdr/util/filetype.py,sha256=pceB08trkwNkdzKJx4fFfOWpz9jYMBRDwXLW4un0sRM,2254
+atcdr/util/gpt.py,sha256=GNJqgV-eVQlxkQ3tnwNiGec27FV6O4QSpwaDiXbFM0w,3392
+atcdr/util/i18n.py,sha256=WRptkwqRSYSpA7L2CeWwv4ufv_uK65KjnorAcOTOot8,17949
+atcdr/util/parse.py,sha256=fo_LtEXLwz0g3871iUKZFHMitxbBh-bz9uBndpKfQeI,7130
+atcdr/util/problem.py,sha256=ZLD-WvhC5SC6TGbyqmiOpTVZVSn-KuhOazWvAvHdyqI,1222
+atcdr/util/session.py,sha256=xct266SY7QuC3bc1IKlkVginttvXE_qK5tepUx6hfWE,4820
+atcoderstudybooster-0.4.1.dist-info/METADATA,sha256=yV1OZY9piILs7WW_qfKEsGk_az03Vh4ehgrbq1iO-nQ,6077
+atcoderstudybooster-0.4.1.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+atcoderstudybooster-0.4.1.dist-info/entry_points.txt,sha256=-stL-IwnheQGlYAdm82RuZu8CGgSakU0aVIVlA7DmFA,40
+atcoderstudybooster-0.4.1.dist-info/RECORD,,

atcoderstudybooster-0.3.3.dist-info/METADATA

@@ -1,213 +0,0 @@
-Metadata-Version: 2.3
-Name: AtCoderStudyBooster
-Version: 0.3.3
-Summary: A tool to download and manage AtCoder problems.
-Project-URL: Homepage, https://github.com/yuta6/AtCoderStudyBooster
-Author-email: yuta6 <46110512+yuta6@users.noreply.github.com>
-License: MIT
-Requires-Python: >=3.8
-Requires-Dist: beautifulsoup4
-Requires-Dist: click-aliases>=1.0.5
-Requires-Dist: markdownify==0.13.1
-Requires-Dist: pywebview>=5.4
-Requires-Dist: questionary>=2.0.1
-Requires-Dist: requests
-Requires-Dist: rich-click>=1.8.8
-Requires-Dist: rich>=13.7.1
-Requires-Dist: tiktoken
-Requires-Dist: types-beautifulsoup4>=4.12.0.20240511
-Requires-Dist: types-requests>=2.32.0.20240712
-Description-Content-Type: text/markdown
-
-# AtCoderStudyBooster
-
-## 概要
-
-🚧 このプロジェクトはまだ実験段階です。日々のAtCoder学習に役立つ機能を順次追加しています。
-
-AtCoderStudyBoosterはAtCoderの学習を加速させるためのCLIツールです。問題をローカルにダウンロードし、テスト、提出、解答の作成をサポートするツールです。Pythonが入っていることが必須です。Pythonが入っている環境なら、`pip install AtCoderStudyBooster`でインストールできます。(Python3.8以上が必要です)
-
-キャプチャ認証が導入されたあとでも、CLIから半自動でログイン＆提出できます。ただしキャプチャをGUIから人力で解く必要があります。キャプチャー認証をバイパスするものではありません。
-
-このツールは以下のプロジェクトに強く影響を受けています。
-[online-judge-tools](https://github.com/online-judge-tools)
-[atcoder-cli](https://github.com/Tatamo/atcoder-cli)
-
-
-## 利用ケース
-
-まずは`download`コマンドを利用して問題をローカルにダウンロードしてみましょう。
-
-### B問題の練習したい場合
-
-ABCコンテストの223から226のB問題だけを集中的に練習したい場合、次のコマンドを実行します。
-
-```sh
-❯ atcdr download B 223..226
-```
-
-コマンドを実行すると,次のようなフォルダーを作成して、各々のフォルダーに問題をダウンロードします。
-
-```css
-B
-├── 223
-│   ├── StringShifting.html
-│   └── StringShifting.md
-├── 224
-│   ├── Mongeness.html
-│   └── Mongeness.md
-├── 225
-│   ├── StarorNot.html
-│   └── StarorNot.md
-└── 226
-    ├── CountingArrays.html
-    └── CountingArrays.md
-```
-
-### 特定のコンテストの問題に取り組みたい場合
-
-```sh
-❯ atcdr download 223..225 A..C
-```
-のように実行すると以下のようなフォルダーを生成します.
-
-```css
-.
-├── 223
-│   ├── A
-│   │   ├── ExactPrice.html
-│   │   └── ExactPrice.md
-│   ├── B
-│   │   ├── StringShifting.html
-│   │   └── StringShifting.md
-│   └── C
-│       ├── Doukasen.html
-│       └── Doukasen.md
-├── 224
-│   ├── A
-│   │   ├── Tires.html
-│   │   └── Tires.md
-│   ├── B
-│   │   ├── Mongeness.html
-│   │   └── Mongeness.md
-│   └── C
-│       ├── Triangle.html
-│       └── Triangle.md
-└── 225
-    ├── A
-    │   ├── DistinctStrings.html
-    │   └── DistinctStrings.md
-    ├── B
-    │   ├── StarorNot.html
-    │   └── StarorNot.md
-    └── C
-        ├── CalendarValidator.html
-        └── CalendarValidator.md
-```
-
-### 問題を解く
-
-MarkdownファイルあるいはHTMLファイルをVS CodeのHTML Preview, Markdown Previewで開くと問題を確認できます。VS Codeで開くと左側にテキストエディターを表示して、右側で問題をみながら問題に取り組めます。
-
-![demo画像](./.images/demo1.png)
-
-### サンプルをローカルでテストする
-
-問題をダウンロードしたフォルダーに移動します。
-
-```sh
-❯ cd 224/B
-```
-
-移動したフォルダーで解答ファイルを作成後をtestコマンドを実行すると, サンプルケースをテストします。
-
-```sh
-~/.../224/B
-❯ atcdr t
-```
-
-![demo画像](./.images/demo2.png)
-
-WAの場合は以下のような表示になります。
-
-![demo画像](./.images/demo3.png)
-
-
-### 提出する
-
-```sh
-~/.../224/B
-❯ atcdr s
-```
-を実行すると, 提出することができます。提出にはAtCoderのサイトへのログインが必要です。
-
-### 解答をGPTで生成する
-
-```sh
-~/.../224/B
-❯ atcdr g
-```
-で解答をGPTで生成します。Chat GPTのAPIキーが必要です。さらに、生成されたファイルはサンプルケースが自動でテストされ、**テストをパスしなかった場合、テスト結果がGPTにフィードバックされ解答が再生成**されます。
-
-GPTとプログラムとのやり取りのログはJSONファイルで保存されます。
-
-## 解答生成機能generateコマンドに関する注意点
-
-[AtCoder生成AI対策ルール](https://info.atcoder.jp/entry/llm-rules-ja)によるとAtCoder Beginner Contest（以下、ABCとする）および AtCoder Regular Contest (Div. 2) においてに問題文を生成AIに直接与えることは禁止されています。ただし、このルールは過去問を練習している際には適用されません。　該当のコンテスト中にこの機能を使用しないでください。
-
-## その他の機能
-
-### markdownコマンド
-
-完全なCLI環境方向けのコマンドです。
-```sh
-~/.../224/B
-❯ atcdr md
-```
-を実行すると, 問題をプリントします。
-
-![demo画像](./.images/demo4.png)
-
-### 複数のファイルを一度にテスト
-
-```sh
-~/.../224/B
-❯ atcdr t *.py
-```
-でフォルダー内にあるすべてのPythonファイルを一度にテストします。
-```sh
-~/.../224/B
-❯ atcdr t mon.py mon.c mon.cpp
-```
-
-フォルダー内に複数ファイルある場合は、インタラクティブに選択できます。
-```sh
-~/.../224/B
-❯ atcdr t
-```
-
-```sh
-~/.../224/B
-❯ atcdr t
- 複数のファイルが見つかりました.ファイルを選択してください:
- 十字キーで移動, [enter]で実行
- ❯❯❯ mon.py
-     mon.c
-     mon.cpp
-```
-
-### プログラミング言語を指定してコードを生成
-
-`--lang`オプションを使うと、生成したいプログラミング言語を指定できます。
-```sh
-~/.../224/B
-❯ atcdr generate --lang rust
-```
-### テストをせずにコードのみ生成
-
-デフォルトで`atcdr generate`コマンドは生成されたコードをテストしますが、テストせずにコードのみ生成できます。
-
-```sh
-~/.../224/B
-❯ atcdr generate --lang rust --without_test
-```

atcoderstudybooster-0.3.3.dist-info/RECORD

@@ -1,21 +0,0 @@
-atcdr/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atcdr/cli.py,sha256=xiCnGf14VHtLcRlVHXNpLKW3FIxOHS2duTRDTsG8a5w,2595
-atcdr/download.py,sha256=gJ5ZPQJd06fxWOUzC_GFBY-d7KIyaURoPwO86_QdU4A,11711
-atcdr/generate.py,sha256=i-rznjOQpBcAmlI0CGGC8CEY3Nx35SoxQgGaPSh6Oz8,8183
-atcdr/login.py,sha256=gro9gj-nF4pGz4KepkaNSMj8PRGdSJtaVcBe7YKUPzU,4697
-atcdr/logout.py,sha256=WYFifFDZtdcFZ0z3BhqsmdK_JbufjmBdF4q5dDkLbHQ,753
-atcdr/markdown.py,sha256=RpYdXMWgBd2qcMj-WmUrSyF0VdLfyUms-FsTRXfdgRw,1485
-atcdr/open.py,sha256=aRmhg7_TcZU6iPBM0u7lUQhTpPF5Eo227MxS3JUSm1M,1293
-atcdr/submit.py,sha256=T579xpIyLeXp69D8UW_2mNC8vcjJ3d-iFT9rJvoVJ7I,9975
-atcdr/test.py,sha256=y9ENvL4Gdirup07tfFBjJJXA-HeiWZpSW1ncpNwiKOs,13672
-atcdr/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atcdr/util/fileops.py,sha256=jxJ_d-R3XG-CLQemwwxgeNQcvNAE_7Q-3nOQ1npG3ig,3293
-atcdr/util/filetype.py,sha256=pceB08trkwNkdzKJx4fFfOWpz9jYMBRDwXLW4un0sRM,2254
-atcdr/util/gpt.py,sha256=vH10Waa7KXlz6-5pEUBuIbxTbDH3Hys7k9Tt7prvFX4,3772
-atcdr/util/parse.py,sha256=SJ4khlH5iWaSwyORmQLi84npMwh5u2omCeg0q7ScEAE,6974
-atcdr/util/problem.py,sha256=wEoMC5KVQu5l-i4V-ZCR30Z30Zov0VCNtLVIbL-0iI0,2594
-atcdr/util/session.py,sha256=LwlSN86sfnkE9a-opL4qvKYHsCgiMy7eFCdcXdo79eg,4889
-atcoderstudybooster-0.3.3.dist-info/METADATA,sha256=4_jttlJ8DMACriCozvDLlmhEWoUM91EL9YdpMEkjbOI,6836
-atcoderstudybooster-0.3.3.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-atcoderstudybooster-0.3.3.dist-info/entry_points.txt,sha256=-stL-IwnheQGlYAdm82RuZu8CGgSakU0aVIVlA7DmFA,40
-atcoderstudybooster-0.3.3.dist-info/RECORD,,