# coding: utf-8
"""`TarFS` opener definition.
"""

from __future__ import absolute_import
from __future__ import print_function
from __future__ import unicode_literals

import typing

from .base import Opener
from .errors import NotWriteable

if False:  # typing.TYPE_CHECKING
    from typing import Text
    from .parse import ParseResult
    from ..tarfs import TarFS


class TarOpener(Opener):
    """`TarFS` opener.
    """

    protocols = ['tar']

    def open_fs(self,
                fs_url,         # type: Text
                parse_result,   # type: ParseResult
                writeable,      # type: bool
                create,         # type: bool
                cwd             # type: Text
                ):
        # type: (...) -> TarFS
        from ..tarfs import TarFS
        if not create and writeable:
            raise NotWriteable(
                'Unable to open existing TAR file for writing'
            )
        tar_fs = TarFS(
            parse_result.resource,
            write=create
        )
        return tar_fs
