dabodoc Commit Revision 60 Date: 2011-02-26 01:59:47 -0800 (Sat, 26 Feb 2011) Author: Werner Trac: http://trac.dabodev.com/changeset/60
Changed: A trunk/api/sphinx/ A trunk/api/sphinx/_rst_basefiles/ A trunk/api/sphinx/_rst_basefiles/index_htmlhelp.rst A trunk/api/sphinx/_rst_basefiles/index_latex no.rst A trunk/api/sphinx/_rst_basefiles/index_normal.rst A trunk/api/sphinx/_rst_basefiles/tree_module_list.rst A trunk/api/sphinx/build/ A trunk/api/sphinx/config.py A trunk/api/sphinx/genGallery.py A trunk/api/sphinx/make.bat A trunk/api/sphinx/makeRST.py A trunk/api/sphinx/makeSphinx.py A trunk/api/sphinx/source/ A trunk/api/sphinx/source/_static/ A trunk/api/sphinx/source/_static/AGW.css A trunk/api/sphinx/source/_static/API.png A trunk/api/sphinx/source/_static/About.png A trunk/api/sphinx/source/_static/About_thumb.png A trunk/api/sphinx/source/_static/Appearance.png A trunk/api/sphinx/source/_static/Backward.png A trunk/api/sphinx/source/_static/Class_Hierarchy.png A trunk/api/sphinx/source/_static/Class_Summary.png A trunk/api/sphinx/source/_static/Description.png A trunk/api/sphinx/source/_static/EasyDialogBuilder.png A trunk/api/sphinx/source/_static/EasyDialogBuilder_thumb.png A trunk/api/sphinx/source/_static/Events.png A trunk/api/sphinx/source/_static/Indices.png A trunk/api/sphinx/source/_static/Layout.png A trunk/api/sphinx/source/_static/License.png A trunk/api/sphinx/source/_static/Link.png A trunk/api/sphinx/source/_static/Login.png A trunk/api/sphinx/source/_static/Login_thumb.png A trunk/api/sphinx/source/_static/Method_Summary.png A trunk/api/sphinx/source/_static/Other_Info.png A trunk/api/sphinx/source/_static/Platforms.png A trunk/api/sphinx/source/_static/PreferenceDialog.png A trunk/api/sphinx/source/_static/PreferenceDialog_thumb.png A trunk/api/sphinx/source/_static/Python.png A trunk/api/sphinx/source/_static/Settings.png A trunk/api/sphinx/source/_static/SortingForm.png A trunk/api/sphinx/source/_static/SortingForm_thumb.png A trunk/api/sphinx/source/_static/Stats.png A trunk/api/sphinx/source/_static/SubClasses.png A trunk/api/sphinx/source/_static/SuperClasses.png A trunk/api/sphinx/source/_static/Table_Contents.png A trunk/api/sphinx/source/_static/Usage.png A trunk/api/sphinx/source/_static/Window_Extra_Styles.png A trunk/api/sphinx/source/_static/Window_Styles.png A trunk/api/sphinx/source/_static/Wizard.png A trunk/api/sphinx/source/_static/Wizard_thumb.png A trunk/api/sphinx/source/_static/background.png A trunk/api/sphinx/source/_static/dBaseMenuBar.png A trunk/api/sphinx/source/_static/dBaseMenuBar_thumb.png A trunk/api/sphinx/source/_static/dBitmap.png A trunk/api/sphinx/source/_static/dBitmapButton.png A trunk/api/sphinx/source/_static/dBitmapButton_thumb.png A trunk/api/sphinx/source/_static/dBitmap_thumb.png A trunk/api/sphinx/source/_static/dBorderLessButton.png A trunk/api/sphinx/source/_static/dBorderLessButton_thumb.png A trunk/api/sphinx/source/_static/dBorderSizer.png A trunk/api/sphinx/source/_static/dBorderSizer_thumb.png A trunk/api/sphinx/source/_static/dButton.png A trunk/api/sphinx/source/_static/dButton_thumb.png A trunk/api/sphinx/source/_static/dCalendar.png A trunk/api/sphinx/source/_static/dCalendar_thumb.png A trunk/api/sphinx/source/_static/dCheckBox.png A trunk/api/sphinx/source/_static/dCheckBox_thumb.png A trunk/api/sphinx/source/_static/dCheckList.png A trunk/api/sphinx/source/_static/dCheckList_thumb.png A trunk/api/sphinx/source/_static/dColorDialog.png A trunk/api/sphinx/source/_static/dColorDialog_thumb.png A trunk/api/sphinx/source/_static/dComboBox.png A trunk/api/sphinx/source/_static/dComboBox_thumb.png A trunk/api/sphinx/source/_static/dDialog.png A trunk/api/sphinx/source/_static/dDialog_thumb.png A trunk/api/sphinx/source/_static/dDockForm.png A trunk/api/sphinx/source/_static/dDockForm_thumb.png A trunk/api/sphinx/source/_static/dDockTabs.png A trunk/api/sphinx/source/_static/dDockTabs_thumb.png A trunk/api/sphinx/source/_static/dDropDownList.png A trunk/api/sphinx/source/_static/dDropDownList_thumb.png A trunk/api/sphinx/source/_static/dEditBox.png A trunk/api/sphinx/source/_static/dEditBox_thumb.png A trunk/api/sphinx/source/_static/dEditableList.png A trunk/api/sphinx/source/_static/dEditableList_thumb.png A trunk/api/sphinx/source/_static/dEditor.png A trunk/api/sphinx/source/_static/dEditor_thumb.png A trunk/api/sphinx/source/_static/dFileDialog.png A trunk/api/sphinx/source/_static/dFileDialog_thumb.png A trunk/api/sphinx/source/_static/dFolderDialog.png A trunk/api/sphinx/source/_static/dFolderDialog_thumb.png A trunk/api/sphinx/source/_static/dFontDialog.png A trunk/api/sphinx/source/_static/dFontDialog_thumb.png A trunk/api/sphinx/source/_static/dForm.png A trunk/api/sphinx/source/_static/dForm1.png A trunk/api/sphinx/source/_static/dForm1_thumb.png A trunk/api/sphinx/source/_static/dFormMain.png A trunk/api/sphinx/source/_static/dFormMain_thumb.png A trunk/api/sphinx/source/_static/dForm_thumb.png A trunk/api/sphinx/source/_static/dGauge.png A trunk/api/sphinx/source/_static/dGauge_thumb.png A trunk/api/sphinx/source/_static/dGrid.png A trunk/api/sphinx/source/_static/dGrid_thumb.png A trunk/api/sphinx/source/_static/dHtmlAbout.png A trunk/api/sphinx/source/_static/dHtmlAbout_thumb.png A trunk/api/sphinx/source/_static/dHtmlBox.png A trunk/api/sphinx/source/_static/dHtmlBox_thumb.png A trunk/api/sphinx/source/_static/dHyperLink.png A trunk/api/sphinx/source/_static/dHyperLink_thumb.png A trunk/api/sphinx/source/_static/dImage.png A trunk/api/sphinx/source/_static/dImage_thumb.png A trunk/api/sphinx/source/_static/dLabel.png A trunk/api/sphinx/source/_static/dLabel_thumb.png A trunk/api/sphinx/source/_static/dLed.png A trunk/api/sphinx/source/_static/dLed_thumb.png A trunk/api/sphinx/source/_static/dLinePlot.png A trunk/api/sphinx/source/_static/dLinePlot_thumb.png A trunk/api/sphinx/source/_static/dListBox.png A trunk/api/sphinx/source/_static/dListBox_thumb.png A trunk/api/sphinx/source/_static/dListControl.png A trunk/api/sphinx/source/_static/dListControl_thumb.png A trunk/api/sphinx/source/_static/dMaskedTextBox.png A trunk/api/sphinx/source/_static/dMaskedTextBox_thumb.png A trunk/api/sphinx/source/_static/dMessageBox.png A trunk/api/sphinx/source/_static/dMessageBox_thumb.png A trunk/api/sphinx/source/_static/dPage.png A trunk/api/sphinx/source/_static/dPageFrame.png A trunk/api/sphinx/source/_static/dPageFrameNoTabs.png A trunk/api/sphinx/source/_static/dPageFrameNoTabs_thumb.png A trunk/api/sphinx/source/_static/dPageFrame_thumb.png A trunk/api/sphinx/source/_static/dPageList.png A trunk/api/sphinx/source/_static/dPageList_thumb.png A trunk/api/sphinx/source/_static/dPageSelect.png A trunk/api/sphinx/source/_static/dPageSelect_thumb.png A trunk/api/sphinx/source/_static/dPageStyled.png A trunk/api/sphinx/source/_static/dPageStyled_thumb.png A trunk/api/sphinx/source/_static/dPageToolBar.png A trunk/api/sphinx/source/_static/dPageToolBar_thumb.png A trunk/api/sphinx/source/_static/dPage_thumb.png A trunk/api/sphinx/source/_static/dPanel.png A trunk/api/sphinx/source/_static/dPanel_thumb.png A trunk/api/sphinx/source/_static/dPdfWindow.png A trunk/api/sphinx/source/_static/dPdfWindow_thumb.png A trunk/api/sphinx/source/_static/dRadioList.png A trunk/api/sphinx/source/_static/dRadioList_thumb.png A trunk/api/sphinx/source/_static/dRichTextBox.png A trunk/api/sphinx/source/_static/dRichTextBox_thumb.png A trunk/api/sphinx/source/_static/dSaveDialog.png A trunk/api/sphinx/source/_static/dSaveDialog_thumb.png A trunk/api/sphinx/source/_static/dScrollPanel.png A trunk/api/sphinx/source/_static/dScrollPanel_thumb.png A trunk/api/sphinx/source/_static/dSearchBox.png A trunk/api/sphinx/source/_static/dSearchBox_thumb.png A trunk/api/sphinx/source/_static/dShell.png A trunk/api/sphinx/source/_static/dShell_thumb.png A trunk/api/sphinx/source/_static/dSlidePanel.png A trunk/api/sphinx/source/_static/dSlidePanel_thumb.png A trunk/api/sphinx/source/_static/dSlider.png A trunk/api/sphinx/source/_static/dSlider_thumb.png A trunk/api/sphinx/source/_static/dSpinner.png A trunk/api/sphinx/source/_static/dSpinner_thumb.png A trunk/api/sphinx/source/_static/dSplitForm.png A trunk/api/sphinx/source/_static/dSplitForm_thumb.png A trunk/api/sphinx/source/_static/dSplitter.png A trunk/api/sphinx/source/_static/dSplitter_thumb.png A trunk/api/sphinx/source/_static/dTextBox.png A trunk/api/sphinx/source/_static/dTextBox_thumb.png A trunk/api/sphinx/source/_static/dToggleButton.png A trunk/api/sphinx/source/_static/dToggleButton_thumb.png A trunk/api/sphinx/source/_static/dToolBar.png A trunk/api/sphinx/source/_static/dToolBar_thumb.png A trunk/api/sphinx/source/_static/dTreeView.png A trunk/api/sphinx/source/_static/dTreeView_thumb.png A trunk/api/sphinx/source/_static/dabo_horizontal_sidebar.png A trunk/api/sphinx/source/_static/dabo_logo.png A trunk/api/sphinx/source/_static/dabo_small.png A trunk/api/sphinx/source/_static/doc_title.png A trunk/api/sphinx/source/_static/file_info.png A trunk/api/sphinx/source/_static/headings.txt A trunk/api/sphinx/source/_static/minus2.png A trunk/api/sphinx/source/_static/plus2.png A trunk/api/sphinx/source/_static/svn.gif A trunk/api/sphinx/source/_static/svn_diff.gif A trunk/api/sphinx/source/_static/svn_log.png A trunk/api/sphinx/source/_static/svn_main.gif A trunk/api/sphinx/source/_static/todo_big.png A trunk/api/sphinx/source/_static/vision.png A trunk/api/sphinx/source/_static/whatsnew.png A trunk/api/sphinx/source/_templates/ A trunk/api/sphinx/source/_templates/gallery.html A trunk/api/sphinx/source/_templates/layout.html A trunk/api/sphinx/source/conf.py A trunk/api/sphinx/source/dabo_theme/ A trunk/api/sphinx/source/dabo_theme/layout.html A trunk/api/sphinx/source/dabo_theme/static/ A trunk/api/sphinx/source/dabo_theme/static/default.css_t A trunk/api/sphinx/source/dabo_theme/static/sidebar.js A trunk/api/sphinx/source/dabo_theme/theme.conf A trunk/api/sphinx/tempsource/ Log: - initial commit for the Sphinx build stuff Diff: Added: trunk/api/sphinx/_rst_basefiles/index_htmlhelp.rst =================================================================== --- trunk/api/sphinx/_rst_basefiles/index_htmlhelp.rst (rev 0) +++ trunk/api/sphinx/_rst_basefiles/index_htmlhelp.rst 2011-02-26 09:59:47 UTC (rev 60) @@ -0,0 +1,183 @@ +.. include:: _static/headings.txt + +======================================================== +|doc_title| **Dabo - The desktop application framework** +======================================================== + +Desktop applications. That's what Dabo does. It's not YAWF (yet another web framework). +There are plenty of excellent web frameworks out there, so if that's what you are looking +for, Dabo isn't for you. But there are almost no desktop application frameworks out there, +and if you want to create applications that run on Windows, OS X or Linux, Dabo is for you! + +| + +.. figure:: _static/dabo_horizontal_sidebar.png + :alt: dabo screenshots + :figclass: floatcenter + :align: center + :target: gallery.html + + **Dabo** sample screenshots + +| + +:Version: |version| +:Date: |today| + + +========================= +|description| Description +========================= + +Dabo is a 3-tier, cross-platform application development framework, written in Python atop the wxPython GUI toolkit. And while Dabo is designed to create database-centric apps, that is not a requirement. Lots of people are using Dabo for the GUI tools to create apps that have no need to connect to a database at all. + + +======================== +|description| Background +======================== + +Dabo's authors, Ed Leafe and Paul McNett, have strong backgrounds in database application development using the awesome and underrated Microsoft Visual FoxPro development environment. + +While Visual FoxPro shines at developing data-centric applications, it has one limitation that cannot be ignored: it only runs on Microsoft Windows, and Ed and Paul both have clients that want their applications to run on Linux and Macintosh. We are sure we are not alone in this regard: it is a multi-platform world with more diverse needs than one vendor can fulfill. + +Ed and Paul got to talking one day: Paul had been researching various multiplatform GUI toolkits for about 18 months, and Ed has lots of experience developing the Visual FoxPro Codebook framework. We decided to work together to make a framework for developing robust data-centric applications for multi-platform deployment. We've come up with a design that is simple, flexible, and robust, and we've begun developing our own client applications using the Dabo framework. + +=========================== +|description| 3-Tier Design +=========================== + +We have taken what we've learned from 25 combined years of FoxPro database application development, and built an easy-to-use runtime framework that runs on all three major platforms. Dabo consists of 3 logical tiers plus an umbrella application object. The three tiers are: + +====================== +|description| Database +====================== + +Currently, Dabo supports MySQL, PostgreSQL, Firebird, Microsoft SQL Server and SQLite backends, but in the near future it will support all databases that have drivers that conform to the Python dbapi. These databases include: + + * MySQL (already supported) + * PostgreSQL(already supported) + * Firebird (already supported) + * MS-SQL and MSDE (already supported) + * SQLite (already supported) + * Oracle + * DB2 + * Sybase + * Berkeley DB + +============================ +|description| Business Rules +============================ + +This tier is where all the business logic resides. You simply subclass dBizobj, set a few properties, and override a few methods. The dBizobj communicates with the database tier and the user interface tier, and enforces your business rules to your specifications. + +============================ +|description| User Interface +============================ + +You create your forms by laying out various controls or widgets, and setting properties to tell Dabo what bizobj and what field in the dataset the control represents. There is no business logic at this level, and only minimal code will be entered here: it is mostly laying out your UI design and setting properties to tell Dabo how to connect to the business rules. + +Currently, the only supported UI is wxPython, but we've left it open for possible future additions of other UI libraries, such as: + + * wxPython (already supported) + * PyQt + * TkInter + * Curses (text only - perhaps the computer isn't running a GUI) + * HTTP (web server providing a browser interface) + +However, wrapping a UI toolkit is a major effort, so don't hold your breath waiting for any of the other UIs - unless, of course, you want to volunteer to work with us to get it working! + +============================ +|description| Multi-Platform +============================ + +Dabo applications are known to run on all flavors of Windows, all recent flavors of Linux, and Macintosh OS X 10.2 or higher. Because Dabo is currently built on top of wxPython, which is built on top of wxWidgets, it probably runs elsewhere, too. It also suffers from the same display limitations on some platforms (most notably OS X), but these should improve as the underlying toolkits improve. + +You can develop Dabo applications on all three supported platforms, and you can run your Dabo applications on all three supported platforms. Flexibility is a really good thing. + +======================= +|description| Community +======================= + +Visual FoxPro has a vibrant, vocal, energetic community that knows how to have a good time. From what we've seen of the Python community so far, the same goes there. We hope to provide the structure for forming a new community, a Dabo community that shares ideas and code, supports one-another, and hopefully even gets together once a year to socialize. There are mailing lists for users of Dabo and developers of Dabo, and a world-editable Dabo Wiki. We are friendly and look forward to meeting you. + +Oh, and if you are a disenchanted Visual Basic developer, you've found the right place, too. + +============================== +|other_info| Other Information +============================== + +Bugs and Limitations: many, patches and fixes welcome :-D + +See the demo for an example of what **Dabo** can do, and on how to use it. + +--------------- + +Copyright: Ed Leafe and Paul McNett + +License: As of 11/4/2004, Dabo is licensed under the very liberal MIT License, which allows you to do whatever you want with our code, as long as the copyright notice and license terms remain intact. See http://www.dabodev.com/licensing. + +--------------- + +SVN for latest code: +http://svn.dabodev.com/dabo/trunk/dabo + +Mailing List: [email protected] + +--------------- + +Please let us know if you are using **Dabo**! + +--------------- + +**Dabo** version: |version| + +Last updated: |today|, 10.00 GMT + +--------------- + + +|table_contents| Table of Contents +================================== + +| + ++-----------------------------------+-----------------------------------+ +| Dabo | Databases supported | ++===================================+===================================+ +| * :ref:`dabo.dApp` | * :ref:`dabo.db.dbFirebird` | +| * :ref:`dabo.dObject` | * :ref:`dabo.db.dbMSSQL` | +| * :ref:`dabo.dReportWriter` | * :ref:`dabo.db.dbMySQL` | +| * :ref:`dabo.dSecurityManager` | * :ref:`dabo.db.dbPostgreSQL` | +| * :ref:`dabo.dUserSettingProvider`| * :ref:`dabo.db.dbSQLite` | ++-----------------------------------+-----------------------------------+ +| db module | biz module | ++-----------------------------------+-----------------------------------+ +| * :ref:`dabo.db.dBackend` | * :ref:`dabo.biz.dBizobj` | +| * :ref:`dabo.db.dConnectInfo` | * :ref:`dabo.biz.dAutoBizobj` | +| * :ref:`dabo.db.dConnection` | * :ref:`dabo.biz.RemoteBizObj` | +| * :ref:`dabo.db.dCursorMixin` | | +| * :ref:`dabo.db.dNoEscQuoteStr` | | +| * :ref:`dabo.db.dTable` | | +| | | ++-----------------------------------+-----------------------------------+ +| ui module | | ++-----------------------------------+-----------------------------------+ +| * :ref:`dabo.ui` | | ++-----------------------------------+-----------------------------------+ + + + +|indices| Indices and tables +============================ + +* :ref:`daboindex` +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + +.. toctree:: + :hidden: + + general_index + Added: trunk/api/sphinx/_rst_basefiles/index_latex no.rst =================================================================== --- trunk/api/sphinx/_rst_basefiles/index_latex no.rst (rev 0) +++ trunk/api/sphinx/_rst_basefiles/index_latex no.rst 2011-02-26 09:59:47 UTC (rev 60) @@ -0,0 +1,183 @@ +.. include:: _static/headings.txt + +======================================================== +|doc_title| **Dabo - The desktop application framework** +======================================================== + +Desktop applications. That's what Dabo does. It's not YAWF (yet another web framework). +There are plenty of excellent web frameworks out there, so if that's what you are looking +for, Dabo isn't for you. But there are almost no desktop application frameworks out there, +and if you want to create applications that run on Windows, OS X or Linux, Dabo is for you! + +| + +.. figure:: _static/dabo_horizontal_sidebar.png + :alt: dabo screenshots + :figclass: floatcenter + :align: center + :target: gallery.html + + **Dabo** sample screenshots + +| + +:Version: |version| +:Date: |today| + + +========================= +|description| Description +========================= + +Dabo is a 3-tier, cross-platform application development framework, written in Python atop the wxPython GUI toolkit. And while Dabo is designed to create database-centric apps, that is not a requirement. Lots of people are using Dabo for the GUI tools to create apps that have no need to connect to a database at all. + + +======================== +|description| Background +======================== + +Dabo's authors, Ed Leafe and Paul McNett, have strong backgrounds in database application development using the awesome and underrated Microsoft Visual FoxPro development environment. + +While Visual FoxPro shines at developing data-centric applications, it has one limitation that cannot be ignored: it only runs on Microsoft Windows, and Ed and Paul both have clients that want their applications to run on Linux and Macintosh. We are sure we are not alone in this regard: it is a multi-platform world with more diverse needs than one vendor can fulfill. + +Ed and Paul got to talking one day: Paul had been researching various multiplatform GUI toolkits for about 18 months, and Ed has lots of experience developing the Visual FoxPro Codebook framework. We decided to work together to make a framework for developing robust data-centric applications for multi-platform deployment. We've come up with a design that is simple, flexible, and robust, and we've begun developing our own client applications using the Dabo framework. + +=========================== +|description| 3-Tier Design +=========================== + +We have taken what we've learned from 25 combined years of FoxPro database application development, and built an easy-to-use runtime framework that runs on all three major platforms. Dabo consists of 3 logical tiers plus an umbrella application object. The three tiers are: + +====================== +|description| Database +====================== + +Currently, Dabo supports MySQL, PostgreSQL, Firebird, Microsoft SQL Server and SQLite backends, but in the near future it will support all databases that have drivers that conform to the Python dbapi. These databases include: + + * MySQL (already supported) + * PostgreSQL(already supported) + * Firebird (already supported) + * MS-SQL and MSDE (already supported) + * SQLite (already supported) + * Oracle + * DB2 + * Sybase + * Berkeley DB + +============================ +|description| Business Rules +============================ + +This tier is where all the business logic resides. You simply subclass dBizobj, set a few properties, and override a few methods. The dBizobj communicates with the database tier and the user interface tier, and enforces your business rules to your specifications. + +============================ +|description| User Interface +============================ + +You create your forms by laying out various controls or widgets, and setting properties to tell Dabo what bizobj and what field in the dataset the control represents. There is no business logic at this level, and only minimal code will be entered here: it is mostly laying out your UI design and setting properties to tell Dabo how to connect to the business rules. + +Currently, the only supported UI is wxPython, but we've left it open for possible future additions of other UI libraries, such as: + + * wxPython (already supported) + * PyQt + * TkInter + * Curses (text only - perhaps the computer isn't running a GUI) + * HTTP (web server providing a browser interface) + +However, wrapping a UI toolkit is a major effort, so don't hold your breath waiting for any of the other UIs - unless, of course, you want to volunteer to work with us to get it working! + +============================ +|description| Multi-Platform +============================ + +Dabo applications are known to run on all flavors of Windows, all recent flavors of Linux, and Macintosh OS X 10.2 or higher. Because Dabo is currently built on top of wxPython, which is built on top of wxWidgets, it probably runs elsewhere, too. It also suffers from the same display limitations on some platforms (most notably OS X), but these should improve as the underlying toolkits improve. + +You can develop Dabo applications on all three supported platforms, and you can run your Dabo applications on all three supported platforms. Flexibility is a really good thing. + +======================= +|description| Community +======================= + +Visual FoxPro has a vibrant, vocal, energetic community that knows how to have a good time. From what we've seen of the Python community so far, the same goes there. We hope to provide the structure for forming a new community, a Dabo community that shares ideas and code, supports one-another, and hopefully even gets together once a year to socialize. There are mailing lists for users of Dabo and developers of Dabo, and a world-editable Dabo Wiki. We are friendly and look forward to meeting you. + +Oh, and if you are a disenchanted Visual Basic developer, you've found the right place, too. + +============================== +|other_info| Other Information +============================== + +Bugs and Limitations: many, patches and fixes welcome :-D + +See the demo for an example of what **Dabo** can do, and on how to use it. + +--------------- + +Copyright: Ed Leafe and Paul McNett + +License: As of 11/4/2004, Dabo is licensed under the very liberal MIT License, which allows you to do whatever you want with our code, as long as the copyright notice and license terms remain intact. See http://www.dabodev.com/licensing. + +--------------- + +SVN for latest code: +http://svn.dabodev.com/dabo/trunk/dabo + +Mailing List: [email protected] + +--------------- + +Please let us know if you are using **Dabo**! + +--------------- + +**Dabo** version: |version| + +Last updated: |today|, 10.00 GMT + +--------------- + + +|table_contents| Table of Contents +================================== + +| + ++-----------------------------------+-----------------------------------+ +| Dabo | Databases supported | ++===================================+===================================+ +| * :ref:`dabo.dApp` | * :ref:`dabo.db.dbFirebird` | +| * :ref:`dabo.dObject` | * :ref:`dabo.db.dbMSSQL` | +| * :ref:`dabo.dReportWriter` | * :ref:`dabo.db.dbMySQL` | +| * :ref:`dabo.dSecurityManager` | * :ref:`dabo.db.dbPostgreSQL` | +| * :ref:`dabo.dUserSettingProvider`| * :ref:`dabo.db.dbSQLite` | ++-----------------------------------+-----------------------------------+ +| db module | biz module | ++-----------------------------------+-----------------------------------+ +| * :ref:`dabo.db.dBackend` | * :ref:`dabo.biz.dBizobj` | +| * :ref:`dabo.db.dConnectInfo` | * :ref:`dabo.biz.dAutoBizobj` | +| * :ref:`dabo.db.dConnection` | * :ref:`dabo.biz.RemoteBizObj` | +| * :ref:`dabo.db.dCursorMixin` | | +| * :ref:`dabo.db.dNoEscQuoteStr` | | +| * :ref:`dabo.db.dTable` | | +| | | ++-----------------------------------+-----------------------------------+ +| ui module | | ++-----------------------------------+-----------------------------------+ +| * :ref:`dabo.ui` | | ++-----------------------------------+-----------------------------------+ + + + +|indices| Indices and tables +============================ + +* :ref:`daboindex` +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + +.. toctree:: + :hidden: + + general_index + Added: trunk/api/sphinx/_rst_basefiles/index_normal.rst =================================================================== --- trunk/api/sphinx/_rst_basefiles/index_normal.rst (rev 0) +++ trunk/api/sphinx/_rst_basefiles/index_normal.rst 2011-02-26 09:59:47 UTC (rev 60) @@ -0,0 +1,183 @@ +.. include:: _static/headings.txt + +======================================================== +|doc_title| **Dabo - The desktop application framework** +======================================================== + +Desktop applications. That's what Dabo does. It's not YAWF (yet another web framework). +There are plenty of excellent web frameworks out there, so if that's what you are looking +for, Dabo isn't for you. But there are almost no desktop application frameworks out there, +and if you want to create applications that run on Windows, OS X or Linux, Dabo is for you! + +| + +.. figure:: _static/dabo_horizontal_sidebar.png + :alt: dabo screenshots + :figclass: floatcenter + :align: center + :target: gallery.html + + **Dabo** sample screenshots + +| + +:Version: |version| +:Date: |today| + + +========================= +|description| Description +========================= + +Dabo is a 3-tier, cross-platform application development framework, written in Python atop the wxPython GUI toolkit. And while Dabo is designed to create database-centric apps, that is not a requirement. Lots of people are using Dabo for the GUI tools to create apps that have no need to connect to a database at all. + + +======================== +|description| Background +======================== + +Dabo's authors, Ed Leafe and Paul McNett, have strong backgrounds in database application development using the awesome and underrated Microsoft Visual FoxPro development environment. + +While Visual FoxPro shines at developing data-centric applications, it has one limitation that cannot be ignored: it only runs on Microsoft Windows, and Ed and Paul both have clients that want their applications to run on Linux and Macintosh. We are sure we are not alone in this regard: it is a multi-platform world with more diverse needs than one vendor can fulfill. + +Ed and Paul got to talking one day: Paul had been researching various multiplatform GUI toolkits for about 18 months, and Ed has lots of experience developing the Visual FoxPro Codebook framework. We decided to work together to make a framework for developing robust data-centric applications for multi-platform deployment. We've come up with a design that is simple, flexible, and robust, and we've begun developing our own client applications using the Dabo framework. + +=========================== +|description| 3-Tier Design +=========================== + +We have taken what we've learned from 25 combined years of FoxPro database application development, and built an easy-to-use runtime framework that runs on all three major platforms. Dabo consists of 3 logical tiers plus an umbrella application object. The three tiers are: + +====================== +|description| Database +====================== + +Currently, Dabo supports MySQL, PostgreSQL, Firebird, Microsoft SQL Server and SQLite backends, but in the near future it will support all databases that have drivers that conform to the Python dbapi. These databases include: + + * MySQL (already supported) + * PostgreSQL(already supported) + * Firebird (already supported) + * MS-SQL and MSDE (already supported) + * SQLite (already supported) + * Oracle + * DB2 + * Sybase + * Berkeley DB + +============================ +|description| Business Rules +============================ + +This tier is where all the business logic resides. You simply subclass dBizobj, set a few properties, and override a few methods. The dBizobj communicates with the database tier and the user interface tier, and enforces your business rules to your specifications. + +============================ +|description| User Interface +============================ + +You create your forms by laying out various controls or widgets, and setting properties to tell Dabo what bizobj and what field in the dataset the control represents. There is no business logic at this level, and only minimal code will be entered here: it is mostly laying out your UI design and setting properties to tell Dabo how to connect to the business rules. + +Currently, the only supported UI is wxPython, but we've left it open for possible future additions of other UI libraries, such as: + + * wxPython (already supported) + * PyQt + * TkInter + * Curses (text only - perhaps the computer isn't running a GUI) + * HTTP (web server providing a browser interface) + +However, wrapping a UI toolkit is a major effort, so don't hold your breath waiting for any of the other UIs - unless, of course, you want to volunteer to work with us to get it working! + +============================ +|description| Multi-Platform +============================ + +Dabo applications are known to run on all flavors of Windows, all recent flavors of Linux, and Macintosh OS X 10.2 or higher. Because Dabo is currently built on top of wxPython, which is built on top of wxWidgets, it probably runs elsewhere, too. It also suffers from the same display limitations on some platforms (most notably OS X), but these should improve as the underlying toolkits improve. + +You can develop Dabo applications on all three supported platforms, and you can run your Dabo applications on all three supported platforms. Flexibility is a really good thing. + +======================= +|description| Community +======================= + +Visual FoxPro has a vibrant, vocal, energetic community that knows how to have a good time. From what we've seen of the Python community so far, the same goes there. We hope to provide the structure for forming a new community, a Dabo community that shares ideas and code, supports one-another, and hopefully even gets together once a year to socialize. There are mailing lists for users of Dabo and developers of Dabo, and a world-editable Dabo Wiki. We are friendly and look forward to meeting you. + +Oh, and if you are a disenchanted Visual Basic developer, you've found the right place, too. + +============================== +|other_info| Other Information +============================== + +Bugs and Limitations: many, patches and fixes welcome :-D + +See the demo for an example of what **Dabo** can do, and on how to use it. + +--------------- + +Copyright: Ed Leafe and Paul McNett + +License: As of 11/4/2004, Dabo is licensed under the very liberal MIT License, which allows you to do whatever you want with our code, as long as the copyright notice and license terms remain intact. See http://www.dabodev.com/licensing. + +--------------- + +SVN for latest code: +http://svn.dabodev.com/dabo/trunk/dabo + +Mailing List: [email protected] + +--------------- + +Please let us know if you are using **Dabo**! + +--------------- + +**Dabo** version: |version| + +Last updated: |today|, 10.00 GMT + +--------------- + + +|table_contents| Table of Contents +================================== + +| + ++-----------------------------------+-----------------------------------+ +| Dabo | Databases supported | ++===================================+===================================+ +| * :ref:`dabo.dApp` | * :ref:`dabo.db.dbFirebird` | +| * :ref:`dabo.dObject` | * :ref:`dabo.db.dbMSSQL` | +| * :ref:`dabo.dReportWriter` | * :ref:`dabo.db.dbMySQL` | +| * :ref:`dabo.dSecurityManager` | * :ref:`dabo.db.dbPostgreSQL` | +| * :ref:`dabo.dUserSettingProvider`| * :ref:`dabo.db.dbSQLite` | ++-----------------------------------+-----------------------------------+ +| db module | biz module | ++-----------------------------------+-----------------------------------+ +| * :ref:`dabo.db.dBackend` | * :ref:`dabo.biz.dBizobj` | +| * :ref:`dabo.db.dConnectInfo` | * :ref:`dabo.biz.dAutoBizobj` | +| * :ref:`dabo.db.dConnection` | * :ref:`dabo.biz.RemoteBizObj` | +| * :ref:`dabo.db.dCursorMixin` | | +| * :ref:`dabo.db.dNoEscQuoteStr` | | +| * :ref:`dabo.db.dTable` | | +| | | ++-----------------------------------+-----------------------------------+ +| ui module | | ++-----------------------------------+-----------------------------------+ +| * :ref:`dabo.ui` | | ++-----------------------------------+-----------------------------------+ + + + +|indices| Indices and tables +============================ + +* :ref:`daboindex` +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + +.. toctree:: + :hidden: + + general_index + Added: trunk/api/sphinx/_rst_basefiles/tree_module_list.rst =================================================================== --- trunk/api/sphinx/_rst_basefiles/tree_module_list.rst (rev 0) +++ trunk/api/sphinx/_rst_basefiles/tree_module_list.rst 2011-02-26 09:59:47 UTC (rev 60) @@ -0,0 +1,6 @@ +dabo.dabo_module, Dabo +dabo.dApp_module, dApp +dabo.biz_module, Business Objects +dabo.ui_module, ui widgets +dabo.db_module, Database modules +dabo.lib_module, lib Added: trunk/api/sphinx/config.py =================================================================== --- trunk/api/sphinx/config.py (rev 0) +++ trunk/api/sphinx/config.py 2011-02-26 09:59:47 UTC (rev 60) @@ -0,0 +1,39 @@ +# -*- coding: utf-8 -*-# + +import os +import sys +import platform + +# review and update as needed + +# folder where .rst files will be stored +baseFolder = os.getcwd() +docFolder = os.path.join(baseFolder, "source") +# used to generate files, only changed ones will be copied to docFolder +# this speeds up the Sphinx build +rstTempFolder = os.path.join(baseFolder, "tempsource") +folderToDoc = os.path.join(baseFolder, "../dabo") + +if platform.system() == "Windows": + sphinxBuildCmd = "C:\\Python26\\Scripts\\sphinx-build.exe" + # this is needed for the Sphinx Inheritance diagrams + graphVizDot = ' -D graphviz_dot="C:\\Program Files (x86)\\Graphviz2.26.3\\bin\\dot.exe" ' + # is not tested yet + hhcExe = "C:\Program Files (x86)\HTML Help Workshop\hhc.exe " + +else: + # needs to be adapted + sphinxBuildCmd = "C:\\Python26\\Scripts\\sphinx-build.exe" + graphVizDot = ' -D graphviz_dot="C:\\Program Files (x86)\\Graphviz2.26.3\\bin\\dot.exe" ' + hhcExe = "C:\Program Files (x86)\HTML Help Workshop\hhc.exe " (183944 bytes were truncated as it was too long for the email (max 40000 bytes.) _______________________________________________ Post Messages to: [email protected] Subscription Maintenance: http://leafe.com/mailman/listinfo/dabo-dev Searchable Archives: http://leafe.com/archives/search/dabo-dev This message: http://leafe.com/archives/byMID/[email protected]
