Managing dsu Projects
With the advent of dsu v3.0.0, Projects have been introduced.
A dsu Project is a way of grouping DSU entries together. All DSU entries belong to a Project. Consequently, projects allow you manage DSU entries for different teams. For example, if you belonged to multiple agile development teams, you would want to keep your DSU entries for these teams separate.
When you install dsu 3.0.0, any entries you may have had prior, are added to the dsu default project. The default dsu project (named "default"), can be renamed to something more meaningful (see Renaming a project).
You can create dsu "projects" to manage DSU entries. Typically you would want to use dsu projects to segregate your DSU entries to be shared with different agile teams.
dsu project create PROJECT_NAME [PROJECT_DESCRIPTION]
dsu p c PROJECT_NAME [PROJECT_DESCRIPTION] # Equivalent to the above, only using shortcuts
dsu project create "GSA" "General Services Administration"
dsu p c "GSA" "General Services Administration" # Equivalent to the above, only using shortcuts
PROJECT_DESCRIPTION is optional. If omitted, a project description of "<PROJECT_NAME> project" is used, where PROJECT_NAME is the name of the project entered.
dsu project create "DHS Global"
dsu p c "DHS Global"
DSU entries are added to the "current" dsu project. In order to designate a particular project to be the "current" project, you must first issue the dsu project use command against that project. You can set the current project by PROJECT_NAME or PROJECT_NUMBER. If PROJECT_NAME is used, the project having that name will become the current project. If PROJECT_NUMBER is used, the project equating to the nth project in the list of projects will become the current project (see Listing projects). You can also designate a project to be the "default" project by using the --default option.
dsu project use [OPTIONS] [PROJECT_NAME|PROJECT_NUMBER]
dsu p u [OPTIONS] [PROJECT_NAME|PROJECT_NUMBER] # Equivalent to the above, only using shortcuts
dsu project use "DHS Global"
dsu p u "DHS Global" # Equivalent to the above, only using shortcuts
The below commands will accomplish the same as the above commands, only using PROJECT_NUMBER.
dsu project use 2
dsu p u 2 # Equivalent to the above, only using shortcuts
You can also designate a project to be the "default" project by using the --default option. The advantage of designating a project to be the "default" project, is that certain dsu commands can be issued without designating a PROJECT_NAME or PROJECT_NUMBER, in which case, the default project will be used. For example, dsu project delete, dsu project rename and dsu project use.
dsu project use --default "DHS Global"
dsu p u -d "DHS Global" # Equivalent to the above, only using shortcuts
You can delete dsu "projects" if you don't need them anymore. Deleting a dsu project permanently removes the project and all DSU entries associated with the project, so be sure you want to do this. Projects can be deleted using the PROJECT_NAME or PROJECT_NUMBER. If PROJECT_NAME is used, the project will be deleted. If PROJECT_NUMBER is used, the project equating to the nth project in the list of projects will be deleted (see Listing projects).
dsu project delete [PROJECT_NAME|PROJECT_NUMBER]
dsu p d [PROJECT_NAME|PROJECT_NUMBER] # Equivalent to the above, only using shortcuts
dsu project delete "GSA"
dsu p d "GSA" # Equivalent to the above, only using shortcuts
The below command deletes the project equating to the 2nd project in the projects list (see Listing projects). Consequently, the "DHS Global" project would be deleted.
dsu project delete 2
dsu p d 2 # Equivalent to the above, only using shortcuts
You can display a list of dsu projects at any time using the dsu project list command. This command will also highlight the default and current projects.
dsu project list
dsu p l # Equivalent to the above, only using shortcuts
You can rename a project at any time using the dsu project rename command. Projects can be renamed by PROJECT_NAME or PROJECT_NUMBER. If PROJECT_NUMBER is used, the project equating to the nth project in the list of projects will be renamed (see Listing projects)
dsu project rename PROJECT_NAME|PROJECT_NUMBER NEW_PROJECT_NAME [NEW_PROJECT_DESCRIPTION]
dsu p r PROJECT_NAME|PROJECT_NUMBER NEW_PROJECT_NAME [NEW_PROJECT_DESCRIPTION] # Equivalent to the above, only using shortcuts
dsu project rename "DHS Global" "New Name" "New Description"
dsu p r "DHS Global" "New Name" "New Description" # Equivalent to the above, only using shortcuts
The following command will accomplish the same as the above, only using PROJECT_NUMBER.
dsu project rename 2 "New Name" "New Description"
dsu p r 2 "New Name" "New Description" # Equivalent to the above, only using shortcuts
NOTE: The dsu project list command sorts projects ascending by project name; consequently, New Name project is now #3 on the projects list.