khiops 10.3.2.1__tar.gz

khiops-10.3.2.1/LICENSE.md

@@ -0,0 +1,32 @@
+The Clear BSD License
+
+Copyright (c) 2024 Orange S.A.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted (subject to the limitations in the disclaimer
+below) provided that the following conditions are met:
+
+     * Redistributions of source code must retain the above copyright notice,
+     this list of conditions and the following disclaimer.
+
+     * Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+
+     * Neither the name of the copyright holder nor the names of its
+     contributors may be used to endorse or promote products derived from this
+     software without specific prior written permission.
+
+NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY
+THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
+CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

khiops-10.3.2.1/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.1
+Name: khiops
+Version: 10.3.2.1
+Summary: Python library for the Khiops AutoML suite
+Home-page: https://khiops.org
+Maintainer: The Khiops Team
+Maintainer-email: khiops.team@orange.com
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.8
+License-File: LICENSE.md
+Requires-Dist: pandas>=0.25.3
+Requires-Dist: scikit-learn>=0.22.2
+Provides-Extra: s3
+Requires-Dist: boto3<=1.35.69,>=1.17.39; extra == "s3"
+Requires-Dist: pyopenssl<25.0.0,>=24.0.0; extra == "s3"
+Provides-Extra: gcs
+Requires-Dist: google-cloud-storage>=1.37.0; extra == "gcs"

khiops-10.3.2.1/README.md

@@ -0,0 +1,62 @@
+# Khiops Python Library
+
+This is the repository of the **Khiops Python Library** for the [Khiops AutoML suite][khiops].
+
+## Description
+Khiops is a robust AutoML suite for constructing supervised models (classifiers, regressors and
+encoders) and unsupervised models (coclusterings). With this package you can use Khiops via Python
+in two ways:
+- with the module `khiops.core`: To use Khiops in its native way (Khiops dictionary files +
+  tabular data files as input)
+- with the module `khiops.sklearn`: To use Khiops with Scikit-Learn estimator objects (Pandas
+  dataframes or NumPy arrays as input)
+
+## Installation
+
+```bash
+conda install -c conda-forge -c khiops khiops
+```
+Other install methods are documented at the [Khiops website][khiops-install].
+
+### Requirements
+- [Python][python] (>=3.8)
+- [Pandas][pandas] (>=0.25.3)
+- [Scikit-Learn][sklearn] (>=0.22.2)
+
+[pandas]: https://pandas.pydata.org
+[sklearn]: https://scikit-learn.org/stable
+
+## Documentation
+The API Docs for the Khiops Python library are available [here][khiops-api-docs]. Other
+documentation (algorithms, installation etc.) can be found on the [Khiops site][khiops].
+
+The library itself is documented with docstrings: for example, to obtain help on the
+`KhiopsClassifier` estimator and on the `train_predictor` function, respectively,
+you can use:
+```python
+from khiops.sklearn import KhiopsClassifier
+help(KhiopsClassifier)
+
+from khiops import core as kh
+help(kh.train_predictor)
+```
+
+## License
+The Khiops Python library is distributed under the BSD 3-Clause-clear License, the text
+of which is available at
+https://spdx.org/licenses/BSD-3-Clause-Clear.html or see the [LICENSE.md](./LICENSE.md) for more
+details.
+
+## Credits
+The Khiops Python library is currently developed at [Orange Innovation][o-innov] by the Khiops
+Team: khiops.team@orange.com .
+
+[khiops]: https://khiops.org
+[khiops-install]: https://khiops.org/setup
+[khiops-api-docs]: https://khiopsml.github.io/khiops-python
+[python]: https://www.python.org
+[pandas]: https://pandas.pydata.org
+[sklearn]: https://scikit-learn.org/stable
+[boto3]: https://github.com/boto/boto3
+[gcs]: https://github.com/googleapis/python-storage
+[o-innov]: https://hellofuture.orange.com/en/

khiops-10.3.2.1/khiops/__init__.py

@@ -0,0 +1,62 @@
+######################################################################################
+# Copyright (c) 2023-2025 Orange. All rights reserved.                               #
+# This software is distributed under the BSD 3-Clause-clear License, the text of     #
+# which is available at https://spdx.org/licenses/BSD-3-Clause-Clear.html or         #
+# see the "LICENSE.md" file for more details.                                        #
+######################################################################################
+"""
+The main module of the Khiops Python package.
+
+Example:
+   from khiops import core as kh
+   kh.train_predictor(...)
+
+The available sub-modules inside the package are:
+
+- core/api: main API to execute Khiops in its native way
+- core/dictionary: Classes to manipulate Khiops dictionaries JSON files
+  (extension ".kdicj")
+- core/analysis_results: Classes to inspect Khiops JSON report files
+  (extension ".khj")
+- core/coclustering_results: Classes to instpect Khiops Coclustering report files
+  (extension ".khcj")
+- sklearn: Scikit-Learn estimator classes to learn and use Khiops models
+"""
+import importlib
+import importlib.util
+import os
+import sys
+import warnings
+from copy import copy
+from pathlib import Path
+
+from khiops._version import get_versions
+from khiops.core.internals.version import KhiopsVersion
+
+__version__ = get_versions()["version"]
+del get_versions
+
+
+def get_compatible_khiops_version():
+    """Returns the latest Khiops version compatible with this package's version"""
+
+    # Define auxiliary function to remove trailing and old pre-release chars
+    def remove_trailing_chars(version_part):
+        if "+" in version_part:
+            clean_version_part = version_part[: version_part.index("+")]
+        else:
+            clean_version_part = version_part
+        if "b" in clean_version_part:
+            clean_version_part = clean_version_part[: clean_version_part.index("b")]
+        return clean_version_part
+
+    # Build the Khiops Python version without the snapshot part
+    khiops_version_parts = __version__.split(".")
+    if len(khiops_version_parts) < 3:
+        raise ValueError(f"Invalid Khiops Python version '{__version__}'")
+    khiops_version_major = remove_trailing_chars(khiops_version_parts[0])
+    khiops_version_minor = remove_trailing_chars(khiops_version_parts[1])
+    khiops_version_patch = remove_trailing_chars(khiops_version_parts[2])
+    return KhiopsVersion(
+        f"{khiops_version_major}.{khiops_version_minor}.{khiops_version_patch}"
+    )

khiops-10.3.2.1/khiops/_version.py

@@ -0,0 +1,21 @@
+
+# This file was generated by 'versioneer.py' (0.19) from
+# revision-control system data, or from the parent directory name of an
+# unpacked source archive. Distribution tarballs contain a pre-generated copy
+# of this file.
+
+import json
+
+version_json = '''
+{
+ "date": "2025-08-08T11:39:20+0200",
+ "dirty": false,
+ "error": null,
+ "full-revisionid": "888280dc01c90128e02761363cd53d41386a47a2",
+ "version": "10.3.2.1"
+}
+'''  # END VERSION_JSON
+
+
+def get_versions():
+    return json.loads(version_json)

khiops-10.3.2.1/khiops/core/__init__.py

@@ -0,0 +1,14 @@
+######################################################################################
+# Copyright (c) 2023-2025 Orange. All rights reserved.                               #
+# This software is distributed under the BSD 3-Clause-clear License, the text of     #
+# which is available at https://spdx.org/licenses/BSD-3-Clause-Clear.html or         #
+# see the "LICENSE.md" file for more details.                                        #
+######################################################################################
+"""Pure Python library for the Khiops AutoML suite"""
+from khiops.core.analysis_results import *
+from khiops.core.api import *
+from khiops.core.coclustering_results import *
+from khiops.core.dictionary import *
+from khiops.core.exceptions import *
+from khiops.core.helpers import *
+from khiops.core.internals.runner import get_runner, set_runner