- small updates to scripts and bpython docs, also fixed two warnings;
[blender-staging.git] / source / blender / python / api2_2x / doc / Sys.py
1 # Blender.sys module
2
3 """
4 The Blender.sys submodule.
5
6 sys
7 ===
8
9 B{New}: L{exists}
10
11 This module provides a minimal set of helper functions and data.  Its purpose
12 is to avoid the need for the standard Python module 'os', in special 'os.path',
13 though it is only meant for the simplest cases.
14
15 Example::
16
17   import Blender
18
19   filename = ""
20   def f(name): # file selector callback
21     global filename
22     filename = name
23
24   Blender.Window.FileSelector(f)
25
26   if filename:
27     print 'basename:', Blender.sys.basename(filename)
28     print 'dirname:',  Blender.sys.dirname(filename)
29     print 'splitext:', Blender.sys.splitext(filename)
30
31   # what would basename(splitext(filename)[0]) print?
32
33 @type sep: char
34 @var sep: the platform-specific dir separator for this Blender: '/'
35     everywhere, except on Win systems, that use '\\'. 
36 @type dirsep: char
37 @var dirsep: same as L{sep}.
38 @type progname: string
39 @var progname: the Blender executable (argv[0]).
40
41 @attention: The module is called sys, not Sys.
42 """
43
44 def basename (path):
45   """
46   Get the base name (filename stripped from dir info) of 'path'.
47   @type path: string
48   @param path: a path name
49   @rtype: string
50   @return: the base name
51   """
52
53 def dirname (path):
54   """
55   Get the dir name (dir path stripped from filename) of 'path'.
56   @type path: string
57   @param path: a path name
58   @rtype: string
59   @return: the dir name
60   """
61
62 def splitext (path):
63   """
64   Split 'path' into (root, ext), where 'ext' is a file extension.
65   @type path: string
66   @param path: a path name
67   @rtype: list with two strings
68   @return: (root, ext)
69   """
70
71 def exists(path):
72   """
73   Tell if the given pathname (file or dir) exists.
74   @rtype: bool
75   @return: 1 if 'path' exists, 0 otherwise.
76   """
77
78 def time ():
79   """
80   Get the current time in seconds since a fixed value.  Successive calls to
81   this function are garanteed to return values greater than the previous call.
82   @rtype: float
83   @return: the elapsed time in seconds.
84   """