devlogs 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9df7671be5997a9e311b6a8c10863732b95fb3e6bdb89a7f5ba8476d3cec4653
-  data.tar.gz: af3731bb2c7134cea231b17a7c940d313d13f21c0721c720029e1084d706f0a4
+  metadata.gz: 710e8aea6a7ce1d312e3f94c36bb01c718358e94d46be5745956ffa66e902c77
+  data.tar.gz: f02110b5872d1cc117aad8b4e5cd5e5baabdb160336a9a300d96b16ad08aca5a
 SHA512:
-  metadata.gz: ffe4be66ace5c88074c0ce3e8a20e0f82a53162e59776be3bfdbf1d72c038d4d73365ca65bf91047b4730a64efeb548f3e1b7f8a8704a0f9554bc427ed0daa39
-  data.tar.gz: 9f3326e754283f25d307c598aa8824c53aa5686c112ebb9c9301ee7dc424710c572cac02275f72cf204e5e00677c92c03bd7e3f4ee157e7d585c9a3bcd2fc6c9
+  metadata.gz: 70776c55ba2df5ac5c14d96e6a773a30821e8ceb7fbcffeb9af65c005cd54cf04ec161dff61b8f0285f1324921ca1fb7d92aa05ce8ce48056423c5a7b3a1f28e
+  data.tar.gz: 371ede787d87a78a2de645734e8a0953467acb7a9e64a01c5d887057b894eefe3530649c2d482462d05119fc28fec9c5e6aeb37705944aab9641881c39ebb6ee

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    devlogs (1.0.0)
+    devlogs (1.1.0)
       rsync (~> 1.0, >= 1.0.9)
       thor (~> 1.2.1)
       tty-prompt (~> 0.23.1)

data/README.md

@@ -47,7 +47,8 @@ obsidianvault
      >> content mirrored here
 ```
 
-### Creating entries
+### Logs 
+#### Creating log entries
 Once you are done for the day or session run the `new` command:
 
 ```bash
@@ -66,22 +67,60 @@ Your editor will pop up and you can fill in cliff notes.
 
 Save and if you set a mirror it will sync over!
 
-### Retrieve previous entry
+#### Retrieve previous entry
 You can use the `last` command to retrieve the most recent entry
 
 ```bash
 devlogs last
 ```
 
-## Development
+#### List all log entires
+You can use the `ls` command to retrieve the most recent entry
+
+```bash
+devlogs ls
+```
+
+### Issues
+Devlogs also allows you to manage issues locally as well. Devlogs creates a separate subdirectory in the `.devlogs` folder which will contain all issues. These files are also synced if the repository is mirrored.
+
+#### Creating an Issue
+You can create a new issue via `devlogs new_issue`. You will be prompted to provide some information and then your editor will open and you can fill in some details
+
+```bash
+devlogs new_issue
+```
 
+#### List all issues
+You can use the `ls_issues` command to retrieve the most recent entry
+
+```bash
+devlogs ls_issues
+```
+
+### Custom Templates
+Devlogs initializes the log repository with two custom templates that you can edit freely `.log_template.erb.md` and `.issue_template.erb.md`. These are [Embedded Ruby Files](https://en.wikipedia.org/wiki/ERuby) meaning they can access certain variables.
+
+#### Log Template
+| Variable Name | Value |
+| --- | --- |
+| Time | The current date, hour and minute time |
+
+#### Issue Template
+| Variable Name | Value |
+| --- | --- |
+| Time | The current date, hour and minute time |
+| Issue Title | The provided issue title input from the issue creation prompt |
+| Description | The provided description input from the issue creation prompt |
+| Reproduction Steps | The provided input for reproduction steps from the issue creation prompt |
+
+## Development
 After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/devlogs.
+Bug reports and pull requests are welcome on GitHub at https://github.com/aquaflamingo/devlogs.
 
 ## License
 

data/lib/devlogs/cli.rb

@@ -4,7 +4,7 @@ require_relative "version"
 require_relative "repository"
 require_relative "editor"
 require_relative "pager"
-require_relative "prompt_utils"
+require_relative "helper/tty_prompt_helper"
 require_relative "repository/initializer"
 require "thor"
 
@@ -13,7 +13,7 @@ module Devlogs
   # The CLI devlogs CLI
   #
   class CLI < Thor
-    include PromptUtils
+    include TTYPromptHelper
 
     package_name "devlogs"
 
@@ -40,10 +40,10 @@ module Devlogs
       puts "Creating devlogs repository"
 
       Repository::Initializer.run(
-        { 
+        {
           force: options.force?,
-          dirpath: options.dirpath,
-        },
+          dirpath: options.dirpath
+        }
       )
 
       puts "Created devlogs repository"
@@ -64,6 +64,8 @@ module Devlogs
         puts File.read(last_entry)
       end
     end
+
+    # FIXME: Add logs sub command
     #
     # Creates a devlogs entry in the repository and syncs changes
     # to the mirrored directory if set
@@ -76,6 +78,39 @@ module Devlogs
       repo.sync
     end
 
+    # FIXME: Add logs sub command
+    #
+    # Creates a devlogs entry in the repository and syncs changes
+    # to the mirrored directory if set
+    #
+    desc "new_issue", "Create a new devlogs entry" # [4]
+    def new_issue
+      repo.create_issue
+      repo.sync
+    end
+
+    #
+    # Lists repository issues
+    #
+    desc "ls_issues", "Lists the repository issues and allows you to select"
+    def ls_issues
+      issues = repo.ls_issues
+
+      if issues.empty?
+        puts "No issues present in this repository"
+        exit 0
+      end
+
+      # Use the file names as visible keys for the prompt
+      issue_names = issues.map { |e| File.basename(e) }
+
+      # Build the TTY:Prompt
+      result = build_select_prompt(data: issue_names, text: "Select an issue issue...")
+
+      # Open in paging program
+      Pager.open(issues[result])
+    end
+
     #
     # Lists repository logs
     #
@@ -83,7 +118,7 @@ module Devlogs
     def ls
       entries = repo.ls
 
-      if entries.size < 1 
+      if entries.empty?
         puts "No logs present in this repository"
         exit 0
       end
@@ -103,7 +138,7 @@ module Devlogs
     # Helper method for repository loading
     #
     def repo
-      # FIXME: Need to add in path specification here 
+      # FIXME: Need to add in path specification here
       @repo ||= Repository.load
     end
   end

data/lib/devlogs/helper/time_helper.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module TimeHelper
+  # Example: 11-22-2022__13h43m
+  TIME_FORMAT_FILE_PREFIX = "%m-%d-%Y__%kh%Mm"
+
+  def current_time(format: TIME_FORMAT_FILE_PREFIX)
+    time = Time.new
+    time.strftime(format)
+  end
+end

data/lib/devlogs/{prompt_utils.rb → helper/tty_prompt_helper.rb}

@@ -5,7 +5,7 @@ require "tty-prompt"
 #
 # Utility module for tty-prompt library
 #
-module PromptUtils
+module TTYPromptHelper
   #
   # Builds a basic select prompt using the provided data
   #
@@ -22,4 +22,10 @@ module PromptUtils
       end
     end
   end
+
+  module Validator
+    def self.length_range(min: 0, max: 99)
+      ->(input) { input.size > min && input.size <= max }
+    end
+  end
 end

data/lib/devlogs/{log_template.rb → render/erb_template_renderer.rb}

@@ -3,9 +3,10 @@
 require "erb"
 
 #
-# LogTemplate is a class that represents the rendered log template
+# ErbTemplateRenderer is a base class for rendering arbitrary
+# ERB templates.
 #
-class LogTemplate
+class ErbTemplateRenderer
   attr_reader :time
 
   TIME_FORMAT_TEXT_ENTRY = "%m-%d-%Y %k:%M"

data/lib/devlogs/render/issue_template_renderer.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative "erb_template_renderer"
+
+#
+# IssueTemplateRenderer captures issue information and
+# renders it within a given ERB template
+#
+class IssueTemplateRenderer < ErbTemplateRenderer
+  attr_reader :title, :description, :reproduction
+
+  def initialize(template_file_path, info = {})
+    super(template_file_path)
+
+    @title = info[:display_title]
+    @description = info[:description]
+    @reproduction = info[:reproduction]
+  end
+end

data/lib/devlogs/render/log_template_renderer.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "erb_template_renderer"
+
+#
+# LogTemplateRenderer captures log information and
+# renders it within a given ERB template
+#
+class LogTemplateRenderer < ErbTemplateRenderer
+end

data/lib/devlogs/repository/config.rb

@@ -4,7 +4,7 @@
 class Repository
   class Config
     # FIXME: Need to figure out file path
-    attr_reader :name, :description, :mirror, :file_path, :template_file_path
+    attr_reader :name, :description, :mirror, :file_path, :template_file_path, :short_code
 
     # Configuration associated with the Mirror
     MirrorConfig = Struct.new(:use_mirror, :path, keyword_init: true)
@@ -13,6 +13,7 @@ class Repository
       @file_path = path
       @template_file_path = opts[:template_file_path]
       @name = opts[:name]
+      @short_code = opts[:short_code]
       @description = opts[:description]
       @mirror = MirrorConfig.new(opts[:mirror])
     end

data/lib/devlogs/repository/config_builder.rb

@@ -0,0 +1,186 @@
+# frozen_string_literal: true
+
+class Repository
+  class ConfigBuilder
+    def initialize(dirpath)
+      @config_store = if dirpath
+                        Repository::ConfigStore.new(dir: dirpath)
+                      else
+                        Repository::ConfigStore.new
+                      end
+    end
+
+    def build
+      config_info = prompt_for_info
+
+      DraftConfig.new(@config_store, config_info)
+    end
+
+    private
+
+    # Creates an interactive prompt for user input
+    #
+    # @returns [Hash]
+    def prompt_for_info
+      prompt = TTY::Prompt.new
+
+      prompt.collect do |_p|
+        # Project name
+        key(:name).ask("What is the project name?") do |q|
+          q.required true
+        end
+
+        # Project description
+        key(:desc).ask("What is the project description?") do |q|
+          q.required true
+        end
+
+        # Project short code, e.g. RLP
+        key(:short_code).ask("What is the project short code (3 letters)?") do |q|
+          q.required true
+
+          q.validate ->(input) { input.size.positive? && input.size <= 3 }
+
+          q.messages[:valid?] = "Short code must be 3 letters or less"
+        end
+
+        key(:mirror) do
+          key(:use_mirror).ask("Do you want to mirror these logs?", convert: :boolean)
+          key(:path).ask("Path to mirror directory: ")
+        end
+      end
+    end
+
+    class DraftConfig
+      INFO_FILE_SUFFIX = "devlogs.info.md"
+      LOG_TEMPLATE_FILE_NAME = "__log_template.erb.md"
+      ISSUE_TEMPLATE_FILE_NAME = "__issue_template.erb.md"
+
+      def initialize(config_store, config_info)
+        @config_store = config_store
+        @config_info = config_info
+      end
+
+      #
+      # Initiates the write process of devlogs repository
+      #
+      # @param force [Boolean]
+      #
+      def save!(force: false)
+        exists = File.exist?(@config_store.file_path)
+
+        if exists && !force
+          puts "Log repository already exists in aborting..."
+          raise RuntimeError
+        end
+
+        create_config_store_dir
+        save_config_file
+        save_info_file
+        save_log_template_file
+
+        create_issue_dir
+        save_issue_template_file
+        save_data_file
+      end
+
+      private
+
+      #
+      # Creates the configuration store directory
+      #
+      def create_config_store_dir
+        # Create the draft_config directory
+        FileUtils.mkdir_p(@config_store.dir)
+      end
+
+      #
+      # Creates the issue directory
+      #
+      def create_issue_dir
+        # Create the draft_config directory
+        FileUtils.mkdir_p(@config_store.issue_dir_path)
+      end
+
+      #
+      # Saves the .devlogs.config.yml file
+      #
+      def save_config_file
+        # Create draft_config file
+        File.open(@config_store.file_path, "w") do |f|
+          f.write @config_info.to_yaml
+        end
+      end
+
+      #
+      # Saves the .info file
+      #
+      def save_info_file
+        # Replace spaces in project name with underscores
+        sanitized_project_name = @config_info[:name].gsub(/ /, "_").downcase
+
+        # Create the info file
+        info_file_name = "#{sanitized_project_name}.#{INFO_FILE_SUFFIX}"
+        info_file = File.join(@config_store.dir, info_file_name)
+
+        File.open(info_file, "w") do |f|
+          f.puts "# #{@config_info[:name]}"
+          f.puts (@config_info[:desc]).to_s
+        end
+      end
+
+      #
+      # Copies the log template to the config store directory
+      #
+      def save_log_template_file
+        # Copy the default template file inside the gem into the repository
+        default_log_template_path = get_template_path(LOG_TEMPLATE_FILE_NAME)
+
+        draft_config_log_template_file_path = File.join(@config_store.dir, Repository::ConfigStore::LOG_TEMPLATE_FILE)
+
+        FileUtils.cp(default_log_template_path, draft_config_log_template_file_path)
+      end
+
+      #
+      # Copies the log template to the config store directory
+      #
+      def save_issue_template_file
+        default_iss_template_path = get_template_path(ISSUE_TEMPLATE_FILE_NAME)
+
+        draft_config_iss_template_file_path = File.join(@config_store.dir, Repository::ConfigStore::ISSUE_TEMPLATE_FILE)
+
+        FileUtils.cp(default_iss_template_path, draft_config_iss_template_file_path)
+      end
+
+      #
+      # Creates a .devlogs.data.yml file
+      #
+      def save_data_file
+        data_file = File.join(@config_store.dir, Repository::ConfigStore::DATA_FILE)
+
+        #
+        # MARK: Default Data
+        #
+        data_info = {
+          issues: {
+            index: 1
+          },
+          logs: {},
+          repository: {}
+        }
+
+        File.open(data_file, "w") do |f|
+          f.puts data_info.to_yaml
+        end
+      end
+
+      # Gets the template file path embedded in the gem from the library root
+      #
+      # @returns [String]
+      #
+      def get_template_path(file_name)
+        File.join(Devlogs.lib_root, "templates", file_name)
+      end
+    end
+  end
+end

data/lib/devlogs/repository/config_store.rb

@@ -8,12 +8,14 @@ require_relative "config"
 # A per repository configuration storage directory
 class Repository
   class ConfigStore
-    attr_reader :dir, :values
+    attr_reader :dir
 
     CONFIG_FILE = ".devlogs.config.yml"
+    DATA_FILE = ".devlogs.data.yml"
+    ISSUE_TEMPLATE_FILE = ".issue_template.erb.md"
+    LOG_TEMPLATE_FILE = ".log_template.erb.md"
 
-    # TODO: should be part of configuration
-    TEMPLATE_FILE = ".log_template.erb.md"
+    ISSUE_DIR = "issues"
     DEFAULT_DIRECTORY_PATH = "."
     DEFAULT_DIRECTORY_NAME = ".devlogs"
 
@@ -25,15 +27,55 @@ class Repository
       @values ||= load_values_from_config_file
     end
 
+    #
+    # Retrieves the data file
+    #
+    # @returns [String]
+    #
+    def data_file_path
+      File.join(@dir, DATA_FILE)
+    end
+
+    #
+    # Retrieves .devlogs.config.yml file path
+    #
+    # @returns [String]
+    #
     def file_path
       File.join(@dir, CONFIG_FILE)
     end
 
+    #
+    # The template File
+    #
+    # @returns [String]
+    # FIXME: rename to log_template_file_path
     def template_file_path
-      File.join(@dir, TEMPLATE_FILE)
+      File.join(@dir, LOG_TEMPLATE_FILE)
+    end
+
+    #
+    # The issue template file path:
+    #
+    # @returns [String]
+    #
+    def issue_template_file_path
+      File.join(@dir, ISSUE_TEMPLATE_FILE)
+    end
+
+    #
+    # Issue directory path
+    #
+    # @returns [String]
+    #
+    def issue_dir_path
+      File.join(@dir, ISSUE_DIR)
     end
 
     class << self
+      #
+      # Initialization utility method
+      #
       def load_from(path = File.join(DEFAULT_DIRECTORY_PATH, DEFAULT_DIRECTORY_NAME))
         exists = File.exist?(path)
 

data/lib/devlogs/repository/initializer.rb

@@ -1,86 +1,19 @@
 # frozen_string_literal: true
 
 require_relative "config_store"
+require_relative "config_builder"
 
 # Initialize is an execution object which initializes a Repository on the
 # filesystem
 class Repository
   class Initializer
-    INFO_FILE_SUFFIX = "devlogs.info.md"
-    LOG_TEMPLATE_FILE_NAME = "__log_template.erb.md"
-
     # Creates a new devlogs repository at the provided path
     def self.run(opts = {})
-      new_config = if opts[:dirpath]
-                     Repository::ConfigStore.new(dir: opts[:dirpath])
-                   else
-                     Repository::ConfigStore.new
-                   end
-
-      exists = File.exist?(new_config.file_path)
-
-      if exists && !opts[:force]
-        puts "Log repository already exists in #{new_config.file_path}. Aborting..."
-        raise RuntimeError
-      end
-
-      results = prompt_for_info
-
-      # Create the new_config directory
-      FileUtils.mkdir_p(new_config.dir)
-
-      # Create new_config file
-      File.open(new_config.file_path, "w") do |f|
-        f.write results.to_yaml
-      end
-
-      # Replace spaces in project name with underscores
-      sanitized_project_name = results[:name].gsub(/ /, "_").downcase
-
-      # Create the info file
-      info_file_name = "#{sanitized_project_name}.devlogs.info.md"
-      info_file = File.join(new_config.dir, info_file_name)
-
-      File.open(info_file, "w") do |f|
-        f.puts "# #{results[:name]}"
-        f.puts (results[:desc]).to_s
-      end
+      new_config = Repository::ConfigBuilder.new(opts[:dirpath])
 
-      # Copy the default template file inside the gem into the repository
-      default_template_path = get_template_path
-
-      new_config_template_file_path = File.join(new_config.dir, Repository::ConfigStore::TEMPLATE_FILE)
-
-      FileUtils.cp(default_template_path, new_config_template_file_path)
-    end
-
-    # Creates an interactive prompt for user input
-    #
-    # @returns [Hash]
-    def self.prompt_for_info
-      prompt = TTY::Prompt.new
-
-      prompt.collect do |_p|
-        # Project name
-        key(:name).ask("What is the project name?") do |q|
-          q.required true
-        end
-
-        # Project description
-        key(:desc).ask("What is the project description?") do |q|
-          q.required true
-        end
-
-        key(:mirror) do
-          key(:use_mirror).ask("Do you want to mirror these logs?", convert: :boolean)
-          key(:path).ask("Path to mirror directory: ")
-        end
-      end
-    end
+      draft = new_config.build
 
-    # Gets the template file path embedded in the gem from the library root
-    def self.get_template_path
-      File.join(Devlogs.lib_root, "templates", LOG_TEMPLATE_FILE_NAME)
+      draft.save!(force: opts[:force])
     end
   end
 end

data/lib/devlogs/repository/issue_manager.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+require_relative "../helper/time_helper"
+require_relative "../helper/tty_prompt_helper"
+require_relative "../render/issue_template_renderer"
+
+#
+# IssueManager is an abstraction class to orchestrate the internals
+# of issue management and creation for a repository
+#
+class IssueManager
+  include TTYPromptHelper
+  include TimeHelper
+
+  VALID_DIRECTION = %i[asc desc].freeze
+  ISSUE_SEPARATOR = "__"
+
+  #
+  # @param [Repository::ConfigStore]
+  #
+  def initialize(repo_config_store)
+    @config_store = repo_config_store
+  end
+
+  #
+  # Lists the issue entries present in the repository
+  #
+  # @param direction [Symbol] ascending or descending
+  #
+  def list(direction = :desc)
+    raise ArgumentError, "Must be one of: " + VALID_DIRECTION unless VALID_DIRECTION.include?(direction.to_sym)
+
+    # Anything with the SHORTCODE- prefix
+    #
+    # i.e. RLP-1, RLP-2, et cetera
+    #
+    short_code_pattern = "#{config_values.short_code}-*"
+
+    #
+    # pattern: RLP-*
+    #
+    glob_pattern = File.join(@config_store.issue_dir_path, short_code_pattern)
+
+    Dir.glob(glob_pattern).sort_by do |fpath|
+      # i.e. [RLP-1, title_of_issue.md]
+      issue_tag, = File.basename(fpath).split(ISSUE_SEPARATOR)
+
+      # i.e. [RLP, 1]
+      _, issue_num = issue_tag.split("-")
+
+      if direction == :asc
+        issue_num.to_i
+      else
+        -1 * issue_num.to_i
+      end
+    end
+  end
+
+  #
+  # Adds a new entry to the repository
+  #
+  # @returns [String] entry file path
+  #
+  def create
+    info = issue_info_prompt
+
+    issue = compose_issue(info)
+
+    issue_file_path = File.join(@config_store.issue_dir_path, issue[:file_name])
+
+    template = IssueTemplateRenderer.new(@config_store.issue_template_file_path, issue)
+
+    unless File.exist?(issue_file_path)
+      # Add default boiler plate if the file does not exist yet
+      File.open(issue_file_path, "w") do |f|
+        f.write template.render
+      end
+
+      increment_issue_index!
+    end
+
+    issue_file_path
+  end
+
+  private
+
+  #
+  # Sanitizes and composes the content for display
+  #
+  # @returns [Hash]
+  def compose_issue(info = {})
+    # RLP-n
+    short_code_issue = compute_short_code
+
+    # RLP-1: User Validation Fails.md
+    display_title = "#{short_code_issue}: #{info[:title]}"
+
+    # rlp_1__user_validation_fails.md
+    file_name_title = snakify(info[:title])
+
+    issue_file_name = "#{short_code_issue}#{ISSUE_SEPARATOR}#{file_name_title}.md".downcase
+
+    {
+      display_title: display_title,
+      file_name: issue_file_name,
+      description: info[:description].join(""),
+      reproduction: info[:reproduction].join("")
+    }
+  end
+
+  #
+  # Increments the issue index in the data file by one
+  #
+  def increment_issue_index!
+    data = YAML.load_file(@config_store.data_file_path)
+
+    data[:issues][:index] += 1
+
+    File.open(@config_store.data_file_path, "w") do |f|
+      f.write data.to_yaml
+    end
+  end
+
+  #
+  # Gets TTY input for issue data
+  #
+  # @return [Hash]
+  #
+  def issue_info_prompt
+    prompt = TTY::Prompt.new
+
+    prompt.collect do
+      key(:title).ask("What is the issue title?") do |q|
+        q.required true
+        q.validate Validator.length_range(min: 0, max: 25)
+        q.messages[:valid?] = "Title cannot be empty and may be maximum 25 characters"
+      end
+
+      key(:description).multiline("Describe the issue: ") do |q|
+        q.default "There is an issue with..."
+        q.help "Press ctrl+d to end"
+      end
+
+      key(:reproduction).multiline("Describe the reproduction steps: ") do |q|
+        q.default "To reproduce the issue..."
+        q.help "Press ctrl+d to end"
+      end
+    end
+  end
+
+  #
+  # Convenience method for accessing config store values
+  #
+  # @returns [Repository::Config]
+  #
+  def config_values
+    @config_store.values
+  end
+
+  # Transforms a string with spaces or hyphens to
+  # an snake case String
+  #
+  # @param input [String]
+  # @returns [String]
+  #
+  def snakify(input)
+    input.gsub(/[ -]/, "_").downcase
+  end
+
+  #
+  # Reads the .data.yml file in the repository to
+  # get the latest issue index number
+  #
+  # @returns [String]
+  #
+  def compute_short_code
+    data = YAML.load_file(@config_store.data_file_path)
+
+    issue_index = data[:issues][:index]
+
+    "#{config_values.short_code}-#{issue_index}".upcase
+  end
+end

data/lib/devlogs/repository/log_manager.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative "../helper/time_helper"
+require_relative "../render/log_template_renderer"
+
+#
+# LogManager is an abstraction class to orchestrate the internals
+# of issue management and creation for a repository
+#
+class LogManager
+  include TimeHelper
+  LOG_FILE_SUFFIX = "log.md"
+  VALID_DIRECTION = %i[asc desc].freeze
+
+  def initialize(repo_config_store)
+    @config_store = repo_config_store
+  end
+
+  # Lists the log entries present in the repository
+  #
+  # @param direction [Symbol] ascending or descending
+  #
+  def list(direction = :desc)
+    raise ArgumentError, "Must be one of: " + VALID_DIRECTION unless VALID_DIRECTION.include?(direction.to_sym)
+
+    # Anything with the _log.md suffix
+    glob_pattern = File.join(@config_store.dir, "*_#{LOG_FILE_SUFFIX}")
+
+    Dir.glob(glob_pattern).sort_by do |fpath|
+      # The date is joined by two underscores to the suffix
+      date, = File.basename(fpath).split("_#{LOG_FILE_SUFFIX}")
+
+      time_ms = Time.strptime(date, TimeHelper::TIME_FORMAT_FILE_PREFIX).to_i
+
+      if direction == :asc
+        time_ms
+      else
+        -time_ms
+      end
+    end
+  end
+
+  #
+  # Adds a new entry to the repository
+  #
+  # @returns [String] entry file path
+  #
+  def create
+    entry_file_name = "#{current_time}_#{LOG_FILE_SUFFIX}"
+
+    entry_file_path = File.join(@config_store.dir, entry_file_name)
+
+    template = LogTemplateRenderer.new(@config_store.template_file_path)
+
+    unless File.exist?(entry_file_path)
+      # Add default boiler plate if the file does not exist yet
+      File.open(entry_file_path, "w") do |f|
+        f.write template.render
+      end
+    end
+
+    entry_file_path
+  end
+end

data/lib/devlogs/repository.rb

@@ -8,17 +8,13 @@ require "time"
 require_relative "repository/config_store"
 require_relative "editor"
 require_relative "repository/sync_manager"
-require_relative "log_template"
+require_relative "helper/time_helper"
+require_relative "repository/log_manager"
+require_relative "repository/issue_manager"
 
-# Repostiroy is an accessor object for the devlogs directory
+# Repository is an accessor object for the devlogs directory
 class Repository
-  # Example: 11-22-2022_1343
-  TIME_FORMAT_FILE_PREFIX = "%m-%d-%Y__%kh%Mm"
-
-  LOG_FILE_SUFFIX = "log.md"
-  ISSUE_FILE_PREFIX = "iss"
-
-  VALID_DIRECTION = %i[asc desc].freeze
+  include TimeHelper
 
   # Initializes a .devlogs repository with the supplied configuration
   #
@@ -31,27 +27,21 @@ class Repository
   #
   # @returns nil
   def create
-    time = Time.new
-    time_prefix = time.strftime(TIME_FORMAT_FILE_PREFIX)
-
-    entry_file_name = "#{time_prefix}_#{LOG_FILE_SUFFIX}"
+    entry_file_path = log_manager.create_entry
 
-    # FIXME: Need to figure out file path
-    entry_file_path = File.join(@config_store.dir, entry_file_name)
+    Editor.open(entry_file_path)
 
-    # FIXME: Need to figure out file path
-    template = LogTemplate.new(@config_store.template_file_path)
+    puts "Writing entry to #{entry_file_path}.."
+  end
 
-    unless File.exist?(entry_file_path)
-      # Add default boiler plate if the file does not exist yet
-      File.open(entry_file_path, "w") do |f|
-        f.write template.render
-      end
-    end
+  #
+  # @returns nil
+  def create_issue
+    issue_file_path = issue_manager.create
 
-    Editor.open(entry_file_path)
+    Editor.open(issue_file_path)
 
-    puts "Writing entry to #{entry_file_path}.."
+    puts "Writing issue to #{issue_file_path}.."
   end
 
   # Syncs the directory changes to the (optional) mirror repository
@@ -64,21 +54,12 @@ class Repository
 
   # Lists the files in the repository
   def ls(direction = :desc)
-    raise ArgumentError, "Must be one of: " + VALID_DIRECTION unless VALID_DIRECTION.include?(direction.to_sym)
-
-    Dir.glob(File.join(@config_store.dir, "*_#{LOG_FILE_SUFFIX}")).sort_by do |fpath|
-      # The date is joined by two underscores to the suffix
-      date, = File.basename(fpath).split("__")
-
-      time_ms = Time.strptime(date, "%m-%d-%Y").to_i
+    log_manager.list(direction)
+  end
 
-      # Descending
-      if direction == :asc
-        time_ms
-      else
-        -time_ms
-      end
-    end
+  # Lists the issues in the repository
+  def ls_issues(direction = :desc)
+    issue_manager.list(direction)
   end
 
   class << self
@@ -98,4 +79,12 @@ class Repository
   def sync_manager
     @sync_manager ||= Repository::SyncManager.new(@config_store)
   end
+
+  def log_manager
+    @log_manager ||= LogManager.new(@config_store)
+  end
+
+  def issue_manager
+    @issue_manager ||= IssueManager.new(@config_store)
+  end
 end

data/lib/devlogs/templates/__issue_template.erb.md

@@ -0,0 +1,13 @@
+[[@INFO]]
+Tags:
+Links:
+
+---
+
+# <%= title %>
+
+## Problem
+<%= description %>
+
+## Reproduction Steps
+<%= reproduction %>

data/lib/devlogs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Devlogs
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: devlogs
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - aquaflamingo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-09-17 00:00:00.000000000 Z
+date: 2022-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rsync
@@ -99,14 +99,21 @@ files:
 - lib/devlogs/editor.rb
 - lib/devlogs/executable.rb
 - lib/devlogs/gem.rb
-- lib/devlogs/log_template.rb
+- lib/devlogs/helper/time_helper.rb
+- lib/devlogs/helper/tty_prompt_helper.rb
 - lib/devlogs/pager.rb
-- lib/devlogs/prompt_utils.rb
+- lib/devlogs/render/erb_template_renderer.rb
+- lib/devlogs/render/issue_template_renderer.rb
+- lib/devlogs/render/log_template_renderer.rb
 - lib/devlogs/repository.rb
 - lib/devlogs/repository/config.rb
+- lib/devlogs/repository/config_builder.rb
 - lib/devlogs/repository/config_store.rb
 - lib/devlogs/repository/initializer.rb
+- lib/devlogs/repository/issue_manager.rb
+- lib/devlogs/repository/log_manager.rb
 - lib/devlogs/repository/sync_manager.rb
+- lib/devlogs/templates/__issue_template.erb.md
 - lib/devlogs/templates/__log_template.erb.md
 - lib/devlogs/version.rb
 homepage: http://github.com/aquaflamingo/devlogs