#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# -----------------------------------------------------------------------------------------------------------
# Copyright (c) 2026 Huawei Technologies Co., Ltd. All Rights Reserved.
# This program is free software, you can redistribute it and/or modify it under the terms and conditions of
# CANN Open Software License Agreement Version 2.0 (the "License").
# Please refer to the License for details. You may not use this file except in compliance with the License.
# THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
# INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
# See LICENSE in the root of the software repository for the full text of the License.
# -----------------------------------------------------------------------------------------------------------

"""Tensorflow function definitions"""

USE_DEFAULT = object()


class TrainSpec(object):
    """Configuration for training"""
    def __new__(cls, input_fn, max_steps=None, hooks=None):
        pass


class EvalSpec(object):
    """Configuration for evaluation"""
    def __new__(cls,
                input_fn,
                steps=100,
                name=None,
                hooks=None,
                exporters=None,
                start_delay_secs=120,
                throttle_secs=600):
        pass


class Estimator(object):
    """Used to train and evaluate models in Tensorflow"""
    def __init__(self, model_fn, model_dir=None, config=None, params=None,
                 warm_start_from=None):
        pass

    def train(self,
              input_fn,
              hooks=None,
              steps=None,
              max_steps=None,
              saving_listeners=None):
        """Used to train a model with data generated by input_fn"""
        pass


class Model(object):
    """Class used for training and inference"""
    def __init__(self, *args, **kwargs):
        pass

    def compile(self,
                optimizer='rmsprop',
                loss=None,
                metrics=None,
                loss_weights=None,
                sample_weight_mode=None,
                weighted_metrics=None,
                target_tensors=None,
                distribute=None,
                **kwargs):
        """Used to configure the training model"""
        pass

    def fit(self,
            x=None,
            y=None,
            batch_size=None,
            epochs=1,
            verbose=1,
            callbacks=None,
            validation_split=0.,
            validation_data=None,
            shuffle=True,
            class_weight=None,
            sample_weight=None,
            initial_epoch=0,
            steps_per_epoch=None,
            validation_steps=None,
            validation_freq=1,
            max_queue_size=10,
            workers=1,
            use_multiprocessing=False,
            **kwargs):
        """Train a model for user specified epoches"""
        pass

    def fit_generator(self,
                      generator,
                      steps_per_epoch=None,
                      epochs=1,
                      verbose=1,
                      callbacks=None,
                      validation_data=None,
                      validation_steps=None,
                      validation_freq=1,
                      class_weight=None,
                      max_queue_size=10,
                      workers=1,
                      use_multiprocessing=False,
                      shuffle=True,
                      initial_epoch=0):
        """Train a model on data produced by a generator batch-by-batch"""
        pass


class Session(object):
    """Class used to run Tensorflow operations"""
    def __init__(self, target='', graph=None, config=None):
        pass


class InteractiveSession(object):
    """A session used in user interactive contexts"""
    def __init__(self, target='', graph=None, config=None):
        pass


def MonitoredTrainingSession(
        master='',  # pylint: disable=invalid-name
        is_chief=True,
        checkpoint_dir=None,
        scaffold=None,
        hooks=None,
        chief_only_hooks=None,
        save_checkpoint_secs=USE_DEFAULT,
        save_summaries_steps=USE_DEFAULT,
        save_summaries_secs=USE_DEFAULT,
        config=None,
        stop_grace_period_secs=120,
        log_step_count_steps=100,
        max_wait_secs=7200,
        save_checkpoint_steps=USE_DEFAULT,
        summary_dir=None):
    """Construct monitored session for training"""
    pass


class Supervisor(object):
    """A training helper class used for saving model checkpoints and computing summaries"""
    def __init__(self,
                 graph=None,
                 ready_op=USE_DEFAULT,
                 ready_for_local_init_op=USE_DEFAULT,
                 is_chief=True,
                 init_op=USE_DEFAULT,
                 init_feed_dict=None,
                 local_init_op=USE_DEFAULT,
                 logdir=None,
                 summary_op=USE_DEFAULT,
                 saver=USE_DEFAULT,
                 global_step=USE_DEFAULT,
                 save_summaries_secs=120,
                 save_model_secs=600,
                 recovery_wait_secs=30,
                 stop_grace_secs=120,
                 checkpoint_basename="model.ckpt",
                 session_manager=None,
                 summary_writer=USE_DEFAULT,
                 init_fn=None,
                 local_init_run_options=None):
        pass

    def managed_session(self,
                        master="",
                        config=None,
                        start_standard_services=True,
                        close_summary_writer=True):
        """Return a context manager of the managed session"""
        pass