Smos Logo Smos

A comprehensive self-management system

Waiting report

Documentation about the smos-query waiting command, for a report of what you are waiting for sorted by how long you have been waiting for it

The waiting report shows you all of the entries that you are waiting for input from others for.

There is a default threshold of 7 days for what "too long" means in "you have been waiting for too long, better go ping them". You can change this default via configuration, and you can use the waiting_threshold property to override it on a per-entry basis.

Reference

Options

smos-query waiting [FILTER [FILTER]] [--hide-archive | --show-archive|-a] [--threshold TIME]

  FILTER            A filter to filter entries by                                      
  FILTER            A filter to filter entries by                                      
  --hide-archive    Hide archived files                                                
  --show-archive|-a Do not hide archived files                                         
  --threshold       The threshold at which to color waiting entries red default: Days 7

Environment variables

  SMOS_WAITING_IGNORE_ARCHIVE BOOL   Whether to consider archived entries                  default: HideArchive
  SMOS_WAITING_THRESHOLD TIME        The threshold at which to color waiting entries red   default: Days 7     

Configuration values

  Whether to consider archived entries
  default: HideArchive
  waiting.hide-archive:
    # or null
    <boolean>
  The threshold at which to color waiting entries red
  default: Days 7
  waiting.threshold:
    # or null
    def: Time
    # any of
    [ # Time string, for example:
      #  2s
      #  2 seconds
      #  3m
      #  3 minutes
      #  4h
      #  4 hours
      #  5d
      #  5 days
      #  6w
      #  6 weeks
      #  7mo
      #  7 months
      #  8y
      #  8 years
      <string>
    , # Interpreted as a number of days
      <integer> # 64 bit unsigned integer
    ]

Combined settings

Usage: smos-query waiting [FILTER [FILTER]] [--hide-archive | --show-archive|-a] [--threshold TIME]

Run the waiting report

Available settings:
  Show this help text
  switch: -h|--help

  A filter to filter entries by
  argument: FILTER

  A filter to filter entries by
  argument: FILTER

  Hide archived files
  switch: --hide-archive

  Do not hide archived files
  switch: --show-archive|-a

  Whether to consider archived entries
  env: SMOS_WAITING_IGNORE_ARCHIVE BOOL
  config:
    waiting.hide-archive: # or null
      <boolean>
  default: HideArchive

  The threshold at which to color waiting entries red
  option: --threshold TIME
  env: SMOS_WAITING_THRESHOLD TIME
  config:
    waiting.threshold: # or null
      def: Time
      # any of
      [ # Time string, for example:
        #  2s
        #  2 seconds
        #  3m
        #  3 minutes
        #  4h
        #  4 hours
        #  5d
        #  5 days
        #  6w
        #  6 weeks
        #  7mo
        #  7 months
        #  8y
        #  8 years
        <string>
      , # Interpreted as a number of days
        <integer> # 64 bit unsigned integer
      ]
  default: Days 7