strukto-ai--mirage/python/mirage/commands/builtin/s3/__init__.py

# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
# 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 2026 @ Strukto.AI All Rights Reserved. =========

from mirage.commands.builtin.filetype_factory import make_filetype_commands
from mirage.commands.builtin.generic_bind import (CommandIO,
                                                  make_generic_commands)
from mirage.commands.builtin.s3._provision import \
    file_read_provision as _ft_provision
from mirage.commands.builtin.s3.du import du
from mirage.commands.builtin.s3.mkdir import mkdir
from mirage.commands.builtin.s3.rm import rm
from mirage.commands.builtin.s3.stat import stat
from mirage.commands.builtin.s3.tee import tee
from mirage.commands.builtin.s3.touch import touch
from mirage.core.s3.constants import SCOPE_ERROR
from mirage.core.s3.copy import copy as _copy
from mirage.core.s3.du import du as _du
from mirage.core.s3.du import du_all as _du_all
from mirage.core.s3.exists import exists as _exists
from mirage.core.s3.find import find as _find
from mirage.core.s3.glob import resolve_glob as _ft_resolve_glob
from mirage.core.s3.mkdir import mkdir as _mkdir
from mirage.core.s3.read import read_bytes as _read
from mirage.core.s3.readdir import readdir as _readdir
from mirage.core.s3.rename import rename as _rename
from mirage.core.s3.rm import rm_r as _rm_r
from mirage.core.s3.rmdir import rmdir as _rmdir
from mirage.core.s3.stat import stat as _stat
from mirage.core.s3.stream import read_stream as _read_stream
from mirage.core.s3.unlink import unlink as _unlink
from mirage.core.s3.write import write_bytes as _write

_S3_CMD_OPS = CommandIO(
    readdir=_readdir,
    read_bytes=_read,
    read_stream=_read_stream,
    stat=_stat,
    is_mounted=lambda a: True,
    local=False,
    max_glob_matches=SCOPE_ERROR,
    write=_write,
    exists=_exists,
    mkdir=_mkdir,
    unlink=_unlink,
    rmdir=_rmdir,
    rm_r=_rm_r,
    rename=_rename,
    copy=_copy,
    find=_find,
    du_total=_du,
    du_all=_du_all,
)

# s3-specific behaviours kept as overrides: no real directories (mkdir -p,
# rm not-empty), write-tracking (touch/tee), du_multi aggregation, and the
# index-threaded, missing-operand stat. patch is generic (the factory builder
# delegates to the shared generic patch).
_S3_OVERRIDES = {"stat", "du", "rm", "mkdir", "tee", "touch"}

COMMANDS = [
    *make_filetype_commands(
        "s3", _ft_resolve_glob, _read, provision=_ft_provision),
    *make_generic_commands(
        "s3",
        _S3_CMD_OPS,
        overrides=_S3_OVERRIDES,
    ),
    du,
    mkdir,
    rm,
    stat,
    tee,
    touch,
]