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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: abbd29418f4cd3c86a0e826ed9a43d7aba9e11d455c1fcd34024eeb6f1cff0b2
4
- data.tar.gz: e99710491e91d8302582bec2e201244616a126d509e8915c57a5b13e54581418
3
+ metadata.gz: c27f3abb1daf923976963a1612f08258fd8a0460d672c1674dc2c149aa69ed03
4
+ data.tar.gz: 8611ccb51518e24f9497ffc0c02a7b1dd567321419728f727969718620da5b59
5
5
  SHA512:
6
- metadata.gz: 46bb2a7b817f6dcc413dbf343598dd9c016752eb84657f7b47c0bb19a923618c0e7ef0dc0e59f2a410808537ead6b26f2e647faabe93932c931cf1040be63acb
7
- data.tar.gz: 348649411b52ed829e640e7c1e5a7d00c6df99bbaa80051a9f98176d34a0c078db4de035ba2a8137bb3295a57e5a500f223a3c7f7c7bf2868356bc226933467c
6
+ metadata.gz: d1b1bcd4f9222bf2629ffa0d02434b429280f20e760676f2cde2eaca40860f56952995ce7a69628981cc0f7caf941a48c07cca91a9c1f96b4334e872d5a7374a
7
+ data.tar.gz: 0436e614b146dbfd71ca098cc699d7b6de99cafe47cfbad8141ac6268853b6f7d68285d8222053796bb2db729cf86c14e03e3fa3f2dca97554fd78998449fbbe
data/CHANGELOG.md CHANGED
@@ -1,3 +1,6 @@
1
+ ## [0.1.0.alpha.4] - 2023-05-09
2
+ * Changes
3
+ - Gemfile gemspec description changes.
1
4
  ## [0.1.0.alpha.3] - 2023-05-09
2
5
  * Changes
3
6
  - Entry groups are now editable using the `dsu edit SUBCOMMAND` command. See the README.md or `dsu help edit` for more information.
data/Gemfile.lock CHANGED
@@ -1,7 +1,7 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- dsu (0.1.0.alpha.3)
4
+ dsu (0.1.0.alpha.4)
5
5
  activesupport (~> 7.0, >= 7.0.4)
6
6
  colorize (~> 0.8.1)
7
7
  deco_lite (~> 1.3)
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
- ## Quick Start
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
- ### Adding DSU Entries
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
- #### Today
41
- If you need to add a DSU entry to the current day (today), you can use the `-t, [--today]` option. Today (`-t`) is the default; therefore, the `-t` flag is optional when adding DSU entries for the current day:
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 [-t] "Pair with John on ticket IN-12345"`
43
+ `$ dsu add -n|-today "Pair with John on ticket IN-12345"`
44
44
 
45
- #### Yesterday
46
- If for some reason you need to add a DSU entry for the previous day, you can use the `-p, [--previous-day]` option:
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 -p "Pick up ticket IN-12345"`
48
+ `$ dsu add -y|--yesterday "Pick up ticket IN-12345"`
49
49
 
50
- #### Tomorrow
51
- If you need to add a DSU entry for the previous day, you can use the `-n, [--next-day]` option:
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 -n "Pick up ticket IN-12345"`
53
+ `$ dsu add -t|--tomorrow "Pick up ticket IN-12345"`
54
54
 
55
- #### Miscellaneous Date
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
- ### Displaying DSU Entries
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
- #### Examples
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
- Where 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 thee 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.`:
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
- ### Editing DSU Entries
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
- #### Examples
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
- ##### Edit an Entry
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
- ##### Add an Entry
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
- ##### Delete an Entry
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
- ##### Reorder Entries
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
- ### Customizing the `dsu` Configuration File
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
- #### Initializing/Customizing the `dsu` Configuration File
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
- ##### Configuration File Options
211
- ###### editor
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
- ###### entries_display_order
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
- ###### entries_file_name
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
- ###### entries_folder
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
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Dsu
4
- VERSION = '0.1.0.alpha.3'
4
+ VERSION = '0.1.0.alpha.4'
5
5
  end
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.3
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: |2
116
- dsu is little gem that helps manage your Agile DSU (Daily Stand Up) participation. How? by providing a simple command line interface (CLI) which allows you to create, read, update, and delete (CRUD) noteworthy activities that you performed during your day. During your DSU, you can then easily recall and share these these activities with your team. Activities are grouped by day and can be viewed in simple text format from the command line. When viewing a particular day, dsu will automatically display the previous day's activities as well. This is useful for remembering what you did yesterday, so you can share your "Today" and "Yesterday" activities with your team during your DSU.
117
-
118
- NOTE: This gem is currently in development (alpha release) and does not provide the ability to UPDATE or DELETE activities. These features will be added in future releases.
119
-
120
- IN ADDITION TO THIS: dsu's current behavior when viewing a particular day is to display the previous day's activities. This behavior is not necessarily ideal when sharing activities for a DSU that occurs on a Monday. This is because Monday's DSU typically includes sharing what you did on last FRIDAY (not necessarily "Yesterday"), as well as what you plan on doing "Today". This behavior will be changed in a future release as well, to display the previous Friday's activities (as well as Saturday and Sunday) if "Today" happens to be Monday.
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: