ruby_todo 0.3.0 → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +33 -54
- data/PRD.md +264 -0
- data/PROGRESS.md +273 -0
- data/README.md +94 -1
- data/exe/ruby_todo +6 -0
- data/lib/ruby_todo/cli.rb +853 -0
- data/lib/ruby_todo/database.rb +121 -0
- data/lib/ruby_todo/models/notebook.rb +74 -0
- data/lib/ruby_todo/models/task.rb +79 -0
- data/lib/ruby_todo/models/template.rb +84 -0
- data/lib/ruby_todo/version.rb +1 -1
- metadata +11 -3
- data/ruby_todo.gemspec +0 -52
data/README.md
CHANGED
@@ -35,6 +35,32 @@ Or install it yourself as:
|
|
35
35
|
$ gem install ruby_todo
|
36
36
|
```
|
37
37
|
|
38
|
+
## Quick Start
|
39
|
+
|
40
|
+
After installing the gem:
|
41
|
+
|
42
|
+
1. Initialize the application:
|
43
|
+
```bash
|
44
|
+
$ ruby_todo init
|
45
|
+
```
|
46
|
+
|
47
|
+
2. Create your first notebook:
|
48
|
+
```bash
|
49
|
+
$ ruby_todo notebook create "Personal"
|
50
|
+
```
|
51
|
+
|
52
|
+
3. Add your first task:
|
53
|
+
```bash
|
54
|
+
$ ruby_todo task add "Personal" "My first task"
|
55
|
+
```
|
56
|
+
|
57
|
+
4. List your tasks:
|
58
|
+
```bash
|
59
|
+
$ ruby_todo task list "Personal"
|
60
|
+
```
|
61
|
+
|
62
|
+
All `ruby_todo` commands can be run from anywhere in your terminal as they're installed globally with the gem.
|
63
|
+
|
38
64
|
## Usage
|
39
65
|
|
40
66
|
### Initialization
|
@@ -206,10 +232,26 @@ Templates support the following placeholder types:
|
|
206
232
|
|
207
233
|
## Development
|
208
234
|
|
209
|
-
After checking out the repo, run `bundle install` to install dependencies. Then, run `rake test` to run the tests.
|
235
|
+
After checking out the repo, run `bundle install` to install dependencies. Then, run `rake test` to run the tests. You can also run `rubocop` to check the code style.
|
210
236
|
|
211
237
|
To install this gem onto your local machine, run `bundle exec rake install`.
|
212
238
|
|
239
|
+
### CI/CD
|
240
|
+
|
241
|
+
This project uses GitHub Actions for continuous integration and delivery:
|
242
|
+
|
243
|
+
- **CI Workflow**: Runs tests and RuboCop on multiple Ruby versions for every push and pull request
|
244
|
+
- **Release Workflow**: Automatically increments version number, updates CHANGELOG, creates a GitHub release, and publishes to RubyGems when code is pushed to the main branch
|
245
|
+
|
246
|
+
To release a new version, just merge your changes to the main branch. The automation will:
|
247
|
+
1. Increment the patch version
|
248
|
+
2. Update the CHANGELOG.md file
|
249
|
+
3. Run tests to ensure everything works
|
250
|
+
4. Build and publish the gem to RubyGems
|
251
|
+
5. Create a GitHub release
|
252
|
+
|
253
|
+
For manual releases or version changes (major or minor), update the version in `lib/ruby_todo/version.rb` before merging to main.
|
254
|
+
|
213
255
|
## Contributing
|
214
256
|
|
215
257
|
Bug reports and pull requests are welcome on GitHub at https://github.com/jeremiahparrack/ruby_todo.
|
@@ -217,3 +259,54 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/jeremi
|
|
217
259
|
## License
|
218
260
|
|
219
261
|
The gem is available as open source under the terms of the MIT License.
|
262
|
+
|
263
|
+
## Troubleshooting
|
264
|
+
|
265
|
+
### Command not found after installation
|
266
|
+
|
267
|
+
If you see "command not found" after installing the gem, check the following:
|
268
|
+
|
269
|
+
1. Verify the gem is installed:
|
270
|
+
```bash
|
271
|
+
$ gem list ruby_todo
|
272
|
+
```
|
273
|
+
|
274
|
+
2. Check your gem installation path:
|
275
|
+
```bash
|
276
|
+
$ gem environment
|
277
|
+
```
|
278
|
+
|
279
|
+
3. Make sure your PATH includes the gem bin directory shown in the environment output.
|
280
|
+
|
281
|
+
4. You may need to run:
|
282
|
+
```bash
|
283
|
+
$ rbenv rehash # If using rbenv
|
284
|
+
```
|
285
|
+
or
|
286
|
+
```bash
|
287
|
+
$ rvm rehash # If using RVM
|
288
|
+
```
|
289
|
+
|
290
|
+
### Database Issues
|
291
|
+
|
292
|
+
If you encounter database issues:
|
293
|
+
|
294
|
+
1. Try resetting the database:
|
295
|
+
```bash
|
296
|
+
$ rm ~/.ruby_todo/ruby_todo.db
|
297
|
+
$ ruby_todo init
|
298
|
+
```
|
299
|
+
|
300
|
+
2. Check file permissions:
|
301
|
+
```bash
|
302
|
+
$ ls -la ~/.ruby_todo/
|
303
|
+
```
|
304
|
+
|
305
|
+
### Getting Help
|
306
|
+
|
307
|
+
Run any command with `--help` to see available options:
|
308
|
+
|
309
|
+
```bash
|
310
|
+
$ ruby_todo --help
|
311
|
+
$ ruby_todo task add --help
|
312
|
+
```
|