tasks_cli 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65c56bae0c638f891b0b2d8893cbedefbeb8a3f9a2ca695eb16d9331f2c4f5af
-  data.tar.gz: d22a346ea8346f234e6849ef23073ad41ab671dc6652fb7b5fbba8c462e0e75e
+  metadata.gz: 23f5574360b1def72fa621127d325779afb0ae22b260755686ff3dd87cf8bef0
+  data.tar.gz: dd4090622a552cde4d2bf01b774f1e2ae53980fae66b767491f7dcc36d9643c2
 SHA512:
-  metadata.gz: ea2f7bb708341e7aa16a16be841036a937a0f3a7b3bc189379b1f3157d7a6c2da921bea6861b79a9063669702b1cd44f5300045cc86ec22bdca2a6baeb6aa478
-  data.tar.gz: e89f423a18348ecf83cefbd0e46c66eda9c64004b23f198aced45e3e7eb5ccb561c662901641edbb4b61eef66ef65f73c6f6ddeffcf567b2f3a1b75e84e2a772
+  metadata.gz: 1dcf2eef4863b35bb212cec9dbf4e090670d3c84ff734fb8e231eaed9151fd1780dc4ef7a95d640d8f7eeb377779f7fe89d3ea64a3cfadb47f69dbf154d5860c
+  data.tar.gz: f0d031c7ede706093e0ef8f5980ac7c64973a1b230e16a2e7557540267b1a1a3a38773ef1f9464d94f1e817076dcb934561bd1de1b150de6b9f496778728c70a

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    tasks_cli (0.1.1)
+    tasks_cli (0.1.3)
       csv (~> 3.0)
       logger (~> 1.5)
       ostruct (~> 0.3.0)

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 adilw3nomad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/lib/tasks_cli/cli.rb

@@ -12,12 +12,23 @@ module TasksCLI
       print_tasks(manager.all_tasks)
     end
 
-    desc 'filter FIELD:VALUE', 'Filter tasks by field and value'
-    def filter(filter_string)
+    desc 'filter FIELD:VALUE [FIELD:VALUE ...]',
+         'Filter tasks by one or more field:value pairs. Example: filter status:in_progress priority:high'
+    def filter(*args)
+      criteria = {}
+      args.flatten.each do |arg|
+        field, value = arg.split(':', 2)
+        criteria[field.to_sym] ||= []
+        criteria[field.to_sym] << value
+      end
       manager = TaskManager.new
-      key, value = filter_string.split(':')
-      filtered_tasks = manager.filter_tasks({ key => value })
-      print_tasks(filtered_tasks)
+      filtered_tasks = manager.filter_tasks(criteria)
+      if filtered_tasks.empty?
+        puts Rainbow('No tasks found matching the given criteria.').yellow
+      else
+        print_tasks(filtered_tasks)
+        puts "\nFiltered tasks: #{Rainbow(filtered_tasks.count).green}"
+      end
     end
 
     desc 'view NUMBER', 'View details of a specific task'

data/lib/tasks_cli/task_manager.rb

@@ -78,7 +78,9 @@ module TasksCLI
 
     def filter_tasks(criteria)
       @tasks.select do |task|
-        criteria.all? { |field, value| task.matches?(field, value) }
+        criteria.all? do |field, values|
+          values.any? { |value| task.matches?(field, value) }
+        end
       end
     end
 

data/lib/tasks_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TasksCLI
-  VERSION = '0.1.2'
+  VERSION = '0.1.3'
 end

data/readme.md

@@ -0,0 +1,106 @@
+# TasksCLI
+
+TasksCLI is a command-line interface tool for managing tasks stored in a CSV file. It allows you to list, filter, view, and update tasks efficiently from your terminal.
+
+
+## Features
+
+- List all tasks
+- Filter tasks by field and value
+- View detailed information for a specific task
+- Update task status
+- Colorful output for better readability
+
+![TasksCLI Example](example.png)
+
+
+
+## Installation
+
+Install the gem by running:
+
+```
+gem install tasks_cli
+```
+
+## Configuration
+
+TasksCLI expects a CSV file located at `~/tasks.csv`. Ensure this file exists and has the correct format before using the tool.
+
+### CSV Format
+
+The CSV file should have the following columns:
+
+1. Epic Name
+2. Ticket Number
+3. Ticket Name
+4. Ticket Description
+5. Priority
+6. Status
+7. Relates To [Array]
+8. Blocked By [Array]
+9. Updated At (optional)
+
+```
+Epic Name,Ticket Number,Ticket Name,Ticket Description,Priority,Status,Relates To,Blocked By,Updated At
+Epic 1,1,Task 1,Description 1,High,To Do,,,
+Epic 1,2,Task 2,Description 2,Medium,In Progress,,,
+Epic 1,3,Task 3,Description 3,Low,Done,,,
+```
+
+What I find best is to use the following process;
+1. Loosely define the project with an LLM of your choice. 
+2. Ask LLM to generate a list of tasks for the project.
+3. Iterate on the LLM generated tasks until you are satisfied.
+4. Ask LLM to generate the CSV of the tasks using the above format. 
+
+## Usage
+
+### Listing Tasks
+
+To list all tasks, run:
+
+```
+tasks list
+```
+
+### Filtering Tasks
+
+To filter tasks by a specific field and value, run:
+
+```
+tasks filter FIELD:VALUE
+```
+
+Replace `FIELD` with the column name and `VALUE` with the value you want to filter by.
+
+For example, to filter tasks by Epic 1:
+
+```
+tasks filter "Epic Name":"Epic 1" 
+```
+
+### Viewing Task Details
+
+To view details of a specific task, run:
+
+```
+tasks view NUMBER
+```
+
+### Updating Task Status
+
+To update the status of a task, run:
+
+```
+tasks update NUMBER STATUS
+```
+
+Replace `NUMBER` with the ticket number and `STATUS` with the new status you want to set.
+
+## License
+
+This project is licensed under the MIT License. See the `LICENSE` file for more details.
+
+
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tasks_cli
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - adilw3nomad
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-16 00:00:00.000000000 Z
+date: 2024-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: csv
@@ -104,13 +104,15 @@ extra_rdoc_files: []
 files:
 - Gemfile
 - Gemfile.lock
+- LICENSE
 - bin/tasks
+- example.png
 - lib/tasks_cli.rb
 - lib/tasks_cli/cli.rb
 - lib/tasks_cli/task.rb
 - lib/tasks_cli/task_manager.rb
 - lib/tasks_cli/version.rb
-- tasks
+- readme.md
 - tasks_cli.gemspec
 homepage: https://github.com/adilw3nomad/tasks_cli
 licenses:

data/tasks

@@ -1,259 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'csv'
-require 'optparse'
-require 'rainbow'
-require 'time'
-require 'json'
-
-Rainbow.enabled = true
-
-class Task
-  attr_reader :epic, :number, :name, :description, :priority, :status, :relates_to, :blocked_by, :updated_at
-  
-  def initialize(row)
-    @epic = extract_value(row[0])
-    @number = extract_value(row[1])
-    @name = extract_value(row[2])
-    @description = extract_value(row[3])
-    @priority = extract_value(row[4])
-    @status = extract_value(row[5])
-    @relates_to = extract_value(row[6])
-    @blocked_by = extract_value(row[7])
-    @updated_at = extract_value(row[8]) || Time.now.iso8601
-  end
-
-  def status_color
-    case @status.downcase
-    when 'to do' then :red
-    when 'in progress' then :yellow
-    when 'done' then :green
-    else :white
-    end
-  end
-  
-  
-
-  def extract_value(field)
-    return field if field.is_a?(String)
-    field.is_a?(Array) ? field[1].to_s.strip : field.to_s.strip
-  end
-
-  def to_s
-    "#{Rainbow(@number).cyan}: #{Rainbow(@name).bright} (#{status_color}) - Priority: #{priority_colored} - Updated: #{@updated_at}"
-  end
-
-  def detailed_view
-    <<~TASK
-      #{Rainbow("Epic:").bright} #{@epic}
-      #{Rainbow("Number:").bright} #{Rainbow(@number).cyan}
-      #{Rainbow("Name:").bright} #{Rainbow(@name).bright}
-      #{Rainbow("Description:").bright} #{@description}
-      #{Rainbow("Priority:").bright} #{priority_colored}
-      #{Rainbow("Status:").bright} #{status_color}
-      #{Rainbow("Relates To:").bright} #{@relates_to}
-      #{Rainbow("Blocked By:").bright} #{@blocked_by}
-      #{Rainbow("Last Updated:").bright} #{@updated_at}
-    TASK
-  end
-
-  def to_csv
-    [@epic, @number, @name, @description, @priority, @status, @relates_to, @blocked_by, @updated_at]
-  end
-
-  def matches?(field, value)
-    send(field.to_sym).to_s.downcase.include?(value.to_s.downcase)
-  rescue NoMethodError
-    false
-  end
-
-  def update_timestamp
-    @updated_at = Time.now.iso8601
-  end
-
-  def status_color
-    case @status.downcase
-    when 'to do' then Rainbow(@status).red
-    when 'in progress' then Rainbow(@status).yellow
-    when 'done' then Rainbow(@status).green
-    else Rainbow(@status).white
-    end
-  end
-
-  def priority_colored
-    case @priority.downcase
-    when 'high' then Rainbow(@priority).red
-    when 'medium' then Rainbow(@priority).yellow
-    when 'low' then Rainbow(@priority).green
-    else Rainbow(@priority).white
-    end
-  end
-end
-
-class TaskManager
-  def initialize(file_path)
-    @file_path = file_path
-    load_tasks
-  end
-
-  def load_tasks
-    @tasks = []
-    CSV.foreach(@file_path, headers: false) do |row|
-      next if row == ["Epic Name", "Ticket Number", "Ticket Name", "Ticket Description", "Priority", "Status", "Relates To", "Blocked By", "Updated At"]
-      begin
-        parsed_row = row.map do |field|
-          parse_field(field)
-        end
-        @tasks << Task.new(parsed_row)
-      rescue => e
-        puts "Error processing row: #{row.inspect}"
-        puts "Error message: #{e.message}"
-      end
-    end
-  rescue CSV::MalformedCSVError => e
-    puts Rainbow("Error reading CSV: #{e.message}. Trying to parse with alternative method...").red
-    parse_csv_manually
-  rescue => e
-    puts Rainbow("Unexpected error while loading tasks: #{e.message}").red
-    puts e.backtrace
-  end
-
-  def parse_field(field)
-    return field if field.nil? || !(field.start_with?('[') && field.end_with?(']'))
-    parsed = JSON.parse(field.gsub('=>', ':'))
-    [parsed[0], parsed[1]]
-  rescue JSON::ParserError
-    [nil, field]
-  end
-
-  def parse_csv_manually
-    @tasks = []
-    lines = File.readlines(@file_path)
-    lines[1..-1].each do |line|
-      fields = line.strip.split(',')
-      parsed_fields = fields.map { |field| parse_field(field) }
-      @tasks << Task.new(parsed_fields)
-    rescue => e
-      puts "Error processing line: #{line}"
-      puts "Error message: #{e.message}"
-    end
-  end
-
-  def save_tasks(task_number)
-    lines = File.readlines(@file_path)
-    File.open(@file_path, 'w') do |file|
-      file.puts lines[0].chomp  # Write header as is
-      lines[1..-1].each do |line|
-        fields = line.strip.split(',').map { |f| parse_field(f) }
-        if fields[1][1] == task_number
-          task = find_task(task_number)
-          updated_line = task.to_csv.map { |value| [fields[_1][0], value].to_s }.join(',')
-          file.puts updated_line
-        else
-          file.puts line.chomp  # Write unchanged lines as is
-        end
-      end
-    end
-  end
-
-  def all_tasks
-    @tasks
-  end
-
-  def filter_tasks(criteria)
-    @tasks.select do |task|
-      criteria.all? { |field, value| task.matches?(field, value) }
-    end
-  end
-
-  def find_task(number)
-    @tasks.find { |task| task.number == number }
-  end
-
-  def update_status(number, new_status)
-    task = find_task(number)
-    if task
-      old_status = task.status
-      task.instance_variable_set(:@status, new_status)
-      task.update_timestamp
-      save_tasks(number)
-      puts Rainbow("Updated status of task #{number} from #{old_status} to #{new_status}").green
-      puts Rainbow("Last updated: #{task.updated_at}").cyan
-    else
-      puts Rainbow("Task not found").red
-    end
-  end
-end
-
-def print_tasks(tasks)
-  if tasks.empty?
-    puts Rainbow("No tasks found.").yellow
-    return
-  end
-
-  puts Rainbow("\n%-10s %-30s %-15s %-10s %-25s" % ["Number", "Name", "Status", "Priority", "Last Updated"]).underline
-  tasks.each do |task|
-    puts "%-10s %-30s %-15s %-10s %-25s" % [
-      Rainbow(task.number).cyan,
-      Rainbow(task.name.to_s.truncate(30)).magenta,
-      task.status_color,
-      task.priority_colored,
-      Rainbow(task.updated_at).blue
-    ]
-  end
-  puts "\nTotal tasks: #{Rainbow(tasks.count).green}"
-end
-
-# Main program
-if __FILE__ == $0
-  begin
-    file_path = File.expand_path('~/tasks.csv')  # Store the CSV in the user's home directory
-    manager = TaskManager.new(file_path)
-
-    options = {}
-    OptionParser.new do |opts|
-      opts.banner = "Usage: tasks [options]"
-
-      opts.on("-a", "--all", "View all tasks") do
-        options[:all] = true
-      end
-
-      opts.on("-f FIELD:VALUE", "--filter FIELD:VALUE", "Filter tasks by field and value (can be used multiple times)") do |f|
-        options[:filter] ||= {}
-        key, value = f.split(':')
-        options[:filter][key] = value
-      end
-
-      opts.on("-v NUMBER", "--view NUMBER", "View a single task") do |v|
-        options[:view] = v
-      end
-
-      opts.on("-u NUMBER,STATUS", "--update NUMBER,STATUS", Array, "Update a task's status") do |u|
-        options[:update] = u
-      end
-    end.parse!
-
-    if options[:all]
-      print_tasks(manager.all_tasks)
-    elsif options[:filter]
-      print_tasks(manager.filter_tasks(options[:filter]))
-    elsif options[:view]
-      task = manager.find_task(options[:view])
-      if task
-        puts task.detailed_view
-      else
-        puts Rainbow("Task not found").red
-      end
-    elsif options[:update]
-      number, status = options[:update]
-      manager.update_status(number, status)
-    else
-      puts Rainbow("No valid option provided. Use -h for help.").yellow
-    end
-  rescue Errno::ENOENT
-    puts Rainbow("Error: CSV file '#{file_path}' not found. Please ensure the file exists.").red
-  rescue => e
-    puts Rainbow("An unexpected error occurred: #{e.message}").red
-    puts e.backtrace
-  end
-end