source: test/test_path.py @ 1721:3557f65ded13

# Copyright (C) 2003-2018, Stefan Schwarzer <sschwarzer@sschwarzer.net>
# and ftputil contributors (see `doc/contributors.txt`)
# See the file LICENSE for licensing terms.

import ftplib
import time

import pytest

import ftputil
import ftputil.error
import ftputil.tool

from test import mock_ftplib
from test import test_base


class FailingFTPHost(ftputil.FTPHost):

    def _dir(self, path):
        raise ftputil.error.FTPOSError("simulate a failure, e. g. timeout")


# Mock session, used for testing an inaccessible login directory
class SessionWithInaccessibleLoginDirectory(mock_ftplib.MockSession):

    def cwd(self, dir):
        # Assume that `dir` is the inaccessible login directory.
        raise ftplib.error_perm("can't change into this directory")


class TestPath:
    """Test operations in `FTPHost.path`."""

    # TODO: Add unit tests for changes for ticket #113
    # (commits [b4c9b089b6b8] and [4027740cdd2d]).
    def test_regular_isdir_isfile_islink(self):
        """Test regular `FTPHost._Path.isdir/isfile/islink`."""
        host = test_base.ftp_host_factory()
        testdir = "/home/sschwarzer"
        host.chdir(testdir)
        # Test a path which isn't there.
        assert not host.path.isdir("notthere")
        assert not host.path.isfile("notthere")
        assert not host.path.islink("notthere")
        #  This checks additional code (see ticket #66).
        assert not host.path.isdir("/notthere/notthere")
        assert not host.path.isfile("/notthere/notthere")
        assert not host.path.islink("/notthere/notthere")
        # Test a directory.
        assert host.path.isdir(testdir)
        assert not host.path.isfile(testdir)
        assert not host.path.islink(testdir)
        # Test a file.
        testfile = "/home/sschwarzer/index.html"
        assert not host.path.isdir(testfile)
        assert host.path.isfile(testfile)
        assert not host.path.islink(testfile)
        # Test a link. Since the link target of `osup` doesn't exist,
        # neither `isdir` nor `isfile` return `True`.
        testlink = "/home/sschwarzer/osup"
        assert not host.path.isdir(testlink)
        assert not host.path.isfile(testlink)
        assert host.path.islink(testlink)

    def test_workaround_for_spaces(self):
        """Test whether the workaround for space-containing paths is used."""
        host = test_base.ftp_host_factory()
        testdir = "/home/sschwarzer"
        host.chdir(testdir)
        # Test a file name containing spaces.
        testfile = "/home/dir with spaces/file with spaces"
        assert not host.path.isdir(testfile)
        assert host.path.isfile(testfile)
        assert not host.path.islink(testfile)

    def test_inaccessible_home_directory_and_whitespace_workaround(self):
        "Test combination of inaccessible home directory + whitespace in path."
        host = test_base.ftp_host_factory(
               session_factory=SessionWithInaccessibleLoginDirectory)
        with pytest.raises(ftputil.error.InaccessibleLoginDirError):
            host._dir("/home dir")

    def test_isdir_isfile_islink_with_dir_failure(self):
        """
        Test failing `FTPHost._Path.isdir/isfile/islink` because of
        failing `_dir` call.
        """
        host = test_base.ftp_host_factory(ftp_host_class=FailingFTPHost)
        testdir = "/home/sschwarzer"
        host.chdir(testdir)
        # Test if exceptions are propagated.
        FTPOSError = ftputil.error.FTPOSError
        with pytest.raises(FTPOSError):
            host.path.isdir("index.html")
        with pytest.raises(FTPOSError):
            host.path.isfile("index.html")
        with pytest.raises(FTPOSError):
            host.path.islink("index.html")

    def test_isdir_isfile_with_infinite_link_chain(self):
        """
        Test if `isdir` and `isfile` return `False` if they encounter
        an infinite link chain.
        """
        host = test_base.ftp_host_factory()
        assert host.path.isdir("/home/bad_link") is False
        assert host.path.isfile("/home/bad_link") is False

    def test_exists(self):
        """Test `FTPHost.path.exists`."""
        # Regular use of `exists`
        host = test_base.ftp_host_factory()
        testdir = "/home/sschwarzer"
        host.chdir(testdir)
        assert host.path.exists("index.html")
        assert not host.path.exists("notthere")
        # Test if exceptions are propagated.
        host = test_base.ftp_host_factory(ftp_host_class=FailingFTPHost)
        with pytest.raises(ftputil.error.FTPOSError):
            host.path.exists("index.html")


class TestAcceptEitherBytesOrUnicode:

    def setup_method(self, method):
        self.host = test_base.ftp_host_factory()

    def _test_method_string_types(self, method, path):
        expected_type = type(path)
        assert isinstance(method(path), expected_type)

    def test_methods_that_take_and_return_one_string(self):
        """
        Test whether the same string type as for the argument is returned.
        """
        method_names = ("abspath basename dirname join normcase normpath".
                        split())
        for method_name in method_names:
            method = getattr(self.host.path, method_name)
            self._test_method_string_types(method, "/")
            self._test_method_string_types(method, ".")
            self._test_method_string_types(method, b"/")
            self._test_method_string_types(method, b".")

    def test_methods_that_take_a_string_and_return_a_bool(self):
        """Test whether the methods accept byte and unicode strings."""
        host = self.host
        as_bytes = ftputil.tool.as_bytes
        host.chdir("/home/file_name_test")
        # `isabs`
        assert not host.path.isabs("ä")
        assert not host.path.isabs(as_bytes("ä"))
        # `exists`
        assert host.path.exists("ä")
        assert host.path.exists(as_bytes("ä"))
        # `isdir`, `isfile`, `islink`
        assert host.path.isdir("ä")
        assert host.path.isdir(as_bytes("ä"))
        assert host.path.isfile("ö")
        assert host.path.isfile(as_bytes("ö"))
        assert host.path.islink("ü")
        assert host.path.islink(as_bytes("ü"))

    def test_join(self):
        """
        Test whether `FTPHost.path.join` accepts only arguments of
        the same string type and returns the same string type.
        """
        join = self.host.path.join
        as_bytes = ftputil.tool.as_bytes
        # Only unicode
        parts = list("äöü")
        result = join(*parts)
        assert result == "ä/ö/ü"
        # Only bytes
        parts = [as_bytes(s) for s in "äöü"]
        result = join(*parts)
        assert result == as_bytes("ä/ö/ü")
        # Mixture of unicode and bytes
        parts = ["ä", as_bytes("ö")]
        with pytest.raises(TypeError):
            join(*parts)
        parts = [as_bytes("ä"), as_bytes("ö"), "ü"]
        with pytest.raises(TypeError):
            join(*parts)

    def test_getmtime(self):
        """
        Test whether `FTPHost.path.getmtime` accepts byte and unicode
        paths.
        """
        host = self.host
        as_bytes = ftputil.tool.as_bytes
        host.chdir("/home/file_name_test")
        # We don't care about the _exact_ time, so don't bother with
        # timezone differences. Instead, do a simple sanity check.
        day = 24 * 60 * 60  # seconds
        expected_mtime = time.mktime((2000, 5, 29, 0, 0, 0, 0, 0, 0))
        mtime_makes_sense = (lambda mtime: expected_mtime - day <= mtime <=
                                           expected_mtime + day)
        assert mtime_makes_sense(host.path.getmtime("ä"))
        assert mtime_makes_sense(host.path.getmtime(as_bytes("ä")))

    def test_getsize(self):
        """
        Test whether `FTPHost.path.getsize` accepts byte and unicode paths.
        """
        host = self.host
        as_bytes = ftputil.tool.as_bytes
        host.chdir("/home/file_name_test")
        assert host.path.getsize("ä") == 512
        assert host.path.getsize(as_bytes("ä")) == 512

    def test_walk(self):
        """Test whether `FTPHost.path.walk` accepts bytes and unicode paths."""
        host = self.host
        as_bytes = ftputil.tool.as_bytes
        def noop(arg, top, names):
            del names[:]
        host.path.walk("ä", noop, None)
        host.path.walk(as_bytes("ä"), noop, None)