fisch-chess 0.1.0__tar.gz

fisch_chess-0.1.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: fisch-chess
+Version: 0.1.0
+Summary: A lightweight terminal chess game written in Python.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# FISCH CHESS
+
+> chess built from scratch, for the terminal.
+
+This is a lightweight chess game written in Python and played entirely inside the terminal(v1).
+
+## ✦ Features
+```
+[-] local two-player chess 
+[-] simple computer opponent 
+[-] legal move validation 
+[-] check + checkmate 
+[-] castling 
+[-] en passant 
+[-] pawn promotion 
+[-] stalemate + draw detection 
+[-] undo / redo 
+[-] move history 
+[-] FEN loading 
+[-] puzzle mode 
+```
+
+chess logic is implemented inside the project itself insetad of relying on Stockish, Lichess, Chess(dot)com or another chess library/service
+
+## ✦ Installation
+
+You need: 
+ `Python 3.11+`
+
+Clone the repo:
+
+> `git clone https://github.com/noxindeed/fisch-chess/`
+> `cd fisch-chess`
+
+Optional, but recommended is to run it in a venv
+
+## ✦ Run
+
+From the project root:
+
+`python3 -m src.main`
+
+You should get:
+```
+FISCH CHESS
+===========
+
+1. New Game (two players, offline)
+2. New Game (vs not so smart AI)
+3. Load Position (FEN)
+4. Puzzle Mode
+5. Quit
+```
+
+## moves
+
+Fisch uses coordinate notation.
+So,
+
+`e2e4` means: `e2 → e4`
+
+Knight example: `g1f3`
+
+Promotion: `e7e8q`
+
+Promotion pieces:
+
+- q  queen
+- r  rook
+- b  bishop
+- n  knight
+
+## ✦ Commands
+
+While playing:
+
+u  -  undo
+r  -  redo
+h  -  move history
+f  -  show FEN
+n  -  new game
+q  -  back to menu
+
+## ✦ Project structure
+```
+fisch-chess/
+│
+└── src/
+    ├── main.py
+    ├── engine.py
+    ├── board.py
+    ├── moves.py
+    ├── pieces.py
+    └── __init__.py
+```
+
+- main.py
+
+    Terminal UI, menus, commands, puzzles and the computer player.
+
+- engine.py
+
+    Game state, legal move filtering, checks, draws, FEN, history and move application.
+
+- board.py
+
+    Board representation, coordinates and attack detection.
+
+- moves.py
+
+    Pseudo-legal move generation for every piece.
+
+- pieces.py
+
+    Piece/color helpers.
+
+## ✦ Future plans
+V2
+```
+├── online multiplayer
+├── create / join game codes
+├── real-time moves
+├── reconnecting
+├── resignation
+└── draw offers
+```
+later
+```
+├── rematches
+├── chess clocks
+├── spectators
+├── saved games
+├── better puzzles
+├── stronger AI
+├── game history
+└── web client
+```

fisch_chess-0.1.0/README.md

@@ -0,0 +1,137 @@
+# FISCH CHESS
+
+> chess built from scratch, for the terminal.
+
+This is a lightweight chess game written in Python and played entirely inside the terminal(v1).
+
+## ✦ Features
+```
+[-] local two-player chess 
+[-] simple computer opponent 
+[-] legal move validation 
+[-] check + checkmate 
+[-] castling 
+[-] en passant 
+[-] pawn promotion 
+[-] stalemate + draw detection 
+[-] undo / redo 
+[-] move history 
+[-] FEN loading 
+[-] puzzle mode 
+```
+
+chess logic is implemented inside the project itself insetad of relying on Stockish, Lichess, Chess(dot)com or another chess library/service
+
+## ✦ Installation
+
+You need: 
+ `Python 3.11+`
+
+Clone the repo:
+
+> `git clone https://github.com/noxindeed/fisch-chess/`
+> `cd fisch-chess`
+
+Optional, but recommended is to run it in a venv
+
+## ✦ Run
+
+From the project root:
+
+`python3 -m src.main`
+
+You should get:
+```
+FISCH CHESS
+===========
+
+1. New Game (two players, offline)
+2. New Game (vs not so smart AI)
+3. Load Position (FEN)
+4. Puzzle Mode
+5. Quit
+```
+
+## moves
+
+Fisch uses coordinate notation.
+So,
+
+`e2e4` means: `e2 → e4`
+
+Knight example: `g1f3`
+
+Promotion: `e7e8q`
+
+Promotion pieces:
+
+- q  queen
+- r  rook
+- b  bishop
+- n  knight
+
+## ✦ Commands
+
+While playing:
+
+u  -  undo
+r  -  redo
+h  -  move history
+f  -  show FEN
+n  -  new game
+q  -  back to menu
+
+## ✦ Project structure
+```
+fisch-chess/
+│
+└── src/
+    ├── main.py
+    ├── engine.py
+    ├── board.py
+    ├── moves.py
+    ├── pieces.py
+    └── __init__.py
+```
+
+- main.py
+
+    Terminal UI, menus, commands, puzzles and the computer player.
+
+- engine.py
+
+    Game state, legal move filtering, checks, draws, FEN, history and move application.
+
+- board.py
+
+    Board representation, coordinates and attack detection.
+
+- moves.py
+
+    Pseudo-legal move generation for every piece.
+
+- pieces.py
+
+    Piece/color helpers.
+
+## ✦ Future plans
+V2
+```
+├── online multiplayer
+├── create / join game codes
+├── real-time moves
+├── reconnecting
+├── resignation
+└── draw offers
+```
+later
+```
+├── rematches
+├── chess clocks
+├── spectators
+├── saved games
+├── better puzzles
+├── stronger AI
+├── game history
+└── web client
+```

fisch_chess-0.1.0/fisch_chess.egg-info/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: fisch-chess
+Version: 0.1.0
+Summary: A lightweight terminal chess game written in Python.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# FISCH CHESS
+
+> chess built from scratch, for the terminal.
+
+This is a lightweight chess game written in Python and played entirely inside the terminal(v1).
+
+## ✦ Features
+```
+[-] local two-player chess 
+[-] simple computer opponent 
+[-] legal move validation 
+[-] check + checkmate 
+[-] castling 
+[-] en passant 
+[-] pawn promotion 
+[-] stalemate + draw detection 
+[-] undo / redo 
+[-] move history 
+[-] FEN loading 
+[-] puzzle mode 
+```
+
+chess logic is implemented inside the project itself insetad of relying on Stockish, Lichess, Chess(dot)com or another chess library/service
+
+## ✦ Installation
+
+You need: 
+ `Python 3.11+`
+
+Clone the repo:
+
+> `git clone https://github.com/noxindeed/fisch-chess/`
+> `cd fisch-chess`
+
+Optional, but recommended is to run it in a venv
+
+## ✦ Run
+
+From the project root:
+
+`python3 -m src.main`
+
+You should get:
+```
+FISCH CHESS
+===========
+
+1. New Game (two players, offline)
+2. New Game (vs not so smart AI)
+3. Load Position (FEN)
+4. Puzzle Mode
+5. Quit
+```
+
+## moves
+
+Fisch uses coordinate notation.
+So,
+
+`e2e4` means: `e2 → e4`
+
+Knight example: `g1f3`
+
+Promotion: `e7e8q`
+
+Promotion pieces:
+
+- q  queen
+- r  rook
+- b  bishop
+- n  knight
+
+## ✦ Commands
+
+While playing:
+
+u  -  undo
+r  -  redo
+h  -  move history
+f  -  show FEN
+n  -  new game
+q  -  back to menu
+
+## ✦ Project structure
+```
+fisch-chess/
+│
+└── src/
+    ├── main.py
+    ├── engine.py
+    ├── board.py
+    ├── moves.py
+    ├── pieces.py
+    └── __init__.py
+```
+
+- main.py
+
+    Terminal UI, menus, commands, puzzles and the computer player.
+
+- engine.py
+
+    Game state, legal move filtering, checks, draws, FEN, history and move application.
+
+- board.py
+
+    Board representation, coordinates and attack detection.
+
+- moves.py
+
+    Pseudo-legal move generation for every piece.
+
+- pieces.py
+
+    Piece/color helpers.
+
+## ✦ Future plans
+V2
+```
+├── online multiplayer
+├── create / join game codes
+├── real-time moves
+├── reconnecting
+├── resignation
+└── draw offers
+```
+later
+```
+├── rematches
+├── chess clocks
+├── spectators
+├── saved games
+├── better puzzles
+├── stronger AI
+├── game history
+└── web client
+```

fisch_chess-0.1.0/fisch_chess.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+README.md
+pyproject.toml
+fisch_chess.egg-info/PKG-INFO
+fisch_chess.egg-info/SOURCES.txt
+fisch_chess.egg-info/dependency_links.txt
+fisch_chess.egg-info/entry_points.txt
+fisch_chess.egg-info/top_level.txt
+src/__init__.py
+src/__main__.py
+src/board.py
+src/engine.py
+src/main.py
+src/moves.py
+src/pieces.py

fisch_chess-0.1.0/fisch_chess.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fisch_chess-0.1.0/fisch_chess.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fisch = src.main:main

fisch_chess-0.1.0/fisch_chess.egg-info/top_level.txt

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

fisch_chess-0.1.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fisch-chess"
+version = "0.1.0"
+description = "A lightweight terminal chess game written in Python."
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = []
+
+[project.scripts]
+fisch = "src.main:main"
+
+[tool.setuptools]
+packages = ["src"]

fisch_chess-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fisch_chess-0.1.0/src/board.py

@@ -0,0 +1,164 @@
+from .pieces import EMPTY, WHITE, BLACK, color_of, opponent
+
+STARTING_FEN = "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1"
+
+# directions and offsets for mvmt 
+KNIGHT_OFFSETS = [
+    (-2,-1), (-2,1),(-1,-2),(-1,2),(1,-2),(1,2),
+    (2,-1),(2,1),
+]
+
+KING_OFFSETS = [
+    (-1,-1),(-1,0),(-1,1),(0,-1),(0,1),(1,-1),(1,0),(1,1),
+
+]
+
+BISHOP_DIRECTIONS = [(-1,-1),(-1,1),(1,-1),(1,1)]
+ROOK_DIRECTIONS = [(-1,0),(1,0),(0,-1),(0,1)]
+
+QUEEN_DIRECTIONS = BISHOP_DIRECTIONS + ROOK_DIRECTIONS
+
+def on_board(row, col):
+    return 0 <= row < 8 and 0 <= col < 8
+
+def square_name(r,c):
+    # converts (r,c) to algebraic names 
+    return chr(ord("a")+c) + str(8-r)
+
+def parse_square(name):
+    # converts algebraic names to row,col pair
+    if len(name) != 2:
+        return None
+
+    file_ch, rank_ch = name[0], name[1]
+    if file_ch < "a" or file_ch > "h" or rank_ch < "1" or rank_ch > "8":
+        return None
+    return (8-int(rank_ch), ord(file_ch) - ord("a"))
+
+class Board:
+    def __init__(self):
+        self.grid = [[EMPTY]*8 for _ in range(8)]
+
+    def get(self, row, col):
+        return self.grid[row][col]
+
+    def set(self, row,col,piece):
+        self.grid[row][col] = piece
+
+    def find_king(self, color):
+        target = "K" if color == WHITE else "k"
+        for row in range(8):
+            for col in range(8):
+                if self.grid[row][col] == target:
+                    return (row,col)
+        return None
+
+# attack detection 
+
+    def is_square_attacked(self, row, col, by_color):
+
+        # pawns
+        pawn = "P" if by_color == WHITE else "p"
+        pawn_offset = 1 if by_color == WHITE else -1
+        for dc in (-1, 1):
+            r,c = row + pawn_offset, col+dc
+            if on_board(r, c) and self.grid[r][c] == pawn:
+                return True
+
+        # knights
+        knight = "N" if by_color == WHITE else "n"
+        for dr, dc in KNIGHT_OFFSETS:
+            r, c = row + dr, col + dc
+            if on_board(r,c) and self.grid[r][c] == knight:
+                return True 
+
+        diagonals = ("B" if by_color == WHITE else "b",
+                     "Q" if by_color == WHITE else "q")
+        straights = ("R" if by_color == WHITE else "r",
+                     "Q" if by_color == WHITE else "q")
+
+        #kings 
+        king = "K" if by_color == WHITE else "k"
+        for dr,dc in KING_OFFSETS:
+            r,c = row + dr, col + dc
+            if on_board(r,c) and self.grid[r][c] == king:
+                return True
+
+        diagonals= (
+            "B" if by_color == WHITE else "b",
+            "Q" if by_color == WHITE else "q",
+        )
+
+        straights = (
+            "R" if by_color == WHITE else "r",
+            "Q" if by_color == WHITE else "q",
+        )
+
+        if self._ray_attacks(row, col, BISHOP_DIRECTIONS, diagonals):
+            return True
+        if self._ray_attacks(row, col, ROOK_DIRECTIONS, straights):
+            return True 
+        return False
+
+    def _ray_attacks(self, row, col, directions, attackers):
+        for dr, dc in directions:
+            r,c = row+dr, col+dc
+            while on_board(r,c):
+                piece = self.grid[r][c]
+                if piece != EMPTY:
+                    if piece in attackers:
+                        return True
+                    break 
+                r += dr
+                c += dc
+        return False
+
+    # FEN
+
+    def to_fen_board(self):
+        rows = []
+        for r in range(8):
+            empty = 0
+            out = ""
+            for col in range(8):
+                piece = self.grid[r][col]
+                if piece == EMPTY:
+                    empty += 1
+                else:
+                    if empty:
+                        out += str(empty)
+                        empty = 0
+                    out += piece
+            if empty:
+                out += str(empty)
+            rows.append(out)
+        return "/".join(rows)
+
+    def load_fen_board(self, placement):
+        self.grid = [[EMPTY]*8 for _ in range(8)]
+        ranks = placement.split("/")
+
+        if len(ranks) != 8:
+            raise ValueError("FEN board must have 8 ranks")
+        for row, rank in enumerate(ranks):
+            col = 0
+            for ch in rank:
+                if ch.isdigit():
+                    col += int(ch)
+                elif ch in "PNBRQKpnbrqk":
+                    if col >= 8:
+                        raise ValueError("FEN rank too long")
+                    self.grid[row][col] = ch
+                    col += 1
+                else:
+                    raise ValueError(f"Invalid FEN character: {ch!r}")
+            if col != 8:
+                raise ValueError("FEN rank too short")
+
+
+
+        
+
+        
+
+