pygridgain-dbapi 9.0.14__tar.gz

pygridgain_dbapi-9.0.14/CMakeLists.txt

@@ -0,0 +1,51 @@
+#
+# Copyright (C) GridGain Systems. All Rights Reserved.
+# _________        _____ __________________        _____
+# __  ____/___________(_)______  /__  ____/______ ____(_)_______
+# _  / __  __  ___/__  / _  __  / _  / __  _  __ `/__  / __  __ \
+# / /_/ /  _  /    _  /  / /_/ /  / /_/ /  / /_/ / _  /  _  / / /
+# \____/   /_/     /_/   \_,__/   \____/   \__,_/  /_/   /_/ /_/
+#
+
+cmake_minimum_required(VERSION 3.18)
+project(pygridgain_dbapi VERSION ${IGNITE_VERSION} LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# Dealing with Python native libraries
+set(Python_FIND_VIRTUALENV FIRST)
+find_package(Python3 COMPONENTS Interpreter Development)
+
+message("Python3_FOUND:${Python3_FOUND}")
+message("Python3_VERSION:${Python3_VERSION}")
+message("Python3_Development_FOUND:${Python3_Development_FOUND}")
+message("Python3_LIBRARIES:${Python3_LIBRARIES}")
+message("EXTENSION_FILENAME:${EXTENSION_FILENAME}")
+
+# Dealing with Ignite C++ libraries
+set(ENABLE_ODBC ON)
+set(ENABLE_CLIENT OFF)
+set(ENABLE_TESTS OFF)
+set(INSTALL_IGNITE_FILES OFF)
+set(ENABLE_ADDRESS_SANITIZER OFF)
+set(ENABLE_UB_SANITIZER OFF)
+set(WARNINGS_AS_ERRORS OFF)
+
+if(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/../cpp)
+    set(IGNITE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/../cpp)
+else()
+    set(IGNITE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/cpp)
+endif()
+
+set(IGNITE_BIN_DIR ${CMAKE_CURRENT_BINARY_DIR})
+set(IGNITE_CMAKE_MODULE_PATH ${IGNITE_DIR}/cmake)
+
+list(APPEND CMAKE_MODULE_PATH ${IGNITE_CMAKE_MODULE_PATH})
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_BINARY_DIR})
+list(APPEND CMAKE_PREFIX_PATH ${CMAKE_BINARY_DIR})
+
+include_directories(${IGNITE_DIR})
+
+add_subdirectory(${IGNITE_DIR} ${IGNITE_BIN_DIR}/ignite)
+add_subdirectory(cpp_module)

pygridgain_dbapi-9.0.14/LICENSE

@@ -0,0 +1,6 @@
+Copyright (C) GridGain Systems. All Rights Reserved.
+_________        _____ __________________        _____
+__  ____/___________(_)______  /__  ____/______ ____(_)_______
+_  / __  __  ___/__  / _  __  / _  / __  _  __ `/__  / __  __ \
+/ /_/ /  _  /    _  /  / /_/ /  / /_/ /  / /_/ / _  /  _  / / /
+\____/   /_/     /_/   \_,__/   \____/   \__,_/  /_/   /_/ /_/

pygridgain_dbapi-9.0.14/MANIFEST.in

@@ -0,0 +1,11 @@
+graft requirements
+graft tests
+global-exclude *.py[cod]
+global-exclude *__pycache__*
+include README.md
+include LICENSE
+include NOTICE
+include pygridgain_dbapi/_version.txt
+include CMakeLists.txt
+recursive-include cpp_module *
+recursive-include cpp *

pygridgain_dbapi-9.0.14/NOTICE

@@ -0,0 +1,2 @@
+GridGain 9 DB API Driver
+Copyright (C) GridGain Systems. All Rights Reserved.

pygridgain_dbapi-9.0.14/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.1
+Name: pygridgain-dbapi
+Version: 9.0.14
+Summary: GridGain 9 DB API Driver
+Home-page: https://www.gridgain.com
+Author: GridGain Systems
+Author-email: eng@gridgain.com
+License: Copyright (C) GridGain Systems. All Rights Reserved.
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Database :: Front-Ends
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: Free for non-commercial use
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: attrs==23.1.0
+
+# pygridgain-dbapi
+GridGain 9 DB API Driver.
+
+## Prerequisites
+
+- Python 3.9 or above (3.9, 3.10, 3.11, 3.12 and 3.13 are tested),
+- Access to GridGain 9 node, local or remote.
+
+## Installation
+
+### From repository
+This is a recommended way for users. If you only want to use the `pygridgain-dbapi` module in your project, do:
+```
+$ pip install pygridgain-dbapi
+```
+
+### From sources
+This way is more suitable for developers, or if you install the client from zip archive.
+1. Download and/or unzip GridGain 9 DB API Driver sources to `pygridgain_dbapi_path`
+2. Go to `pygridgain_dbapi_path` folder
+3. Execute `pip install -e .`
+
+```bash
+$ cd <pygridgain_dbapi_path>
+$ pip install -e .
+```
+
+This will install the repository version of `pygridgain-dbapi` into your environment in so-called “develop” or “editable”
+mode. You may read more about [editable installs](https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs)
+in the `pip` manual.
+
+Then run through the contents of `requirements` folder to install the additional requirements into your working Python
+environment using
+```
+$ pip install -r requirements/<your task>.txt
+```
+
+You may also want to consult the `setuptools` manual about using `setup.py`.
+
+### *C extension*
+
+The core of the package is a C++ extension. It shares the code with the GridGain C++ Client. The package is pre-built
+for the most common platforms, but you may need to build it if your platform is not included.
+
+Linux building requirements:
+- GCC (and G++);
+- CMake version >=3.18;
+- unixODBC (dev version of the package);
+- OpenSSL (dev version of the package);
+- Docker to build wheels;
+- Supported versions of Python (3.9, 3.10, 3.11, 3.12 and 3.13).
+  You can disable some of these versions, but you'd need to edit the script for that.
+
+For building universal `wheels` (binary packages) for Linux, just invoke script `./scripts/create_distr.sh`.
+
+Windows building requirements:
+- MSVC 14.x, and it should be in path;
+- CMake version >=3.18;
+- OpenSSL (headers are required for the build);
+- Supported versions of Python (3.9, 3.10, 3.11, 3.12 and 3.13).
+  You can disable some of these versions, but you'd need to edit the script for that.
+
+For building `wheels` for Windows, invoke script `.\scripts\BuildWheels.ps1` using PowerShell.
+Make sure that your execution policy allows execution of scripts in your environment.
+The script only works with Python distributions installed in a standard path, which is LOCALAPPDATA\Programs\Python.
+
+Ready wheels will be located in `distr` directory.
+
+### Updating from older version
+
+To upgrade an existing package, use the following command:
+```
+pip install --upgrade pygridgain-dbapi
+```
+
+To install the latest version of a package:
+
+```
+pip install pygridgain-dbapi
+```
+
+To install a specific version:
+
+```
+pip install pygridgain_dbapi==3.0.0
+```
+
+## Testing
+*NB!* It is recommended installing `pygridgain_dbapi` in development mode.
+Refer to [this section](#from-sources) for instructions.
+
+Remember to install test requirements:
+```bash
+$ pip install -r requirements/install.txt -r requirements/tests.txt
+```
+
+### Run basic tests
+Running tests themselves:
+```bash
+$ pytest
+```
+
+## Documentation
+
+Install documentation requirements:
+```bash
+$ pip install -r requirements/docs.txt
+```
+
+Generate documentation:
+
+```bash
+$ cd docs
+$ make html
+```
+
+The resulting documentation can be found in `docs/_build/html`. If you want to open the documentation locally, you can
+open the index of the documentation `docs/_build/html/index.html` using any modern browser.

pygridgain_dbapi-9.0.14/README.md

@@ -0,0 +1,118 @@
+# pygridgain-dbapi
+GridGain 9 DB API Driver.
+
+## Prerequisites
+
+- Python 3.9 or above (3.9, 3.10, 3.11, 3.12 and 3.13 are tested),
+- Access to GridGain 9 node, local or remote.
+
+## Installation
+
+### From repository
+This is a recommended way for users. If you only want to use the `pygridgain-dbapi` module in your project, do:
+```
+$ pip install pygridgain-dbapi
+```
+
+### From sources
+This way is more suitable for developers, or if you install the client from zip archive.
+1. Download and/or unzip GridGain 9 DB API Driver sources to `pygridgain_dbapi_path`
+2. Go to `pygridgain_dbapi_path` folder
+3. Execute `pip install -e .`
+
+```bash
+$ cd <pygridgain_dbapi_path>
+$ pip install -e .
+```
+
+This will install the repository version of `pygridgain-dbapi` into your environment in so-called “develop” or “editable”
+mode. You may read more about [editable installs](https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs)
+in the `pip` manual.
+
+Then run through the contents of `requirements` folder to install the additional requirements into your working Python
+environment using
+```
+$ pip install -r requirements/<your task>.txt
+```
+
+You may also want to consult the `setuptools` manual about using `setup.py`.
+
+### *C extension*
+
+The core of the package is a C++ extension. It shares the code with the GridGain C++ Client. The package is pre-built
+for the most common platforms, but you may need to build it if your platform is not included.
+
+Linux building requirements:
+- GCC (and G++);
+- CMake version >=3.18;
+- unixODBC (dev version of the package);
+- OpenSSL (dev version of the package);
+- Docker to build wheels;
+- Supported versions of Python (3.9, 3.10, 3.11, 3.12 and 3.13).
+  You can disable some of these versions, but you'd need to edit the script for that.
+
+For building universal `wheels` (binary packages) for Linux, just invoke script `./scripts/create_distr.sh`.
+
+Windows building requirements:
+- MSVC 14.x, and it should be in path;
+- CMake version >=3.18;
+- OpenSSL (headers are required for the build);
+- Supported versions of Python (3.9, 3.10, 3.11, 3.12 and 3.13).
+  You can disable some of these versions, but you'd need to edit the script for that.
+
+For building `wheels` for Windows, invoke script `.\scripts\BuildWheels.ps1` using PowerShell.
+Make sure that your execution policy allows execution of scripts in your environment.
+The script only works with Python distributions installed in a standard path, which is LOCALAPPDATA\Programs\Python.
+
+Ready wheels will be located in `distr` directory.
+
+### Updating from older version
+
+To upgrade an existing package, use the following command:
+```
+pip install --upgrade pygridgain-dbapi
+```
+
+To install the latest version of a package:
+
+```
+pip install pygridgain-dbapi
+```
+
+To install a specific version:
+
+```
+pip install pygridgain_dbapi==3.0.0
+```
+
+## Testing
+*NB!* It is recommended installing `pygridgain_dbapi` in development mode.
+Refer to [this section](#from-sources) for instructions.
+
+Remember to install test requirements:
+```bash
+$ pip install -r requirements/install.txt -r requirements/tests.txt
+```
+
+### Run basic tests
+Running tests themselves:
+```bash
+$ pytest
+```
+
+## Documentation
+
+Install documentation requirements:
+```bash
+$ pip install -r requirements/docs.txt
+```
+
+Generate documentation:
+
+```bash
+$ cd docs
+$ make html
+```
+
+The resulting documentation can be found in `docs/_build/html`. If you want to open the documentation locally, you can
+open the index of the documentation `docs/_build/html/index.html` using any modern browser.

pygridgain_dbapi-9.0.14/cpp/.clang-format

@@ -0,0 +1,46 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+#
+
+#
+# This requires clang-format-14 or later
+#
+
+BasedOnStyle: WebKit
+Standard: c++17
+AllowShortBlocksOnASingleLine: Never
+AllowShortFunctionsOnASingleLine: InlineOnly
+AlwaysBreakTemplateDeclarations: Yes
+BraceWrapping:
+  AfterFunction:   false
+BreakBeforeBinaryOperators: NonAssignment
+BreakBeforeBraces: Custom
+ColumnLimit: 120
+Cpp11BracedListStyle: true
+EmptyLineBeforeAccessModifier: Always
+FixNamespaceComments: true
+IndentCaseLabels: true
+IndentPPDirectives: AfterHash
+PPIndentWidth: 1
+NamespaceIndentation: None
+PointerAlignment: Right
+SeparateDefinitionBlocks: Always
+ShortNamespaceLines: 5
+SpaceAfterCStyleCast: true
+SpaceAfterTemplateKeyword: false
+SpaceBeforeCpp11BracedList: false
+SpaceInEmptyBlock: false
+

pygridgain_dbapi-9.0.14/cpp/.clang-tidy

@@ -0,0 +1,163 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+#
+
+---
+Checks: '-*,
+bugprone-argument-comment,
+bugprone-assert-side-effect,
+bugprone-bad-signal-to-kill-thread,
+bugprone-branch-clone,
+bugprone-copy-constructor-init,
+bugprone-dangling-handle,
+bugprone-dynamic-static-initializers,
+bugprone-fold-init-type,
+bugprone-forward-declaration-namespace,
+bugprone-forwarding-reference-overload,
+bugprone-inaccurate-erase,
+bugprone-incorrect-roundings,
+bugprone-integer-division,
+bugprone-lambda-function-name,
+bugprone-macro-parentheses,
+bugprone-macro-repeated-side-effects,
+bugprone-misplaced-operator-in-strlen-in-alloc,
+bugprone-misplaced-pointer-arithmetic-in-alloc,
+bugprone-misplaced-widening-cast,
+bugprone-move-forwarding-reference,
+bugprone-multiple-statement-macro,
+bugprone-no-escape,
+bugprone-not-null-terminated-result,
+bugprone-parent-virtual-call,
+bugprone-posix-return,
+bugprone-reserved-identifier,
+bugprone-sizeof-container,
+bugprone-sizeof-expression,
+bugprone-spuriously-wake-up-functions,
+bugprone-string-constructor,
+bugprone-string-integer-assignment,
+bugprone-string-literal-with-embedded-nul,
+bugprone-suspicious-enum-usage,
+bugprone-suspicious-include,
+bugprone-suspicious-memory-comparison,
+bugprone-suspicious-memset-usage,
+bugprone-suspicious-missing-comma,
+bugprone-suspicious-semicolon,
+bugprone-suspicious-string-compare,
+bugprone-swapped-arguments,
+bugprone-terminating-continue,
+bugprone-throw-keyword-missing,
+bugprone-too-small-loop-variable,
+bugprone-undefined-memory-manipulation,
+bugprone-undelegated-constructor,
+bugprone-unhandled-self-assignment,
+bugprone-unused-raii,
+bugprone-unused-return-value,
+bugprone-use-after-move,
+bugprone-virtual-near-miss,
+cert-dcl21-cpp,
+cert-dcl58-cpp,
+cert-err34-c,
+cert-err52-cpp,
+cert-err60-cpp,
+cert-flp30-c,
+cert-msc50-cpp,
+cert-msc51-cpp,
+cert-str34-c,
+cppcoreguidelines-interfaces-global-init,
+cppcoreguidelines-narrowing-conversions,
+cppcoreguidelines-pro-type-member-init,
+cppcoreguidelines-pro-type-static-cast-downcast,
+cppcoreguidelines-slicing,
+google-default-arguments,
+google-explicit-constructor,
+google-runtime-operator,
+hicpp-exception-baseclass,
+hicpp-multiway-paths-covered,
+misc-misplaced-const,
+misc-new-delete-overloads,
+misc-no-recursion,
+misc-non-copyable-objects,
+misc-throw-by-value-catch-by-reference,
+misc-unconventional-assign-operator,
+misc-uniqueptr-reset-release,
+modernize-avoid-bind,
+modernize-concat-nested-namespaces,
+modernize-deprecated-headers,
+modernize-deprecated-ios-base-aliases,
+modernize-loop-convert,
+modernize-make-shared,
+modernize-make-unique,
+modernize-pass-by-value,
+modernize-raw-string-literal,
+modernize-redundant-void-arg,
+modernize-replace-auto-ptr,
+modernize-replace-disallow-copy-and-assign-macro,
+modernize-replace-random-shuffle,
+modernize-return-braced-init-list,
+modernize-shrink-to-fit,
+modernize-unary-static-assert,
+modernize-use-auto,
+modernize-use-bool-literals,
+modernize-use-emplace,
+modernize-use-equals-default,
+modernize-use-equals-delete,
+modernize-use-nodiscard,
+modernize-use-noexcept,
+modernize-use-nullptr,
+modernize-use-override,
+modernize-use-transparent-functors,
+modernize-use-uncaught-exceptions,
+mpi-buffer-deref,
+mpi-type-mismatch,
+openmp-use-default-none,
+performance-faster-string-find,
+performance-for-range-copy,
+performance-implicit-conversion-in-loop,
+performance-inefficient-algorithm,
+performance-inefficient-string-concatenation,
+performance-inefficient-vector-operation,
+performance-move-const-arg,
+performance-move-constructor-init,
+performance-no-automatic-move,
+performance-noexcept-move-constructor,
+performance-trivially-destructible,
+performance-type-promotion-in-math-fn,
+performance-unnecessary-copy-initialization,
+performance-unnecessary-value-param,
+portability-simd-intrinsics,
+readability-avoid-const-params-in-decls,
+readability-const-return-type,
+readability-container-size-empty,
+readability-convert-member-functions-to-static,
+readability-delete-null-pointer,
+readability-deleted-default,
+readability-inconsistent-declaration-parameter-name,
+readability-make-member-function-const,
+readability-misleading-indentation,
+readability-misplaced-array-index,
+readability-non-const-parameter,
+readability-redundant-control-flow,
+readability-redundant-declaration,
+readability-redundant-function-ptr-dereference,
+readability-redundant-smartptr-get,
+readability-redundant-string-cstr,
+readability-redundant-string-init,
+readability-simplify-subscript-expr,
+readability-static-accessed-through-instance,
+readability-static-definition-in-anonymous-namespace,
+readability-string-compare,
+readability-uniqueptr-delete-release,
+readability-use-anyofallof'

pygridgain_dbapi-9.0.14/cpp/.gitignore

@@ -0,0 +1 @@
+cmake-build-*