Sj-UdZddlmZddlmZddlmZmZmZddl Z ddl m Z m Z ddl mZdZd ed <d Zd ed <dZd ed<ddhZded<dhZded<dZded<dZded<d5dZd6d!Ze jd"#d7d$Ze jd"#d8d&Ze jd"#d9d(ZGd)d*ZGd+d,ZGd-d.ZGd/d0Z Gd1d2Z!Gd3d4Z"dS):a Unit Test Suite for FreeExile 30 Map Styles Asset Integrity & Quality. Verifies: 1. Presence of all 30 style folders under client/webapp/assets/map/styles/. 2. Presence of all 9 required textures per style: floor.png, wall.png, path.png, liquid.png, props.png, floor_normal.png, wall_normal.png, path_normal.png, liquid_normal.png. 3. Valid non-empty PNG magic header (\x89PNG\r\n\x1a\n). 4. Standard dimensions (floor/path/liquid: 64x32 or 128x64 px; wall: 128x128 px). 5. Tangent-space lighting compliance (normal maps Blue channel mean > 128.0). 6. File size efficiency: individual tile files < 60 KB, total asset folder < 10 MB. 7. Adversarial edge cases: corrupt magic, invalid dimensions, inverted normals, oversized files. ) annotations)Path)ListSetTupleN)Image ImageStat)list_available_stylessPNG  bytes PNG_MAGIC) floor.pngwall.pngpath.png liquid.png props.pngfloor_normal.pngwall_normal.pngpath_normal.pngliquid_normal.pngzTuple[str, ...]REQUIRED_ASSET_FILES)rrrrNORMAL_MAP_FILES@ )rzSet[Tuple[int, int]]VALID_TILE_DIMS)rrVALID_WALL_DIMSiintMAX_TILE_FILE_SIZE_BYTESiMAX_TOTAL_FOLDER_SIZE_BYTES file_pathrreturnboolc|r|jdkrdSt|d5}|d}dddn #1swxYwY|t kS)zKVerifies that the file exists, is non-empty, and has valid PNG magic bytes.FrbN)is_filestatst_sizeopenreadr )r!fheaders CC:\Projects\FreeExile\tests\unit\test_map_style_assets_integrity.pyverify_png_magic_headerr/5s     ).."2"2":Q">">u i  ! Y sA&&A*-A*floatctj|5}tj|}t |jdkr&t |jdcdddS dddn #1swxYwYdS)zAComputes the mean intensity of the Blue channel across the image.Ng)rr*r Statlenmeanr0)r!imgr(s r.compute_blue_channel_meanr8>s I  '#~c"" ty>>Q  1&&'''''''' ''''''''''''''' 3sAA55A9<A9module)scopeclttjjjS)zReturn repository root path.)r__file__resolveparentr. project_rootrAGs% >> ! ! # # * 1 88r@rAc$|dz dz dz dz dz S)zBReturn canonical styles directory client/webapp/assets/map/styles.clientwebappassetsmapstylesr?)rAs r. styles_rootrHMs# ( "X - 85 @8 KKr@ List[str]c|t}t|dksJdt||S)z$Retrieve all 30 canonical style IDs.zExpected 30 styles, got )r r5)rGs r.canonical_stylesrLSsB# $ $F v;;"   FVFF    Mr@c*eZdZdZd dZd d Zd d Zd S)TestMapStyleDirectoryStructurez@Validates root styles directory and all 30 style subdirectories.rHrr"Nonec|s Jd||s Jd|dS)z4Root styles directory must exist and be a directory.zStyles root does not exist: z Styles root is not a directory: N)existsis_dir)selfrHs r.!test_styles_root_directory_existsz@TestMapStyleDirectoryStructure.test_styles_root_directory_exists^sZ!!##QQ%QK%Q%QQQ#!!##UU%U %U%UUU#UUr@rLrIcBfd|D}|r Jd|dS)zAAll 30 canonical styles must have a matching lowercase directory.cfg|]-}|z +|.Sr?)lowerrR).0s_idrHs r. zYTestMapStyleDirectoryStructure.test_all_30_style_subdirectories_exist..gsH   $**,,.6688    r@zMissing style subdirectories: Nr?)rSrHrLmissings ` r.&test_all_30_style_subdirectories_existzETestMapStyleDirectoryStructure.test_all_30_style_subdirectories_existcsO    -   FFFWFFFF{FFr@cd|D}d|D}||z }|r Jd|dS)z=Only the 30 canonical style subdirectories should be present.c6h|]}|Sr?)rW)rXrYs r. z[TestMapStyleDirectoryStructure.test_no_unrecognized_style_subdirectories..qs CCC$CCCr@cDh|]}||jSr?)rRname)rXps r.r_z[TestMapStyleDirectoryStructure.test_no_unrecognized_style_subdirectories..rs7   QXXZZ F   r@z,Unexpected subdirectories in styles folder: N)iterdir)rSrHrL expected_dirs actual_dirs unexpecteds r.)test_no_unrecognized_style_subdirectorieszHTestMapStyleDirectoryStructure.test_no_unrecognized_style_subdirectoriesmsqDC2BCCC   '//11   !=0 ZZZjZZZZ~ZZr@NrHrr"rO)rHrrLrIr"rO)__name__ __module__ __qualname____doc__rTr\rgr?r@r.rNrN[sdJJVVVV GGGG [ [ [ [ [ [r@rNc eZdZdZejded dZejded d Z ejded d Z d S) $TestMapStyleFileCompletenessAndMagiczGValidates presence and PNG magic headers for all required style assets.style_idrHrstrr"rOc||z s JdfdtD}|rJ|d|dS)z;Each style folder must contain the 9 mandatory asset files.zStyle folder not found: cBg|]}|z |Sr?)r')rXfname style_dirs r.rZzaTestMapStyleFileCompletenessAndMagic.test_style_contains_all_9_required_files..s@   %..00    r@z missing required files: N)rWrRr)rSrHro missing_filesrts @r.(test_style_contains_all_9_required_fileszMTestMapStyleFileCompletenessAndMagic.test_style_contains_all_9_required_files|s  (.."2"22 !!II#Ii#I#III!    3   !WWX"W"W "W"WWW WWr@c ||z }tD]n}||z }|s Jd||jdks Jd|t |s Jd|odS)zEEvery required file must be non-empty and start with PNG magic bytes.zFile does not exist: rzFile is empty: zInvalid PNG magic in N)rWrr'r(r)r/)rSrHrortrsfpaths r.3test_style_files_have_valid_png_magic_and_non_emptyzXTestMapStyleFileCompletenessAndMagic.test_style_files_have_valid_png_magic_and_non_emptys  (.."2"22 ) S SE%E==?? C C$CE$C$C C C?::<<'!+++-Fu-F-F+++*511 R R3R53R3R R R1 R  S Sr@c2||z }tD]w}||z }tj|5}|jdksJ|d|jd|jdkr |jdks Jd| dddn #1swxYwYxdS)z@PIL must successfully decode every required file as a PNG image.PNGz format is z, expected PNGrzInvalid dimensions for N)rWrrr*formatwidthheight)rSrHrortrsrxr7s r.%test_style_files_are_decodable_by_pilzJTestMapStyleFileCompletenessAndMagic.test_style_files_are_decodable_by_pils   (.."2"22 ) [ [E%EE"" [czU***u,[,[,[,[,[***y1}}a9ZSX9Z9Z7 [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [sAB  B B NrHrrorpr"rO) rirjrkrlpytestmark parametrizer rvryrr?r@r.rnrnysQQ [Z)>)>)@)@AA X X XBA X [Z)>)>)@)@AA S S SBA S [Z)>)>)@)@AA [ [ [BA [ [ [r@rnc eZdZdZejded dZejded d Z ejded d Z d S) TestMapStyleDimensionszFValidates isometric and wall dimension contracts across all 30 styles.rorHrrpr"rOc ||z }d}|D]e}||z }tj|5}|j|jf}|t vsJ|d|d|dt  dddn #1swxYwYfdS)z@Floor, path, and liquid tiles must be either 64x32 or 128x64 px.)r rrrrr/ dimensions  not in N)rWrr*r}r~r) rSrHrort tile_filesrsrxr7dimss r.test_isometric_tile_dimensionsz5TestMapStyleDimensions.test_isometric_tile_dimensionss  (.."2"22     E%EE"" c 3:....TT%TTTTT?TT/...                 s2A66A: =A: c ||z }dD]e}||z }tj|5}|j|jf}|t vsJ|d|d|dt  dddn #1swxYwYfdS)zFWall albedo and normal maps must be 128x128 px for vertical extrusion.)rrrrrN)rWrr*r}r~r)rSrHrortrsrxr7rs r.test_wall_tile_dimensionsz0TestMapStyleDimensions.test_wall_tile_dimensionss  (.."2"22 4  E%EE"" c 3:....TT%TTTTT?TT/...                 s2A44A8 ;A8 c||z }|dz }tj|5}|jdksJ|d|jd|jdksJ|d|jd ddddS#1swxYwYdS) z;Props sheet must be a non-empty image with width >= height.rrz/props.png width z < 64rz/props.png height z < 32N)rWrr*r}r~)rSrHrort props_pathr7s r.test_props_sheet_dimensionsz2TestMapStyleDimensions.test_props_sheet_dimensionss  (.."2"22 , Z # # Vs9???x$R$R#)$R$R$R???:###%U%UCJ%U%U%U#### V V V V V V V V V V V V V V V V V VsABBBNr) rirjrkrlrrrr rrrr?r@r.rrsPP [Z)>)>)@)@AABA" [Z)>)>)@)@AA   BA  [Z)>)>)@)@AAVVVBAVVVr@rcleZdZdZejded dZd S) "TestMapStyleNormalMapsTangentSpacezEValidates tangent-space normal maps Blue channel dominance (> 128.0).rorHrrpr"rOc||z }tD]0}||z }t|}|dksJ|d|d|dd1dS)zCNormal maps must have Blue channel mean > 128 for lighting shaders.`@rz B-channel mean .2fz <= 128.0N)rWrr8)rSrHrortrsrxb_means r.'test_normal_maps_blue_channel_dominancezJTestMapStyleNormalMapsTangentSpace.test_normal_maps_blue_channel_dominances}  (.."2"22 %  E%E.u55FE>>>JJeJJVJJJJ">>>  r@Nr) rirjrkrlrrrr rr?r@r.rrsVOO [Z)>)>)@)@AA   BA   r@rcteZdZdZejded dZd d Z d S) TestMapStyleFileSizeAndBudgetzCValidates file size budgets for mobile efficiency and fast loading.rorHrrpr"rOc||z }tD]B}||z }|j}|tksJ|d|d|dz ddCdS)zBIndividual tile textures and normal maps must be strictly < 60 KB.rz size iz.1fz KB >= 60 KB budgetN)rWrr(r)r)rSrHrortrsrx size_bytess r.%test_individual_tile_files_under_60kbzCTestMapStyleFileSizeAndBudget.test_individual_tile_files_under_60kbs  (.."2"22 )  E%E-J 8888UUeUU:+<UUUU9888  r@ctd|dD}|tksJd|dz dddS)zCTotal size of all assets under map/styles must be strictly < 10 MB.c3pK|]1}||jV2dS)N)r'r(r))rXr,s r. zYTestMapStyleFileSizeAndBudget.test_total_assets_folder_size_under_10mb..sN  !"  FFHH       r@*zTotal styles size irz MB >= 10 MB budgetN)sumrglobr )rSrH total_sizes r.(test_total_assets_folder_size_under_10mbzFTestMapStyleFileSizeAndBudget.test_total_assets_folder_size_under_10mbss  &1&7&7&<&<     7777 T{!; T T T T87777r@Nrrh) rirjrkrlrrrr rrr?r@r.rrsjMM [Z)>)>)@)@AA   BA       r@rc:eZdZdZd dZd dZd dZd d Zd d Zd S)(TestMapStyleAssetAdversarialAndEdgeCaseszEAdversarial stress tests for integrity validators and error handling.tmp_pathrr"rOc\|dz }|dt|rJdS)z.Corrupted header bytes must fail verification.z corrupt.pngsNOT_A_PNG_FILE_HEADERN write_bytesr/rSr fake_files r.&test_corrupt_png_magic_header_detectedzOTestMapStyleAssetAdversarialAndEdgeCases.test_corrupt_png_magic_header_detecteds;}, 6777*95555555r@c\|dz }|dt|rJdS)z5Files with fewer than 8 bytes must fail verification.z truncated.pngsPNGNrrs r.#test_truncated_header_file_detectedzLTestMapStyleAssetAdversarialAndEdgeCases.test_truncated_header_file_detecteds:. j)))*95555555r@c2|dz }t|rJdS)z7Missing file must safely return False without crashing.z ghost.pngN)r/)rSrghosts r.test_nonexistent_file_detectedzGTestMapStyleAssetAdversarialAndEdgeCases.test_nonexistent_file_detected s&;&*51111111r@c|dz }tjddd}||dt|}|dksJdS) z9Normal map with Blue channel mean <= 128 must be flagged.zbad_normal.pngRGBr)rrKr{)r|rN)rnewsaver8)rSrbad_normr7rs r.)test_low_blue_channel_normal_map_detectedzRTestMapStyleAssetAdversarialAndEdgeCases.test_low_blue_channel_normal_map_detectedsT..ix88 %(((*844r@c6d}|tvsJ|tvsJdS)zJArbitrary dimension (e.g. 100x100) must not match tile or wall dimensions.)drN)rr)rSdims r.#test_invalid_tile_dimension_flaggedzLTestMapStyleAssetAdversarialAndEdgeCases.test_invalid_tile_dimension_flaggeds//))))/))))))r@N)rrr"rO)r"rO) rirjrkrlrrrrrr?r@r.rrs~OO6666 6666 2222 ******r@r)r!rr"r#)r!rr"r0)r"r)rArr"r)r"rI)#rl __future__rpathlibrtypingrrrrPILrr server.world.map_style_catalogr r __annotations__rrrrrr r/r8fixturerArHrLrNrnrrrrr?r@r.rs   #"""""########## @@@@@@' '''' )    %*29(=====)3 4444 )))))#33333h999 9 hLLL L h [[[[[[[[<&[&[&[&[&[&[&[&[R,V,V,V,V,V,V,V,V^"        4 * * * * * * * * * *r@