Nuitka-winsvc 1.8__cp311-cp311-win_amd64.whl → 2.5.1__cp311-cp311-win_amd64.whl

nuitka/build/static_src/HelpersChecksumTools.c

@@ -1,29 +1,19 @@
-//     Copyright 2023, Kay Hayen, mailto:kay.hayen@gmail.com
-//
-//     Part of "Nuitka", an optimizing Python compiler that is compatible and
-//     integrates with CPython, but also works on its own.
-//
-//     Licensed under the Apache License, Version 2.0 (the "License");
-//     you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
-//
-//        http://www.apache.org/licenses/LICENSE-2.0
-//
-//     Unless required by applicable law or agreed to in writing, software
-//     distributed under the License is distributed on an "AS IS" BASIS,
-//     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-//     See the License for the specific language governing permissions and
-//     limitations under the License.
-//
+//     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
 // This file is included from another C file, help IDEs to still parse it on
 // its own.
 #ifdef __IDE_ONLY__
 #include "nuitka/prelude.h"
 #endif
 
-uint32_t initCRC32(void) { return 0xFFFFFFFF; }
+// Comment in to disable outside zlib usage for code size, very slow though,
+// since it doesn't use assembly to use CPU crc32 instructions.
+// #define _NUITKA_USE_OWN_CRC32
+
+#ifdef _NUITKA_USE_OWN_CRC32
+uint32_t _initCRC32(void) { return 0xFFFFFFFF; }
 
-uint32_t updateCRC32(uint32_t crc, unsigned char const *message, uint32_t size) {
+uint32_t _updateCRC32(uint32_t crc, unsigned char const *message, uint32_t size) {
     for (uint32_t i = 0; i < size; i++) {
         unsigned int c = message[i];
         crc = crc ^ c;
@@ -37,9 +27,33 @@ uint32_t updateCRC32(uint32_t crc, unsigned char const *message, uint32_t size)
     return crc;
 }
 
-uint32_t finalizeCRC32(uint32_t crc) { return ~crc; }
+uint32_t _finalizeCRC32(uint32_t crc) { return ~crc; }
 
 // No Python runtime is available yet, need to do this in C.
 uint32_t calcCRC32(unsigned char const *message, uint32_t size) {
-    return finalizeCRC32(updateCRC32(initCRC32(), message, size));
+    return _finalizeCRC32(_updateCRC32(_initCRC32(), message, size));
 }
+#else
+
+#ifdef _NUITKA_USE_SYSTEM_CRC32
+#include "zlib.h"
+#else
+#include "crc32.c"
+#endif
+
+uint32_t calcCRC32(unsigned char const *message, uint32_t size) { return crc32(0, message, size) & 0xFFFFFFFF; }
+#endif
+//     Part of "Nuitka", an optimizing Python compiler that is compatible and
+//     integrates with CPython, but also works on its own.
+//
+//     Licensed under the Apache License, Version 2.0 (the "License");
+//     you may not use this file except in compliance with the License.
+//     You may obtain a copy of the License at
+//
+//        http://www.apache.org/licenses/LICENSE-2.0
+//
+//     Unless required by applicable law or agreed to in writing, software
+//     distributed under the License is distributed on an "AS IS" BASIS,
+//     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//     See the License for the specific language governing permissions and
+//     limitations under the License.

nuitka/build/static_src/HelpersClasses.c

@@ -1,20 +1,5 @@
-//     Copyright 2023, Kay Hayen, mailto:kay.hayen@gmail.com
-//
-//     Part of "Nuitka", an optimizing Python compiler that is compatible and
-//     integrates with CPython, but also works on its own.
-//
-//     Licensed under the Apache License, Version 2.0 (the "License");
-//     you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
-//
-//        http://www.apache.org/licenses/LICENSE-2.0
-//
-//     Unless required by applicable law or agreed to in writing, software
-//     distributed under the License is distributed on an "AS IS" BASIS,
-//     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-//     See the License for the specific language governing permissions and
-//     limitations under the License.
-//
+//     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
 /** For creating classes.
  *
  * Currently only the Python3 meta class selection is here, but more will be
@@ -89,3 +74,18 @@ PyObject *SELECT_METACLASS(PyThreadState *tstate, PyObject *metaclass, PyObject
     }
 }
 #endif
+
+//     Part of "Nuitka", an optimizing Python compiler that is compatible and
+//     integrates with CPython, but also works on its own.
+//
+//     Licensed under the Apache License, Version 2.0 (the "License");
+//     you may not use this file except in compliance with the License.
+//     You may obtain a copy of the License at
+//
+//        http://www.apache.org/licenses/LICENSE-2.0
+//
+//     Unless required by applicable law or agreed to in writing, software
+//     distributed under the License is distributed on an "AS IS" BASIS,
+//     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//     See the License for the specific language governing permissions and
+//     limitations under the License.

nuitka/build/static_src/HelpersComparisonDualEq.c

@@ -0,0 +1,183 @@
+//     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+/* WARNING, this code is GENERATED. Modify the template HelperOperationComparisonDual.c.j2 instead! */
+
+/* This file is included from another C file, help IDEs to still parse it on its own. */
+#ifdef __IDE_ONLY__
+#include "nuitka/prelude.h"
+#endif
+
+/* C helpers for type specialized "==" (EQ) comparisons */
+
+static PyObject *COMPARE_EQ_OBJECT_CLONG_CLONG(long operand1, long operand2) {
+
+    const long a = operand1;
+    const long b = operand2;
+
+    bool r = a == b;
+
+    // Convert to target type.
+    PyObject *result = BOOL_FROM(r);
+    Py_INCREF_IMMORTAL(result);
+    return result;
+}
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "NILONG" to Nuitka int/long/C long value.
+ */
+PyObject *RICH_COMPARE_EQ_OBJECT_NILONG_NILONG(nuitka_ilong *operand1, nuitka_ilong *operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+    CHECK_NILONG_OBJECT(operand2);
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = IS_NILONG_C_VALUE_VALID(operand2);
+
+    if (left_c_usable && right_c_usable) {
+        return COMPARE_EQ_OBJECT_CLONG_CLONG(operand1->c_value, operand2->c_value);
+    } else if (!left_c_usable && !right_c_usable) {
+        return RICH_COMPARE_EQ_OBJECT_LONG_LONG(operand1->python_value, operand2->python_value);
+    } else {
+        bool r;
+        if (left_c_usable) {
+            r = COMPARE_EQ_CBOOL_LONG_CLONG(operand2->python_value, operand1->c_value);
+            r = !r;
+        } else {
+            r = COMPARE_EQ_CBOOL_LONG_CLONG(operand1->python_value, operand2->c_value);
+        }
+
+        // Convert to target type.
+        PyObject *result = BOOL_FROM(r);
+        Py_INCREF_IMMORTAL(result);
+        return result;
+    }
+}
+
+static bool COMPARE_EQ_CBOOL_CLONG_CLONG(long operand1, long operand2) {
+
+    const long a = operand1;
+    const long b = operand2;
+
+    bool r = a == b;
+
+    // Convert to target type.
+    bool result = r;
+
+    return result;
+}
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "NILONG" to Nuitka int/long/C long value.
+ */
+bool RICH_COMPARE_EQ_CBOOL_NILONG_NILONG(nuitka_ilong *operand1, nuitka_ilong *operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+    CHECK_NILONG_OBJECT(operand2);
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = IS_NILONG_C_VALUE_VALID(operand2);
+
+    if (left_c_usable && right_c_usable) {
+        return COMPARE_EQ_CBOOL_CLONG_CLONG(operand1->c_value, operand2->c_value);
+    } else if (!left_c_usable && !right_c_usable) {
+        return RICH_COMPARE_EQ_CBOOL_LONG_LONG(operand1->python_value, operand2->python_value);
+    } else {
+        bool r;
+        if (left_c_usable) {
+            r = COMPARE_EQ_CBOOL_LONG_CLONG(operand2->python_value, operand1->c_value);
+            r = !r;
+        } else {
+            r = COMPARE_EQ_CBOOL_LONG_CLONG(operand1->python_value, operand2->c_value);
+        }
+
+        // Convert to target type.
+        bool result = r;
+
+        return result;
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "CLONG" to C platform long value. */
+PyObject *RICH_COMPARE_EQ_OBJECT_NILONG_CLONG(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        return COMPARE_EQ_OBJECT_CLONG_CLONG(operand1->c_value, operand2);
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_EQ_OBJECT_LONG_CLONG(operand1->python_value, operand2);
+    } else {
+        return COMPARE_EQ_OBJECT_LONG_CLONG(operand1->python_value, operand2);
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "CLONG" to C platform long value. */
+bool RICH_COMPARE_EQ_CBOOL_NILONG_CLONG(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        return COMPARE_EQ_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_EQ_CBOOL_LONG_CLONG(operand1->python_value, operand2);
+    } else {
+        return COMPARE_EQ_CBOOL_LONG_CLONG(operand1->python_value, operand2);
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "DIGIT" to C platform digit value for long
+ * Python objects. */
+PyObject *RICH_COMPARE_EQ_OBJECT_NILONG_DIGIT(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+    assert(Py_ABS(operand2) < (1 << PyLong_SHIFT));
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        return COMPARE_EQ_OBJECT_CLONG_CLONG(operand1->c_value, operand2);
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_EQ_OBJECT_LONG_DIGIT(operand1->python_value, operand2);
+    } else {
+        return COMPARE_EQ_OBJECT_LONG_DIGIT(operand1->python_value, operand2);
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "DIGIT" to C platform digit value for long
+ * Python objects. */
+bool RICH_COMPARE_EQ_CBOOL_NILONG_DIGIT(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+    assert(Py_ABS(operand2) < (1 << PyLong_SHIFT));
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        return COMPARE_EQ_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_EQ_CBOOL_LONG_DIGIT(operand1->python_value, operand2);
+    } else {
+        return COMPARE_EQ_CBOOL_LONG_DIGIT(operand1->python_value, operand2);
+    }
+}
+
+//     Part of "Nuitka", an optimizing Python compiler that is compatible and
+//     integrates with CPython, but also works on its own.
+//
+//     Licensed under the Apache License, Version 2.0 (the "License");
+//     you may not use this file except in compliance with the License.
+//     You may obtain a copy of the License at
+//
+//        http://www.apache.org/licenses/LICENSE-2.0
+//
+//     Unless required by applicable law or agreed to in writing, software
+//     distributed under the License is distributed on an "AS IS" BASIS,
+//     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//     See the License for the specific language governing permissions and
+//     limitations under the License.

nuitka/build/static_src/HelpersComparisonDualGe.c

@@ -0,0 +1,121 @@
+//     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+/* WARNING, this code is GENERATED. Modify the template HelperOperationComparisonDual.c.j2 instead! */
+
+/* This file is included from another C file, help IDEs to still parse it on its own. */
+#ifdef __IDE_ONLY__
+#include "nuitka/prelude.h"
+#endif
+
+/* C helpers for type specialized ">=" (GE) comparisons */
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "CLONG" to C platform long value. */
+PyObject *RICH_COMPARE_GE_OBJECT_NILONG_CLONG(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        bool r = COMPARE_LT_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+
+        // Convert to target type.
+        PyObject *result = BOOL_FROM(!r);
+        Py_INCREF_IMMORTAL(result);
+        return result;
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_GE_OBJECT_LONG_CLONG(operand1->python_value, operand2);
+    } else {
+        return COMPARE_GE_OBJECT_LONG_CLONG(operand1->python_value, operand2);
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "CLONG" to C platform long value. */
+bool RICH_COMPARE_GE_CBOOL_NILONG_CLONG(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        bool r = COMPARE_LT_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+
+        // Convert to target type.
+        bool result = !r;
+
+        return result;
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_GE_CBOOL_LONG_CLONG(operand1->python_value, operand2);
+    } else {
+        return COMPARE_GE_CBOOL_LONG_CLONG(operand1->python_value, operand2);
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "DIGIT" to C platform digit value for long
+ * Python objects. */
+PyObject *RICH_COMPARE_GE_OBJECT_NILONG_DIGIT(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+    assert(Py_ABS(operand2) < (1 << PyLong_SHIFT));
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        bool r = COMPARE_LT_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+
+        // Convert to target type.
+        PyObject *result = BOOL_FROM(!r);
+        Py_INCREF_IMMORTAL(result);
+        return result;
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_GE_OBJECT_LONG_DIGIT(operand1->python_value, operand2);
+    } else {
+        return COMPARE_GE_OBJECT_LONG_DIGIT(operand1->python_value, operand2);
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "DIGIT" to C platform digit value for long
+ * Python objects. */
+bool RICH_COMPARE_GE_CBOOL_NILONG_DIGIT(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+    assert(Py_ABS(operand2) < (1 << PyLong_SHIFT));
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        bool r = COMPARE_LT_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+
+        // Convert to target type.
+        bool result = !r;
+
+        return result;
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_GE_CBOOL_LONG_DIGIT(operand1->python_value, operand2);
+    } else {
+        return COMPARE_GE_CBOOL_LONG_DIGIT(operand1->python_value, operand2);
+    }
+}
+
+//     Part of "Nuitka", an optimizing Python compiler that is compatible and
+//     integrates with CPython, but also works on its own.
+//
+//     Licensed under the Apache License, Version 2.0 (the "License");
+//     you may not use this file except in compliance with the License.
+//     You may obtain a copy of the License at
+//
+//        http://www.apache.org/licenses/LICENSE-2.0
+//
+//     Unless required by applicable law or agreed to in writing, software
+//     distributed under the License is distributed on an "AS IS" BASIS,
+//     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//     See the License for the specific language governing permissions and
+//     limitations under the License.

nuitka/build/static_src/HelpersComparisonDualGt.c

@@ -0,0 +1,121 @@
+//     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+/* WARNING, this code is GENERATED. Modify the template HelperOperationComparisonDual.c.j2 instead! */
+
+/* This file is included from another C file, help IDEs to still parse it on its own. */
+#ifdef __IDE_ONLY__
+#include "nuitka/prelude.h"
+#endif
+
+/* C helpers for type specialized ">" (GT) comparisons */
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "CLONG" to C platform long value. */
+PyObject *RICH_COMPARE_GT_OBJECT_NILONG_CLONG(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        bool r = COMPARE_LE_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+
+        // Convert to target type.
+        PyObject *result = BOOL_FROM(!r);
+        Py_INCREF_IMMORTAL(result);
+        return result;
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_GT_OBJECT_LONG_CLONG(operand1->python_value, operand2);
+    } else {
+        return COMPARE_GT_OBJECT_LONG_CLONG(operand1->python_value, operand2);
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "CLONG" to C platform long value. */
+bool RICH_COMPARE_GT_CBOOL_NILONG_CLONG(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        bool r = COMPARE_LE_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+
+        // Convert to target type.
+        bool result = !r;
+
+        return result;
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_GT_CBOOL_LONG_CLONG(operand1->python_value, operand2);
+    } else {
+        return COMPARE_GT_CBOOL_LONG_CLONG(operand1->python_value, operand2);
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "DIGIT" to C platform digit value for long
+ * Python objects. */
+PyObject *RICH_COMPARE_GT_OBJECT_NILONG_DIGIT(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+    assert(Py_ABS(operand2) < (1 << PyLong_SHIFT));
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        bool r = COMPARE_LE_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+
+        // Convert to target type.
+        PyObject *result = BOOL_FROM(!r);
+        Py_INCREF_IMMORTAL(result);
+        return result;
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_GT_OBJECT_LONG_DIGIT(operand1->python_value, operand2);
+    } else {
+        return COMPARE_GT_OBJECT_LONG_DIGIT(operand1->python_value, operand2);
+    }
+}
+
+/* Code referring to "NILONG" corresponds to Nuitka int/long/C long value and "DIGIT" to C platform digit value for long
+ * Python objects. */
+bool RICH_COMPARE_GT_CBOOL_NILONG_DIGIT(nuitka_ilong *operand1, long operand2) {
+    CHECK_NILONG_OBJECT(operand1);
+    assert(Py_ABS(operand2) < (1 << PyLong_SHIFT));
+
+    bool left_c_usable = IS_NILONG_C_VALUE_VALID(operand1);
+    bool right_c_usable = true;
+
+    if (left_c_usable && right_c_usable) {
+        bool r = COMPARE_LE_CBOOL_CLONG_CLONG(operand1->c_value, operand2);
+
+        // Convert to target type.
+        bool result = !r;
+
+        return result;
+    } else if (!left_c_usable && !right_c_usable) {
+        ENFORCE_NILONG_OBJECT_VALUE(operand1);
+
+        return COMPARE_GT_CBOOL_LONG_DIGIT(operand1->python_value, operand2);
+    } else {
+        return COMPARE_GT_CBOOL_LONG_DIGIT(operand1->python_value, operand2);
+    }
+}
+
+//     Part of "Nuitka", an optimizing Python compiler that is compatible and
+//     integrates with CPython, but also works on its own.
+//
+//     Licensed under the Apache License, Version 2.0 (the "License");
+//     you may not use this file except in compliance with the License.
+//     You may obtain a copy of the License at
+//
+//        http://www.apache.org/licenses/LICENSE-2.0
+//
+//     Unless required by applicable law or agreed to in writing, software
+//     distributed under the License is distributed on an "AS IS" BASIS,
+//     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//     See the License for the specific language governing permissions and
+//     limitations under the License.