-
Notifications
You must be signed in to change notification settings - Fork 1
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"
![image](https://private-user-images.githubusercontent.com/346917/305675342-928450ea-792b-4118-b975-6d08174f506f.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwOTMyOTIsIm5iZiI6MTcyNjA5Mjk5MiwicGF0aCI6Ii8zNDY5MTcvMzA1Njc1MzQyLTkyODQ1MGVhLTc5MmItNDExOC1iOTc1LTZkMDgxNzRmNTA2Zi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxMVQyMjE2MzJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0zMmVkODA2MDc2ZTYwOGU0NDYzODE3NTA0MDFlNTA0Y2I1YzFhZDMxYmI3OTZkMWJjMzdhMGIwODg5MzAwM2I1JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.thOZAZpVfqAKrgmMe_5LoKWkycqEZ4OetOAKpvVfiFQ)
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
![Screen Shot 2024-02-17 at 8 34 38 PM](https://private-user-images.githubusercontent.com/346917/305679876-b704fd8b-61bf-4b7d-958f-d8ae6193df40.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwOTMyOTIsIm5iZiI6MTcyNjA5Mjk5MiwicGF0aCI6Ii8zNDY5MTcvMzA1Njc5ODc2LWI3MDRmZDhiLTYxYmYtNGI3ZC05NThmLWQ4YWU2MTkzZGY0MC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxMVQyMjE2MzJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1hN2Q5ZGQ0YWZjZjMzZTg5MzI3NDgyY2NkN2M4Y2UwYTc5MjkxZTk2YTM2YjEyMDg2MmViMDRiNTc5OWE5OTJjJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.b8PNsqAMvF8r9HIljsS-e1gcPTZ9CLuRaXo1rzxAOJw)
![Screen Shot 2024-02-17 at 8 42 24 PM](https://private-user-images.githubusercontent.com/346917/305679482-4f0bb686-168e-422d-a818-e75d7f78ec6b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwOTMyOTIsIm5iZiI6MTcyNjA5Mjk5MiwicGF0aCI6Ii8zNDY5MTcvMzA1Njc5NDgyLTRmMGJiNjg2LTE2OGUtNDIyZC1hODE4LWU3NWQ3Zjc4ZWM2Yi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxMVQyMjE2MzJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1kZDBmYzBkNzc5ZDU1ODc0MTc1MmJkZGE3OTc4N2I2ODI5YTcyOTBkMjgyOGY3M2EzOTgzN2NlMGE1OTY0ZTQ4JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.BrcNRx_orMJGT0ssViDVq9QhFAXE3NvZP931E4uhh6E)
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
![Screen Shot 2024-02-17 at 8 34 38 PM](https://private-user-images.githubusercontent.com/346917/305679886-69f6e88b-d86b-4216-b0c7-31b1cc395ae5.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwOTMyOTIsIm5iZiI6MTcyNjA5Mjk5MiwicGF0aCI6Ii8zNDY5MTcvMzA1Njc5ODg2LTY5ZjZlODhiLWQ4NmItNDIxNi1iMGM3LTMxYjFjYzM5NWFlNS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxMVQyMjE2MzJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT00OGI4OTUwMWI2MjcxNjQ2YTFlNWM0NjNjYjY3OTMyNTU4NGVkNDZmNDE2NTFjY2M1MGFkYTg1MDNmMmQxOTNlJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.wrOKRLQAgnAveBybvp90CGUtkEy3OYWe37fCwWlay5M)
![Screen Shot 2024-02-17 at 8 30 47 PM](https://private-user-images.githubusercontent.com/346917/305679157-51c1d885-27a6-4e7d-aea5-4d28a9f6da38.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwOTMyOTIsIm5iZiI6MTcyNjA5Mjk5MiwicGF0aCI6Ii8zNDY5MTcvMzA1Njc5MTU3LTUxYzFkODg1LTI3YTYtNGU3ZC1hZWE1LTRkMjhhOWY2ZGEzOC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxMVQyMjE2MzJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1mZmViZWQ1NDkwNGFmMDdlOTcxYmJhMTA3NTE4M2ZiYjU4NzhlMjk1ZmE3ZGQwYThjYjhiMGIxNGVmNWEzNTUzJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.T_o0z2iCXgthFYsl2mJxxobvKjoluaBGNmN1rTZOvRg)
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
![Screen Shot 2024-02-17 at 7 09 07 PM](https://private-user-images.githubusercontent.com/346917/305676454-e02100af-fa39-4aa7-84cf-53b3801653da.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwOTMyOTIsIm5iZiI6MTcyNjA5Mjk5MiwicGF0aCI6Ii8zNDY5MTcvMzA1Njc2NDU0LWUwMjEwMGFmLWZhMzktNGFhNy04NGNmLTUzYjM4MDE2NTNkYS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxMVQyMjE2MzJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT04OGYwMTYzOWU2NjRjNWY2NGE2NDA1NDM2YzJhNzM5OTdhZGQzODgzMThiYWE3ZWJjMDk2MzhhYWZiMWViZGRlJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.BJWteVDc36x9xX64_1uuKvLAJTegv6_quAtPvxarS3Q)
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
![Screen Shot 2024-02-17 at 7 29 40 PM](https://private-user-images.githubusercontent.com/346917/305677209-57ef86c5-67ce-4991-93d1-66d02a13f08a.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwOTMyOTIsIm5iZiI6MTcyNjA5Mjk5MiwicGF0aCI6Ii8zNDY5MTcvMzA1Njc3MjA5LTU3ZWY4NmM1LTY3Y2UtNDk5MS05M2QxLTY2ZDAyYTEzZjA4YS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxMVQyMjE2MzJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT00ZDdmM2ZiZTZkMTUwNWJjMGQwMzNmYjllNTVkNzc5Y2JmMjZjZmE1NmFjZmYyMTliYzZmZDJlMDhlZjA4OGVjJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.DCGXxgtlJzaaU43xwj_V17lz2q-HiGCF3-P_Yiu5GRY)
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
![Screen Shot 2024-02-17 at 7 09 07 PM](https://private-user-images.githubusercontent.com/346917/305677760-12827105-ae12-4792-817e-55dd38b1fcba.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwOTMyOTIsIm5iZiI6MTcyNjA5Mjk5MiwicGF0aCI6Ii8zNDY5MTcvMzA1Njc3NzYwLTEyODI3MTA1LWFlMTItNDc5Mi04MTdlLTU1ZGQzOGIxZmNiYS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxMVQyMjE2MzJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT04ZTEwODFiY2Y4MzRiMzIwMTFjMTUxYjMwNTk4ZGU0NTdlNDE5MTVmNzU1NmE4ODU4ODk0ODM5M2NmYzZmZTEyJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.yDqBb5MznZYGm0dwFH6diG_UjUih87NIqf8oz_HW33w)
![Screen Shot 2024-02-17 at 7 49 59 PM](https://private-user-images.githubusercontent.com/346917/305677812-e1521a6f-e3cd-49c3-ac54-183dce0590cc.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwOTMyOTIsIm5iZiI6MTcyNjA5Mjk5MiwicGF0aCI6Ii8zNDY5MTcvMzA1Njc3ODEyLWUxNTIxYTZmLWUzY2QtNDljMy1hYzU0LTE4M2RjZTA1OTBjYy5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxMVQyMjE2MzJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1lNDZmNWZiMGY1M2NmYzU1NzY0Y2IzYjkyNDFiMTc0NjZmNzFmMDNmZWY2NTZlY2ZhZjAyMzJhZDQxMmQ2YzJhJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.YAmgU_T1xHt3IuddZOoO8DxZreGfZidDb0QhZvjs_20)
NOTE: The dsu project list
command sorts projects ascending by project name; consequently, New Name project is now #3 on the projects list.