manim-chess 0.0.1__py3-none-any.whl

manim_chess-0.0.1.dist-info/METADATA

@@ -0,0 +1,212 @@
+Metadata-Version: 2.1
+Name: manim_chess
+Version: 0.0.1
+Home-page: https://github.com/swoyer2/manim_chess
+Author: Swoyer2
+Author-email: swoyer.logan@gmail.com
+License: MIT
+Classifier: License :: OSI Approved :: MIT License
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: twine>=4.0.2; extra == "dev"
+
+# Manim Chess
+
+This is a [Manim Community](https://www.manim.community/) plugin that allows you to generate a chess board/chess game easily.
+
+
+## Installation
+
+```bash
+pip install manim-chess
+```
+
+## Features
+
+- **Create Chessboard**: Allows you to create and display a chessboard.
+- **Move Pieces**: Animate piece movement with PGN notation or the simplified notation in the package.
+- **Special Moves**: Handle special chess moves like castling and en passant.
+- **Load FEN Strings**: Load and display a board configuration from a FEN string.
+- **Play PGN Files**: Load and animate moves from PGN files.
+- **Evaluation Bar**: Allows the creation and ability to display an evaluation bar.
+- **Update Evaluation Bar**: Can update the value in the evaluation bar with externally obtained evaulations.
+- **Mark Squares**: Can mark and unmark squares to highlight them.
+- **Draw Arrows**: Can draw/undraw arrows similar to chess.com
+
+## Usage
+
+In order to use this package you need to run the script using Manim. I have provided some examples on how to use it
+below.
+
+
+### Moving Pieces
+This example initializes the chessboard and shows how you can move a piece.
+
+![MovingPieces](https://github.com/swoyer2/manim_chess/blob/main/gifs/moving_pieces.gif)
+
+
+```python
+from manim import *
+import manim_chess
+
+class MovingPieces(Scene):
+    def construct(self):
+        chess_board = manim_chess.Board()
+        chess_board.set_board_from_FEN("rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1") # Also can set the default board with no arguments
+
+        # Define the moves you want to be done with the default notation (starting_square, ending_square, promotion_piece)
+        # Note that the promotion piece is blank unless a pawn is promoting
+        moves = [('e2', 'e4', ''), ('e7', 'e5', ''), ('g1', 'f3', '')]
+
+        self.add(chess_board)
+        self.wait()
+        manim_chess.play_game(scene=self, board=chess_board, moves=moves)
+        self.wait()
+```
+
+### Using a PGN Notation
+This example demonstrates playing moves from a PGN file on the chessboard. NOTE if you are starting from a different FEN than the standard start of a game, include FEN=your_fen_string
+
+![PGNExample](https://github.com/swoyer2/manim_chess/blob/main/gifs/PGN_example.gif)
+
+
+```python
+from manim import *
+import manim_chess
+
+class PGN_Example(MovingCameraScene):
+    def construct(self):
+        chess_board = manim_chess.Board()
+        chess_board.set_board_from_FEN("rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1") # Also can set the default board with no arguments
+
+        # You can paste a PGN straight from wherever you got your pgn. Just make it a multiline string with """PGN"""
+        moves = manim_chess.convert_from_PGN("""[Event "It (cat.17)"]
+[Site "Wijk aan Zee (Netherlands)"]
+[Date "1999.??.??"]
+[Round "4"]
+[White "Kasparov Garry (RUS)"]
+[Black "Topalov Veselin (BUL)"]
+[Result "1-0"]
+[ECO "B07"]
+[WhiteElo "2851"]
+[BlackElo "2690"]
+[Annotator ""]
+[Source ""]
+[Remark "I"]
+[WhiteUrl "https://images.chesscomfiles.com/uploads/v1/master_player/4fe1281a-a9df-11e8-8450-4ff4fd58ed06.bb91bfe2.50x50o.77b8f8a95e5e.jpeg"]
+[WhiteCountry ""]
+[WhiteTitle ""]
+[BlackUrl "https://images.chesscomfiles.com/uploads/v1/master_player/e9640f50-c002-11e8-b93d-e56e1835faa8.4a751865.50x50o.dd0ca3584c8b.png"]
+[BlackCountry ""]
+[BlackTitle ""]
+[Link "https://www.chess.com/analysis/game/master/969971?tab=analysis"]
+
+1. e4 d6 2. d4 Nf6 3. Nc3 g6 4. Be3 Bg7 5. Qd2 c6 6. f3 b5 7. Nge2 Nbd7 8. Bh6
+Bxh6 9. Qxh6 Bb7 10. a3 e5 11. O-O-O Qe7 12. Kb1 a6 13. Nc1 $6 O-O-O $2 14. Nb3 $6
+exd4 15. Rxd4 c5 16. Rd1 Nb6 17. g3 $6 Kb8 $6 18. Na5 $6 Ba8 19. Bh3 d5 20. Qf4+
+Ka7 21. Rhe1 d4 $1 22. Nd5 Nbxd5 23. exd5 Qd6 24. Rxd4 $1 cxd4 $2 25. Re7+ $3 Kb6 26.
+Qxd4+ Kxa5 27. b4+ $1 Ka4 28. Qc3 $1 Qxd5 29. Ra7 $1 Bb7 30. Rxb7 Qc4 31. Qxf6 Kxa3 $2
+32. Qxa6+ $1 Kxb4 33. c3+ $1 Kxc3 34. Qa1+ $1 Kd2 35. Qb2+ $1 Kd1 36. Bf1 $3 Rd2 37.
+Rd7 $3 Rxd7 38. Bxc4 bxc4 39. Qxh8 Rd3 40. Qa8 c3 41. Qa4+ Ke1 42. f4 f5 43. Kc1
+Rd2 44. Qa7 1-0""")
+
+        self.add(chess_board)
+        self.wait()
+        manim_chess.play_game(scene=self, board=chess_board, moves=moves)
+        self.wait()
+```
+
+### Evaluation Bar
+This example shows how to add and adjust the values of the evaluation bar
+
+![EvalBarExample](https://github.com/swoyer2/manim_chess/blob/main/gifs/eval_bar.gif)
+
+
+```python
+from manim import *
+import manim_chess
+
+
+class EvalBarExample(MovingCameraScene):
+    def construct(self):
+        chess_board = manim_chess.Board()
+        chess_board.set_board_from_FEN("rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1") # Also can set the default board with no arguments
+
+        eval_bar = manim_chess.EvaluationBar()
+        eval_bar.move_to(chess_board.get_left()).shift(LEFT*0.5)
+
+        self.add(chess_board, eval_bar)
+        self.wait()
+        self.play(eval_bar.set_evaluation(1.5))
+        self.wait()
+        self.play(eval_bar.set_evaluation(-3))
+        self.wait()
+```
+
+### Marking Squares
+This example shows how to mark and unmark squares on the chessboard.
+
+![MarkSquaresExample](https://github.com/swoyer2/manim_chess/blob/main/gifs/mark_squares_example.gif)
+
+
+```python
+from manim import *
+import manim_chess
+
+
+class MarkSquaresExample(MovingCameraScene):
+    def construct(self):
+        chess_board = manim_chess.Board()
+        chess_board.set_board_from_FEN()
+
+        self.add(chess_board)
+
+        chess_board.mark_square('e4')
+        self.wait()
+        chess_board.mark_square('c5')
+        self.wait()
+        chess_board.unmark_square('e4')
+        chess_board.unmark_square('c5')
+        self.wait()
+```
+
+### Draw Arrows
+This is how you would draw and remove arrows.
+
+![DrawArrowsExample](https://github.com/swoyer2/manim_chess/blob/main/gifs/draw_arrows_example.gif)
+
+
+```python
+from manim import *
+import manim_chess
+
+
+class DrawArrowsExample(MovingCameraScene):
+    def construct(self):
+        chess_board = manim_chess.Board()
+        chess_board.set_board_from_FEN()
+
+        self.add(chess_board)
+
+        chess_board.draw_arrow('e2', 'e4')
+        self.wait()
+        chess_board.draw_arrow('b8', 'c6')
+        self.wait()
+        chess_board.draw_arrow('b1', 'a3')
+        self.wait()
+        chess_board.remove_arrows()
+        self.wait()
+```
+
+
+### Running the Examples
+To run any of the examples, execute the script using Manim. For instance, here is an example on how to render the first example with low quality (if you want high quality replace -pql with -hql)
+
+```sh
+manim -pql examples.py MovingPieces
+```
+
+Replace `MovingPieces` with the class name of the example you want to run.
+
+### License
+This project is licensed under the MIT License. See the LICENSE file for more details.

manim_chess-0.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+src/__init__.py,sha256=x6PCRFc18I6rHgyQfwkxsxS7bsi9i0QDd7zvMZX0gFA,199
+src/board.py,sha256=FIFEiLzssQRtojcIhWCdkiOlaWOaeJqkknSc29bRzsU,19715
+src/evaluation_bar.py,sha256=ELjhyFPi5x_Q4Gw3U0FLVhQqN55k8rYCu-lpkru4nPo,3655
+src/game_player.py,sha256=fESDu5eksZK9ic47CwQNgeq1rpkcMKt0O7_X7-E5lp0,31102
+src/pieces.py,sha256=890HggU4vGv_PgLyUPnJj2p3ZdivoqG5BukjqsS6MeU,7634
+manim_chess-0.0.1.dist-info/METADATA,sha256=oSYlLtpXsj6LvT7oKQkLmIIs5g31vLrXyA6VdQ_3U7Y,7257
+manim_chess-0.0.1.dist-info/WHEEL,sha256=5Mi1sN9lKoFv_gxcPtisEVrJZihrm_beibeg5R6xb4I,91
+manim_chess-0.0.1.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+manim_chess-0.0.1.dist-info/RECORD,,

manim_chess-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

manim_chess-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+src

src/__init__.py

@@ -0,0 +1,11 @@
+from .pieces import (
+    Pawn,
+    Knight,
+    Bishop,
+    Rook,
+    Queen,
+    King
+)
+from .board import Board
+from .evaluation_bar import EvaluationBar
+from .game_player import play_game