rujira 0.7.0 → 0.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e934f91388416b891e49d824c5f3d875708d5102d2084d8fa3c641be5006d02
-  data.tar.gz: 5cc8ee2aa9475057ae26953287f5f99c9be83adc0cd578236d17b758d5c82486
+  metadata.gz: 22f2c365275fa72514c36702efe3fda2463bdc1948dcc020f38148b4a25bac3a
+  data.tar.gz: 1a4995399b9f0ff4616fbef8627c3c3b717d5e0edcc9d3f1e1defb11d9262fe8
 SHA512:
-  metadata.gz: 83a61e445cb8b1a3e2e5f5cb338d9f31070df47c3ea1aff9be54c49a63f8d022658d76856fee5f934b0343b79d37c04ae78bf9cfd17cb721fa988f3971f9ac1f
-  data.tar.gz: 503b7bc45991306f9346ee2b8cc1b77e492194544caea88bb3931b71d30f04a8f99fc10a76de98f6ff91d008743de259860503c61698f159b1fbc8bfc04c22de
+  metadata.gz: ecde3caf684b3907b6764a858ca723c09e19606fc91fa238c92c8648ba0b8827b08e7bbabbe39d221fcb6674517c9791315f88bd246145a4f02632f179deadab
+  data.tar.gz: a7abd29b1bdd8222ab99bf02432b4ba7fb396b8e5b3e4148bda3bd27fe70cce28f03bcef12aed0f7fb69a59bac9d6bfb4c4b7031764fb9b44359bddcd0cbadcb

data/CHANGELOG.md

@@ -1,11 +1,43 @@
-## [0.7.0] - 2025-10-01
+## [0.7.3] - 2026-03-27
 
 ### 🚀 Features
 
+- Added priority API
+- Added issue_type API and link generator
+
+### 🚜 Refactor
+
+- Create utils libs
+- Added list of issue types
+- Rename dispatchable to wrap_responses
+- Use editor for enter description
+- Added alias for payload
+
+### 📚 Documentation
+
+- Added short description for link generator
+- Added example test for parallel usage
+## [0.7.2] - 2026-03-26
+
+### 🚀 Features
+
+- Added user creation
+## [0.7.1] - 2026-03-25
+
+### 🚀 Features
+
+- Use patch changes log
+- Added exception raising for obj
+- Added attach file alias
+- Added api for task creation
 - Added project as obj
 
 ### 🚜 Refactor
 
+- Rename commitable to lazy
+- Linter issues
+- Added new methods for agile boards
+- Added new task
 - Tuning for tests
 
 ### 📚 Documentation
@@ -38,51 +70,3 @@
 
 - Dispatchable for client
 ## [0.4.0] - 2025-09-13
-
-### 🚀 Features
-
-- Extend Issue #2
-- Extend Issue
-- Added Filter
-- Extend Avatar, Configuration, CustomFields, Field
-- Extend Attachments
-- Added ApplicationRole
-- Added ApplicationProperties
-- Added permissions api
-
-### 🐛 Bug Fixes
-
-- Fix for tasks
-
-### 🚜 Refactor
-
-- Dont raising for faraday
-- Cleanup attachments
-- Split issue #3
-- Split issue #2
-- Split issue
-## [0.3.3] - 2025-09-13
-
-### 📚 Documentation
-
-- Added comments from ai #4
-- Added comments from ai #3
-- Added comments from ai #2
-- Added comments from ai
-## [0.3.2] - 2025-09-13
-
-### 🚜 Refactor
-
-- Remove configuration
-
-### 📚 Documentation
-
-- Updated inline description
-## [0.3.1] - 2025-09-13
-
-### 🚜 Refactor
-
-- Fix for headers setter
-- Cleanup data method
-- Abort if id is nil #2
-- Abort if id is nil

data/README.md

@@ -1,7 +1,11 @@
 # RUJIRA
 
+[![Ruby](https://github.com/itmagelab/rujira/actions/workflows/ruby.yml/badge.svg)](https://github.com/itmagelab/rujira/actions/workflows/ruby.yml)
+
 **RUJIRA** is a Ruby gem for easy interaction with the Jira API. It provides a simple and flexible interface to work with Jira resources and includes Rake tasks for convenient command-line operations.
 
+This project was created as an alternative to <https://github.com/sumoheavy/jira-ruby>, offering a more user-friendly and intuitive interface. It lets you work with requests as objects or hash arrays, provides flexibility in choosing a connection adapter, and makes the codebase easier to maintain.
+
 ---
 
 ## Features
@@ -16,7 +20,7 @@
 Add to your `Gemfile`:
 
 ```ruby
-gem 'rujira', '~> 0.6.0'
+gem 'rujira', '~> 0.7.0'
 ```
 
 Or install directly:
@@ -40,6 +44,102 @@ LOG_LEVEL=error
 
 ### Example of usage
 
+By default, we can use an object-oriented approach, but this method does not cover all API capabilities.
+
+```ruby
+url = ENV.fetch('RUJIRA_URL', 'http://localhost:8080')
+client = Rujira::Client.new(url, wrap_responses: true)
+
+project = random_name
+me = client.Myself.get
+project = me.create_software_project key: project.to_s,
+                                     name: project.to_s
+task = project.add_task summary: 'BOT: added a new task.',
+                        description: 'This task was generated by the bot when creating changes in the repository.'
+task.add_comment 'Bot added a comment as obj #1'
+task.attach_file '/tmp/upload.file'
+```
+
+Demonstrates the full lifecycle of a Jira user: creation, retrieval, update, deactivation, and deletion using the Rujira client.
+
+```ruby
+url = ENV.fetch('RUJIRA_URL', 'http://localhost:8080')
+client = Rujira::Client.new(url, wrap_responses: true)
+
+username = random_name
+me = client.Myself.get
+
+user = client.User.create do
+  payload({
+            name: username,
+            password: username,
+            emailAddress: "#{username}@username",
+            displayName: "#{username} created be #{me.name}",
+            applicationKeys: ['jira-core']
+          })
+end
+
+user = client.User.get user.key
+
+user.update do
+  payload emailAddress: 'root@test'
+end
+
+user.deactivate!
+user.delete
+```
+
+This function demonstrates that the library supports executing requests in parallel using multiple threads. By processing tasks concurrently, it significantly improves performance when handling a large number of repetitive operations, such as creating or deleting entities.
+
+```ruby
+url = ENV.fetch('RUJIRA_URL', 'http://localhost:8080')
+client = Rujira::Client.new(url, debug: true, wrap_responses: false, lazy: true)
+
+me = client.Myself.get.execute
+
+queue = Queue.new
+
+project_name = random_name
+project = client.Project.create do
+  payload key: project_name.to_s,
+          name: project_name.to_s,
+          projectTypeKey: 'software',
+          lead: me['name']
+end.to_obj
+
+count.times do
+  task = project.add_task summary: 'BOT: added a new task.',
+                          description: 'This task was generated by the bot when creating changes in the repository.'
+  queue << task
+end
+
+workers = thread.times.map do
+  Thread.new do
+    until queue.empty?
+      begin
+        task = begin
+          queue.pop(true)
+        rescue StandardError
+          nil
+        end
+        next unless task
+
+        task = task.to_obj
+
+        task.delete
+      rescue StandardError => e
+        warn "Error in thread: #{e.message}"
+      end
+    end
+  end
+end
+
+workers.each(&:join)
+project.delete
+```
+
+Alternatively, we can work with the API directly, as with a regular request dispatcher; in this form, most operations are available.
+
 ```ruby
 require 'date'
 
@@ -151,7 +251,9 @@ rake jira:dashboard:list          # Get list of dashboards
 rake jira:issue:attach            # Example usage attaching in issue
 rake jira:issue:create            # Create a issue
 rake jira:issue:delete            # Delete issue
+rake jira:issue:generate_link     # Generate a Jira link for creating a new issue
 rake jira:issue:search            # Search issue by fields
+rake jira:project:create          # Create project
 rake jira:project:list            # Get list of projects
 rake jira:server_info             # Test connection by getting server information
 rake jira:sprint:properties:list  # Get sprint properties
@@ -165,6 +267,34 @@ rake jira:issue:search JQL='project = ITMG'
 rake jira:issue:attach FILE='upload.png' ISSUE_ID='ITMG-1'
 ```
 
+### Generate a Jira Issue Creation Link
+
+The `generate_link` task interactively collects input (project, summary, description, and issue type) and generates a ready-to-use Jira URL with pre-filled fields for creating a new issue.
+
+It opens your default editor for entering the description and then outputs a link that can be opened in a browser.
+
+#### Usage
+
+```
+rake jira::issue::generate_link
+```
+
+#### Example session
+
+```
+Project key (e.g., ABC): TEST
+Summary (short description): Fix login bug
+Opening editor for description...
+Issue type (Bug/Task/Story): Bug
+```
+
+#### Output
+
+```
+Generated issue creation link:
+https://your-jira-instance/secure/CreateIssueDetails!init.jspa?pid=10000&summary=Fix+login+bug&description=Steps+to+reproduce...&reporter=john.doe&issuetype=1
+```
+
 ## Development runs
 
 ```bash

data/Rakefile

@@ -23,11 +23,3 @@ end
 task :version do
   puts Rujira::VERSION
 end
-
-desc 'Cleanup test installation'
-task :cleanup do
-  url = ENV.fetch('RUJIRA_URL', 'http://localhost:8080')
-  client = Rujira::Client.new(url, dispatchable: false)
-  projects = client.Project.list
-  projects.map(&:delete)
-end

data/cliff.toml

@@ -92,3 +92,6 @@ sort_commits = "newest"
 recurse_submodules = false
 
 limit_commits = 50
+
+[bump]
+bump_type = "patch"

data/compose.yaml

@@ -13,7 +13,7 @@ services:
 
   db:
     image: postgres
-    mem_limit: 128mb  
+    mem_limit: 128mb
     restart: always
     shm_size: 128mb
     environment:

data/examples/create_issue_as_obj.rb

@@ -5,7 +5,7 @@ require_relative '../lib/rujira'
 
 Dotenv.load
 
-client = Rujira::Client.new('http://localhost:8080', dispatchable: false)
+client = Rujira::Client.new('http://localhost:8080', wrap_responses: true)
 
 project_name = 'TEST124'
 project_key = project_name

data/examples/create_issue_in_sprint.rb

@@ -5,7 +5,7 @@ require_relative '../lib/rujira'
 
 Dotenv.load
 
-client = Rujira::Client.new('http://localhost:8080', dispatchable: true)
+client = Rujira::Client.new('http://localhost:8080')
 
 project_name = 'TEST124'
 project_key = project_name

data/lib/rujira/api/board.rb

@@ -8,7 +8,7 @@ module Rujira
     # API reference:
     # https://docs.atlassian.com/jira-software/REST/9.17.0/#agile/1.0/board
     #
-    class Board < Common
+    class Board < Common # rubocop:disable Metrics/ClassLength
       # Initializes a new Board API client.
       #
       # @param [Object] client The HTTP client instance used to perform requests.
@@ -63,6 +63,145 @@ module Rujira
         call
       end
 
+      def create(&block)
+        builder do
+          method :post
+          path 'board'
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def delete(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          method :delete
+          path "board/#{id}"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def backlog(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/backlog"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def configuration(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/configuration"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def issue(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/issue"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def epic(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/epic"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def epic_issues(id, epic_id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/epic/#{epic_id}/issue"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def epic_none_issues(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/epic/none/issue"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def project(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/project"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def settings(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/settings/refined-velocity"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def set_settings(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          method :put
+          path "board/#{id}/settings/refined-velocity"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def properties(id, &block)
+        abort 'Board ID is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/properties"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def set_properties(id, property_key, &block)
+        abort 'board id is required' if id.to_s.strip.empty?
+        builder do
+          method :put
+          path "board/#{id}/properties/#{property_key}"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def get_properties(id, property_key, &block)
+        abort 'board id is required' if id.to_s.strip.empty?
+        builder do
+          path "board/#{id}/properties/#{property_key}"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def delete_properties(id, property_key, &block)
+        abort 'board id is required' if id.to_s.strip.empty?
+        builder do
+          method :delete
+          path "board/#{id}/properties/#{property_key}"
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
       # Retrieves all sprints for a specific board.
       #
       # Available query parameters:

data/lib/rujira/api/common.rb

@@ -40,8 +40,8 @@ module Rujira
       # @return [Object] The API response after dispatching the request.
       def call
         @client.logger.debug "Call the method: #{caller_locations(1, 1)[0].label}"
-        return @client.dispatch(@request) if @client.dispatchable
-        return self if @client.commitable
+        return @client.dispatch(@request) unless @client.wrap_responses
+        return self if @client.lazy
 
         to_obj
       end
@@ -52,6 +52,7 @@ module Rujira
       def commit
         @client.dispatch(@request)
       end
+      alias execute commit
 
       # Converts the API response into structured Ruby objects.
       # If the response is an array of hashes, maps each element through `process`.
@@ -59,9 +60,9 @@ module Rujira
       #
       # @return [Object] Processed response as one or more resource objects, or original response.
       def to_obj
-        response = commit
+        response = execute
 
-        return response.map { |el| process(el) } if response.is_a?(Array) && response.all? { |el| el.is_a?(Hash) }
+        return response.map { |el| process(el) } if response.is_a?(Array) && response.all?(Hash)
         return response unless response.is_a?(Hash)
 
         process response
@@ -76,7 +77,12 @@ module Rujira
       def process(response)
         response.merge!(@metadata)
         resource_class_name = self.class.name.sub('Api', 'Resource')
-        Object.const_get(resource_class_name).new(@client, **response)
+        begin
+          Object.const_get(resource_class_name).new(@client, **response)
+        rescue NameError
+          raise "Resource class '#{resource_class_name}' not found. " \
+                'Please ensure the class exists or use wrap_responses mode.'
+        end
       end
 
       # Sets ownership context for the resource by storing a parent ID or key

data/lib/rujira/api/issue_type.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Rujira
+  module Api
+    # API reference:
+    # https://docs.atlassian.com/software/jira/docs/api/REST/9.17.0/#api/2/issuetype
+    #
+    class IssueType < Common
+      def get(&block)
+        builder do
+          path 'issuetype'
+          method :get
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def get_by_name(name, &block)
+        issue_types = get(&block)
+        issue_types.find { |type| type.name == name }
+      end
+    end
+  end
+end

data/lib/rujira/api/priority.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Rujira
+  module Api
+    # API reference:
+    # https://docs.atlassian.com/software/jira/docs/api/REST/9.17.0/#api/2/priority
+    #
+    class Priority < Common
+      def get(&block)
+        builder do
+          path 'priority'
+          method :get
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def get_by_name(name, &block)
+        priorities = get(&block)
+        priorities.find { |type| type.name == name }
+      end
+    end
+  end
+end

data/lib/rujira/api/user.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Rujira
+  module Api
+    class User < Common # rubocop:disable Style/Documentation
+      def create(&block)
+        builder do
+          path 'user'
+          method :post
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def update(key, &block)
+        builder do
+          path 'user'
+          method :put
+          params key: key
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def get(key = nil, include_deleted: false, &block)
+        builder do
+          path 'user'
+          method :get
+          params key: key, includeDeleted: include_deleted
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+
+      def delete(key, &block)
+        builder do
+          path 'user'
+          method :delete
+          params key: key
+          instance_eval(&block) if block_given?
+        end
+        call
+      end
+    end
+  end
+end

data/lib/rujira/client.rb

@@ -11,7 +11,7 @@ module Rujira
   #   client.issue.get("TEST-123")
   #
   class Client
-    attr_reader :dispatchable, :logger, :commitable
+    attr_reader :wrap_responses, :logger, :lazy
 
     SUPPORTED_METHODS = %i[get delete head post put patch].freeze
 
@@ -23,9 +23,9 @@ module Rujira
     # @example Initialize client
     #   client = Rujira::Client.new("https://jira.example.com", debug: true)
     #
-    def initialize(url, debug: false, dispatchable: true, commitable: false, log_level: 'error') # rubocop:disable Metrics/MethodLength
-      @dispatchable = dispatchable
-      @commitable = commitable
+    def initialize(url, debug: false, wrap_responses: false, lazy: false, log_level: 'error') # rubocop:disable Metrics/MethodLength
+      @wrap_responses = wrap_responses
+      @lazy = lazy
       @uri = URI(url)
       @debug = ENV.fetch('RUJIRA_DEBUG', debug.to_s) == 'true'
       @raise_error = false

data/lib/rujira/request.rb

@@ -136,6 +136,8 @@ module Rujira
 
       @payload = payload
     end
+    alias body payload
+    alias data payload
 
     # Extends the current payload by merging the given hash into it.
     #

data/lib/rujira/resource/common.rb

@@ -2,9 +2,17 @@
 
 module Rujira
   module Resource
-    class Common
-      def initialize(client, **_args)
+    class Common # rubocop:disable Style/Documentation
+      attr_reader :response
+
+      def initialize(client, **response)
         @client = client
+        @response = response
+      end
+
+      def reload!
+        user = @client.User.get(@key)
+        initialize(@client, **user.response)
       end
     end
   end

data/lib/rujira/resource/issue.rb

@@ -47,6 +47,10 @@ module Rujira
         @client.logger.debug "Deleting issue #{@key}"
         @client.Issue.delete(@id)
       end
+
+      def attach_file(path)
+        @client.Issue.attachments @key, path
+      end
     end
   end
 end

data/lib/rujira/resource/issue_type.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Rujira
+  module Resource
+    # TODO
+    class IssueType < Common
+      # @return [String] The ID of the issue
+      attr_reader :id
+      # @return [String] The key of the issue (e.g., "TEST-123")
+      attr_reader :name
+      # @return [String] The URL to access this issue via Jira REST API
+      attr_reader :url
+
+      # Initializes an IssueType resource
+      #
+      # @param [Object] client The API client instance used to make requests
+      # @param [Hash] hash The issue data from the Jira API
+      def initialize(client, **args)
+        super
+
+        @id = args['id']
+        @name = args['name']
+        @url = args['self']
+      end
+    end
+  end
+end

data/lib/rujira/resource/myself.rb

@@ -25,6 +25,18 @@ module Rujira
         @name = args['name']
         @email = args['emailAddress']
       end
+
+      def create_software_project(**args)
+        key = args[:key]
+        project_name = args[:name]
+        name = @name
+        @client.Project.create do
+          payload key: key,
+                  name: project_name,
+                  projectTypeKey: 'software',
+                  lead: name
+        end
+      end
     end
   end
 end

data/lib/rujira/resource/priority.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Rujira
+  module Resource
+    # TODO
+    class Priority < Common
+      # @return [String] The ID of the issue
+      attr_reader :id
+      # @return [String] The key of the issue (e.g., "TEST-123")
+      attr_reader :name
+      # @return [String] The URL to access this issue via Jira REST API
+      attr_reader :url
+
+      # Initializes an Priority resource
+      #
+      # @param [Object] client The API client instance used to make requests
+      # @param [Hash] hash The issue data from the Jira API
+      def initialize(client, **args)
+        super
+
+        @id = args['id']
+        @name = args['name']
+        @url = args['self']
+      end
+    end
+  end
+end

data/lib/rujira/resource/project.rb

@@ -30,6 +30,19 @@ module Rujira
       def delete
         @client.Project.delete(@id)
       end
+
+      def add_task(**args)
+        key = @key
+        @client.Issue.create do
+          payload fields: {
+            project: { key: key },
+            summary: args[:summary],
+            description: args[:description],
+            issuetype: { name: 'Task' }
+          }
+          params updateHistory: true
+        end
+      end
     end
   end
 end

data/lib/rujira/resource/user.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Rujira
+  module Resource
+    # Represents a Jira issue resource.
+    # Provides access to issue attributes and actions such as adding comments.
+    #
+    # Example usage:
+    #   issue = Rujira::Resource::User.new(client, data)
+    #   issue.add_comment("This is a comment")
+    #
+    class User < Common
+      # @return [String] The URL to access this issue via Jira REST API
+      attr_reader :url
+      # @return [String] The key of the issue (e.g., "TEST-123")
+      attr_reader :key
+      attr_reader :name, :email, :display_name, :active
+
+      # Initializes an User resource
+      #
+      # @param [Object] client The API client instance used to make requests
+      # @param [Hash] hash The issue data from the Jira API
+      def initialize(client, **args)
+        super
+
+        @url = args['self']
+        @key = args['key']
+        @name = args['name']
+        @email = args['emailAddress']
+        @display_name = args['displayName']
+        @active = args.fetch('active', true)
+        @deleted = args.fetch('deleted', false)
+      end
+
+      def delete
+        @client.User.delete(@key)
+      end
+
+      def update(&block)
+        @client.User.update(@key) do
+          instance_eval(&block) if block_given?
+        end
+        reload!
+      end
+
+      def deactivate!
+        @client.User.update(@key) do
+          payload active: false
+        end
+        reload!
+      end
+
+      def activate!
+        @client.User.update(@key) do
+          payload active: true
+        end
+        reload!
+      end
+    end
+  end
+end

data/lib/rujira/tasks/generate.rake

@@ -10,31 +10,16 @@ module Rujira
     # TODO
     class Jira
       include Rake::DSL if defined?(Rake::DSL)
+      require_relative 'utils'
+
       def initialize
         generate
       end
 
-      def client
-        url = ENV.fetch('RUJIRA_URL', 'http://localhost:8080')
-        @client ||= Rujira::Client.new(url, debug: false)
-      end
-
-      def fetch_options(params, name)
-        help = params.map { |k| "#{k}=<VALUE>" }.join(' ')
-        options = params.to_h do |k|
-          [k.downcase.to_sym, ENV.fetch(k, nil)]
-        end
-        missing = options.select { |_, v| v.nil? }.keys
-        unless missing.empty?
-          abort "❌ ERROR: The following required environment variables are missing: #{missing.join(', ').upcase}\n" \
-                "✅ USAGE: rake #{name} #{help}"
-        end
-
-        options
-      end
-
       def generate # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
-        namespace :jira do
+        namespace :jira do # rubocop:disable Metrics/BlockLength
+          require_relative 'issue'
+
           desc 'Test connection by getting username'
           task :whoami do
             result = client.Myself.get
@@ -53,6 +38,18 @@ module Rujira
               result = client.Project.list
               puts JSON.pretty_generate(result)
             end
+
+            desc 'Create project'
+            task :create do |t|
+              options = fetch_options(%w[KEY NAME TYPE LEAD], t.name)
+              result = client.Project.create do
+                payload key: options[:key],
+                        name: options[:name],
+                        projectTypeKey: options[:type],
+                        lead: options[:lead]
+              end
+              puts JSON.pretty_generate(result)
+            end
           end
 
           namespace :dashboard do
@@ -106,48 +103,6 @@ module Rujira
               end
             end
           end
-
-          namespace :issue do
-            desc 'Create a issue'
-            task :create do |t|
-              options = fetch_options(%w[PROJECT SUMMARY DESCRIPTION ISSUETYPE], t.name)
-              abort 'ISSUETYPE must start with a capital letter' unless options[:issuetype].match?(/\A[A-Z]/)
-
-              result = client.Issue.create do
-                payload fields: {
-                  project: { key: options[:project] },
-                  summary: options[:summary],
-                  issuetype: { name: options[:issuetype] },
-                  description: options[:description]
-                }
-              end
-              puts JSON.pretty_generate(result)
-            end
-
-            desc 'Search issue by fields'
-            task :search do |t|
-              options = fetch_options(%w[JQL], t.name)
-              result = client.Search.get do
-                data jql: options[:jql]
-              end
-              result['issues'].each { |i| puts JSON.pretty_generate(i) }
-            end
-
-            desc 'Delete issue'
-            task :delete do |t|
-              options = fetch_options(%w[ISSUE_ID], t.name)
-
-              client.Issue.del options[:issue_id]
-            end
-
-            desc 'Example usage attaching in issue'
-            task :attach do |t|
-              options = fetch_options(%w[FILE ISSUE_ID], t.name)
-
-              result = client.Issue.attachments options[:issue_id], @options[:file]
-              puts JSON.pretty_generate(result)
-            end
-          end
         end
       end
     end

data/lib/rujira/tasks/issue.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+namespace :issue do # rubocop:disable Metrics/BlockLength
+  desc 'Create a issue'
+  task :create do |t|
+    options = fetch_options(%w[PROJECT_KEY SUMMARY DESCRIPTION ISSUETYPE], t.name)
+    abort 'ISSUETYPE must start with a capital letter' unless options[:issuetype].match?(/\A[A-Z]/)
+
+    result = client.Issue.create do
+      payload fields: {
+        project: { key: options[:project_key] },
+        summary: options[:summary],
+        issuetype: { name: options[:issuetype] },
+        description: options[:description]
+      }
+    end
+    puts JSON.pretty_generate(result)
+  end
+
+  desc 'Generate a Jira link for creating a new issue'
+  task :generate_link do # rubocop:disable Metrics/BlockLength
+    require 'cgi'
+
+    me = client_wrapped.Myself.get
+    server_info = client.ServerInfo.get
+    base_url = server_info['baseUrl']
+
+    print 'Project key (e.g., ABC): '
+    project_key = $stdin.gets.chomp
+    project = client_wrapped.Project.get(project_key)
+
+    print 'Summary (short description): '
+    summary = $stdin.gets.chomp
+
+    puts 'Opening editor for description...'
+    description = open_editor
+
+    issue_types = client_wrapped.IssueType.get
+    names = issue_types.map(&:name).join('/')
+    print "Issue type (#{names}): "
+    issue_type_name = $stdin.gets.chomp
+    issue_type = issue_types.find do |i|
+      i.name.downcase == issue_type_name.downcase
+    end
+
+    encoded_summary = CGI.escape(summary)
+    encoded_description = CGI.escape(description)
+
+    jira_url = "#{base_url}/secure/CreateIssueDetails!init.jspa" \
+               "?pid=#{project.id}" \
+               "&summary=#{encoded_summary}" \
+               "&description=#{encoded_description}" \
+               "&reporter=#{me.name}" \
+               "&issuetype=#{issue_type.id}"
+
+    puts "\nGenerated issue creation link:"
+    puts jira_url
+  end
+
+  desc 'Search issue by fields'
+  task :search do |t|
+    options = fetch_options(%w[JQL], t.name)
+    result = client.Search.get do
+      data jql: options[:jql]
+    end
+    result['issues'].each { |i| puts JSON.pretty_generate(i) }
+  end
+
+  desc 'Delete issue'
+  task :delete do |t|
+    options = fetch_options(%w[ISSUE_ID], t.name)
+
+    client.Issue.del options[:issue_id]
+  end
+
+  desc 'Example usage attaching in issue'
+  task :attach do |t|
+    options = fetch_options(%w[FILE ISSUE_ID], t.name)
+
+    result = client.Issue.attachments options[:issue_id], @options[:file]
+    puts JSON.pretty_generate(result)
+  end
+end

data/lib/rujira/tasks/utils.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+def client
+  url = ENV.fetch('RUJIRA_URL', 'http://localhost:8080')
+  @client ||= Rujira::Client.new(url, debug: false)
+end
+
+def client_wrapped
+  url = ENV.fetch('RUJIRA_URL', 'http://localhost:8080')
+  @client_wrapped ||= Rujira::Client.new(url, debug: false, wrap_responses: true)
+end
+
+def open_editor(initial_text = '')
+  require 'tempfile'
+
+  editor = ENV['EDITOR'] || 'vi'
+
+  file = Tempfile.new(['jira_description', '.txt'])
+  file.write(initial_text)
+  file.flush
+  file.close
+
+  system("#{editor} #{file.path}")
+
+  content = File.read(file.path)
+  file.unlink
+
+  content
+end
+
+def fetch_options(params, name)
+  help = params.map { |k| "#{k}=<VALUE>" }.join(' ')
+  options = params.to_h do |k|
+    [k.downcase.to_sym, ENV.fetch(k, nil)]
+  end
+  missing = options.select { |_, v| v.nil? }.keys
+  unless missing.empty?
+    abort "❌ ERROR: The following required environment variables are missing: #{missing.join(', ').upcase}\n" \
+          "✅ USAGE: rake #{name} #{help}"
+  end
+
+  options
+end

data/lib/rujira/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rujira
-  VERSION = '0.7.0'
+  VERSION = '0.7.3'
 end

data/lib/rujira.rb

@@ -34,6 +34,12 @@ require_relative 'rujira/api/configuration'
 require_relative 'rujira/api/custom_fields'
 require_relative 'rujira/api/field'
 require_relative 'rujira/api/filter'
+require_relative 'rujira/api/user'
+require_relative 'rujira/resource/user'
+require_relative 'rujira/api/issue_type'
+require_relative 'rujira/resource/issue_type'
+require_relative 'rujira/api/priority'
+require_relative 'rujira/resource/priority'
 
 # Main Rujira module.
 # Serves as the namespace for the Jira SDK.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rujira
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.3
 platform: ruby
 authors:
 - Andrey Semenov
@@ -71,20 +71,28 @@ files:
 - lib/rujira/api/issue.rb
 - lib/rujira/api/issue/comments.rb
 - lib/rujira/api/issue/watchers.rb
+- lib/rujira/api/issue_type.rb
 - lib/rujira/api/myself.rb
 - lib/rujira/api/permissions.rb
+- lib/rujira/api/priority.rb
 - lib/rujira/api/project.rb
 - lib/rujira/api/search.rb
 - lib/rujira/api/server_info.rb
 - lib/rujira/api/sprint.rb
+- lib/rujira/api/user.rb
 - lib/rujira/client.rb
 - lib/rujira/request.rb
 - lib/rujira/resource/comment.rb
 - lib/rujira/resource/common.rb
 - lib/rujira/resource/issue.rb
+- lib/rujira/resource/issue_type.rb
 - lib/rujira/resource/myself.rb
+- lib/rujira/resource/priority.rb
 - lib/rujira/resource/project.rb
+- lib/rujira/resource/user.rb
 - lib/rujira/tasks/generate.rake
+- lib/rujira/tasks/issue.rb
+- lib/rujira/tasks/utils.rb
 - lib/rujira/version.rb
 - sig/rujira.rbs
 homepage: https://github.com/itmagelabs/rujira