Difference between revisions of "Documentation/Labs/ExtensionsFrameworkRoadmap"

From Slicer Wiki
Jump to: navigation, search
Line 65: Line 65:
 
For scripted extensions, creation directly from within Slicer:
 
For scripted extensions, creation directly from within Slicer:
  
−
# Slicer: Python interactor -> <code>createScriptedExtension('Foo')</code>  ''Note: The final API may be slightly different''
+
# 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''
 
# Slicer: Restart - 'Foo' module should show up. ''Note: This last step could probably be removed''
  
 
=== To save extension code ===
 
=== To save extension code ===
 +
 +
For all type of extensions, the simplified workflow is:
 +
 
# Github: Create an account
 
# Github: Create an account
 
# Workstation -> Github: Create repository done with '''1 command'''. <code>ExtensionWizard.py --publish ~/code/MyExtension</code>
 
# Workstation -> Github: Create repository done with '''1 command'''. <code>ExtensionWizard.py --publish ~/code/MyExtension</code>
 +
 +
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 simplified workflow is:
 +
 +
# git commit, ..., git push
  
 
=== To contribute an extension to the Index  ===
 
=== To contribute an extension to the Index  ===
Line 78: Line 96:
 
# Workstation -> ExtensionServer: Test upload [1 command to enter in a terminal / 1 click in visual studio]
 
# Workstation -> ExtensionServer: Test upload [1 command to enter in a terminal / 1 click in visual studio]
 
# Add extension to the index using '''1 command''': <code>ExtensionWizard.py --contribute --target master ~/code/MyExtension</code>
 
# Add extension to the index using '''1 command''': <code>ExtensionWizard.py --contribute --target master ~/code/MyExtension</code>
−
 
  
 
== Progress ==
 
== Progress ==

Revision as of 21:06, 28 February 2014

Home < Documentation < Labs < ExtensionsFrameworkRoadmap

This page serves as roadmap for the Slicer Extensions framework.


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

  1. Workstation: Build Slicer application in Release
  2. Workstation: Use the Wizard to create an extension 5 commands to enter in a terminal
  3. Workstation: Initialize git repository 1 command
  4. Workstation: Implement extension / local commits

To save extension code

  1. Github: Create an account
  2. Github: Create a repository
  3. Workstation -> Github: Push local work on Github

To contribute an extension to Index

  1. SlicerWiki: Create documentation page
  2. Extension Server: Create an account
  3. Extension Server: Join community
  4. Extension Server: Ask permission for experimental folder.
  5. Workstation: Configure upload credential
  6. Workstation -> ExtensionServer: Test upload [1 command to enter in a terminal / 1 click in visual studio]
  7. Github: Fork ExtensionsIndex
  8. Workstation: Clone fork locally
  9. Workstation: Create branch add-YourExtensionName
  10. Workstation: Commit description file obtained from build tree
  11. Workstation -> Github: Push the topic to fork
  12. Github: Click on Pull request button

To update an extension in Index

  1. SlicerWiki: Update documentation page
  2. Workstation: In extension index clone: 5 commands to type
  3. Workstation: Create branch update-YourExtensionName
  4. Workstation: Commit description file obtained from build tree
  5. Workstation -> Github: Create pull request manually creating the URL
  6. 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:

  1. Workstation: Build Slicer application in Release
  2. Workstation: Use the Wizard to create an extension 1 commands to enter in a terminal
  3. Workstation: Initialize git repository 1 command
  4. Workstation: Implement extension / local commits


For scripted extensions, creation directly from within Slicer:

  1. Slicer: Modules -> Developer -> ExtensionWizard
  2. ExtensionWizard module: Set name, description, contributors etc ... then click on Create
    1. Set the working directory ? Where to create.
    2. External link to the github account creation page (will open web browswer or tab in the extension manager ?)
    3. Optionally create github repo and pre-populate repo ...
  3. Path to the module(s) in extension should be added to the additional module path.
  4. 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:

  1. Github: Create an account
  2. Workstation -> Github: Create repository done with 1 command. ExtensionWizard.py --publish ~/code/MyExtension

For scripted extensions:

  1. initial publish on github done from the ExtensionWizard module. See above

To publish extension code update

For all type of extensions, the simplified workflow is:

  1. git commit, ..., git push

To contribute an extension to the Index

  1. SlicerWiki: Create documentation page
  2. Extension Server: Create an account [Join community + experimental folder permission consolidated in one location]
  3. Workstation: Configure upload credential
  4. Workstation -> ExtensionServer: Test upload [1 command to enter in a terminal / 1 click in visual studio]
  5. Add extension to the index using 1 command: ExtensionWizard.py --contribute --target master ~/code/MyExtension

Progress

  • In case of Python extension, remove the need for a Slicer build tree: 50%
    • Wizard: Remove dependency on build tree or CMake generated file. Check.svg - Review in progress
    • 3269: Simplify contribution of scripted extension: 50%
    • Slicer: Creation of python extension directly from within Slicer. ToBeDone
      • Slicer: Optional Restart. ToBeDone

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

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

Retrieved from "https://www.slicer.org/w/index.php?title=Documentation/Labs/ExtensionsFrameworkRoadmap&oldid=37412"