# As a test suite for the os module, this is woefully inadequate, but this

# does add tests for a few functions which have been determined to be more

# portable than they had been thought to be.



import os

import unittest

import warnings

import sys

from test import test_support



warnings.filterwarnings("ignore", "tempnam", RuntimeWarning, __name__)

warnings.filterwarnings("ignore", "tmpnam", RuntimeWarning, __name__)



# Tests creating TESTFN

class FileTests(unittest.TestCase):

    def setUp(self):

        if os.path.exists(test_support.TESTFN):

            os.unlink(test_support.TESTFN)

    tearDown = setUp



    def test_access(self):

        f = os.open(test_support.TESTFN, os.O_CREAT|os.O_RDWR)

        os.close(f)

        self.assert_(os.access(test_support.TESTFN, os.W_OK))



    def test_closerange(self):

        first = os.open(test_support.TESTFN, os.O_CREAT|os.O_RDWR)

        # We must allocate two consecutive file descriptors, otherwise

        # it will mess up other file descriptors (perhaps even the three

        # standard ones).

        second = os.dup(first)

        try:

            retries = 0

            while second != first + 1:

                os.close(first)

                retries += 1

                if retries > 10:

                    # XXX test skipped

                    print >> sys.stderr, (

                        "couldn't allocate two consecutive fds, "

                        "skipping test_closerange")

                    return

                first, second = second, os.dup(second)

        finally:

            os.close(second)

        # close a fd that is open, and one that isn't

        os.closerange(first, first + 2)

        self.assertRaises(OSError, os.write, first, "a")



    def test_rename(self):

        path = unicode(test_support.TESTFN)

        old = sys.getrefcount(path)

        self.assertRaises(TypeError, os.rename, path, 0)

        new = sys.getrefcount(path)

        self.assertEqual(old, new)





class TemporaryFileTests(unittest.TestCase):

    def setUp(self):

        self.files = []

        os.mkdir(test_support.TESTFN)



    def tearDown(self):

        for name in self.files:

            os.unlink(name)

        os.rmdir(test_support.TESTFN)



    def check_tempfile(self, name):

        # make sure it doesn't already exist:

        self.failIf(os.path.exists(name),

                    "file already exists for temporary file")

        # make sure we can create the file

        open(name, "w")

        self.files.append(name)



    def test_tempnam(self):

        if not hasattr(os, "tempnam"):

            return

        warnings.filterwarnings("ignore", "tempnam", RuntimeWarning,

                                r"test_os$")

        self.check_tempfile(os.tempnam())



        name = os.tempnam(test_support.TESTFN)

        self.check_tempfile(name)



        name = os.tempnam(test_support.TESTFN, "pfx")

        self.assert_(os.path.basename(name)[:3] == "pfx")

        self.check_tempfile(name)



    def test_tmpfile(self):

        if not hasattr(os, "tmpfile"):

            return

        # As with test_tmpnam() below, the Windows implementation of tmpfile()

        # attempts to create a file in the root directory of the current drive.

        # On Vista and Server 2008, this test will always fail for normal users

        # as writing to the root directory requires elevated privileges.  With

        # XP and below, the semantics of tmpfile() are the same, but the user

        # running the test is more likely to have administrative privileges on

        # their account already.  If that's the case, then os.tmpfile() should

        # work.  In order to make this test as useful as possible, rather than

        # trying to detect Windows versions or whether or not the user has the

        # right permissions, just try and create a file in the root directory

        # and see if it raises a 'Permission denied' OSError.  If it does, then

        # test that a subsequent call to os.tmpfile() raises the same error. If

        # it doesn't, assume we're on XP or below and the user running the test

        # has administrative privileges, and proceed with the test as normal.

        if sys.platform == 'win32':

            name = '\\python_test_os_test_tmpfile.txt'

            if os.path.exists(name):

                os.remove(name)

            try:

                fp = open(name, 'w')

            except IOError, first:

                # open() failed, assert tmpfile() fails in the same way.

                # Although open() raises an IOError and os.tmpfile() raises an

                # OSError(), 'args' will be (13, 'Permission denied') in both

                # cases.

                try:

                    fp = os.tmpfile()

                except OSError, second:

                    self.assertEqual(first.args, second.args)

                else:

                    self.fail("expected os.tmpfile() to raise OSError")

                return

            else:

                # open() worked, therefore, tmpfile() should work.  Close our

                # dummy file and proceed with the test as normal.

                fp.close()

                os.remove(name)



        fp = os.tmpfile()

        fp.write("foobar")

        fp.seek(0,0)

        s = fp.read()

        fp.close()

        self.assert_(s == "foobar")



    def test_tmpnam(self):

        import sys

        if not hasattr(os, "tmpnam"):

            return

        warnings.filterwarnings("ignore", "tmpnam", RuntimeWarning,

                                r"test_os$")

        name = os.tmpnam()

        if sys.platform in ("win32",):

            # The Windows tmpnam() seems useless.  From the MS docs:

            #

            #     The character string that tmpnam creates consists of

            #     the path prefix, defined by the entry P_tmpdir in the

            #     file STDIO.H, followed by a sequence consisting of the

            #     digit characters '0' through '9'; the numerical value

            #     of this string is in the range 1 - 65,535.  Changing the

            #     definitions of L_tmpnam or P_tmpdir in STDIO.H does not

            #     change the operation of tmpnam.

            #

            # The really bizarre part is that, at least under MSVC6,

            # P_tmpdir is "\\".  That is, the path returned refers to

            # the root of the current drive.  That's a terrible place to

            # put temp files, and, depending on privileges, the user

            # may not even be able to open a file in the root directory.

            self.failIf(os.path.exists(name),

                        "file already exists for temporary file")

        else:

            self.check_tempfile(name)



# Test attributes on return values from os.*stat* family.

class StatAttributeTests(unittest.TestCase):

    def setUp(self):

        os.mkdir(test_support.TESTFN)

        self.fname = os.path.join(test_support.TESTFN, "f1")

        f = open(self.fname, 'wb')

        f.write("ABC")

        f.close()



    def tearDown(self):

        os.unlink(self.fname)

        os.rmdir(test_support.TESTFN)



    def test_stat_attributes(self):

        if not hasattr(os, "stat"):

            return



        import stat

        result = os.stat(self.fname)



        # Make sure direct access works

        self.assertEquals(result[stat.ST_SIZE], 3)

        self.assertEquals(result.st_size, 3)



        import sys



        # Make sure all the attributes are there

        members = dir(result)

        for name in dir(stat):

            if name[:3] == 'ST_':

                attr = name.lower()

                if name.endswith("TIME"):

                    def trunc(x): return int(x)

                else:

                    def trunc(x): return x

                self.assertEquals(trunc(getattr(result, attr)),

                                  result[getattr(stat, name)])

                self.assert_(attr in members)



        try:

            result[200]

            self.fail("No exception thrown")

        except IndexError:

            pass



        # Make sure that assignment fails

        try:

            result.st_mode = 1

            self.fail("No exception thrown")

        except TypeError:

            pass



        try:

            result.st_rdev = 1

            self.fail("No exception thrown")

        except (AttributeError, TypeError):

            pass



        try:

            result.parrot = 1

            self.fail("No exception thrown")

        except AttributeError:

            pass



        # Use the stat_result constructor with a too-short tuple.

        try:

            result2 = os.stat_result((10,))

            self.fail("No exception thrown")

        except TypeError:

            pass



        # Use the constructr with a too-long tuple.

        try:

            result2 = os.stat_result((0,1,2,3,4,5,6,7,8,9,10,11,12,13,14))

        except TypeError:

            pass





    def test_statvfs_attributes(self):

        if not hasattr(os, "statvfs"):

            return



        try:

            result = os.statvfs(self.fname)

        except OSError, e:

            # On AtheOS, glibc always returns ENOSYS

            import errno

            if e.errno == errno.ENOSYS:

                return



        # Make sure direct access works

        self.assertEquals(result.f_bfree, result[3])



        # Make sure all the attributes are there.

        members = ('bsize', 'frsize', 'blocks', 'bfree', 'bavail', 'files',

                    'ffree', 'favail', 'flag', 'namemax')

        for value, member in enumerate(members):

            self.assertEquals(getattr(result, 'f_' + member), result[value])



        # Make sure that assignment really fails

        try:

            result.f_bfree = 1

            self.fail("No exception thrown")

        except TypeError:

            pass



        try:

            result.parrot = 1

            self.fail("No exception thrown")

        except AttributeError:

            pass



        # Use the constructor with a too-short tuple.

        try:

            result2 = os.statvfs_result((10,))

            self.fail("No exception thrown")

        except TypeError:

            pass



        # Use the constructr with a too-long tuple.

        try:

            result2 = os.statvfs_result((0,1,2,3,4,5,6,7,8,9,10,11,12,13,14))

        except TypeError:

            pass



    def test_utime_dir(self):

        delta = 1000000

        st = os.stat(test_support.TESTFN)

        # round to int, because some systems may support sub-second

        # time stamps in stat, but not in utime.

        os.utime(test_support.TESTFN, (st.st_atime, int(st.st_mtime-delta)))

        st2 = os.stat(test_support.TESTFN)

        self.assertEquals(st2.st_mtime, int(st.st_mtime-delta))



    # Restrict test to Win32, since there is no guarantee other

    # systems support centiseconds

    if sys.platform == 'win32':

        def get_file_system(path):

            root = os.path.splitdrive(os.path.abspath(path))[0] + '\\'

            import ctypes

            kernel32 = ctypes.windll.kernel32

            buf = ctypes.create_string_buffer("", 100)

            if kernel32.GetVolumeInformationA(root, None, 0, None, None, None, buf, len(buf)):

                return buf.value



        if get_file_system(test_support.TESTFN) == "NTFS":

            def test_1565150(self):

                t1 = 1159195039.25

                os.utime(self.fname, (t1, t1))

                self.assertEquals(os.stat(self.fname).st_mtime, t1)



        def test_1686475(self):

            # Verify that an open file can be stat'ed

            try:

                os.stat(r"c:\pagefile.sys")

            except WindowsError, e:

                if e.errno == 2: # file does not exist; cannot run test

                    return

                self.fail("Could not stat pagefile.sys")



from test import mapping_tests



class EnvironTests(mapping_tests.BasicTestMappingProtocol):

    """check that os.environ object conform to mapping protocol"""

    type2test = None

    def _reference(self):

        return {"KEY1":"VALUE1", "KEY2":"VALUE2", "KEY3":"VALUE3"}

    def _empty_mapping(self):

        os.environ.clear()

        return os.environ

    def setUp(self):

        self.__save = dict(os.environ)

        os.environ.clear()

    def tearDown(self):

        os.environ.clear()

        os.environ.update(self.__save)



    # Bug 1110478

    def test_update2(self):

        if os.path.exists("/bin/sh"):

            os.environ.update(HELLO="World")

            value = os.popen("/bin/sh -c 'echo $HELLO'").read().strip()

            self.assertEquals(value, "World")



class WalkTests(unittest.TestCase):

    """Tests for os.walk()."""



    def test_traversal(self):

        import os

        from os.path import join



        # Build:

        #     TESTFN/

        #       TEST1/              a file kid and two directory kids

        #         tmp1

        #         SUB1/             a file kid and a directory kid

        #           tmp2

        #           SUB11/          no kids

        #         SUB2/             a file kid and a dirsymlink kid

        #           tmp3

        #           link/           a symlink to TESTFN.2

        #       TEST2/

        #         tmp4              a lone file

        walk_path = join(test_support.TESTFN, "TEST1")

        sub1_path = join(walk_path, "SUB1")

        sub11_path = join(sub1_path, "SUB11")

        sub2_path = join(walk_path, "SUB2")

        tmp1_path = join(walk_path, "tmp1")

        tmp2_path = join(sub1_path, "tmp2")

        tmp3_path = join(sub2_path, "tmp3")

        link_path = join(sub2_path, "link")

        t2_path = join(test_support.TESTFN, "TEST2")

        tmp4_path = join(test_support.TESTFN, "TEST2", "tmp4")



        # Create stuff.

        os.makedirs(sub11_path)

        os.makedirs(sub2_path)

        os.makedirs(t2_path)

        for path in tmp1_path, tmp2_path, tmp3_path, tmp4_path:

            f = file(path, "w")

            f.write("I'm " + path + " and proud of it.  Blame test_os.\n")

            f.close()

        if hasattr(os, "symlink"):

            os.symlink(os.path.abspath(t2_path), link_path)

            sub2_tree = (sub2_path, ["link"], ["tmp3"])

        else:

            sub2_tree = (sub2_path, [], ["tmp3"])



        # Walk top-down.

        all = list(os.walk(walk_path))

        self.assertEqual(len(all), 4)

        # We can't know which order SUB1 and SUB2 will appear in.

        # Not flipped:  TESTFN, SUB1, SUB11, SUB2

        #     flipped:  TESTFN, SUB2, SUB1, SUB11

        flipped = all[0][1][0] != "SUB1"

        all[0][1].sort()

        self.assertEqual(all[0], (walk_path, ["SUB1", "SUB2"], ["tmp1"]))

        self.assertEqual(all[1 + flipped], (sub1_path, ["SUB11"], ["tmp2"]))

        self.assertEqual(all[2 + flipped], (sub11_path, [], []))

        self.assertEqual(all[3 - 2 * flipped], sub2_tree)



        # Prune the search.

        all = []

        for root, dirs, files in os.walk(walk_path):

            all.append((root, dirs, files))

            # Don't descend into SUB1.

            if 'SUB1' in dirs:

                # Note that this also mutates the dirs we appended to all!

                dirs.remove('SUB1')

        self.assertEqual(len(all), 2)

        self.assertEqual(all[0], (walk_path, ["SUB2"], ["tmp1"]))

        self.assertEqual(all[1], sub2_tree)



        # Walk bottom-up.

        all = list(os.walk(walk_path, topdown=False))

        self.assertEqual(len(all), 4)

        # We can't know which order SUB1 and SUB2 will appear in.

        # Not flipped:  SUB11, SUB1, SUB2, TESTFN

        #     flipped:  SUB2, SUB11, SUB1, TESTFN

        flipped = all[3][1][0] != "SUB1"

        all[3][1].sort()

        self.assertEqual(all[3], (walk_path, ["SUB1", "SUB2"], ["tmp1"]))

        self.assertEqual(all[flipped], (sub11_path, [], []))

        self.assertEqual(all[flipped + 1], (sub1_path, ["SUB11"], ["tmp2"]))

        self.assertEqual(all[2 - 2 * flipped], sub2_tree)



        if hasattr(os, "symlink"):

            # Walk, following symlinks.

            for root, dirs, files in os.walk(walk_path, followlinks=True):

                if root == link_path:

                    self.assertEqual(dirs, [])

                    self.assertEqual(files, ["tmp4"])

                    break

            else:

                self.fail("Didn't follow symlink with followlinks=True")



    def tearDown(self):

        # Tear everything down.  This is a decent use for bottom-up on

        # Windows, which doesn't have a recursive delete command.  The

        # (not so) subtlety is that rmdir will fail unless the dir's

        # kids are removed first, so bottom up is essential.

        for root, dirs, files in os.walk(test_support.TESTFN, topdown=False):

            for name in files:

                os.remove(os.path.join(root, name))

            for name in dirs:

                dirname = os.path.join(root, name)

                if not os.path.islink(dirname):

                    os.rmdir(dirname)

                else:

                    os.remove(dirname)

        os.rmdir(test_support.TESTFN)



class MakedirTests (unittest.TestCase):

    def setUp(self):

        os.mkdir(test_support.TESTFN)



    def test_makedir(self):

        base = test_support.TESTFN

        path = os.path.join(base, 'dir1', 'dir2', 'dir3')

        os.makedirs(path)             # Should work

        path = os.path.join(base, 'dir1', 'dir2', 'dir3', 'dir4')

        os.makedirs(path)



        # Try paths with a '.' in them

        self.failUnlessRaises(OSError, os.makedirs, os.curdir)

        path = os.path.join(base, 'dir1', 'dir2', 'dir3', 'dir4', 'dir5', os.curdir)

        os.makedirs(path)

        path = os.path.join(base, 'dir1', os.curdir, 'dir2', 'dir3', 'dir4',

                            'dir5', 'dir6')

        os.makedirs(path)









    def tearDown(self):

        path = os.path.join(test_support.TESTFN, 'dir1', 'dir2', 'dir3',

                            'dir4', 'dir5', 'dir6')

        # If the tests failed, the bottom-most directory ('../dir6')

        # may not have been created, so we look for the outermost directory

        # that exists.

        while not os.path.exists(path) and path != test_support.TESTFN:

            path = os.path.dirname(path)



        os.removedirs(path)



class DevNullTests (unittest.TestCase):

    def test_devnull(self):

        f = file(os.devnull, 'w')

        f.write('hello')

        f.close()

        f = file(os.devnull, 'r')

        self.assertEqual(f.read(), '')

        f.close()



class URandomTests (unittest.TestCase):

    def test_urandom(self):

        try:

            self.assertEqual(len(os.urandom(1)), 1)

            self.assertEqual(len(os.urandom(10)), 10)

            self.assertEqual(len(os.urandom(100)), 100)

            self.assertEqual(len(os.urandom(1000)), 1000)

            # see http://bugs.python.org/issue3708

            self.assertEqual(len(os.urandom(0.9)), 0)

            self.assertEqual(len(os.urandom(1.1)), 1)

            self.assertEqual(len(os.urandom(2.0)), 2)

        except NotImplementedError:

            pass



class Win32ErrorTests(unittest.TestCase):

    def test_rename(self):

        self.assertRaises(WindowsError, os.rename, test_support.TESTFN, test_support.TESTFN+".bak")



    def test_remove(self):

        self.assertRaises(WindowsError, os.remove, test_support.TESTFN)



    def test_chdir(self):

        self.assertRaises(WindowsError, os.chdir, test_support.TESTFN)



    def test_mkdir(self):

        self.assertRaises(WindowsError, os.chdir, test_support.TESTFN)



    def test_utime(self):

        self.assertRaises(WindowsError, os.utime, test_support.TESTFN, None)



    def test_access(self):

        self.assertRaises(WindowsError, os.utime, test_support.TESTFN, 0)



    def test_chmod(self):

        self.assertRaises(WindowsError, os.utime, test_support.TESTFN, 0)



class TestInvalidFD(unittest.TestCase):

    singles = ["fchdir", "fdopen", "dup", "fdatasync", "fstat",

               "fstatvfs", "fsync", "tcgetpgrp", "ttyname"]

    #singles.append("close")

    #We omit close because it doesn'r raise an exception on some platforms

    def get_single(f):

        def helper(self):

            if  hasattr(os, f):

                self.check(getattr(os, f))

        return helper

    for f in singles:

        locals()["test_"+f] = get_single(f)



    def check(self, f, *args):

        self.assertRaises(OSError, f, test_support.make_bad_fd(), *args)



    def test_isatty(self):

        if hasattr(os, "isatty"):

            self.assertEqual(os.isatty(test_support.make_bad_fd()), False)



    def test_closerange(self):

        if hasattr(os, "closerange"):

            fd = test_support.make_bad_fd()

            # Make sure none of the descriptors we are about to close are

            # currently valid (issue 6542).

            for i in range(10):

                try: os.fstat(fd+i)

                except OSError:

                    pass

                else:

                    break

            if i < 2:

                # Unable to acquire a range of invalid file descriptors,

                # so skip the test (in 2.6+ this is a unittest.SkipTest).

                return

            self.assertEqual(os.closerange(fd, fd + i-1), None)



    def test_dup2(self):

        if hasattr(os, "dup2"):

            self.check(os.dup2, 20)



    def test_fchmod(self):

        if hasattr(os, "fchmod"):

            self.check(os.fchmod, 0)



    def test_fchown(self):

        if hasattr(os, "fchown"):

            self.check(os.fchown, -1, -1)



    def test_fpathconf(self):

        if hasattr(os, "fpathconf"):

            self.check(os.fpathconf, "PC_NAME_MAX")



    #this is a weird one, it raises IOError unlike the others

    def test_ftruncate(self):

        if hasattr(os, "ftruncate"):

            self.assertRaises(IOError, os.ftruncate, test_support.make_bad_fd(),

                              0)



    def test_lseek(self):

        if hasattr(os, "lseek"):

            self.check(os.lseek, 0, 0)



    def test_read(self):

        if hasattr(os, "read"):

            self.check(os.read, 1)



    def test_tcsetpgrpt(self):

        if hasattr(os, "tcsetpgrp"):

            self.check(os.tcsetpgrp, 0)



    def test_write(self):

        if hasattr(os, "write"):

            self.check(os.write, " ")



if sys.platform != 'win32':

    class Win32ErrorTests(unittest.TestCase):

        pass



    class PosixUidGidTests(unittest.TestCase):

        if hasattr(os, 'setuid'):

            def test_setuid(self):

                if os.getuid() != 0:

                    self.assertRaises(os.error, os.setuid, 0)

                self.assertRaises(OverflowError, os.setuid, 1<<32)



        if hasattr(os, 'setgid'):

            def test_setgid(self):

                if os.getuid() != 0:

                    self.assertRaises(os.error, os.setgid, 0)

                self.assertRaises(OverflowError, os.setgid, 1<<32)



        if hasattr(os, 'seteuid'):

            def test_seteuid(self):

                if os.getuid() != 0:

                    self.assertRaises(os.error, os.seteuid, 0)

                self.assertRaises(OverflowError, os.seteuid, 1<<32)



        if hasattr(os, 'setegid'):

            def test_setegid(self):

                if os.getuid() != 0:

                    self.assertRaises(os.error, os.setegid, 0)

                self.assertRaises(OverflowError, os.setegid, 1<<32)



        if hasattr(os, 'setreuid'):

            def test_setreuid(self):

                if os.getuid() != 0:

                    self.assertRaises(os.error, os.setreuid, 0, 0)

                self.assertRaises(OverflowError, os.setreuid, 1<<32, 0)

                self.assertRaises(OverflowError, os.setreuid, 0, 1<<32)



        if hasattr(os, 'setregid'):

            def test_setregid(self):

                if os.getuid() != 0:

                    self.assertRaises(os.error, os.setregid, 0, 0)

                self.assertRaises(OverflowError, os.setregid, 1<<32, 0)

                self.assertRaises(OverflowError, os.setregid, 0, 1<<32)

else:

    class PosixUidGidTests(unittest.TestCase):

        pass



def test_main():

    test_support.run_unittest(

        FileTests,

        TemporaryFileTests,

        StatAttributeTests,

        EnvironTests,

        WalkTests,

        MakedirTests,

        DevNullTests,

        URandomTests,

        Win32ErrorTests,

        TestInvalidFD,

        PosixUidGidTests

    )



if __name__ == "__main__":

    test_main()

