dsu 0.1.0.alpha.3 → 0.1.0.alpha.4
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +3 -0
- data/Gemfile.lock +1 -1
- data/README.md +37 -29
- data/lib/dsu/version.rb +1 -1
- metadata +13 -7
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: c27f3abb1daf923976963a1612f08258fd8a0460d672c1674dc2c149aa69ed03
|
4
|
+
data.tar.gz: 8611ccb51518e24f9497ffc0c02a7b1dd567321419728f727969718620da5b59
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: d1b1bcd4f9222bf2629ffa0d02434b429280f20e760676f2cde2eaca40860f56952995ce7a69628981cc0f7caf941a48c07cca91a9c1f96b4334e872d5a7374a
|
7
|
+
data.tar.gz: 0436e614b146dbfd71ca098cc699d7b6de99cafe47cfbad8141ac6268853b6f7d68285d8222053796bb2db729cf86c14e03e3fa3f2dca97554fd78998449fbbe
|
data/CHANGELOG.md
CHANGED
data/Gemfile.lock
CHANGED
data/README.md
CHANGED
@@ -11,7 +11,7 @@
|
|
11
11
|
|
12
12
|
**NOTE:** This gem is in development (alpha version). Please see the [WIP Notes](#wip-notes) section for current `dsu` features.
|
13
13
|
|
14
|
-
##
|
14
|
+
## Help
|
15
15
|
|
16
16
|
After installation (`gem install dsu`), the first thing you may want to do is run the `dsu` help:
|
17
17
|
### Displaying Help
|
@@ -32,32 +32,33 @@ Options:
|
|
32
32
|
|
33
33
|
The next thing you may want to do is `add` some DSU activities (entries) for a particular day:
|
34
34
|
|
35
|
-
|
35
|
+
## Adding DSU Entries
|
36
36
|
`dsu add [OPTIONS] DESCRIPTION`
|
37
37
|
|
38
38
|
Adding DSU entry using this command will _add_ the DSU entry for the given day (or date, `-d`), and also _display_ the given day's (or date's, `-d`) DSU entries, as well as the DSU entries for the previous day relative to the given day or date (`-d`).
|
39
39
|
|
40
|
-
|
41
|
-
If you need to add a DSU entry to the current day (today), you can use the `-
|
40
|
+
### Today
|
41
|
+
If you need to add a DSU entry to the current day (today), you can use the `-n`|`--today` option. Today (`-n`) is the default; therefore, the `-n` flag is optional when adding DSU entries for the current day:
|
42
42
|
|
43
|
-
`$ dsu add
|
43
|
+
`$ dsu add -n|-today "Pair with John on ticket IN-12345"`
|
44
44
|
|
45
|
-
|
46
|
-
If for some reason you need to add a DSU entry for
|
45
|
+
### Yesterday
|
46
|
+
If for some reason you need to add a DSU entry for yesterday, you can use the `-y`| `--yesterday` option:
|
47
47
|
|
48
|
-
`$ dsu add -
|
48
|
+
`$ dsu add -y|--yesterday "Pick up ticket IN-12345"`
|
49
49
|
|
50
|
-
|
51
|
-
If you need to add a DSU entry for
|
50
|
+
### Tomorrow
|
51
|
+
If you need to add a DSU entry for tomorrow, you can use the `-t`|`--tomorrow` option:
|
52
52
|
|
53
|
-
`$ dsu add -
|
53
|
+
`$ dsu add -t|--tomorrow "Pick up ticket IN-12345"`
|
54
54
|
|
55
|
-
|
56
|
-
If you need to add a DSU entry for a date other than yesterday, today or tomorrow, you can use the `-d, [--date=DATE]` option, where DATE is any date string that can be parsed using `Time.parse`. For example: `require 'time'; Time.parse("2023-01-01")`:
|
55
|
+
### Miscellaneous Date
|
57
56
|
|
58
57
|
`$ dsu add -d "2022-12-31" "Attend company New Years Coffee Meet & Greet"`
|
59
58
|
|
60
|
-
|
59
|
+
See the [Dates](#dates) section for more information on acceptable DATE formats used by `dsu`.
|
60
|
+
|
61
|
+
## Displaying DSU Entries
|
61
62
|
You can display DSU entries for a particular day or date (`date`) using any of the following commands. When displaying DSU entries for a particular day or date (`date`), `dsu` will display the given day or date's (`date`) DSU entries, as well as the DSU entries for the _previous_ day, relative to the given day or date. If the date or day you are trying to view falls on a weekend or Monday, `dsu` will display back to, and including the weekend and previous Friday inclusive; this is so that you can share what you did over the weekend (if anything) and the previous Friday at your DSU:
|
62
63
|
|
63
64
|
- `$ dsu list today|n`
|
@@ -65,7 +66,7 @@ You can display DSU entries for a particular day or date (`date`) using any of t
|
|
65
66
|
- `$ dsu list yesterday|y`
|
66
67
|
- `$ dsu list date|d DATE`
|
67
68
|
|
68
|
-
|
69
|
+
### Examples
|
69
70
|
The following displays the entries for "Today", where `Time.now == '2023-05-06 08:54:57.6861 -0400'`
|
70
71
|
|
71
72
|
`$ dsu list today`
|
@@ -82,7 +83,7 @@ Friday, (Yesterday) 2023-05-05
|
|
82
83
|
|
83
84
|
`$ dsu list date "2023-05-06"`
|
84
85
|
|
85
|
-
|
86
|
+
See the [Dates](#dates) section for more information on acceptable DATE formats used by `dsu`.
|
86
87
|
|
87
88
|
```shell
|
88
89
|
#=>
|
@@ -94,7 +95,7 @@ Friday, (Yesterday) 2023-05-05
|
|
94
95
|
1. edc25a9a Pick up ticket IN-12345
|
95
96
|
2. f7d3018c Attend new hire meet & greet
|
96
97
|
```
|
97
|
-
|
98
|
+
## Editing DSU Entries
|
98
99
|
|
99
100
|
You can edit DSU entry groups by date. `dsu` will allow you to edit a DSU entry group using the `dsu edit SUBCOMMAND` date (today|tomorrow|yesterday|date DATE) you specify. `dsu edit` will open your DSU entry group entries in your editor, where you'll be able to perform editing functions against one or all of the entries.
|
100
101
|
|
@@ -105,7 +106,7 @@ Note: See the "[Customizing the `dsu` Configuration File](#customizing-the-dsu-c
|
|
105
106
|
- `$ dsu edit yesterday|y`
|
106
107
|
- `$ dsu edit date|d DATE`
|
107
108
|
|
108
|
-
|
109
|
+
### Examples
|
109
110
|
|
110
111
|
The following will edit your DSU entry group entries for "Today", where `Time.now == '2023-05-09 12:13:45.8273 -0400'`. Simply follow the directions in the editor file, then save and close your editor to apply the changes:
|
111
112
|
|
@@ -133,7 +134,7 @@ The following will edit your DSU entry group entries for "Today", where `Time.no
|
|
133
134
|
# *** When you are done, save and close your editor ***
|
134
135
|
```
|
135
136
|
|
136
|
-
|
137
|
+
#### Edit an Entry
|
137
138
|
|
138
139
|
Simply change the entry descripton text.
|
139
140
|
|
@@ -143,7 +144,7 @@ from: 3849f0c0 Interative planning meeting 11:00AM.
|
|
143
144
|
to: 3849f0c0 Interative planning meeting 12:00AM.
|
144
145
|
```
|
145
146
|
|
146
|
-
|
147
|
+
#### Add an Entry
|
147
148
|
|
148
149
|
Replace the entry `sha` one of the add commands: `[+|a|add]`.
|
149
150
|
|
@@ -152,7 +153,7 @@ For example...
|
|
152
153
|
+ Add me to this entry group.
|
153
154
|
```
|
154
155
|
|
155
|
-
|
156
|
+
#### Delete an Entry
|
156
157
|
|
157
158
|
Simply delete the entry or replace the entry `sha` one of the delete commands: `[-|d|delete]`.
|
158
159
|
|
@@ -167,7 +168,7 @@ from: 3849f0c0 Interative planning meeting 11:00AM.
|
|
167
168
|
to: - Interative planning meeting 11:00AM.
|
168
169
|
```
|
169
170
|
|
170
|
-
|
171
|
+
#### Reorder Entries
|
171
172
|
|
172
173
|
Simply reorder the entries in the editor.
|
173
174
|
|
@@ -183,11 +184,11 @@ from: 3849f0c0 Interative planning meeting 11:00AM.
|
|
183
184
|
3849f0c0 Interative planning meeting 11:00AM.
|
184
185
|
```
|
185
186
|
|
186
|
-
|
187
|
+
## Customizing the `dsu` Configuration File
|
187
188
|
|
188
189
|
It is **not** recommended that you create and customize a `dsu` configuration file while this gem is in alpha release. This is because changes to what configuration options are available may take place while in alpha that could break `dsu`. If you *do* want to create and customize the `dsu` configuration file reglardless, you may do the following.
|
189
190
|
|
190
|
-
|
191
|
+
### Initializing/Customizing the `dsu` Configuration File
|
191
192
|
|
192
193
|
```shell
|
193
194
|
# Creates a dsu configuration file in your home folder.
|
@@ -207,25 +208,26 @@ Where `<whoami>` would be your username (`$ whoami` on nix systems)
|
|
207
208
|
|
208
209
|
Once the configuration file is created, you can locate where the `dsu` configuration file is located by running `$ dsu config info` and taking note of the confiruration file path. You may then edit this file using your favorite editor.
|
209
210
|
|
210
|
-
|
211
|
-
|
211
|
+
#### Configuration File Options
|
212
|
+
|
213
|
+
##### editor
|
212
214
|
This is the default editor to use when editing entry groups if the EDITOR environment variable on your system is not set.
|
213
215
|
|
214
216
|
Default: `nano` (you'll need to change the default editor on Windows systems)
|
215
217
|
|
216
|
-
|
218
|
+
##### entries_display_order
|
217
219
|
Valid values are 'asc' and 'desc', and will sort listed DSU entries in ascending or descending order respectfully, by day.
|
218
220
|
|
219
221
|
Default: `'desc'`
|
220
222
|
|
221
|
-
|
223
|
+
##### entries_file_name
|
222
224
|
The entries file name format. It is recommended that you do not change this. The file name must include `%Y`, `%m` and `%d` `Time` formatting specifiers to make sure the file name is unique and able to be located by `dsu` functions. For example, the default file name is `%Y-%m-%d.json`; however, something like `%m-%d-%Y.json` or `entry-group-%m-%d-%Y.json` would work as well.
|
223
225
|
|
224
226
|
ATTENTION: Please keep in mind that if you change this value `dsu` will not recognize entry files using a different format. You would (at this time), have to manually rename any existing entry file names to the new format.
|
225
227
|
|
226
228
|
Default: `'%Y-%m-%d.json'`
|
227
229
|
|
228
|
-
|
230
|
+
##### entries_folder
|
229
231
|
This is the folder where `dsu` stores entry files. You may change this to anything you want. `dsu` will create this folder for you, as long as your system's write permissions allow this.
|
230
232
|
|
231
233
|
ATTENTION: Please keep in mind that if you change this value `dsu` will not be able to find entry files in any previous folder. You would (at this time), have to manually mode any existing entry files to this new folder.
|
@@ -234,6 +236,12 @@ Default: `'/Users/<whoami>/dsu/entries'` on nix systems.
|
|
234
236
|
|
235
237
|
Where `<whoami>` would be your username (`$ whoami` on nix systems)
|
236
238
|
|
239
|
+
## Dates
|
240
|
+
|
241
|
+
These notes apply to anywhere DATE is used...
|
242
|
+
|
243
|
+
DATE may be any date string that can be parsed using `Time.parse`. Consequently, you may use also use '/' as date separators, as well as omit the year if the date you want to display is the current year (e.g. <month>/<day>, or 1/31). For example: `require 'time'; Time.parse('2023-01-02'); Time.parse('1/2') # etc.`
|
244
|
+
|
237
245
|
## WIP Notes
|
238
246
|
This gem is in development (alpha release).
|
239
247
|
|
data/lib/dsu/version.rb
CHANGED
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: dsu
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.1.0.alpha.
|
4
|
+
version: 0.1.0.alpha.4
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Gene M. Angelo, Jr.
|
@@ -112,12 +112,18 @@ dependencies:
|
|
112
112
|
- - "~>"
|
113
113
|
- !ruby/object:Gem::Version
|
114
114
|
version: '1.0'
|
115
|
-
description:
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
|
120
|
-
|
115
|
+
description: " dsu is little gem that helps manage your Agile DSU (Daily Stand
|
116
|
+
Up) participation. How? by providing a simple command line interface (CLI) which
|
117
|
+
allows you to create, read, update, and delete (CRUD) noteworthy activities that
|
118
|
+
you performed during your day. During your DSU, you can then easily recall and share
|
119
|
+
these these activities with your team. Activities are grouped by day and can be
|
120
|
+
viewed in simple text format from the command line. When displaying DSU entries
|
121
|
+
for a particular day or date (date), dsu will display the given day or date's (date)
|
122
|
+
DSU entries, as well as the DSU entries for the previous day, relative to the given
|
123
|
+
day or date. If the date or day you are trying to view falls on a weekend or Monday,
|
124
|
+
dsu will display back to, and including the weekend and previous Friday inclusive;
|
125
|
+
this is so that you can share what you did over the weekend (if anything) and the
|
126
|
+
previous Friday at your DSU.\n"
|
121
127
|
email:
|
122
128
|
- public.gma@gmail.com
|
123
129
|
executables:
|