needgantt

New in version 0.5.5.

needgantt adds a gantt-chart to your documentation:

.. needgantt:: Bug handling gantt
   :tags: gantt_example
   :milestone_filter: type == 'milestone'
Show used needs for above example…
Action: Find & Report bug ACT_BUG ../_images/arrow-right-circle.svg
tags: gantt_example
duration: 5
links incoming: ACT_BUG_ANALYSE
 
Action: Analyse bug ACT_BUG_ANALYSE ../_images/arrow-right-circle.svg
tags: gantt_example
duration: 7
links outgoing: ACT_BUG
links incoming: ACT_TICKET
 
Action: Create solution ticket ACT_TICKET ../_images/arrow-right-circle.svg
tags: gantt_example
duration: 3
links outgoing: ACT_BUG_ANALYSE
links incoming: ACT_TICKET_WORK
 
Action: Work on solution ticket ACT_TICKET_WORK ../_images/arrow-right-circle.svg
tags: gantt_example
duration: 7
links outgoing: ACT_TICKET
links incoming: MS_TICKET_CLOSED
 
Milestone: Solution ticket closed MS_TICKET_CLOSED ../_images/arrow-right-circle.svg
tags: gantt_example
links outgoing: ACT_TICKET_WORK
links incoming: ACT_RELEASE_PLAN
 
Action: Add solution to release plan ACT_RELEASE_PLAN ../_images/arrow-right-circle.svg
tags: gantt_example
duration: 1
links outgoing: MS_TICKET_CLOSED
links incoming: ACT_DEPLOY
 
Action: Deploy release ACT_DEPLOY ../_images/arrow-right-circle.svg
tags: gantt_example
duration: 2
links outgoing: ACT_RELEASE_PLAN
links incoming: ACT_TEST
 
Action: Test release ACT_TEST ../_images/arrow-right-circle.svg
tags: gantt_example
duration: 12
completion: 80%
links outgoing: ACT_DEPLOY
links incoming: MS_BUG_SOLVED
 
Milestone: Bug solved MS_BUG_SOLVED ../_images/arrow-right-circle.svg
tags: gantt_example
links outgoing: ACT_TEST
 

Hint

The Gantt function is quite new in PlantUML and some features are available in the Beta version only. So if you get any syntax errors during the build, please download the latest PlantUML version.

If svg is set as output format for PlantUML, the tasks elements are linked to their related need.

Color is taken from needs_types configuration. This behavior can be deactivated by setting no_color.

needgantt supports the following relationship between tasks and milestones:

The task length is defined by default by the need-option duration. Its value is interpreted in days.

The task completion is defined by default by the need-option completion. Its value is interpreted as percentage and should be between 0 and 100.

Options

Supported options:

milestone_filter

milestone_filter gets executed on each need found by filter or any user related filter option. If it is a match, the gets represented as milestone instead of a task in gantt chart.

milestone_filter must be a valid Filter string.

start_date

Optional start date of the gantt chart. All tasks and milestones dates get calculated based on this base values.

Must be use the format YYYY-MM-DD. Example: 2020-03-25

.. needgantt:: Bug handling gantt
   :tags: gantt_example
   :milestone_filter: type == 'milestone'
   :start_date: 2020-03-25

timeline

Defines the timeline scale.

Allowed values: daily, weekly, monthly.

Default: daily

Works only, if start_date is set as well.

.. needgantt:: Bug handling gantt
   :tags: gantt_example
   :milestone_filter: type == 'milestone'
   :start_date: 2020-03-25
   :timeline: weekly

no_color

Tasks and milestone color is taken from need-typ configuration.

If the default PlantUML colors shall be taken, set this flag.

duration_option

Defines which option to take for a duration value. The value gets interpreted in days, no matter what the name of the option is.

Can be set for the complete documentation by using needs_duration_option in conf.py.

Default: duration

.. needgantt:: Duration example
   :tags: gantt_ex_duration
   :duration_option: hours
Action: Create example ACT_CREATE_EX ../_images/arrow-right-circle.svg
tags: gantt_ex_duration
hours: 12
links incoming: ACT_READ_EX
 
Action: Read example ACT_READ_EX ../_images/arrow-right-circle.svg
tags: gantt_ex_duration
hours: 3
duration: 100
links outgoing: ACT_CREATE_EX
duration option gets ignored in the above needgantt.

completion_option

Defines which option to take for a completion value. The value gets interpreted in percentage.

Can be set for the complete documentation by using needs_completion_option in conf.py.

Default: completion

.. needgantt:: Completion example
   :tags: gantt_ex_completion
   :completion_option: amount
Action: Create example ACT_CREATE_EX_C ../_images/arrow-right-circle.svg
tags: gantt_ex_completion
amount: 90%
duration: 12
links incoming: ACT_READ_EX_C
 
Action: Read example ACT_READ_EX_C ../_images/arrow-right-circle.svg
tags: gantt_ex_completion
amount: 40
duration: 12
links outgoing: ACT_CREATE_EX_C