JavaScript is one of the most popular programming languages in existence but there are few tools for building applications with JavaScript or any other dynamic language. The tools that exist typically require a Web developer to download and install a product in order to get developer productivity features such as command completion suggestions (called INTELLISENSE® in the VISUAL STUDIO® development programs offered by MICROSOFT®), or the developer must simply make do without such features. This experience (requiring developers to download and install software) is contrary to the kinds of applications that JavaScript encourages, which are typically browser-based and can be accessed simply by visiting a Web page.
When developers want to know how something works, they typically read the documentation. The process of creating documentation is often laborious, however, involving not just the developer of the feature in question but writers and editors who actually create the documentation. Most developers have already included substantial information in their source code in the form of comments.
Various technologies and techniques are disclosed for providing an integrated development environment using a dynamic language. In one implementation, command completion suggestions are generated dynamically using introspection. For example, input is received from a user in the form of a code command. Introspection is then used to generate a list of one or more possible code command completion suggestions that are suitable completions for the code command input received from the user. Part or all of the possible code command completion suggestions are displayed to the user.
In another implementation, function documentation is generated dynamically using introspection. For example, upon receiving input from a user to interact with a particular function in the integrated development environment, introspection can be used to analyze a source code section containing the particular function to extract at least one code comment contained within the function. Part or all of the code comment is then displayed to the user as documentation for the particular function.
This Summary was provided to introduce a selection of concepts in a simplified form that are further described below in the Detailed Description. This Summary is not intended to identify key features or essential features of the claimed subject matter, nor is it intended to be used as an aid in determining the scope of the claimed subject matter.
For the purposes of promoting an understanding of the principles of the invention, reference will now be made to the embodiments illustrated in the drawings and specific language will be used to describe the same. It will nevertheless be understood that no limitation of the scope is thereby intended. Any alterations and further modifications in the described embodiments, and any further applications of the principles as described herein are contemplated as would normally occur to one skilled in the art.
The system may be described in the general context as a software development application, but the system also serves other purposes in addition to these. In one implementation, one or more of the techniques described herein can be implemented as features within a software development program such as MICROSOFT® VISUAL STUDIO®, Eclipse, Macromedia Dreamweaver, or from any other type of program or service that allows a user to create software for one or more operating system platforms. In one implementation, a browser-based software development application is provided that is accessible by a user in a browser user interface.
In computer programming, the term introspection refers to the ability to examine something to determine what it is, what it knows, and what it is capable of doing. Using some or all of the techniques discussed herein, introspection can be used to dynamically generate documentation for a browser-based integrated development environment application that is based upon a dynamic language such as JavaScript. That documentation can then be displayed to the user in one or more ways to aid with software development. For example, a list of one or more possible code command completion suggestions that are suitable completions for the code command input received from the user can be generated dynamically using introspection. Alternatively or additionally, function documentation can be generated dynamically using introspection.
As shown in
Additionally, devices 100 and/or 130 may also have additional features/functionality. For example, devices 100 and/or 130 may also include additional storage (removable and/or non-removable) including, but not limited to, magnetic or optical disks or tape. Such additional storage is illustrated in
Computing devices 100 and/or 130 include one or more communication connections that allow computing devices 100 and/or 130 to communicate with each other and/or one or more other computing devices (150, 160, and 170, respectively) over network 116. Communications connection(s) 114 and 144 are examples of communication media. Communication media typically embodies computer readable instructions, data structures, program modules or other data in a modulated data signal such as a carrier wave or other transport mechanism and includes any information delivery media. The term “modulated data signal” means a signal that has one or more of its characteristics set or changed in such a manner as to encode information in the signal. By way of example, and not limitation, communication media includes wired media such as a wired network or direct-wired connection, and wireless media such as acoustic, RF, infrared and other wireless media. The term computer readable media as used herein includes both storage media and communication media.
In one implementation, computing device 100 is a client computer that communicates with server computer 130 using communication connection 114 and 144 over network 116. In such an implementation, browser user interface 118 of client computing device 100 accesses browser-based integrated development environment application 200 on server computing device 130 for performing one or more software development tasks. In one implementation, browser-based user interface 118 of client computing device 100 is a thin client user interface that displays the integrated development environment application 200 to a user, and server computing device 130 is a web server that provides the integrated development environment application 200 to the user upon request from the browser.
Computing devices 100 and 130 may also have input device(s) (114 and 134, respectively) such as keyboard, mouse, pen, voice input device, touch input device, etc. Output device(s) (116 and 136, respectively) such as a display, speakers, printer, etc. may also be included. These devices are well known in the art and need not be discussed at length here.
Turning now to
Browser-based integrated development environment application 200 includes program logic 204, which is responsible for carrying out some or all of the techniques described herein. Program logic 204 includes logic for providing a browser-based integrated development environment that has one or more commands available to a user that have been implemented at least in part using a dynamic language (e.g. such as JavaScript) 206; logic for using introspection to dynamically generate documentation regarding the one or more commands available to the user 208; logic for displaying upon request at least a portion of the documentation regarding the one or more available commands on a display device (e.g. in the form of code command completion suggestions and/or function documentation) 210; and other logic for operating the application 220. In one implementation, program logic 204 is operable to be called programmatically from another program, such as using a single call to a procedure in program logic 204.
Turning now to
Using introspection, the system analyzes a source code section containing a particular function to extract at least one code comment contained within the particular function (stage 336). In one implementation, the system dynamically parses the source code section of the particular function to look for specific constructs (such as “//”, etc.) that indicate a code comment section and returns at least one of the code comment sections as documentation for the particular function (stage 336). The code comment that is returned can be the first code comment present in the function, or one or more later comments (stage 336). At least a portion of the code comment is displayed as documentation for the particular function (e.g. at a location near the function call if the function call is being typed as user input) (stage 338). The process ends at end point 340.
Turning now to
Although the subject matter has been described in language specific to structural features and/or methodological acts, it is to be understood that the subject matter defined in the appended claims is not necessarily limited to the specific features or acts described above. Rather, the specific features and acts described above are disclosed as example forms of implementing the claims. All equivalents, changes, and modifications that come within the spirit of the implementations as described herein and/or by the following claims are desired to be protected.
For example, a person of ordinary skill in the computer software art will recognize that the client and/or server arrangements, user interface screen content, and/or data layouts as described in the examples discussed herein could be organized differently on one or more computers to include fewer or additional options or features than as portrayed in the examples.
Number | Name | Date | Kind |
---|---|---|---|
5642511 | Chow et al. | Jun 1997 | A |
5872973 | Mitchell et al. | Feb 1999 | A |
6023271 | Quaeler-Bock et al. | Feb 2000 | A |
6061721 | Ismael et al. | May 2000 | A |
6078743 | Apte et al. | Jun 2000 | A |
6237135 | Timbol | May 2001 | B1 |
6305008 | Vaidyanathan et al. | Oct 2001 | B1 |
6467081 | Vaidyanathan et al. | Oct 2002 | B2 |
6493719 | Booth et al. | Dec 2002 | B1 |
6609246 | Guhr et al. | Aug 2003 | B1 |
7127707 | Mishra et al. | Oct 2006 | B1 |
7150008 | Cwalina et al. | Dec 2006 | B2 |
7155662 | Edwards et al. | Dec 2006 | B1 |
7322023 | Shulman et al. | Jan 2008 | B2 |
7406687 | Daynes et al. | Jul 2008 | B1 |
7490292 | Hennum | Feb 2009 | B2 |
7606782 | Haley | Oct 2009 | B2 |
7669184 | Bracha et al. | Feb 2010 | B2 |
7971194 | Gilboa | Jun 2011 | B1 |
20040148588 | Sadiq | Jul 2004 | A1 |
20050034109 | Hamilton et al. | Feb 2005 | A1 |
20050050470 | Hudson et al. | Mar 2005 | A1 |
20050114771 | Piehler et al. | May 2005 | A1 |
20050229154 | Hiew et al. | Oct 2005 | A1 |
20050246664 | Michelman et al. | Nov 2005 | A1 |
20050278695 | Synovic | Dec 2005 | A1 |
20060047653 | Vaidyanathan et al. | Mar 2006 | A1 |
20060184925 | Ficatier et al. | Aug 2006 | A1 |
20070168949 | Shattuck et al. | Jul 2007 | A1 |
Entry |
---|
Samuel A. Rebelsky, “CS223 2004F: Introspection in Java,” Dec. 7, 2004. http://www.cs.grinnell.edu/%7Erebelsky/Courses/CS223/2004F/Handouts/introspection.html. |
Rahman et al. “Making Frameworks More Useable: Using Model Introspection and Metadata to Develop Model Processing”, Apr. 2003, Elsevier Ltd. |
Buchner et al. “Introspective Model-Driven Development”, pp. 33-49 2006, Springer-Verlag Berlin Heidelberg. |
“JavaScript Plus”, http://www.vbsoftware.cl/features.htm. |
Doernhoefer, Mark, “Surfing the Net for Software Engineering Notes”, Jul. 2006, pp. 16-24, vol. 31, Issue 4, ACM Press, New York, US, http://delivery.acm.org. |
Pfeiffer et al., “Complex code querying and navigation for AspectJ”, 2005, pp. 60-64, ACM Press, New York, US, http://delivery.acm.org. |
Number | Date | Country | |
---|---|---|---|
20080134142 A1 | Jun 2008 | US |