|
Size: 2078
Comment:
|
Size: 4212
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| Netbeans is a GUI development evirnoment. The following instructions help to work on Sage. | Netbeans is a GUI development environment. The following instructions explain how to work on Sage, for Linux (Ubuntu 8.10, but should work everywhere). It helps with coding, build and run still on command-line. Sometimes it just guesses things, but most of the time it is pretty smart and gives help for navigating around, completion of commands and more. |
| Line 7: | Line 7: |
| * syntax highlighting and assistance * code completion (CTRL-SPACE) * corrects formatting (his probably dangerous, because it changes code-lines throughout the file and we would need a common definition to avoid diffs just for indents and newlines) |
|
| Line 8: | Line 11: |
| * press "CTRL" and click on the class or method name, and you it will jump to it's definition, perhaps opening the appropriate python file. * finds the usage of a method or class: right-click on it and "find usage" or CTRL-F7 * lists all classes and methods in current file in a tree for easy navigation: menu: Window>Navigating>Navigator |
|
| Line 9: | Line 15: |
| * tasks: netbeans searches the source code for tokens that indicate open tasks and lists them ("TODO", etc.), in menu: Window > Tasks * mercurial support * (trac integration/interaction would possible) |
|
| Line 14: | Line 22: |
| * Menu: Tools > Plugins, search for "Python", install | * Netbeans menu: Tools > Plugins, search for "Python", install == Setup == === Definitions === * SAGE_ROOT = root dir of Sage * NETBEANS_ROOT = root dir of netbeans === Instructions === 1. cd $SAGE_ROOT 1. ./sage -sh * note, that $HOME still points to your home dir 1. $NETBEANS_ROOT/bin/netbeans 1. File > New Project - Python > with existing sources * Name: "!SageNetbeans" or what you like, save it in your $HOME dir * Python platform: Manage - "New..." - select Python executable "$SAGE_ROOT/bin/python", name it "Python 2.5.2 Sage" * select "Python 2.5.2 Sage" on the left, on the right in tab "Python Path" you can see the paths are in $SAGE_ROOT/local/lib/... (maybe click "auto detect" ?) 1. next > source root folder: "$SAGE_ROOT/devel/sage/sage" - finish! |
| Line 22: | Line 47: |
| == Setup == === Definitions === * SAGE_ROOT = root dir of Sage === Instructions === TODO |
|
| Line 30: | Line 48: |
| Netbeans supports Merucrial out of the box. Right-click on files in "File" window (Window>Files), see local diffs in a special diff window, commit changes, undo local changes. The Netbeans editor itself also supports nonlinear undos, right click on the left side of a highlighed change, see the diff, change only this part as in the local repository. | Netbeans supports Merucrial out of the box. Right-click on files in "File" window (Window>Files), see local diffs in a special diff window, commit changes, undo local changes. The Netbeans editor itself also supports nonlinear undos, right click on the left side of a highlighted change, see the diff, change only this part as in the local repository. |
| Line 36: | Line 54: |
| * [[http://code.google.com/p/cubeon/wiki/GSTracRepository | cube example for repository integration in netbeans]] * [[http://trac-hacks.org/wiki/XmlRpcPlugin | trac xmlrpc]] |
* [[http://code.google.com/p/cubeon/wiki/GSTracRepository | cube example for Trac repository integration in netbeans]] * [[http://trac-hacks.org/wiki/XmlRpcPlugin | trac xmlrpc]] remote xml procedures to interact with Trac. == Open Issues == * for some reason i don't know all files are marked as "ignored" by mercurial. * you have to build and start Sage still by hand ("./sage -br" on the command line), but it would be possible to select a python script to run in the project properties > run... * pyx/pxd are recognized as normal text-files ---- DocumentationProject |
Developing Python/Sage with Netbeans
Netbeans is a GUI development environment. The following instructions explain how to work on Sage, for Linux (Ubuntu 8.10, but should work everywhere). It helps with coding, build and run still on command-line. Sometimes it just guesses things, but most of the time it is pretty smart and gives help for navigating around, completion of commands and more.
Benefits
- syntax highlighting and assistance
- code completion (CTRL-SPACE)
- corrects formatting (his probably dangerous, because it changes code-lines throughout the file and we would need a common definition to avoid diffs just for indents and newlines)
- indexes python and all libraries, i.e. you get a list of all available classes, functions and methods, completion of partial identifiers and they also show you the help for each command.
- press "CTRL" and click on the class or method name, and you it will jump to it's definition, perhaps opening the appropriate python file.
- finds the usage of a method or class: right-click on it and "find usage" or CTRL-F7
lists all classes and methods in current file in a tree for easy navigation: menu: Window>Navigating>Navigator
- refactoring: i.e. there is limited support (you have to go through all automatic changes in the preview) for renaming variables, classes, etc.
tasks: netbeans searches the source code for tokens that indicate open tasks and lists them ("TODO", etc.), in menu: Window > Tasks
- mercurial support
- (trac integration/interaction would possible)
Requirements
- Python
Netbeans menu: Tools > Plugins, search for "Python", install
Setup
Definitions
- SAGE_ROOT = root dir of Sage
- NETBEANS_ROOT = root dir of netbeans
Instructions
- cd $SAGE_ROOT
- ./sage -sh
- note, that $HOME still points to your home dir
- $NETBEANS_ROOT/bin/netbeans
File > New Project - Python > with existing sources
Name: "SageNetbeans" or what you like, save it in your $HOME dir
- Python platform: Manage - "New..." - select Python executable "$SAGE_ROOT/bin/python", name it "Python 2.5.2 Sage"
- select "Python 2.5.2 Sage" on the left, on the right in tab "Python Path" you can see the paths are in $SAGE_ROOT/local/lib/... (maybe click "auto detect" ?)
next > source root folder: "$SAGE_ROOT/devel/sage/sage" - finish!
Note
- After first startup it has to scan and index all the Python stuff (progress indicator bottom right). This could take some minutes, so don't wonder why nothing works...
Personally, I'm not happy with the default GTK theme in ubuntu linux, therefore I have to change the look&feel settings: edit NETBEANS_ROOT/etc/netbeans.conf - in the "netbeans_default_options" variable, change add/change parameter "--laf javax.swing.plaf.metal.MetalLookAndFeel" to get the java specific metal look&feel (or what you want).
Mercurial
Netbeans supports Merucrial out of the box. Right-click on files in "File" window (Window>Files), see local diffs in a special diff window, commit changes, undo local changes. The Netbeans editor itself also supports nonlinear undos, right click on the left side of a highlighted change, see the diff, change only this part as in the local repository.
Trac Integration
It is theoretically possible to integrate Netbeans with Trac using Cube°n. Maybe someone wants to look deeper into this ...
in netbeans, Tools > Plugins - Install "cube" (all of them)
trac xmlrpc remote xml procedures to interact with Trac.
Open Issues
- for some reason i don't know all files are marked as "ignored" by mercurial.
you have to build and start Sage still by hand ("./sage -br" on the command line), but it would be possible to select a python script to run in the project properties > run...
- pyx/pxd are recognized as normal text-files