Sj-,UdZddlmZddlZddlmcmZddl m Z ddl m Z m Z mZddlZddlmZmZddlmZdZd ed <d Zd ed <dZd ed<ddhZded<dhZded<dZded<dZded<d5dZd6d!Zejd"#d7d$Z ejd"#d8d&Z!ejd"#d9d(Z"Gd)d*Z#Gd+d,Z$Gd-d.Z%Gd/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. ) annotationsN)Path)ListSetTuple)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]ct}t|}d}||k}|stjd|fd||fdt jvstjtrtjtnddt jvstj|rtj|ndtj|tj|dz}tjdt|dzd |iz}ttj |d x}x}}|S) z$Retrieve all 30 canonical style IDs.==)z0%(py3)s {%(py3)s = %(py0)s(%(py1)s) } == %(py6)sr5rG)py0py1py3py6zExpected 30 styles, got z >assert %(py8)spy8N) r r5 @pytest_ar_call_reprcompare @py_builtinslocals_should_repr_global_name _saferepr_format_assertmsgAssertionError_format_explanation)rG @py_assert2 @py_assert5 @py_assert4 @py_format7 @py_format9s r.canonical_stylesraSsO# $ $F v;;F"F;" FFFFFFFFF;"FFFFFFFFFFFF3FFFFF3FFFFFFFFFFFFFvFFFFFvFFFFFF;FFFF"FFFFFFFFFVFFFFFFFFFFFFFFFFFFFFFFFFFF Mr@c*eZdZdZd dZd d Zd d Zd S)TestMapStyleDirectoryStructurez@Validates root styles directory and all 30 style subdirectories.rHrr"Nonec|j}|}|stjd|dzdtjvstj|rtj|ndtj|tj|dz}ttj|dx}}|j }|}|stjd|dzdtjvstj|rtj|ndtj|tj|dz}ttj|dx}}dS)z4Root styles directory must exist and be a directory.zStyles root does not exist: zC >assert %(py4)s {%(py4)s = %(py2)s {%(py2)s = %(py0)s.exists }() }rHrNpy2py4Nz Styles root is not a directory: C >assert %(py4)s {%(py4)s = %(py2)s {%(py2)s = %(py0)s.is_dir }() }) existsrSrYrUrVrWrXrZr[is_dir)selfrH @py_assert1 @py_assert3 @py_format5s r.!test_styles_root_directory_existsz@TestMapStyleDirectoryStructure.test_styles_root_directory_exists^s!Q!!##Q#QQQ%QK%Q%QQQQQQQQQQQQQQ{QQQQQ{QQQQQQ!QQQQ#QQQQQQQQQQQQQQQQQQQ!U!!##U#UUU%U %U%UUUUUUUUUUUUUU{UUUUU{UUUUUU!UUUU#UUUUUUUUUUUUUUUUUUUUUr@rarIc,fd|D}| }|s}tjd|dzddtjvstj|rtj|ndiz}t tj|d}dS)zAAll 30 canonical styles must have a matching lowercase directory.cfg|]-}|z +|.Sr?)lowerrk).0s_idrHs r. zYTestMapStyleDirectoryStructure.test_all_30_style_subdirectories_exist..gsH   $**,,.6688    r@zMissing style subdirectories:  >assert not %(py0)srNmissingN)rSrYrUrVrWrXrZr[)rlrHrarxrm @py_format2s ` r.&test_all_30_style_subdirectories_existzETestMapStyleDirectoryStructure.test_all_30_style_subdirectories_existcs    -   {F{FFFFWFFFFFFFFFFFFFFFF7FFFFF7FFFFFFFFFFFFFFFFFFFFr@cld|D}d|D}||z }| }|s}tjd|dzddtjvstj|rtj|ndiz}ttj|d}dS)z=Only the 30 canonical style subdirectories should be present.c6h|]}|Sr?)rs)rtrus r. z[TestMapStyleDirectoryStructure.test_no_unrecognized_style_subdirectories..qs CCC$CCCr@cDh|]}||jSr?)rkname)rtps r.r}z[TestMapStyleDirectoryStructure.test_no_unrecognized_style_subdirectories..rs7   QXXZZ F   r@z,Unexpected subdirectories in styles folder: rwrN unexpectedN) iterdirrSrYrUrVrWrXrZr[)rlrHra expected_dirs actual_dirsrrmrys r.)test_no_unrecognized_style_subdirectorieszHTestMapStyleDirectoryStructure.test_no_unrecognized_style_subdirectoriesmsDC2BCCC   '//11   !=0 ~Z~ZZZZjZZZZZZZZZZZZZZZZ:ZZZZZ:ZZZZZZZZZZZZZZZZZZZZr@NrHrr"rd)rHrrarIr"rd)__name__ __module__ __qualname____doc__rprzrr?r@r.rcrc[sdJJVVVV GGGG [ [ [ [ [ [r@rcc eZdZdZejded dZejded d Z ejded d Z d S) $TestMapStyleFileCompletenessAndMagiczGValidates presence and PNG magic headers for all required style assets.style_idrHrstrr"rdc||z j}|}|stjddzdt jvstjrtjndtj|tj|dz}ttj |dx}}fdtD}| }|stj|d|dzd d t jvstj|rtj|nd iz}ttj |d}dS) z;Each style folder must contain the 9 mandatory asset files.zStyle folder not found: ri style_dirrfNcBg|]}|z |Sr?)r')rtfnamers r.rvzaTestMapStyleFileCompletenessAndMagic.test_style_contains_all_9_required_files..s@   %..00    r@z missing required files: rwrN missing_files) rsrkrSrYrUrVrWrXrZr[r) rlrHrrmrnrorryrs @r.(test_style_contains_all_9_required_fileszMTestMapStyleFileCompletenessAndMagic.test_style_contains_all_9_required_files|s  (.."2"22 I!!I!III#Ii#I#IIIIIIIIIIIIIIyIIIIIyIIIIIIIIII!IIIIIIIIIIIIIIIIIII    3   ! W WWWX"W"W "W"WWWWWWWWWWWWWWW=WWWWW=WWWWWWWWWWWWWWWWWWWWr@c ||z }tD]}||z }|j}|}|stjd|dzdt jvstj|rtj|ndtj|tj|dz}ttj |dx}}|j }|}|j } d} | | k} | stj d| fd| | fdt jvstj|rtj|ndtj|tj|tj| tj| d z} tjd |d zd | iz} ttj | dx}x}x} x} } t|}|stjd |dzdt jvstjtrtjtnddt jvstj|rtj|ndtj|dz}ttj |d}dS)zEEvery required file must be non-empty and start with PNG magic bytes.zFile does not exist: zD >assert %(py4)s {%(py4)s = %(py2)s {%(py2)s = %(py0)s.is_file }() }fpathrfNr>)z_%(py6)s {%(py6)s = %(py4)s {%(py4)s = %(py2)s {%(py2)s = %(py0)s.stat }() }.st_size } > %(py9)s)rNrgrhrQpy9zFile is empty: z >assert %(py11)spy11zInvalid PNG magic in z. >assert %(py3)s {%(py3)s = %(py0)s(%(py1)s) }r/rNrOrP)rsrr'rSrYrUrVrWrXrZr[r(r)rTr/)rlrHrrrrrmrnror] @py_assert8 @py_assert7 @py_format10 @py_format12r\ @py_format4s 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? C C C$CE$C$C C C C C C C C C C C C C C5 C C C C C5 C C C C C C= C C C C? C C C C C C C C C C C C C C C C C C C: F::<< F<' F! F'!+ F F F F F F F F F'! F F F F F F F F F F F F5 F F F F F5 F F F F F F: F F F F< F F F F' F F F F! F F F F F F F F-Fu-F-F F F F F F F F F F F F F F F F F F F F F F F F F F F F F*511 R1 R R R3R53R3R R R R R R R R R R R R R R* R R R R R* R R R R R R R R R R R R R5 R R R R R5 R R R R R R1 R R R R R R R R R R R R R R R R R R  S Sr@c ||z }tD]}||z }tj|5}|j}d}||k} | st jd| fd||fdtjvst j |rt j |ndt j |t j |dz} t j |d|jddzd | iz} tt j | d x}x} }g}|j} d } | | k} | }| r|j}d }||k}|}|st jd | fd | | fdtjvst j |rt j |ndt j | t j | dz} dd| iz}||| rt jd |fd||fdtjvst j |rt j |ndt j |t j |dz}dd|iz}||t j|d iz}t j d|dzd|iz}tt j |d x}x}x} x} x} x}x}}d d d n #1swxYwYd S)z@PIL must successfully decode every required file as a PNG image.PNGrL)z.%(py2)s {%(py2)s = %(py0)s.format } == %(py5)sr7rNrgpy5z format is z, expected PNG >assert %(py7)spy7Nrr)z,%(py4)s {%(py4)s = %(py2)s.width } > %(py7)s)rgrhrz%(py9)sr)z1%(py13)s {%(py13)s = %(py11)s.height } > %(py16)s)rpy13py16z%(py18)spy18zInvalid dimensions for z >assert %(py21)spy21)rsrrr*formatrSrTrUrVrWrXrYrZr[widthheightappend_format_boolop)rlrHrrrrr7rmr^rn @py_format6 @py_format8 @py_assert6r] @py_assert0 @py_assert12 @py_assert15 @py_assert14r @py_format17 @py_format19 @py_format20 @py_format22s r.%test_style_files_are_decodable_by_pilzJTestMapStyleFileCompletenessAndMagic.test_style_files_are_decodable_by_pils  (.."2"22 ) [ [E%EE"" [cz[U[zU*[[[[[[[[[zU[[[[[[[[[[[[s[[[[[s[[[[[[z[[[[U[[[[[[[[u,[,[,[,[,[[[[[[[[[[[[[[[[[[[[[[[[[ZZsyZ1Zy1}ZZZZZZaZaZZZZZZZZZZZy1ZZZZZZZZZZZZsZZZZZsZZZZZZyZZZZ1ZZZZZZZZZZZZZZZZZZZZZZZZZZZaZZZZZZZZZZZZZZZZZZZZZZZZZZZaZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ9ZSX9Z9ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [sJ1K88K< ?K< NrHrrrr"rd) rrrrpytestmark parametrizer rrrr?r@r.rrysQQ [Z)>)>)@)@AA X X XBA X [Z)>)>)@)@AA S S SBA S [Z)>)>)@)@AA [ [ [BA [ [ [r@rc eZdZdZejded dZejded d Z ejded d Z d S) TestMapStyleDimensionszFValidates isometric and wall dimension contracts across all 30 styles.rrHrrr"rdc ||z }d}|D]E}||z }tj|5}|j|jf}|t v} | st jd| fd|t fdtj vst j |rt j |nddtj vst j t rt j t nddz} t j |d|d|d t d zd | iz} tt j| d } d d d n #1swxYwYGd S) z@Floor, path, and liquid tiles must be either 64x32 or 128x64 px.)r rrrrrinz%(py0)s in %(py2)sdimsrrNrg/ dimensions  not in  >assert %(py4)srhN)rsrr*rrrrSrTrUrVrWrXrYrZr[) rlrHrr tile_filesrrr7rrm @py_format3ros r.test_isometric_tile_dimensionsz5TestMapStyleDimensions.test_isometric_tile_dimensionssU  (.."2"22     E%EE"" c 3:..t   / / TT%TTTTT?TT                 sDEE E c ||z }dD]E}||z }tj|5}|j|jf}|t v}|st jd|fd|t fdtj vst j |rt j |nddtj vst j t rt j t nddz} t j |d|d|d t d zd | iz} tt j| d }d d d n #1swxYwYGd S) zFWall albedo and normal maps must be 128x128 px for vertical extrusion.)rrrrrrrrrrrrhN)rsrr*rrrrSrTrUrVrWrXrYrZr[) rlrHrrrrr7rrmrros r.test_wall_tile_dimensionsz0TestMapStyleDimensions.test_wall_tile_dimensionssL  (.."2"22 4  E%EE"" c 3:..t   / / TT%TTTTT?TT                 sDEE E c||z }|dz }tj|5}|j}d}||k}|st jd|fd||fdt jvst j|rt j |ndt j |t j |dz} t j |d|jdd zd | iz} tt j | d x}x}}|j }d }||k}|st jd|fd ||fdt jvst j|rt j |ndt j |t j |dz} t j |d|j dd zd | iz} tt j | d x}x}}d d d d S#1swxYwYd S)z;Props sheet must be a non-empty image with width >= height.rr)>=)z-%(py2)s {%(py2)s = %(py0)s.width } >= %(py5)sr7rz/props.png width z < 64rrNr)z.%(py2)s {%(py2)s = %(py0)s.height } >= %(py5)sz/props.png height z < 32)rsrr*rrSrTrUrVrWrXrYrZr[r) rlrHrr props_pathr7rmr^rnrrs r.test_props_sheet_dimensionsz2TestMapStyleDimensions.test_props_sheet_dimensionss  (.."2"22 , Z # # Vs9 R R9? R R R R R R R R R9 R R R R R R R R R R R R3 R R R R R3 R R R R R R9 R R R R R R R R R R R Rx$R$R#)$R$R$R R R R R R R R R R R R R R R R R R R R R R R R R: U U:# U U U U U U U U U: U U U U U U U U U U U U3 U U U U U3 U U U U U U: U U U U U U U U U U U U%U%UCJ%U%U%U U U U U U U U U U U U U U U U U U U U U U U U U V V V V V V V V V V V V V V V V V VsGHHHNr) rrrrrrrr rrrr?r@r.rrsPP [Z)>)>)@)@AABA" [Z)>)>)@)@AA   BA  [Z)>)>)@)@AAVVVBAVVVr@rcleZdZdZejded dZd S) "TestMapStyleNormalMapsTangentSpacezEValidates tangent-space normal maps Blue channel dominance (> 128.0).rrHrrr"rdc ||z }tD]}||z }t|}d}||k}|stjd|fd||fdt jvstj|rtj|ndtj|dz} tj |d|d|dd d zd | iz} ttj | d x}}d S) zCNormal maps must have Blue channel mean > 128 for lighting shaders.`@r)z%(py0)s > %(py3)sb_meanrNrPrz B-channel mean .2fz <= 128.0z >assert %(py5)srN) rsrr8rSrTrUrVrWrXrYrZr[) rlrHrrrrrr\rmrrs r.'test_normal_maps_blue_channel_dominancezJTestMapStyleNormalMapsTangentSpace.test_normal_maps_blue_channel_dominances  (.."2"22 %  E%E.u55F! 6E>        6E                      "       JJeJJVJJJJ                        r@Nr) rrrrrrrr rr?r@r.rrsVOO [Z)>)>)@)@AA   BA   r@rcteZdZdZejded dZd d Z d S) TestMapStyleFileSizeAndBudgetzCValidates file size budgets for mobile efficiency and fast loading.rrHrrr"rdc ||z }tD]#}||z }|j}|tk}|st jd|fd|tfdtjvst j |rt j |nddtjvst j trt j tnddz}t j |d|d|dz d d d zd |iz} tt j | d }%d S)zBIndividual tile textures and normal maps must be strictly < 60 KB.<z%(py0)s < %(py2)s size_bytesrrrz size iz.1fz KB >= 60 KB budgetrrhN)rsrr(r)rrSrTrUrVrWrXrYrZr[) rlrHrrrrrrmrros r.%test_individual_tile_files_under_60kbzCTestMapStyleFileSizeAndBudget.test_individual_tile_files_under_60kbs  (.."2"22 )  E%E-J 88        : 8                            !9     !9         UUeUU:+<UUUU                      r@cXtd|dD}|tk}|stjd|fd|tfdt jvstj|rtj|nddt jvstjtrtjtnddz}tj d|d z d d d zd |iz}ttj |d}dS)zCTotal size of all assets under map/styles must be strictly < 10 MB.c3pK|]1}||jV2dS)N)r'r(r))rtr,s r. zYTestMapStyleFileSizeAndBudget.test_total_assets_folder_size_under_10mb..sN  !"  FFHH       r@*rr total_sizer rzTotal styles size irz MB >= 10 MB budgetrrhN) sumrglobr rSrTrUrVrWrXrYrZr[)rlrHrrmrros r.(test_total_assets_folder_size_under_10mbzFTestMapStyleFileSizeAndBudget.test_total_assets_folder_size_under_10mbs  &1&7&7&<&<     77        z7                           8    8          U{!; T T T T                     r@Nrr) rrrrrrrr 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"rdc|dz }|dt|}| }|sddtjvst jtrt jtnddtjvst j|rt j|ndt j|dz}tt j|dx}}dS)z.Corrupted header bytes must fail verification.z corrupt.pngsNOT_A_PNG_FILE_HEADER0assert not %(py3)s {%(py3)s = %(py0)s(%(py1)s) }r/ fake_filerN write_bytesr/rUrVrSrWrXrZr[rlrrr\r^ros r.&test_corrupt_png_magic_header_detectedzOTestMapStyleAssetAdversarialAndEdgeCases.test_corrupt_png_magic_header_detecteds}, 6777*9555555555555555555*55555*555555555555595555595555555555555555555555555555r@c|dz }|dt|}| }|sddtjvst jtrt jtnddtjvst j|rt j|ndt j|dz}tt j|dx}}dS)z5Files with fewer than 8 bytes must fail verification.z truncated.pngsPNGrr/rrNrrs r.#test_truncated_header_file_detectedzLTestMapStyleAssetAdversarialAndEdgeCases.test_truncated_header_file_detecteds. j)))*9555555555555555555*55555*555555555555595555595555555555555555555555555555r@c|dz }t|}| }|sddtjvstjtrtjtnddtjvstj|rtj|ndtj|dz}t tj|dx}}dS)z7Missing file must safely return False without crashing.z ghost.pngrr/ghostrN)r/rUrVrSrWrXrZr[)rlrrr\r^ros r.test_nonexistent_file_detectedzGTestMapStyleAssetAdversarialAndEdgeCases.test_nonexistent_file_detected s;&*5111111111111111111*11111*111111111111151111151111111111111111111111111111r@c|dz }tjddd}||dt|}d}||k}|st jd|fd ||fd t jvst j|rt j |nd t j |d z}d d |iz}tt j |dx}}dS)z9Normal map with Blue channel mean <= 128 must be flagged.zbad_normal.pngRGBr)rrKr)rr)<=)z%(py0)s <= %(py3)srrzassert %(py5)srN) rnewsaver8rSrTrUrVrWrXrZr[) rlrbad_normr7rr\rmrrs r.)test_low_blue_channel_normal_map_detectedzRTestMapStyleAssetAdversarialAndEdgeCases.test_low_blue_channel_normal_map_detecteds ..ix88 %(((*844vvvvr@cd}|tv}|stjd|fd|tfdtjvstj|rtj|nddtjvstjtrtjtnddz}dd|iz}ttj|d }|tv}|stjd|fd|tfdtjvstj|rtj|ndd tjvstjtrtjtnd dz}dd|iz}ttj|d }d S) zJArbitrary dimension (e.g. 100x100) must not match tile or wall dimensions.)dr)not in)z%(py0)s not in %(py2)sdimrrzassert %(py4)srhNr) rrSrTrUrVrWrXrZr[r)rlrrmrros r.#test_invalid_tile_dimension_flaggedzLTestMapStyleAssetAdversarialAndEdgeCases.test_invalid_tile_dimension_flaggeds/))))))))))s/))))))))))))s)))))s)))))))))))))/)))))/)))))))))))))))))))))))))/))))))))))s/))))))))))))s)))))s)))))))))))))/)))))/)))))))))))))))))))))))))))r@N)rrr"rd)r"rd) rrrrrrrrr r?r@r.rrs~OO6666 6666 2222 ******r@r)r!rr"r#)r!rr"r0)r"r)rArr"r)r"rI))r __future__rbuiltinsrU_pytest.assertion.rewrite assertionrewriterSpathlibrtypingrrrrPILrr server.world.map_style_catalogr r __annotations__rrrrrr r/r8fixturerArHrarcrrrrrr?r@r.rs   #"""""########## @@@@@@' '''' )    %*29(=====)3 4444 )))))#33333h999 9 hLLL L h [[[[[[[[<&[&[&[&[&[&[&[&[R,V,V,V,V,V,V,V,V^"        4 * * * * * * * * * *r@