Difference between revisions of "Documentation/Labs/ExtensionsFrameworkRoadmap"
m (→Progress) |
|||
(10 intermediate revisions by the same user not shown) | |||
Line 103: | Line 103: | ||
== Progress == | == Progress == | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
* [http://na-mic.org/Mantis/view.php?id=3604 3604 ExtensionServer: Consolidate ExtensionsIndex account creation.] '''ToBeDone''' | * [http://na-mic.org/Mantis/view.php?id=3604 3604 ExtensionServer: Consolidate ExtensionsIndex account creation.] '''ToBeDone''' | ||
Line 122: | Line 109: | ||
* [http://na-mic.org/Mantis/view.php?id=3606 3606 Slicer: Given an extension python script. Should be possible to upload the extension directly from Slicer.] '''ToBeDone''' | * [http://na-mic.org/Mantis/view.php?id=3606 3606 Slicer: Given an extension python script. Should be possible to upload the extension directly from Slicer.] '''ToBeDone''' | ||
+ | |||
+ | == Completed == | ||
+ | |||
+ | * Improve Wizard to create empty extension: reduce number of terminal commands to 1 - {{done}} '''Completed''' | ||
+ | ** [http://na-mic.org/Mantis/view.php?id=3566 3566: Wizard: Simplify creation of extensions/modules]: {{done}} '''Completed''' | ||
+ | ** [http://na-mic.org/Mantis/view.php?id=3572 3572: Add ExtensionWizard wiki page]: {{done}} Completed - See [[Documentation/Nightly/Developers/ExtensionWizard]] | ||
+ | ** [http://na-mic.org/Mantis/view.php?id=3572 3572: Add developer documentation for ExtensionWizard]. {{done}} '''Completed''' | ||
+ | * Publish extension on Github by creating github repo. {{done}} '''Completed''' | ||
+ | |||
+ | * In case of Python extension, remove the need for a Slicer build tree: {{done}} '''Completed''' | ||
+ | ** Wizard: Remove dependency on build tree or CMake generated file. {{done}} '''Completed''' | ||
+ | ** Add install rules for the template source code - To make them available from an installed Slicer.{{done}} '''Completed''' | ||
+ | ** [http://na-mic.org/Mantis/view.php?id=3269 3269: Simplify contribution of scripted extension]: {{done}} '''Completed''' | ||
+ | ** [http://na-mic.org/Mantis/view.php?id=3603 3603 Slicer: Creation of python extension directly from Slicer.] {{done}} '''Completed''' | ||
+ | *** Slicer: Optional Restart. {{done}} '''NotNeeded''' (Scripted module are optionally loaded after creating them using the wizard.) {{done}} '''Completed''' | ||
= Extensions Catalog / Manager = | = Extensions Catalog / Manager = | ||
Line 130: | Line 132: | ||
== Progress == | == Progress == | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
* Low priority: | * Low priority: | ||
** [http://na-mic.org/Mantis/view.php?id=2334 2334: Differentiate different type of extenions in extension manager: Concept of channel]. '''ToBeDone''' | ** [http://na-mic.org/Mantis/view.php?id=2334 2334: Differentiate different type of extenions in extension manager: Concept of channel]. '''ToBeDone''' | ||
** [http://na-mic.org/Mantis/view.php?id=2778 2778: Add "Download stats" on each extension page ]. '''ToBeDone''' | ** [http://na-mic.org/Mantis/view.php?id=2778 2778: Add "Download stats" on each extension page ]. '''ToBeDone''' | ||
− | |||
** Consolidate rating across extension version. See [https://github.com/midasplatform/slicerappstore/issues/9#issuecomment-15643678 midasplatform/slicerappstore/issues/9] | ** Consolidate rating across extension version. See [https://github.com/midasplatform/slicerappstore/issues/9#issuecomment-15643678 midasplatform/slicerappstore/issues/9] | ||
+ | |||
+ | == Completed == | ||
+ | |||
+ | * [http://na-mic.org/Mantis/view.php?id=2779 2779: Mechanism to keep track of the installed extensions across version]. {{done}} '''Completed''' | ||
+ | * [http://na-mic.org/Mantis/view.php?id=2089 2089: Either on-demand or when slicer starts, check if there are available extensions update.]. {{done}} '''Completed''' | ||
+ | * [http://na-mic.org/Mantis/view.php?id=3564 3564: Add search option in extension manager]. {{done}} '''Completed''' | ||
+ | * [http://na-mic.org/Mantis/view.php?id=3602 3602: ExensionsManager - Add a "Show url" link']. {{done}} '''Completed''' | ||
+ | * [http://na-mic.org/Mantis/view.php?id=3607 3607: ExtensionManager: Exclude category "Example" from "All" listing ]. {{done}} '''Completed''' | ||
+ | * [http://na-mic.org/Mantis/view.php?id=2912 2912: Install dependent extensions ]. {{done}} '''Completed''' | ||
+ | * [http://na-mic.org/Mantis/view.php?id=3608 3608: ExtensionsManager: Display description for installed extensions.]. {{done}} '''Completed''' | ||
+ | * [http://na-mic.org/Mantis/view.php?id=2145 2145: Provide a mechanism allowing to easily install extension given the location of the package ]. {{done}} '''Completed''' | ||
= Extensions Wizard UI = | = Extensions Wizard UI = | ||
Line 152: | Line 157: | ||
[[File:Slicer-in-app-wizard1.png|250px]] | [[File:Slicer-in-app-wizard1.png|250px]] | ||
− | == | + | == Completed == |
− | See issues [http://na-mic.org/Mantis/view.php?id=3603 #3603], [http://na-mic.org/Mantis/view.php?id=3606 #3606] listed above. | + | See issues [http://na-mic.org/Mantis/view.php?id=3603 #3603], [http://na-mic.org/Mantis/view.php?id=3606 #3606] listed above. {{done}} '''Completed''' |
= Extension developer documentation = | = Extension developer documentation = |
Latest revision as of 00:14, 28 March 2018
Home < Documentation < Labs < ExtensionsFrameworkRoadmapThis page serves as roadmap for the Slicer Extensions framework.
Contents
Extension contribution process
The goal here is to simplify the number of steps allowing people to contribute extension.
More specifically, we would like to make it very easy for people to create a python extension by:
- removing the need for a Slicer build tree
- reducing the number of steps required to create and load an extension from a template
- simplifying how an extension is contributed to the index
- simplifying how an extension can be uploaded to the extension server
Current process
The current process to create an empty extension is documented here, then the steps to contribute the extension are documented here.
For all type of extension (C++ or python), the steps can then be summarized as:
To create an extension
- Workstation: Build Slicer application in Release
- Workstation: Use the Wizard to create an extension 5 commands to enter in a terminal
- Workstation: Initialize git repository 1 command
- Workstation: Implement extension / local commits
To save extension code
- Github: Create an account
- Github: Create a repository
- Workstation -> Github: Push local work on Github
To contribute an extension to Index
- SlicerWiki: Create documentation page
- Extension Server: Create an account
- Extension Server: Join community
- Extension Server: Ask permission for experimental folder.
- Workstation: Configure upload credential
- Workstation -> ExtensionServer: Test upload [1 command to enter in a terminal / 1 click in visual studio]
- Github: Fork ExtensionsIndex
- Workstation: Clone fork locally
- Workstation: Create branch add-YourExtensionName
- Workstation: Commit description file obtained from build tree
- Workstation -> Github: Push the topic to fork
- Github: Click on Pull request button
To update an extension in Index
- SlicerWiki: Update documentation page
- Workstation: In extension index clone: 5 commands to type
- Workstation: Create branch update-YourExtensionName
- Workstation: Commit description file obtained from build tree
- Workstation -> Github: Create pull request manually creating the URL
- Github: Add a comment in the pull request with a Compare link also manually generated
Proposed changes
To create an extension
For all type of extensions, the simplified workflow is:
- Workstation: Build Slicer application in Release
- Workstation: Use the Wizard to create an extension 1 commands to enter in a terminal
- Workstation: Initialize git repository 1 command
- Workstation: Implement extension / local commits
For scripted extensions, creation directly from within Slicer:
- Slicer: Modules -> Developer -> ExtensionWizard
- ExtensionWizard module: Set name, description, contributors etc ... then click on Create
- Set the working directory ? Where to create.
- External link to the github account creation page (will open web browswer or tab in the extension manager ?)
- Optionally create github repo and pre-populate repo ...
- Path to the module(s) in extension should be added to the additional module path.
- Slicer: Restart - 'Foo' module should show up. Note: This last step could probably be removed
To save extension code
For all type of extensions, the simplified workflow is:
- Github: Create an account
- Workstation -> Github: Create repository done with 1 command.
ExtensionWizard.py --publish ~/code/MyExtension
For scripted extensions:
- initial publish on github done from the ExtensionWizard module. See above
To publish extension code update
For all type of extensions, the workflow is:
- git commit, ..., git push
To contribute an extension to the Index
- SlicerWiki: Create documentation page.
- Need to check with BHW if wiki version can be updated so that any IP could use the mediawiki API
- Extension Server: Create an account [Join community + experimental folder permission consolidated in one location]
- Create a "Slicer Extensions" community where user have to request access
- Folks belonging to the "Slicer Extensions" would be automatically be granted access
- Jc: Check with Midas team with user can request access to community
- Workstation: Configure upload credential
- Update documentation to explain that MIDAS_API_* variable can be set in the env.
- Workstation -> ExtensionServer: Test upload [1 command to enter in a terminal / 1 click in visual studio]
- Add extension to the index using 1 command:
ExtensionWizard.py --contribute --target master ~/code/MyExtension
Progress
Completed
- Improve Wizard to create empty extension: reduce number of terminal commands to 1 - Completed
- Publish extension on Github by creating github repo. Completed
- In case of Python extension, remove the need for a Slicer build tree: Completed
- Wizard: Remove dependency on build tree or CMake generated file. Completed
- Add install rules for the template source code - To make them available from an installed Slicer. Completed
- 3269: Simplify contribution of scripted extension: Completed
- 3603 Slicer: Creation of python extension directly from Slicer. Completed
Extensions Catalog / Manager
The goal here is to improve the overall user experience associated with the extension catalog.
When accessed from within Slicer the catalog is also referred as extensions manager.
Progress
- Low priority:
- 2334: Differentiate different type of extenions in extension manager: Concept of channel. ToBeDone
- 2778: Add "Download stats" on each extension page . ToBeDone
- Consolidate rating across extension version. See midasplatform/slicerappstore/issues/9
Completed
- 2779: Mechanism to keep track of the installed extensions across version. Completed
- 2089: Either on-demand or when slicer starts, check if there are available extensions update.. Completed
- 3564: Add search option in extension manager. Completed
- 3602: ExensionsManager - Add a "Show url" link'. Completed
- 3607: ExtensionManager: Exclude category "Example" from "All" listing . Completed
- 2912: Install dependent extensions . Completed
- 3608: ExtensionsManager: Display description for installed extensions.. Completed
- 2145: Provide a mechanism allowing to easily install extension given the location of the package . Completed
Extensions Wizard UI
The wizard UI will provide a Slicer module allowing to:
- easily create / publish / contribute extensions directly from Slicer.
- directly load scripted modules after they are created.
Completed
See issues #3603, #3606 listed above. Completed
Extension developer documentation
The goal is to consolidate the existing documentation so that it is easy to understand what is the python API available to the Slicer python extension developer.
Progress
- Generate Slicer python API documentation. In progress. See experiment http://mwoehlke-kitware.github.io/Slicer/Base/