Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.bugs.dist > #1129793

Bug#1026818: ITP: usagef -- A tool to print formatted usage messages

From Justin Morgan <2justinmorgan@gmail.com>
Newsgroups linux.debian.bugs.dist, linux.debian.devel
Subject Bug#1026818: ITP: usagef -- A tool to print formatted usage messages
Date 2022-12-21 16:30 +0100
Message-ID <FF9cC-ccU6-7@gated-at.bofh.it> (permalink)
Organization linux.* mail to news gateway

Cross-posted to 2 groups.

Show all headers | View raw


Package: wnpp
Severity: wishlist
Owner: Justin Morgan <2justinmorgan@gmail.com>
X-Debbugs-Cc: debian-devel@lists.debian.org, 2justinmorgan@gmail.com

* Package name    : usagef
  Version         : 0.1.0
  Upstream Author : Name <2justinmorgan@gmail.com>
* URL             : https://github.com/litelibs/usagef/
* License         : (MIT/X)
  Programming Lang: (C)
  Description     : A tool to print formatted usage messages

Designed for developers of shell scripts, the usagef terminal tool
prints consistent formatted usage messages that contain the information
passed as argv args of the usagef program. 

Here is an example of how usagef can be used to print the usage message
of a custom script, deploy.sh.

$ usagef \
  --name "deploy.sh" \
  --argv "[options] <environment> <package>" \
  --description "Deploy a package to the specified environment" \
  --item "Options:-f, --force:Forces the deployment" \
  --item "Options:-t, --api-token <token>:Specify the api token used" \
  --item "Options:-r, --report <email>:Email a report to someone" \
  --item "Options:-j, --json:Prints output in json format" \
  --item "Environment:dev:Deploy to dashboard.dev.company.com" \
  --item "Environment:preprod:Deploy to dashboard.preprod.company.com" \
  --item "Environment:prod:Deploy to dashboard.company.com" \
  --item "Package:user:Deploys updated user accounts" \
  --item "Package:security:Deploys vetted security protocols"  \
  --item "Package:logging:Deploys a new, and archives old logs"

[OUTPUT]

Usage: deploy.sh [options] <environment> <package>

Deploy a package to the specified environment

Options:
  -f, --force              Forces the deployment
  -t, --api-token <token>  Specify the api token used
  -r, --report <email>     Email a report to someone
  -j, --json               Prints output in json format

Environment:
  dev      Deploy to dashboard.dev.company.com
  preprod  Deploy to dashboard.preprod.company.com
  prod     Deploy to dashboard.company.com

Package:
  user      Deploys updated user accounts
  security  Deploys vetted security protocols
  logging   Deploys a new, and archives old logs



- Why is this package useful/relevant? 
  This package is useful because it bypasses the repeat efforts of
  maintaining consistent formatting of shell script usage messages.
- Is it a dependency for another package?
  No, this is not a dependency for another package.
- Do you use it?
  Yes, it is self-used. A few prototypes have been developed, thus inspiring
  the development of this package.
- If there are other packages providing similar functionality, how does it
  compare?
  There are no known packages that provide similar functionality.
- How do you plan to maintain it?
  Maintenance is planned to be a request-driven method that serves
  user's needs mentioned in https://github.com/litelibs/usagef/issues.
- Inside a packaging team (check list at https://wiki.debian.org/Teams)?
  No, maintenance will not be coordinated via Debian teams. However, a team at
  https://wiki.debian.org/Teams may be needed for future works of usagef.
- Are you looking for co-maintainers?
  No, a co-maintainer is not needed. However, a co-maintainer may be needed for
  future works of usagef.
- Do you need a sponsor?
  No, it is believed that a sponsor is not needed. However, a sponsor would be
  nice to have.

Back to linux.debian.bugs.dist | Previous | Next — Next in thread | Find similar | Unroll thread


Thread

Bug#1026818: ITP: usagef -- A tool to print formatted usage messages Justin Morgan <2justinmorgan@gmail.com> - 2022-12-21 16:30 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance FXqM 184.105.177.132 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-27 18:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance XR26 85.202.160.203 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-27 18:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance lBGj 85.202.160.202 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-27 18:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance yXnq 199.68.177.237 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-27 18:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance FjvQ 85.202.160.45 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-27 18:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance EODq 85.202.160.199 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-27 18:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance 3c7T 199.68.181.30 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-27 18:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance s6De 184.105.177.132 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-27 18:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance 3fS4 85.202.160.38 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-27 18:00 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance FXqM 184.105.177.132) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 01:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance FjvQ 85.202.160.45) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 01:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance XR26 85.202.160.203) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 01:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance EODq 85.202.160.199) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 01:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance lBGj 85.202.160.202) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 01:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance 3fS4 85.202.160.38) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 01:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance yXnq 199.68.177.237) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 03:00 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance 3c7T 199.68.181.30) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 03:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance PuUy 199.68.181.30 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 03:00 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance s6De 184.105.177.132) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 03:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance DHlT 85.202.160.199 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 04:10 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance Slk7 85.202.160.203 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 04:10 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance PuUy 199.68.181.30) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 04:10 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance 32Qv 85.202.160.38 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 04:10 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance rzOG 199.68.177.237 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 04:10 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance RltC 85.202.160.202 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 04:10 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance RltC 85.202.160.202) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 05:10 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance DHlT 85.202.160.199) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 05:10 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance 32Qv 85.202.160.38) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 05:10 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance Slk7 85.202.160.203) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 05:10 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance rzOG 199.68.177.237) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 05:10 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance ulg5 85.202.160.45 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 06:20 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance ulg5 85.202.160.45) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 06:30 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance c0cF 199.68.177.237 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 09:50 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance vrYW 199.68.181.30 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 09:50 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance 5VH4 85.202.160.199 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 09:50 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance rOzu 85.202.160.45 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 09:50 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance 4kjh 184.105.177.132 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 09:50 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance fJBU 85.202.160.38 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 10:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance c0cF 199.68.177.237) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 10:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance vrYW 199.68.181.30) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 10:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance 4kjh 184.105.177.132) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 10:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance 5VH4 85.202.160.199) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 10:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance rOzu 85.202.160.45) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 10:50 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance fJBU 85.202.160.38) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 11:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance 1cE2 85.202.160.202 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 11:00 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance 1cE2 85.202.160.202) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 12:00 +0100
  Bug#1026818: - - Welcome to National Family Auto Insurance whMC 85.202.160.203 Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 12:00 +0100
  Bug#1026818: Info received (- - Welcome to National Family Auto Insurance whMC 85.202.160.203) Sharon Grant <sharongrant19758@gmail.com> - 2022-12-28 13:10 +0100

csiph-web