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.
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
+ ```
data/exe/ruby_todo ADDED
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/env ruby
2
+ # frozen_string_literal: true
3
+
4
+ require "ruby_todo"
5
+
6
+ RubyTodo.start