Support custom task names

Resolves #2

Author: odlp

CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## Unreleased
+
+- Support custom task names
+
+## v0.1.0
+
+- Initial release

README.md

@@ -110,6 +110,24 @@ Invocation:
 bundle exec rake admin:special
 ```
 
+### Task with a custom name
+
+```ruby
+class ObscureClassNameTask do
+  include OopsARake::Task.with_name("custom_name")
+
+  def call
+    puts "Hello"
+  end
+end
+```
+
+Invocation:
+
+```sh
+bundle exec rake custom_name
+```
+
 ## Motivation
 
 Rake is an omnipresent tool in the Ruby world. It has some drawbacks – the main

lib/oops_a_rake/registry.rb

@@ -6,9 +6,7 @@ class Registry
     @tasks = {}
 
     def self.register(task_class)
-      task_name = task_class.name.underscore.gsub("/", ":").delete_suffix("_task")
-
-      task = Rake::Task.define_task(task_name) do |_, args|
+      task = Rake::Task.define_task(task_class.task_name) do |_, args|
         task_class.new.call(*args)
       end
 

lib/oops_a_rake/task.rb

@@ -3,11 +3,28 @@
 module OopsARake
   module Task
     def self.included(klass)
-      Registry::register(klass)
       klass.extend(ClassMethods)
+      Registry::register(klass)
+    end
+
+    def self.with_name(custom_task_name)
+      module_name = "#{custom_task_name.gsub(":", "_").classify}ClassMethods"
+      mod = const_set(module_name, Module.new)
+
+      mod.define_singleton_method(:included) do |klass|
+        klass.extend(OopsARake::Task::ClassMethods)
+        klass.define_singleton_method(:task_name) { custom_task_name }
+        Registry::register(klass)
+      end
+
+      mod
     end
 
     module ClassMethods
+      def task_name
+        name.underscore.gsub("/", ":").delete_suffix("_task")
+      end
+
       def description(description)
         task.comment = description
       end

spec/lib/oops_a_rake/task_spec.rb

@@ -16,6 +16,17 @@ def call
     expect { Rake::Task["greeting"].invoke }.to output(/Hello/).to_stdout
   end
 
+  it "defines the task name on the class" do
+    define_class("GreetingTask") do
+      include OopsARake::Task
+
+      def call
+      end
+    end
+
+    expect(GreetingTask.task_name).to eq("greeting")
+  end
+
   it "supports tasks with arguments" do
     define_class("PersonalizedGreetingTask") do
       include OopsARake::Task
@@ -81,6 +92,44 @@ def call
     expect(Rake::Task["well_documented"].comment).to eq("Informative")
   end
 
+  describe "custom task name" do
+    it "allows tasks to specify a custom name" do
+      define_class("ObscureClassNameTask") do
+        include OopsARake::Task.with_name("clear_name")
+
+        def call
+          puts "Hello"
+        end
+      end
+
+      expect { Rake::Task["clear_name"].invoke }.to output(/Hello/).to_stdout
+      expect(Rake::Task.task_defined?("obscure_class_name")).to be false
+    end
+
+    it "provides access to the task name from the class" do
+      define_class("ObscureClassNameTask") do
+        include OopsARake::Task.with_name("custom_name")
+
+        def call
+        end
+      end
+
+      expect(ObscureClassNameTask.task_name).to eq("custom_name")
+    end
+
+    it "names the module" do
+      define_class("ObscureClassNameTask") do
+        include OopsARake::Task.with_name("foo:bar_baz")
+
+        def call
+        end
+      end
+
+      expect(ObscureClassNameTask.included_modules.map(&:to_s))
+        .to include("OopsARake::Task::FooBarBazClassMethods")
+    end
+  end
+
   private
 
   def define_class(name, &block)