📄 add license headers to test files

Author: Paillat-dev

tests/test_find_util.py

@@ -1,3 +1,27 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-present Pycord Development
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
+
 import pytest
 from discord.utils import find
 

tests/test_format_dt.py

@@ -1,3 +1,27 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-present Pycord Development
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
+
 import datetime
 import random
 import pytest
@@ -28,10 +52,6 @@ def random_time():
 @pytest.mark.parametrize(("dt", "expected_ts"), DATETIME_CASES)
 @pytest.mark.parametrize("style", ALL_STYLES)
 def test_format_dt_formats_datetime(dt, expected_ts, style):
-    """
-    For each (dt, expected_ts) pair and each style,
-    format_dt should produce the correct Discord timestamp.
-    """
     if style is None:
         expected = f"<t:{expected_ts}>"
     else:
@@ -42,10 +62,6 @@ def test_format_dt_formats_datetime(dt, expected_ts, style):
 
 @pytest.mark.parametrize("style", ALL_STYLES)
 def test_format_dt_formats_time_equivalence(style):
-    """
-    For a time-only input, format_dt(time, style) should equal
-    format_dt(datetime.combine(today, time), style).
-    """
     tm = random_time()
     today = datetime.datetime.now().date()
     result_time = format_dt(tm, style=style)

tests/test_snowflake_datetime.py

@@ -1,4 +1,26 @@
-# tests/test_snowflake_utils.py
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-present Pycord Development
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
 
 import datetime
 import pytest
@@ -18,48 +40,39 @@
 
 @pytest.mark.parametrize(("dt", "expected_ms"), DATETIME_CASES)
 def test_generate_snowflake_realistic(dt, expected_ms):
-    """Realistic mode should set lower 22 bits to 0x3FFFFF."""
     sf = generate_snowflake(dt, mode="realistic")
-    # top bits are the timestamp
     assert (sf >> 22) == expected_ms
-    # lower 22 bits are all ones in realistic mode
     assert (sf & ((1 << 22) - 1)) == 0x3FFFFF
 
 
 @pytest.mark.parametrize(("dt", "expected_ms"), DATETIME_CASES)
 def test_generate_snowflake_boundary_low(dt, expected_ms):
-    """Boundary mode low should zero out lower 22 bits."""
     sf = generate_snowflake(dt, mode="boundary", high=False)
     assert (sf >> 22) == expected_ms
     assert (sf & ((1 << 22) - 1)) == 0
 
 
 @pytest.mark.parametrize(("dt", "expected_ms"), DATETIME_CASES)
 def test_generate_snowflake_boundary_high(dt, expected_ms):
-    """Boundary mode high should set lower 22 bits to max."""
     sf = generate_snowflake(dt, mode="boundary", high=True)
     assert (sf >> 22) == expected_ms
     assert (sf & ((1 << 22) - 1)) == (2**22 - 1)
 
 
 @pytest.mark.parametrize(("dt", "expected_ms"), DATETIME_CASES)
 def test_snowflake_time_roundtrip_boundary(dt, expected_ms):
-    """Converting boundary snowflake back to datetime yields the original dt."""
     sf_low = generate_snowflake(dt, mode="boundary", high=False)
     sf_high = generate_snowflake(dt, mode="boundary", high=True)
-    # snowflake_time ignores low bits, so both should map to dt
     assert snowflake_time(sf_low) == dt
     assert snowflake_time(sf_high) == dt
 
 
 @pytest.mark.parametrize(("dt", "expected_ms"), DATETIME_CASES)
 def test_snowflake_time_roundtrip_realistic(dt, expected_ms):
-    """Converting realistic snowflake back to datetime yields the original dt."""
     sf = generate_snowflake(dt, mode="realistic")
     assert snowflake_time(sf) == dt
 
 
 def test_generate_snowflake_invalid_mode():
-    """Passing an invalid mode should raise ValueError."""
     with pytest.raises(ValueError, match="Invalid mode 'nope'. Must be 'realistic' or 'boundary'"):
         generate_snowflake(datetime.datetime.now(tz=UTC), mode="nope")