Willian Padovani Germano
a23c6a71da
- added function Blender.sys.exists(path) to check if a given file exists; - forgot to mention: in my previous commit the blender.html file was also updated slightly.
85 lines
1.9 KiB
Python
85 lines
1.9 KiB
Python
# Blender.sys module
|
|
|
|
"""
|
|
The Blender.sys submodule.
|
|
|
|
sys
|
|
===
|
|
|
|
B{New}: L{exists}
|
|
|
|
This module provides a minimal set of helper functions and data. Its purpose
|
|
is to avoid the need for the standard Python module 'os', in special 'os.path',
|
|
though it is only meant for the simplest cases.
|
|
|
|
Example::
|
|
|
|
import Blender
|
|
|
|
filename = ""
|
|
def f(name): # file selector callback
|
|
global filename
|
|
filename = name
|
|
|
|
Blender.Window.FileSelector(f)
|
|
|
|
if filename:
|
|
print 'basename:', Blender.sys.basename(filename)
|
|
print 'dirname:', Blender.sys.dirname(filename)
|
|
print 'splitext:', Blender.sys.splitext(filename)
|
|
|
|
# what would basename(splitext(filename)[0]) print?
|
|
|
|
@type sep: char
|
|
@var sep: the platform-specific dir separator for this Blender: '/'
|
|
everywhere, except on Win systems, that use '\\'.
|
|
@type dirsep: char
|
|
@var dirsep: same as L{sep}.
|
|
@type progname: string
|
|
@var progname: the Blender executable (argv[0]).
|
|
|
|
@attention: The module is called sys, not Sys.
|
|
"""
|
|
|
|
def basename (path):
|
|
"""
|
|
Get the base name (filename stripped from dir info) of 'path'.
|
|
@type path: string
|
|
@param path: a path name
|
|
@rtype: string
|
|
@return: the base name
|
|
"""
|
|
|
|
def dirname (path):
|
|
"""
|
|
Get the dir name (dir path stripped from filename) of 'path'.
|
|
@type path: string
|
|
@param path: a path name
|
|
@rtype: string
|
|
@return: the dir name
|
|
"""
|
|
|
|
def splitext (path):
|
|
"""
|
|
Split 'path' into (root, ext), where 'ext' is a file extension.
|
|
@type path: string
|
|
@param path: a path name
|
|
@rtype: list with two strings
|
|
@return: (root, ext)
|
|
"""
|
|
|
|
def exists(path):
|
|
"""
|
|
Tell if the given pathname (file or dir) exists.
|
|
@rtype: bool
|
|
@return: 1 if 'path' exists, 0 otherwise.
|
|
"""
|
|
|
|
def time ():
|
|
"""
|
|
Get the current time in seconds since a fixed value. Successive calls to
|
|
this function are garanteed to return values greater than the previous call.
|
|
@rtype: float
|
|
@return: the elapsed time in seconds.
|
|
"""
|