Metadata-Version: 2.1
Name: cchess
Version: 0.80
Summary: ChineseChess library
License: GPL3
Author: walker li
Author-email: walker8088@gmail.com
Requires-Python: >=3.1,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Description-Content-Type: text/markdown

# cchess

cchess是一个Python版的中国象棋库，主要功能如下:

##棋盘显示
```
board_strs = board.text_view()
print()
for s in board_strs:
    print(s)
#or    
board.print_board()
```

##走子(内部格式), 中文显示
```
move = board.move((0,0),(0,1))
print(move.to_chinese())
```

##走子(ICCS纵线格式),中文显示
```
move = board.move_iccs('a0a1')
print(move.to_chinese())
```

##走子(中文格式,尚待完善),中文显示
```
move = board.move_chinese('车九进一')
print(move.to_chinese())
```

##产生某个棋子的合法走子
```
moves = board.create_piece_moves((0,0))
for mv in moves:
    move = board.move(*mv)
    print(move.to_chinese())
```

##产生所有合法走子
```
moves = board.create_moves()
for mv in moves:
    move = board.move(*mv)
    print(move.to_chinese())
```

##将军检测
```
board.from_fen('3k5/9/9/9/9/3R5/9/9/9/4K4 w - - 0 1') 
print(board.is_checking()) #True
```

##将死对方检测
```
print(board.is_win())      #True 
```

##走子被将军检测
```
board.from_fen('3k5/9/9/9/9/3R5/9/9/9/4K4 b - - 0 1')
mv = move.from_iccs('d9e9') 
print(board.is_checked_move(*mv)) #True
```

##被对方将死检测
```
print(board.is_dead())    #True
```

##读取xqf文件, 显示棋谱
```
#8.读取xqf文件, 显示棋谱
game = read_from_xqf("WildHouse.xqf")
game.init_board.print_board()
board_strs = game.init_board.text_view()
print()
for s in board_strs:
    print(s)
    
game.print_chinese_moves()
```

以上参见demo/demo_base.py

##加载引擎进行对弈

参见examples/end_game.py
  
cchess库使用pytest进行单元测试，使用pytest-cov进行覆盖检查，目标实现100%覆盖(目前还未完成)。

测试执行：pytest -v --cov=cchess .\tests\

