Make pyproject.toml work with uv sync (#1942)

* Add uv-compatible pyproject.toml

* Mention uv in readme

* Adjust comment

* Add bash syntax highlighting

* Adjust grammar

* Add uv run to README

* Make black happy

Author: Fulmene

README.md

@@ -30,21 +30,29 @@ Your contribution will be greatly appreciated and help me continue to develop th
 
 
 ### Project setup
-```
-pip3 install -r requirements.txt --user // Install python requirements
-yarn install                            // Install node requirements
-yarn dev                                // Compile typescript files to javascript
-yarn md                                 // Compile md files to html
+```bash
+# Install python requirements
+pip3 install -r requirements.txt --user
+# Alternatively, use uv to install python requirements in a virtual env
+uv sync
+
+yarn install                            # Install node requirements
+yarn dev                                # Compile typescript files to javascript
+yarn md                                 # Compile md files to html
 ```
 
 ### Start server
-```
+```bash
 python3 server/server.py
 ```
+Or if `uv` is used
+```bash
+uv run server/server.py
+```
 
 ### Docker setup
 If you want to avoid installing dependencies (mongo, node, python) you can instead run the server locally in docker using compose. To start it, simply run:
-```
+```bash
 docker compose up --build
 ```
 This recompiles the frontend and starts the server and DB. Once it is up, you can connect to `localhost:8080` in your browser.

pyproject.toml

@@ -1,2 +1,38 @@
+[project]
+name = "pychess-variants"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "aiohttp==3.12.15",
+    "aiohttp-jinja2==1.6",
+    "aiohttp-remotes==1.3.0",
+    "aiohttp-session==2.12.1",
+    "aiohttp-sse==2.2.0",
+    "aiomonitor==0.7.1",
+    "black==25.1.0",
+    "brotli==1.1.0",
+    "cryptography==45.0.6",
+    "discord-py==2.6.2",
+    "dnspython==2.7.0",
+    "flake8==7.3.0",
+    "jinja2==3.1.6",
+    "minify-html==0.16.4",
+    "mongomock-motor==0.0.36",
+    "motor==3.7.1",
+    "mypy==1.17.1",
+    "objgraph==3.6.2",
+    "pre-commit>=4.3.0",
+    "pyffish==0.0.88",
+    "pyffish-alice==0.0.2",
+    "pymongo==4.14.1",
+    "pyopenssl==25.1.0",
+    "python-gettext==5.0",
+    "rustworkx==0.17.1",
+    "sortedcollections==2.1.0",
+    "tzdata==2025.2",
+]
+
 [tool.black]
 line-length = 100

server/bugchess/__init__.py

@@ -1594,7 +1594,7 @@ def __init__(
         fen: Optional[str] = STARTING_FEN,
         *,
         chess960: bool = False,
-        board_id: Optional[int] = None
+        board_id: Optional[int] = None,
     ) -> None:
         BaseBoard.__init__(self, None)
 
@@ -2543,7 +2543,7 @@ def chess960_pos(
         *,
         ignore_turn: bool = False,
         ignore_castling: bool = False,
-        ignore_counters: bool = True
+        ignore_counters: bool = True,
     ) -> Optional[int]:
         """
         Gets the Chess960 starting position index between 0 and 956
@@ -2648,7 +2648,7 @@ def epd(
         shredder: bool = False,
         en_passant: str = "legal",
         promoted: Optional[bool] = None,
-        **operations: Union[None, str, int, float, Move, Iterable[Move]]
+        **operations: Union[None, str, int, float, Move, Iterable[Move]],
     ) -> str:
         """
         Gets an EPD representation of the current position.

server/bugchess/converter.py

@@ -31,7 +31,7 @@ def __init__(
         columns: Optional[int] = 80,
         headers: bool = True,
         comments: bool = True,
-        variations: bool = True
+        variations: bool = True,
     ):
         self.columns = columns
         self.headers = headers

server/bugchess/engine.py

@@ -160,7 +160,7 @@ def run_in_background(
     coroutine: "Callable[[concurrent.futures.Future[T]], Coroutine[Any, Any, None]]",
     *,
     debug: bool = False,
-    _policy_lock: threading.Lock = threading.Lock()
+    _policy_lock: threading.Lock = threading.Lock(),
 ) -> T:
     """
     Runs ``coroutine(future)`` in a new event loop on a background thread.
@@ -306,7 +306,7 @@ def __init__(
         black_clock: Optional[float] = None,
         white_inc: Optional[float] = None,
         black_inc: Optional[float] = None,
-        remaining_moves: Optional[int] = None
+        remaining_moves: Optional[int] = None,
     ):
         self.time = time
         self.depth = depth
@@ -355,7 +355,7 @@ def __init__(
         info: Optional[InfoDict] = None,
         *,
         draw_offered: bool = False,
-        resigned: bool = False
+        resigned: bool = False,
     ) -> None:
         self.move = move
         self.ponder = ponder
@@ -804,7 +804,7 @@ async def play(
         info: Info = INFO_NONE,
         ponder: bool = False,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: ConfigMapping = {}
+        options: ConfigMapping = {},
     ) -> PlayResult:
         """
         Play a position.
@@ -840,7 +840,7 @@ async def analyse(
         game: object = None,
         info: Info = INFO_ALL,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: ConfigMapping = {}
+        options: ConfigMapping = {},
     ) -> Union[List[InfoDict], InfoDict]:
         """
         Analyses a position and returns a dictionary of
@@ -893,7 +893,7 @@ async def analysis(
         game: object = None,
         info: Info = INFO_ALL,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: ConfigMapping = {}
+        options: ConfigMapping = {},
     ) -> "AnalysisResult":
         """
         Starts analysing a position.
@@ -935,7 +935,7 @@ async def popen(
         *,
         setpgrp: bool = False,
         loop=None,
-        **kwargs: Any
+        **kwargs: Any,
     ) -> Tuple[asyncio.SubprocessTransport, EngineProtocolT]:
         if not isinstance(command, list):
             command = [command]
@@ -1264,7 +1264,7 @@ def _go(
         *,
         root_moves: Optional[Iterable[chess.Move]] = None,
         ponder: bool = False,
-        infinite: bool = False
+        infinite: bool = False,
     ) -> None:
         builder = ["go"]
         if ponder:
@@ -1312,7 +1312,7 @@ async def play(
         info: Info = INFO_NONE,
         ponder: bool = False,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: ConfigMapping = {}
+        options: ConfigMapping = {},
     ) -> PlayResult:
         class Command(BaseCommand[UciProtocol, PlayResult]):
             def start(self, engine: UciProtocol) -> None:
@@ -1415,7 +1415,7 @@ async def analysis(
         game: object = None,
         info: Info = INFO_ALL,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: Mapping[str, Union[str]] = {}
+        options: Mapping[str, Union[str]] = {},
     ) -> "AnalysisResult":
         class Command(BaseCommand[UciProtocol, AnalysisResult]):
             def start(self, engine: UciProtocol) -> None:
@@ -1898,7 +1898,7 @@ async def play(
         info: Info = INFO_NONE,
         ponder: bool = False,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: ConfigMapping = {}
+        options: ConfigMapping = {},
     ) -> PlayResult:
         if root_moves is not None:
             raise EngineError(
@@ -2070,7 +2070,7 @@ async def analysis(
         game: object = None,
         info: Info = INFO_ALL,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: ConfigMapping = {}
+        options: ConfigMapping = {},
     ) -> "AnalysisResult":
         if multipv is not None:
             raise EngineError("xboard engine does not support multipv")
@@ -2529,7 +2529,7 @@ def __init__(
         transport: asyncio.SubprocessTransport,
         protocol: EngineProtocol,
         *,
-        timeout: Optional[float] = 10.0
+        timeout: Optional[float] = 10.0,
     ) -> None:
         self.transport = transport
         self.protocol = protocol
@@ -2600,7 +2600,7 @@ def play(
         info: Info = INFO_NONE,
         ponder: bool = False,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: ConfigMapping = {}
+        options: ConfigMapping = {},
     ) -> PlayResult:
         with self._not_shut_down():
             coro = asyncio.wait_for(
@@ -2627,7 +2627,7 @@ def analyse(
         game: object = None,
         info: Info = INFO_ALL,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: ConfigMapping = {}
+        options: ConfigMapping = {},
     ) -> Union[InfoDict, List[InfoDict]]:
         with self._not_shut_down():
             coro = asyncio.wait_for(
@@ -2654,7 +2654,7 @@ def analysis(
         game: object = None,
         info: Info = INFO_ALL,
         root_moves: Optional[Iterable[chess.Move]] = None,
-        options: ConfigMapping = {}
+        options: ConfigMapping = {},
     ) -> "SimpleAnalysisResult":
         with self._not_shut_down():
             coro = asyncio.wait_for(
@@ -2701,7 +2701,7 @@ def popen(
         timeout: Optional[float] = 10.0,
         debug: bool = False,
         setpgrp: bool = False,
-        **popen_args: Any
+        **popen_args: Any,
     ) -> "SimpleEngine":
         async def background(future: "concurrent.futures.Future[SimpleEngine]") -> None:
             transport, protocol = await Protocol.popen(command, setpgrp=setpgrp, **popen_args)
@@ -2725,7 +2725,7 @@ def popen_uci(
         timeout: Optional[float] = 10.0,
         debug: bool = False,
         setpgrp: bool = False,
-        **popen_args: Any
+        **popen_args: Any,
     ) -> "SimpleEngine":
         """
         Spawns and initializes an UCI engine.
@@ -2743,7 +2743,7 @@ def popen_xboard(
         timeout: Optional[float] = 10.0,
         debug: bool = False,
         setpgrp: bool = False,
-        **popen_args: Any
+        **popen_args: Any,
     ) -> "SimpleEngine":
         """
         Spawns and initializes an XBoard engine.

server/bugchess/pgn.py

@@ -300,7 +300,7 @@ def add_variation(
         *,
         comment: str = "",
         starting_comment: str = "",
-        nags: Iterable[int] = ()
+        nags: Iterable[int] = (),
     ) -> "GameNode":
         """Creates a child node with the given attributes."""
         node = type(self).dangling_node()
@@ -337,7 +337,7 @@ def add_line(
         *,
         comment: str = "",
         starting_comment: str = "",
-        nags: Iterable[int] = ()
+        nags: Iterable[int] = (),
     ) -> "GameNode":
         """
         Creates a sequence of child nodes for the given list of moves.
@@ -581,7 +581,7 @@ class Headers(MutableMapping[str, str]):
     def __init__(
         self,
         data: Optional[Union[Mapping[str, str], Iterable[Tuple[str, str]]]] = None,
-        **kwargs: str
+        **kwargs: str,
     ) -> None:
         self._tag_roster = {}  # type: Dict[str, str]
         self._others = {}  # type: Dict[str, str]
@@ -1042,7 +1042,7 @@ def __init__(
         columns: Optional[int] = 80,
         headers: bool = True,
         comments: bool = True,
-        variations: bool = True
+        variations: bool = True,
     ):
         self.columns = columns
         self.headers = headers
@@ -1186,7 +1186,7 @@ def __init__(
         columns: Optional[int] = 80,
         headers: bool = True,
         comments: bool = True,
-        variations: bool = True
+        variations: bool = True,
     ):
         super().__init__(columns=columns, headers=headers, comments=comments, variations=variations)
         self.handle = handle

server/bugchess/polyglot.py

@@ -882,7 +882,7 @@ def __call__(self, board: chess.Board) -> int:
 def zobrist_hash(
     board: chess.Board,
     *,
-    _hasher: Callable[[chess.Board], int] = ZobristHasher(POLYGLOT_RANDOM_ARRAY)
+    _hasher: Callable[[chess.Board], int] = ZobristHasher(POLYGLOT_RANDOM_ARRAY),
 ) -> int:
     """
     Calculates the Polyglot Zobrist hash of the position.
@@ -993,7 +993,7 @@ def find_all(
         board: Union[chess.Board, int],
         *,
         minimum_weight: int = 1,
-        exclude_moves: Container[chess.Move] = ()
+        exclude_moves: Container[chess.Move] = (),
     ) -> Iterator[Entry]:
         """Seeks a specific position and yields corresponding entries."""
         try:
@@ -1039,7 +1039,7 @@ def find(
         board: Union[chess.Board, int],
         *,
         minimum_weight: int = 1,
-        exclude_moves: Container[chess.Move] = ()
+        exclude_moves: Container[chess.Move] = (),
     ) -> Entry:
         """
         Finds the main entry for the given position or Zobrist hash.
@@ -1068,7 +1068,7 @@ def get(
         default: Optional[Entry] = None,
         *,
         minimum_weight: int = 1,
-        exclude_moves: Container[chess.Move] = ()
+        exclude_moves: Container[chess.Move] = (),
     ) -> Optional[Entry]:
         try:
             return self.find(board, minimum_weight=minimum_weight, exclude_moves=exclude_moves)
@@ -1081,7 +1081,7 @@ def choice(
         *,
         minimum_weight: int = 1,
         exclude_moves: Container[chess.Move] = (),
-        random=random
+        random=random,
     ) -> Entry:
         """
         Uniformly selects a random entry for the given position.
@@ -1106,7 +1106,7 @@ def weighted_choice(
         board: Union[chess.Board, int],
         *,
         exclude_moves: Container[chess.Move] = (),
-        random=random
+        random=random,
     ) -> Entry:
         """
         Selects a random entry for the given position, distributed by the

server/bugchess/svg.py

@@ -265,7 +265,7 @@ def board(
     size: Optional[int] = None,
     style: Optional[str] = None,
     base_svg: Optional[ET.Element] = None,
-    add_definitions: bool = True
+    add_definitions: bool = True,
 ) -> str:
     """
     Renders a board with pieces and/or selected squares as an SVG image.

server/bugchess/syzygy.py

@@ -3531,7 +3531,7 @@ def open_tablebase(
     load_wdl: bool = True,
     load_dtz: bool = True,
     max_fds: Optional[int] = 128,
-    VariantBoard: Type[bugchess.Board] = bugchess.Board
+    VariantBoard: Type[bugchess.Board] = bugchess.Board,
 ) -> Tablebase:
     """
     Opens a collection of tables for probing. See