Merge pull request #9 from wszqkzqk/dev

小修改: 类型注释 & CI

.github/workflows/build-pr.yml

@@ -6,9 +6,6 @@ concurrency:
 
 on:
   pull_request:
-  push:
-    branches:
-      - dev
 
 jobs:
   windows:
@@ -18,7 +15,6 @@ jobs:
       matrix:
         python_version:
             - "3.11"
-            - "3.10"
     name: Windows Python ${{ matrix.python_version }}
     steps:
       - uses: actions/checkout@v2
@@ -78,7 +74,7 @@ jobs:
                   --include-data-file=c:\hostedtoolcache\windows\python\${{ matrix.python_version }}*\x64\lib\site-packages\pygame\libvorbisfile-3.dll=libvorbisfile-3.dll `
                   --include-data-file=c:\hostedtoolcache\windows\python\${{ matrix.python_version }}*\x64\lib\site-packages\pygame\libvorbis-0.dll=libvorbis-0.dll `
                   --windows-disable-console `
-                  -o ./out/pypvz-with-python${{ matrix.python_version }}-nuitka-windows-x64.exe `
+                  -o pypvz-with-python${{ matrix.python_version }}-nuitka-windows-x64.exe `
                   pypvz.py
 
       - name: Release the version built by nuitka
@@ -86,7 +82,7 @@ jobs:
         with:
           allowUpdates: true
           tag: Dev
-          artifacts: ./out/*nuitka*.exe
+          artifacts: ./*nuitka*.exe
           token: ${{ secrets.GITHUB_TOKEN }}
 
 
@@ -96,7 +92,6 @@ jobs:
       fail-fast: false
       matrix:
         python_version:
-            - "3.10"
             - "3.11"
     name: Ubuntu Python ${{ matrix.python_version }}
     steps:

.github/workflows/build.yml

@@ -17,7 +17,6 @@ jobs:
       matrix:
         python_version:
             - "3.11"
-            - "3.10"
     name: Windows Python ${{ matrix.python_version }}
     steps:
       - uses: actions/checkout@v2
@@ -77,7 +76,7 @@ jobs:
                   --include-data-file=c:\hostedtoolcache\windows\python\${{ matrix.python_version }}*\x64\lib\site-packages\pygame\libvorbisfile-3.dll=libvorbisfile-3.dll `
                   --include-data-file=c:\hostedtoolcache\windows\python\${{ matrix.python_version }}*\x64\lib\site-packages\pygame\libvorbis-0.dll=libvorbis-0.dll `
                   --windows-disable-console `
-                  -o ./out/pypvz-with-python${{ matrix.python_version }}-nuitka-windows-x64.exe `
+                  -o pypvz-with-python${{ matrix.python_version }}-nuitka-windows-x64.exe `
                   pypvz.py
 
 
@@ -86,7 +85,7 @@ jobs:
         with:
           allowUpdates: true
           tag: Latest
-          artifacts: ./out/*nuitka*.exe
+          artifacts: ./*nuitka*.exe
           token: ${{ secrets.GITHUB_TOKEN }}
 
   linux:
@@ -95,7 +94,6 @@ jobs:
       fail-fast: false
       matrix:
         python_version:
-            - "3.10"
             - "3.11"
     name: Ubuntu Python ${{ matrix.python_version }}
     steps:

README.md

@@ -295,29 +295,29 @@ pyinstaller -F pypvz.py `
 
 ## 截屏
 
-![截屏1](/demo/demo1.webp)
-![截屏2](/demo/demo2.webp)
-![截屏3](/demo/demo3.webp)
-![截屏4](/demo/demo4.webp)
-![截屏5](/demo/demo5.webp)
-![截屏6](/demo/demo6.webp)
-![截屏7](/demo/demo7.webp)
-![截屏8](/demo/demo8.webp)
-![截屏9](/demo/demo9.webp)
-![截屏10](/demo/demo10.webp)
-![截屏11](/demo/demo11.webp)
-![截屏12](/demo/demo12.webp)
-![截屏13](/demo/demo13.webp)
-![截屏14](/demo/demo14.webp)
-![截屏15](/demo/demo15.webp)
-![截屏16](/demo/demo16.webp)
-![截屏17](/demo/demo17.webp)
-![截屏18](/demo/demo18.webp)
-![截屏19](/demo/demo19.webp)
-![截屏20](/demo/demo20.webp)
-![截屏21](/demo/demo21.webp)
-![截屏22](/demo/demo22.webp)
-![截屏23](/demo/demo23.webp)
+![截屏1](/screenshots/screenshot-1.webp)
+![截屏2](/screenshots/screenshot-2.webp)
+![截屏3](/screenshots/screenshot-3.webp)
+![截屏4](/screenshots/screenshot-4.webp)
+![截屏5](/screenshots/screenshot-5.webp)
+![截屏6](/screenshots/screenshot-6.webp)
+![截屏7](/screenshots/screenshot-7.webp)
+![截屏8](/screenshots/screenshot-8.webp)
+![截屏9](/screenshots/screenshot-9.webp)
+![截屏10](/screenshots/screenshot-10.webp)
+![截屏11](/screenshots/screenshot-11.webp)
+![截屏12](/screenshots/screenshot-12.webp)
+![截屏13](/screenshots/screenshot-13.webp)
+![截屏14](/screenshots/screenshot-14.webp)
+![截屏15](/screenshots/screenshot-15.webp)
+![截屏16](/screenshots/screenshot-16.webp)
+![截屏17](/screenshots/screenshot-17.webp)
+![截屏18](/screenshots/screenshot-18.webp)
+![截屏19](/screenshots/screenshot-19.webp)
+![截屏20](/screenshots/screenshot-20.webp)
+![截屏21](/screenshots/screenshot-21.webp)
+![截屏22](/screenshots/screenshot-22.webp)
+![截屏23](/screenshots/screenshot-23.webp)
 
 ## 关于日志与反馈
 

source/component/map.py

@@ -3,7 +3,7 @@ from .. import constants as c
 
 # 记录植物种植情况的地图管理工具
 class Map():
-    def __init__(self, background_type):
+    def __init__(self, background_type:int):
         self.background_type = background_type
         # 注意：从0开始编号
         if self.background_type in c.POOL_EQUIPPED_BACKGROUNDS:
@@ -55,7 +55,7 @@ class Map():
                         for y in range(self.height)
                         ]
 
-    def isValid(self, map_x, map_y):
+    def isValid(self, map_x:int, map_y:int) -> bool:
         if ((0 <= map_x < self.width)
         and (0 <= map_y < self.height)):
             return True
@@ -64,13 +64,13 @@ class Map():
     # 地图单元格状态
     # 注意是可变对象，不能直接引用
     # 由于同一格显然不可能种两个相同的植物，所以用集合
-    def initMapGrid(self, plot_type):
+    def initMapGrid(self, plot_type:str) -> set:
         return {c.MAP_PLANT:set(), c.MAP_SLEEP:False, c.MAP_PLOT_TYPE:plot_type}
 
     # 判断位置是否可用
     # 暂时没有写紫卡植物的判断方法
     # 由于紫卡植物需要移除以前的植物，所以可用另外定义一个函数
-    def isAvailable(self, map_x, map_y, plant_name):
+    def isAvailable(self, map_x:int, map_y:int, plant_name:str) -> bool:
         # 咖啡豆和墓碑吞噬者的判别最为特殊
         if plant_name == c.COFFEEBEAN:
             if (self.map[map_y][map_x][c.MAP_SLEEP]
@@ -147,7 +147,7 @@ class Map():
         else:   # 不可种植区域
             return False
     
-    def getMapIndex(self, x, y):
+    def getMapIndex(self, x:int, y:int) -> tuple[int, int]:
         if self.background_type in c.POOL_EQUIPPED_BACKGROUNDS:
             x -= c.MAP_POOL_OFFSET_X
             y -= c.MAP_POOL_OFFSET_Y
@@ -166,7 +166,7 @@ class Map():
             y -= c.MAP_OFFSET_Y
             return (x // c.GRID_X_SIZE, y // c.GRID_Y_SIZE)
     
-    def getMapGridPos(self, map_x, map_y):
+    def getMapGridPos(self, map_x:int, map_y:int) -> tuple[int, int]:
         if self.background_type in c.POOL_EQUIPPED_BACKGROUNDS:
             return (map_x * c.GRID_POOL_X_SIZE + c.GRID_POOL_X_SIZE//2 + c.MAP_POOL_OFFSET_X,
                     map_y * c.GRID_POOL_Y_SIZE + c.GRID_POOL_Y_SIZE//5 * 3 + c.MAP_POOL_OFFSET_Y)
@@ -177,30 +177,28 @@ class Map():
             return (map_x * c.GRID_X_SIZE + c.GRID_X_SIZE//2 + c.MAP_OFFSET_X,
                     map_y * c.GRID_Y_SIZE + c.GRID_Y_SIZE//5 * 3 + c.MAP_OFFSET_Y)
     
-    def setMapGridType(self, map_x, map_y, plot_type):
+    def setMapGridType(self, map_x:int, map_y:int, plot_type:str):
         self.map[map_y][map_x][c.MAP_PLOT_TYPE] = plot_type
 
-    def addMapPlant(self, map_x, map_y, plant_name, sleep=False):
+    def addMapPlant(self, map_x:int, map_y:int, plant_name:int, sleep:bool=False):
         self.map[map_y][map_x][c.MAP_PLANT].add(plant_name)
         self.map[map_y][map_x][c.MAP_SLEEP] = sleep
     
-    def removeMapPlant(self, map_x, map_y, plant_name):
+    def removeMapPlant(self, map_x:int, map_y:int, plant_name:str):
         self.map[map_y][map_x][c.MAP_PLANT].discard(plant_name)
 
-    def getRandomMapIndex(self):
+    def getRandomMapIndex(self) -> tuple[int, int]:
         map_x = random.randint(0, self.width-1)
         map_y = random.randint(0, self.height-1)
         return (map_x, map_y)
 
-    def checkPlantToSeed(self, x, y, plant_name):
+    def checkPlantToSeed(self, x:int, y:int, plant_name:str) -> tuple[int, int]:
         pos = None
         map_x, map_y = self.getMapIndex(x, y)
         if self.isValid(map_x, map_y) and self.isAvailable(map_x, map_y, plant_name):
             pos = self.getMapGridPos(map_x, map_y)
         return pos
 
-
-
 # 保存具体关卡地图信息常数
 # 冒险模式地图
 LEVEL_MAP_DATA = (
@@ -211,7 +209,7 @@ LEVEL_MAP_DATA = (
     c.INIT_SUN_NAME:    5000,
     c.SHOVEL:           1,
     c.SPAWN_ZOMBIES:    c.SPAWN_ZOMBIES_LIST,
-    c.ZOMBIE_LIST:[
+    c.ZOMBIE_LIST:(
         {"time":0, "map_y":5, "name":"Zomboni"},
         {"time":1000, "map_y":4, "name":"ScreenDoorZombie"},
         {"time":2000, "map_y":4, "name":"ScreenDoorZombie"},
@@ -227,7 +225,7 @@ LEVEL_MAP_DATA = (
         {"time":0, "map_y":3, "name":"ConeheadDuckyTubeZombie"},
         {"time":0, "map_y":2, "name":"SnorkelZombie"},
         {"time":90000, "map_y":2, "name":"ConeheadDuckyTubeZombie"}
-    ]
+    )
 },
 # 第1关：单行草皮
 {

source/component/plant.py

@@ -5,7 +5,7 @@ from .. import constants as c
 
 
 class Car(pg.sprite.Sprite):
-    def __init__(self, x, y, map_y):
+    def __init__(self, x:int, y:int, map_y:int):
         pg.sprite.Sprite.__init__(self)
 
         rect = tool.GFX[c.CAR].get_rect()
@@ -19,7 +19,7 @@ class Car(pg.sprite.Sprite):
         self.state = c.IDLE
         self.dead = False
 
-    def update(self, game_info):
+    def update(self, game_info:dict):
         self.current_time = game_info[c.CURRENT_TIME]
         if self.state == c.WALK:
             self.rect.x += 5
@@ -37,9 +37,9 @@ class Car(pg.sprite.Sprite):
 
 # 豌豆及孢子类普通子弹
 class Bullet(pg.sprite.Sprite):
-    def __init__(   self, x, start_y, dest_y, name, damage,
-                    effect=None, passed_torchwood_x=None,
-                    damage_type=c.ZOMBIE_DEAFULT_DAMAGE):
+    def __init__(   self, x:int, start_y:int, dest_y:int, name:str, damage:int,
+                    effect:str=None, passed_torchwood_x:int=None,
+                    damage_type:str=c.ZOMBIE_DEAFULT_DAMAGE):
         pg.sprite.Sprite.__init__(self)
 
         self.name = name

source/state/mainmenu.py

@@ -8,7 +8,7 @@ class Menu(tool.State):
     def __init__(self):
         tool.State.__init__(self)
     
-    def startup(self, current_time, persist):
+    def startup(self, current_time:int, persist):
         self.next = c.LEVEL
         self.persist = persist
         self.game_info = persist
@@ -88,7 +88,7 @@ class Menu(tool.State):
         self.adventure_clicked = False
         self.option_button_clicked = False
 
-    def checkHilight(self, x, y):
+    def checkHilight(self, x:int, y:int):
         # 高亮冒险模式按钮
         if self.inArea(self.adventure_rect, x, y):
             self.adventure_highlight_time = self.current_time
@@ -112,7 +112,7 @@ class Menu(tool.State):
         self.littleGame_image = self.chooseHilightImage(self.littleGame_highlight_time, self.littleGame_frames)
         self.help_image = self.chooseHilightImage(self.help_hilight_time, self.help_frames)
 
-    def chooseHilightImage(self, hilightTime, frames):
+    def chooseHilightImage(self, hilightTime:int, frames):
         if (self.current_time - hilightTime) < 80:
             index= 1
         else:
@@ -206,7 +206,7 @@ class Menu(tool.State):
             self.sunflower_trophy_rect.y = 280
             self.sunflower_trophy_show_info_time = 0
 
-    def checkSunflowerTrophyInfo(self, surface, x, y):
+    def checkSunflowerTrophyInfo(self, surface:pg.Surface, x:int, y:int):
         if self.inArea(self.sunflower_trophy_rect, x, y):
             self.sunflower_trophy_show_info_time = self.current_time
         if (self.current_time - self.sunflower_trophy_show_info_time) < 80:
@@ -228,7 +228,7 @@ class Menu(tool.State):
         # 播放点击音效
         c.SOUND_BUTTON_CLICK.play()
 
-    def showCurrentVolumeImage(self, surface):
+    def showCurrentVolumeImage(self, surface:pg.Surface):
         # 由于音量可变，因此这一内容不能在一开始就结束加载，而应当不断刷新不断显示
         font = pg.font.Font(c.FONT_PATH, 30)
         volume_tips = font.render(f"音量：{round(self.game_info[c.SOUND_VOLUME]*100):3}%", True, c.LIGHTGRAY)
@@ -237,7 +237,7 @@ class Menu(tool.State):
         volume_tips_rect.y = 247
         surface.blit(volume_tips, volume_tips_rect)
 
-    def update(self, surface, current_time, mouse_pos, mouse_click):
+    def update(self, surface:pg.Surface, current_time:int, mouse_pos:list, mouse_click):
         self.current_time = self.game_info[c.CURRENT_TIME] = current_time
         
         surface.blit(self.bg_image, self.bg_rect)

source/tool.py

@@ -18,7 +18,7 @@ class State():
 
     # 当从其他状态进入这个状态时，需要进行的初始化操作
     @abstractmethod
-    def startup(self, current_time, persist):
+    def startup(self, current_time:int, persist:dict):
         # 前面加了@abstractmethod表示抽象基类中必须要重新定义的method（method是对象和函数的结合）
         pass
     # 当从这个状态退出时，需要进行的清除操作
@@ -27,12 +27,12 @@ class State():
         return self.persist
     # 在这个状态运行时进行的更新操作
     @abstractmethod
-    def update(self, surface, keys, current_time):
+    def update(self, surface:pg.Surface, keys, current_time:int):
         # 前面加了@abstractmethod表示抽象基类中必须要重新定义的method
         pass
 
     # 工具：范围判断函数，用于判断点击
-    def inArea(self, rect, x, y):
+    def inArea(self, rect:pg.Rect, x:int, y:int):
         if (rect.x <= x <= rect.right and
             rect.y <= y <= rect.bottom):
             return True
@@ -101,7 +101,7 @@ class Control():
             f.write(savedata)
         self.game_info = c.INIT_USERDATA.copy() # 内部全是不可变对象，浅拷贝即可
 
-    def setup_states(self, state_dict, start_state):
+    def setup_states(self, state_dict:dict, start_state):
         self.state_dict = state_dict
         self.state_name = start_state
         self.state = self.state_dict[self.state_name]
@@ -155,7 +155,8 @@ class Control():
             pg.display.update()
             self.clock.tick(self.fps)
 
-def get_image(sheet, x, y, width, height, colorkey=c.BLACK, scale=1):
+def get_image(  sheet:pg.Surface, x:int, y:int, width:int, height:int,
+                colorkey:tuple[int]=c.BLACK, scale:int=1) -> pg.Surface:
         # 不保留alpha通道的图片导入
         image = pg.Surface([width, height])
         rect = image.get_rect()
@@ -168,19 +169,21 @@ def get_image(sheet, x, y, width, height, colorkey=c.BLACK, scale=1):
                                     int(rect.height*scale)))
         return image
 
-def get_image_alpha(sheet, x, y, width, height, colorkey=c.BLACK, scale=1):
-        # 保留alpha通道的图片导入
-        image = pg.Surface([width, height], SRCALPHA)
-        rect = image.get_rect()
+def get_image_alpha(sheet:pg.Surface, x:int, y:int, width:int, height:int,
+                    colorkey:tuple[int]=c.BLACK, scale:int=1) -> pg.Surface:
+    # 保留alpha通道的图片导入
+    image = pg.Surface([width, height], SRCALPHA)
+    rect = image.get_rect()
 
-        image.blit(sheet, (0, 0), (x, y, width, height))
-        image.set_colorkey(colorkey)
-        image = pg.transform.scale(image,
-                                   (int(rect.width*scale),
-                                    int(rect.height*scale)))
-        return image  
+    image.blit(sheet, (0, 0), (x, y, width, height))
+    image.set_colorkey(colorkey)
+    image = pg.transform.scale(image,
+                                (int(rect.width*scale),
+                                int(rect.height*scale)))
+    return image  
         
-def load_image_frames(directory, image_name, colorkey, accept):
+def load_image_frames(  directory:str, image_name:str,
+                        colorkey:tuple[int], accept:tuple[str]) -> list[pg.Surface]:
     frame_list = []
     tmp = {}
     # image_name is "Peashooter", pic name is "Peashooter_1", get the index 1
@@ -204,7 +207,8 @@ def load_image_frames(directory, image_name, colorkey, accept):
     return frame_list
 
 # colorkeys 是设置图像中的某个颜色值为透明,这里用来消除白边
-def load_all_gfx(directory, colorkey=c.WHITE, accept=(".png", ".jpg", ".bmp", ".gif", ".webp")):
+def load_all_gfx(   directory:str, colorkey:tuple[int]=c.WHITE,
+                    accept:tuple[str]=(".png", ".jpg", ".bmp", ".gif", ".webp")) -> dict[str:pg.Surface]:
     graphics = {}
     for name1 in os.listdir(directory):
         # subfolders under the folder resources\graphics