pystacker 1.0.3__py3.10.egg → 1.1.0__py3.10.egg

EGG-INFO/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pystacker
-Version: 1.0.3
+Version: 1.1.0
 Summary: Stacker: RPN Calculator in Python
 Home-page: https://github.com/remokasu/stacker
 Author: remokasu
@@ -42,44 +42,22 @@ License-File: LICENSE
 ~~~
 
 
-# Download & Install
+# Install
 
 If you don't have Python 3 installed, please install it beforehand.
 Here are the installation instructions for `stacker`:
 
-1. Download
+1. Install
 ~~~ bash
-> git clone git@github.com:remokasu/stacker.git
-~~~
-
-2. Install dependencies
-~~~
-pip install setuptools
-~~~
-
-* For Windows users only
-~~~ bash
-> pip install pyreadline
+> pip install pystacker
 ~~~
 
-3. Run the program without installation
-~~~ bash
-> cd stacker/stacker
-> python stacker.py
+2. Run the program
 ~~~
-
-4. (Or) Install and run the program
-~~~ bash
-cd stacker
-> python setup.py install
 > stacker
 ~~~
 
-* When you're done playing with it, uninstall
-~~~ bash
-> pip uninstall stacker
-~~~
-
+# Usage
 
 | Operator | Description                                           | Example                    | Result                   |
 |----------|-------------------------------------------------------|----------------------------|--------------------------|
@@ -133,8 +111,13 @@ cd stacker
 | random   | Generate a random floating-point number between 0 and 1| `random`                   | random.random()          |
 | randint  | Generate a random integer within a specified range    | `1 6 randint`              | random.randint(1, 6)     |
 | uniform  | Generate a random floating-point number within a specified range | `1 2 uniform` | random.uniform(1, 2) |
-| d        | Roll dice (e.g., 3d6)                                 | `3 6 d`                     | sum(random.randint(1, 6) for _ in range(3)) |
-
+| dice     | Roll dice (e.g., 3d6)                                 | `3 6 dice`                 | sum(random.randint(1, 6) for _ in range(3)) |
+| delete   | Remove the element at the specified index             | `2 delete`                 | Remove the element at index 2 from the stack  |
+| pluck    | Remove the element at the specified index and move it to the top of the stack | `2 pluck`              | Remove the element at index 2 and move it to the top of the stack  |
+| pick     | Copy the element at the specified index to the top of the stack | `2 pick`                   | Copy the element at index 2 to the top of the stack  |
+| pop      | Remove the top element from the stack                | `pop`                      | Remove the top element from the stack  |
+| exec     | Execute the specified Python code                    | `'print(1+1)' exec`        | Execute 1+1 and print 2 |
+| eval     | Evaluate the specified Python expression             | `'1+1' eval`               | Add 2 to the stack       |
 
 <hr>
 
@@ -190,6 +173,22 @@ Display usage instructions with `help`
 stacker:0> help
 ~~~
 
+# Acknowledgments
+Stacker makes use of the features provided by the Python Prompt Toolkit. We would like to express our gratitude to the developers and contributors of the Python Prompt Toolkit for their excellent work.
+
+## License for Python Prompt Toolkit:
+
+The Python Prompt Toolkit is released under the BSD-3-Clause License. The full license text can be found in the LICENSE file of the Python Prompt Toolkit repository, or at the following URL: https://github.com/prompt-toolkit/python-prompt-toolkit/blob/master/LICENSE
+
+Below is a summary of the main terms of the BSD-3-Clause License:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 <br>
 <hr>
@@ -271,20 +270,16 @@ python3が無ければ事前にインストールしてください。
 ~~~
 
 2. 起動
-~~~
+~~~bash
 > stacker
 ~~~
 
-* windowsの場合の場合、追加で実行
-~~~ bash
-> pip install pyreadline
-~~~
-
 * 遊び終わったら削除しましょう
 ~~~ bash
 > pip uninstall pystacker
 ~~~
 
+
 # 使い方
 
 | 演算子   | 説明                                                  | 使い方                      | 結果                       |
@@ -339,9 +334,13 @@ python3が無ければ事前にインストールしてください。
 | random | 0と1の間の乱数を生成                                  | random                     | random.random()          |
 | randint| 指定した範囲内の整数乱数を生成                        | 1 6 randint                | random.randint(1, 6)     |
 | uniform| 指定した範囲内の浮動小数点数乱数を生成                | 1 2 uniform                | random.uniform(1, 2)     |
-| d      | サイコロを振る (例：3d6)                              | 3 6 d                      | sum(random.randint(1, 6) for _ in range(3)) |
-
-
+| dice   | サイコロを振る (例：3d6)                              | 3 6 dice                   | sum(random.randint(1, 6) for _ in range(3)) |
+| delete   | 指定のindexを削除                                     | `2 delete`                 | スタックからindex 2の要素を削除  |
+| pluck    | 指定のindexを削除し、スタックのトップに移動           | `2 pluck`                  | index 2の要素を削除し、スタックのトップに移動  |
+| pick     | 指定されたインデックスの要素をスタックのトップにコピー | `2 pick`                   | index 2の要素をスタックのトップにコピー  |
+| pop      | スタックのトップを削除                                | `pop`                      | スタックのトップを削除  |
+| exec     | 指定のPythonコードを実行                             | `'print(1+1)' exec`        | 1+1を出力し、2をプリント |
+| eval     | 指定のPython式を評価                                 | `'1+1' eval`               | スタックに2を追加       |
 <br>
 <hr>
 
@@ -415,7 +414,7 @@ stacker:1>
 ただし、execはどんな処理でも結果が`None`なので結果はスタックに入らない。
 結果を表示したければptint文を式中に埋め込もう。
 文字列に対して`exec`することでPythonの処理として実行できる。
-この機能、危険な香りがしますね。
+
 ~~~
 stacker:0> '
 stacker:0> def f(x):
@@ -428,7 +427,7 @@ stacker:7> exec
 []
 ~~~
 
-・面倒くさいので以後はこうしましょうね。
+・面倒くさいので以後はStackerからPythonを起動しましょう。
 ~~~
 stacker:10> '
 stacker:10> from subprocess import run
@@ -440,7 +439,3 @@ Python 3.10.6 (main, Mar 10 2023, 10:55:28) [GCC 11.3.0] on linux
 Type "help", "copyright", "credits" or "license" for more information.
 >>>
 ~~~
-
-<br>
-<hr>
-

EGG-INFO/SOURCES.txt

@@ -11,5 +11,6 @@ stacker/__init__.py
 stacker/stacker.py
 stacker/test.py
 stacker/data/about.txt
+stacker/data/help-jp.txt
 stacker/data/help.txt
 stacker/data/top.txt

stacker/data/help-jp.txt

@@ -0,0 +1,78 @@
+RPN式を入力し、変数の代入、または関数の定義を行ってください。
+'exit'と入力すると終了します。
+
+例:
+    RPN式: 3 4 +
+    変数の代入: x = 5
+    関数の定義: x y func => x y *
+    関数の呼び出し: 4 5 func
+
+サポートされている演算子と関数:
+    ==      等しい
+    !=      等しくない
+    <       より小さい
+    <=      以下
+    >       より大きい
+    >=      以上
+    and     論理積
+    or      論理和
+    not     否定
+    band    ビット毎のAND
+    bor     ビット毎のOR
+    bxor    ビット毎のXOR
+    +       加算
+    -       減算
+    *       乗算
+    /       除算
+    //      整数除算
+    %       剰余
+    ^       べき乗
+    gcd     最大公約数
+    lcm     最小公倍数
+    neg     符号反転
+    abs     絶対値
+    exp     指数関数
+    log     自然対数
+    log10   底が10の対数
+    log2    底が2の対数
+    sin     正弦関数
+    cos     余弦関数
+    tan     正接関数
+    asin    アークサイン
+    acos    アークコサイン
+    atan    アークタンジェント
+    sinh    双曲線正弦
+    cosh    双曲線余弦
+    tanh    双曲線正接
+    asinh   双曲線正弦の逆関数
+    acosh   双曲線余弦の逆関数
+    atanh   双曲線正接の逆関数
+    sqrt    平方根
+    radians 度数からラジアンに変換
+    !       階乗
+    cbrt    立方根
+    ncr     組み合わせ (nCr)
+    npr     順列 (nPr)
+    float   整数を浮動小数点数に変換
+    int     浮動小数点数を整数に変換
+    ceil    切り上げ
+    floor   切り捨て
+    round   四捨五入
+    roundn  任意の桁数で丸める
+    random  0から1までの範囲でランダムな浮動小数点数を生成
+    randint 指定された範囲でランダムな整数を生成
+    uniform 指定された範囲でランダムな浮動小数点数を生成
+    dice    ダイスロー (例: 3d6)
+    delete  指定したインデックスのアイテムをスタックから削除
+    pluck   指定したインデックスのアイテムをスタックから削除し、トップに移動
+    pick    指定したインデックスのアイテムをスタックからコピーしてトップに配置
+    pop     スタックからアイテムを取り除く
+    exec    指定したPythonコードを実行
+    eval    指定したPython式を評価
+
+使い方:
+    RPN表記で数字と演算子を入力し、スペースで区切ります。
+    Enterキーを押すと、式が評価され、結果が表示されます。
+    結果はスタックにプッシュされます。
+    結果を後続の計算で使用するには、次の式を入力します。
+    スタックをクリアするには、'clear'と入力します。

stacker/data/help.txt

@@ -8,19 +8,67 @@ Examples:
   Function call: 4 5 func
 
 Supported operators and functions:
-  Arithmetic: +, -, *, /, //, %, ^, neg, abs
-  Comparison: ==, !=, <, <=, >, >=
-  Logical: and, or, not
-  Bitwise: band, bor, bxor
-  Math functions:
-    exp, log, log10, log2, sin, cos, tan, asin, acos, atan,
-    sinh, cosh, tanh, asinh, acosh, atanh, sqrt, cbrt,
-    ceil, floor, round, roundn, random, randint, uniform, d,
-    ncr((nCr)), npr(nPr)
-
-  Type conversion: int2float, float2int
-  Factorial: !
-  GCD: gcd
+    ==    Equal
+    !=    Not equal
+    <     Less than
+    <=    Less than or equal to
+    >     Greater than
+    >=    Greater than or equal to
+    and   Logical AND
+    or    Logical OR
+    not   Logical NOT
+    band  Bitwise AND
+    bor   Bitwise OR
+    bxor  Bitwise XOR
+    +     Addition
+    -     Subtraction
+    *     Multiplication
+    /     Division
+    //    Integer division
+    %     Modulus
+    ^     Exponentiation
+    gcd   Greatest common divisor
+    lcm   Least common multiple
+    neg   Negation
+    abs   Absolute value
+    exp   Exponential function
+    log   Natural logarithm
+    log10 Base 10 logarithm
+    log2  Base 2 logarithm
+    sin   Sine
+    cos   Cosine
+    tan   Tangent
+    asin  Arcsine
+    acos  Arccosine
+    atan  Arctangent
+    sinh  Hyperbolic sine
+    cosh  Hyperbolic cosine
+    tanh  Hyperbolic tangent
+    asinh Inverse hyperbolic sine
+    acosh Inverse hyperbolic cosine
+    atanh Inverse hyperbolic tangent
+    sqrt  Square root
+    radians Convert degrees to radians
+    !     Factorial
+    cbrt  Cube root
+    ncr   Combinations (nCr)
+    npr   Permutations (nPr)
+    float Convert integer to floating-point number
+    int   Convert floating-point number to integer
+    ceil  Ceiling (smallest integer greater than or equal to the number)
+    floor Floor (largest integer less than or equal to the number)
+    round Round to the nearest integer
+    roundn Round to a specified number of decimal places
+    random Generate a random floating-point number between 0 and 1
+    randint Generate a random integer in the specified range
+    uniform Generate a random floating-point number in the specified range
+    dice   Dice roll (e.g., 3d6)
+    delete Remove an item from the stack at the specified index
+    pluck  Remove an item from the stack at the specified index and move it to the top
+    pick   Copy an item from the specified index to the top of the stack
+    pop    Pop an item from the stack
+    exec   Execute specified Python code
+    eval   Evaluate specified Python expression
 
 Usage:
   Input numbers and operators in RPN notation, separated by spaces.

stacker/stacker.py

@@ -77,6 +77,12 @@ def show_help():
     print(message)
 
 
+def show_help_jp():
+    with pkg_resources.resource_stream(__name__, "data/help-jp.txt") as f:
+        message = f.read().decode('utf-8')
+    print(message)
+
+
 def delete_history():
     if history_file_path.exists():
         history_file_path.unlink()
@@ -198,7 +204,7 @@ class Stacker:
             "random": (lambda: random.random()),  # 0から1までの範囲でランダムな浮動小数点数を生成
             "randint": (lambda x1, x2: random.randint(int(x1), int(x2))),  # 指定された範囲でランダムな整数を生成
             "uniform": (lambda x1, x2: random.uniform(x1, x2)),  # 指定された範囲でランダムな浮動小数点数を生成
-            "d": (lambda num_dice, num_faces: sum(random.randint(1, int(num_faces)) for _ in range(int(num_dice)))),  # ダイスロール(例 3d6)
+            "dice": (lambda num_dice, num_faces: sum(random.randint(1, int(num_faces)) for _ in range(int(num_dice)))),  # ダイスロール(例 3d6)
             "delete": (lambda index: self.stack.pop(index)),  # 指定のindexを削除
             "pluck": (lambda index: self.stack.pop(index)),  # 指定のindexを削除し、スタックのトップに移動
             "pick": (lambda index: self.stack.append((self.stack[index]))),  # 指定されたインデックスの要素をスタックのトップにコピー
@@ -216,7 +222,7 @@ class Stacker:
             "nan": math.nan,
         }
         self.functions = {}
-        self.reserved_word = ["help", "about", "exit", "delete_history"]
+        self.reserved_word = ["help", "help-jp", "about", "exit", "delete_history", "last_pop"]
 
     # def get_operators_with_n_args(self, n: int):
     #     # 任意の引数の数に対応する演算子の一覧を取得
@@ -429,7 +435,11 @@ class InteractiveMode(ExecutionMode):
                     (expression.startswith('"') and expression.count('"') % 2 != 0) or
                     (expression.startswith("'") and expression.count("'") % 2 != 0)
                 ):
-                    next_line = input(f"stacker:{line_count}> ")
+                    next_line = prompt(
+                        f"stacker:{line_count}> ",
+                        history=FileHistory(history_file_path),
+                        completer=self.completer,
+                    )
                     expression += "\n" + next_line
 
                 if expression.lower() == "exit":
@@ -437,6 +447,9 @@ class InteractiveMode(ExecutionMode):
                 if expression.lower() == "help":
                     show_help()
                     continue
+                if expression.lower() == "help-jp":
+                    show_help_jp()
+                    continue
                 if expression.lower() == "about":
                     show_about()
                     continue