Added wxStandardPaths

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@30438 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/wxPython/setup.py b/wxPython/setup.py
index f86d77a1c3f594a17ce06907ba19eefff8b23c79..2140d6d359bdf95a085a1303aeeeb41c2a7ce4ce 100755 (executable)
--- a/wxPython/setup.py
+++ b/wxPython/setup.py
@@ -293,6 +293,7 @@ swig_sources = run_swig(['misc.i'], 'src', GENDIR, PKGDIR,
                           'src/_dnd.i',
                           'src/_display.i',
                           'src/_clipbrd.i',
+                          'src/_stdpaths.i',
                           ],
                         True)
 ext = Extension('_misc_', swig_sources,

diff --git a/wxPython/src/_stdpaths.i b/wxPython/src/_stdpaths.i
new file mode 100644 (file)
index 0000000..9c5d947
--- /dev/null
+++ b/wxPython/src/_stdpaths.i
@@ -0,0 +1,137 @@
+/////////////////////////////////////////////////////////////////////////////
+// Name:        _stdpaths.i
+// Purpose:     SWIG interface for wxStandardPaths
+//
+// Author:      Robin Dunn
+//
+// Created:     10-Nov-2004
+// RCS-ID:      $Id$
+// Copyright:   (c) 2004 by Total Control Software
+// Licence:     wxWindows license
+/////////////////////////////////////////////////////////////////////////////
+
+// Not a %module
+
+
+//---------------------------------------------------------------------------
+
+%{
+#include <wx/stdpaths.h>
+%}
+
+
+//---------------------------------------------------------------------------
+%newgroup
+
+DocStr(wxStandardPaths,
+"wx.StandardPaths returns the standard locations in the file system and
+should be used by the programs to find their data files in a portable
+way.
+
+In the description of the methods below, the example return values are
+given for the Unix, Windows and Mac OS X systems, however please note
+that these are just the examples and the actual values may differ. For
+example, under Windows: the system administrator may change the
+standard directories locations, i.e. the Windows directory may be
+named W:\Win2003 instead of the default C:\Windows.
+
+The strings appname and username should be replaced with the value
+returned by `wx.App.GetAppName` and the name of the currently logged
+in user, respectively. The string prefix is only used under Unix and
+is /usr/local by default but may be changed using `SetInstallPrefix`.
+
+The directories returned by the methods of this class may or may not
+exist. If they don't exist, it's up to the caller to create them,
+wxStandardPaths doesn't do it.
+
+Finally note that these functions only work with standardly packaged
+applications. I.e. under Unix you should follow the standard
+installation conventions and under Mac you should create your
+application bundle according to the Apple guidelines. Again, this
+class doesn't help you to do it.", "");
+
+class wxStandardPaths
+{
+public:
+    
+    DocDeclStr(
+        static wxStandardPaths& , Get(),
+        "Return the global standard paths object", "");
+    
+    DocDeclStr(
+        virtual wxString , GetConfigDir() const,
+        "Return the directory with system config files: /etc under Unix,
+c:\Documents and Settings\All Users\Application Data under Windows,
+/Library/Preferences for Mac", "");
+
+    
+    DocDeclStr(
+        virtual wxString , GetUserConfigDir() const,
+        "Return the directory for the user config files: $HOME under Unix,
+c:\Documents and Settings\username under Windows,
+~/Library/Preferences under Mac
+    
+Only use this if you have a single file to put there, otherwise
+`GetUserDataDir` is more appropriate", "");
+
+    
+    DocDeclStr(
+        virtual wxString , GetDataDir() const,
+        "Return the location of the application's global, (i.e. not
+user-specific,) data files: prefix/share/appname under Unix,
+c:\Program Files\appname under Windows,
+appname.app/Contents/SharedSupport app bundle directory under Mac.", "");
+
+    
+    DocDeclStr(
+        virtual wxString , GetLocalDataDir() const,
+        "Return the location for application data files which are
+host-specific.  Same as `GetDataDir` except under Unix where it is
+/etc/appname", "");
+
+
+    DocDeclStr(
+        virtual wxString , GetUserDataDir() const,
+        "Return the directory for the user-dependent application data files:
+$HOME/.appname under Unix, c:\Documents and
+Settings\username\Application Data\appname under Windows and
+~/Library/Application Support/appname under Mac", "");
+    
+
+    DocDeclStr(
+        virtual wxString , GetUserLocalDataDir() const,
+        "Return the directory for user data files which shouldn't be shared
+with the other machines
+
+Same as `GetUserDataDir` for all platforms except Windows where it is
+the 'Local Settings\Application Data\appname' directory.", "");
+
+
+    DocDeclStr(
+        virtual wxString , GetPluginsDir() const,
+        "Return the directory where the loadable modules (plugins) live:
+prefix/lib/appname under Unix, program directory under Windows and
+Contents/Plugins app bundle subdirectory under Mac", "");
+
+    
+#ifdef __WXGTK__
+    DocDeclStr(
+        void , SetInstallPrefix(const wxString& prefix),
+        "Set the program installation directory which is /usr/local by default.
+This value will be used by other methods such as `GetDataDir` and
+`GetPluginsDir` as the prefix for what they return. (Unix only.)", "");
+    
+
+    DocDeclStr(
+        wxString , GetInstallPrefix() const,
+        "Get the program installation prefix. (Unix only.)", "");
+#else
+    %extend {
+        void SetInstallPrefix(const wxString& prefix) {}
+        wxString GetInstallPrefix() { return wxEmptyString; }
+    }
+#endif
+};
+
+
+//---------------------------------------------------------------------------

diff --git a/wxPython/src/misc.i b/wxPython/src/misc.i
index 270d49696da215c5c831a6d518ab1378b3ceb599..a9c849a562370d7fec1f6542fbd1807424868bde 100644 (file)
--- a/wxPython/src/misc.i
+++ b/wxPython/src/misc.i
@@ -49,5 +49,6 @@ MAKE_CONST_WXSTRING_NOSWIG(EmptyString);
 %include _dnd.i
 %include _clipbrd.i
 %include _display.i
+%include _stdpaths.i
 
 //---------------------------------------------------------------------------

diff --git a/wxPython/wxPython/_misc.py b/wxPython/wxPython/_misc.py
index d9a4334a78d471955becba04c4ed22a62a09dc5d..65d24adb162e11dc2825ae854d5703eca211ef93 100644 (file)
--- a/wxPython/wxPython/_misc.py
+++ b/wxPython/wxPython/_misc.py
@@ -581,6 +581,9 @@ wxDisplayPtr = wx._misc.DisplayPtr
 wxDisplay_GetCount = wx._misc.Display_GetCount
 wxDisplay_GetFromPoint = wx._misc.Display_GetFromPoint
 wxDisplay_GetFromWindow = wx._misc.Display_GetFromWindow
+wxStandardPaths = wx._misc.StandardPaths
+wxStandardPathsPtr = wx._misc.StandardPathsPtr
+wxStandardPaths_Get = wx._misc.StandardPaths_Get
 wxPyTimer = wx._misc.PyTimer
 wxPyDropTarget = wx._misc.PyDropTarget
 wxTheClipboard = wx._misc.TheClipboard