salesforce_certification_calculator 0.2.3 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3e2c79e3592dc37772b3e758787237aee2a59eb61fdf6bb79e69a2922fb409c
-  data.tar.gz: f71f648b7227e328e16e914d1285f53242c3b5d35456c1c59971924f6087cf52
+  metadata.gz: 2b029eea93b1b6f56977e85781962c822e0bee773d870460bf1c836a7dca92ec
+  data.tar.gz: fb84076ace1358dfc93df233953938db8f9b86d42c8ac4fec6ef3c287a89251c
 SHA512:
-  metadata.gz: 75e7530e1274da33a63de6705ae6d024cd8aa736266b74dcd4c01623303fbd4ce2bfdcab96f67423c3451265d84b6cfe03473d3ac867e29148631291b554eaa3
-  data.tar.gz: 200ce30ad30d7841a0fa37f03f86b2ca1d34b3391e6d75fed0604c38bcac88bd77c680ca1268dd567a275889753fad7e3f35b807d9f4b7b8b67f2fcf10eb9814
+  metadata.gz: 427d35fadd423b18a3a3037cd6d10c9ea6ff6a869aec934b1767c6a2d256ea5a3226d9831b97538e2582db4a0ad65d26fba46d7e73a12b7aba80394edcd98689
+  data.tar.gz: 5aadbee6d26c7600831e6d81781d1ec764610708b251b7451a584d73116d82bd382b87ca9cde8be554c4ea60a8a52714d5c90e6156aa092132ed2a0aadd813a9

data/README.md

@@ -28,6 +28,7 @@ I've taken a few Salesforce certification exams in my day, and I was always anno
 - File reading functionality
 - User interface for the CLI to provide prompts to walk user through the input process
 - Methods for calculating the cumulative total and for walking the user through all stages of data collection
+- Executable to allow user to run the module's core functionality with a simple command in the CLI instead of needing to go into a Ruby shell
 
 ## Requirements
 
@@ -65,14 +66,16 @@ If you have trouble downloading the package or just want to play around with the
 1. Fork this repository
 2. Clone it to your local computer
 3. From within your local version of the directory, build the module: `gem build salesforce_certification_calculator.gemspec`
-4. Then install that built module: `gem install ./salesforce_certification_calculator-0.2.3.gem`
+4. Then install that built module: `gem install ./salesforce_certification_calculator-0.2.6.gem`
 5. Open a Ruby environment to use the module: `irb`
 6. Execute any of the recently installed methods
 
-You may need to update the specific version of the build as later releases come out (e.g., `-0.2.3.gem` may need to become `-0.3.0.gem`).
+You may need to update the specific version of the build as later releases come out (e.g., `-0.2.6.gem` may need to become `-0.3.0.gem`).
 
 ## Usage
 
+### Module
+
 1. Open a Ruby environment to use the module: `irb`
 2. Require the package: `require 'salesforce_certification_calculator'`
 3. Create a new calculator to use: `calculator = SalesforceCertificationCalculator.new`
@@ -81,6 +84,14 @@ You may need to update the specific version of the build as later releases come
 
 Of course, you may use any of the other methods provided by the package, but `determine_percentage_manually` is the core method.
 
+### Executable
+
+This package also contains an executable, so you can run its core functionality (the above `determine_percentage_manually` method) directly from the CLI without needing to enter a Ruby shell:
+
+```
+salesforce_certification_calculator
+```
+
 ## Documentation
 
 This project uses **YARD** for documentation generation. To view the published form, see the [documentation on the RubyDoc site](https://www.rubydoc.info/gems/salesforce_certification_calculator/). To view the docs locally, go to the `doc` folder. To generate the docs yourself, execute `rake yard` in the CLI from the root of your local copy of the project.
@@ -123,7 +134,7 @@ end
 
 ## Testing
 
-This project has 103 automated tests, located in the `test` folder at the root. To run them, execute `rake test`. In order to successfully run these tests, you may need to also install `stringio` and `o_stream_catcher`.
+This project has 107 automated tests, located in the `test` folder at the root. To run them, execute `rake test`. In order to successfully run these tests, you may need to also install `stringio` and `o_stream_catcher`.
 
 ## Future Goals
 

data/Rakefile

@@ -12,4 +12,4 @@ end
 desc "Run tests"
 task default: :test
 
-# --- Ran 103 tests in 0.013265s on 7/29/22 --- OK --- #
+# --- Ran 107 tests in 0.016303s on 7/30/22 --- OK --- #

data/lib/salesforce_certification_calculator/exam.rb

@@ -48,6 +48,7 @@ class SalesforceCertificationCalculator::Exam
     def calculate_total
         summed_weights = 0
 
+        # Sum weighted scores of all sections
         @sections.each do |section|
             summed_weights += section.weight
             @total += section.weight * section.score / 100.0

data/lib/salesforce_certification_calculator/file_reader.rb

@@ -8,18 +8,22 @@ class SalesforceCertificationCalculator::FileReader
     def initialize
         sfc_gems = []
 
+        # Get full path to where Ruby gems are stored on user's computer, starting at the base
         gems_path = ENV["HOME"] + "/gems/gems"
         all_gems = Dir.children(gems_path)
 
+        # Create list of all versions of module installed on user's computer
         all_gems.each do |gem|
             if gem.include? "salesforce_certification_calculator"
                 sfc_gems.push(gem)
             end
         end
 
+        # Determine most recent version of module available
         sfc_gems.sort
         latest_sfc = sfc_gems[sfc_gems.length - 1]
 
+        # Set path variable for use by the class's methods
         @base_path = gems_path + "/" + latest_sfc
     end
 
@@ -35,6 +39,7 @@ class SalesforceCertificationCalculator::FileReader
         exams = []
         files = Dir.glob("data/*xml", base: @base_path)
 
+        # Create list of all exams, including their titles and file paths
         files.each do |file|
             exam = SFC::Exam.new
             file_path = @base_path + "/" + file
@@ -65,6 +70,7 @@ class SalesforceCertificationCalculator::FileReader
         names = doc.xpath("//name")
         weights = doc.xpath("//weight")
 
+        # Add all sections' names and weights to existing exam data
         (0..names.length-1).each do |i|
             exam.add_section(names[i].content, weights[i].content.to_i)
         end

data/lib/salesforce_certification_calculator/u_i.rb

@@ -13,6 +13,7 @@ class SalesforceCertificationCalculator::UI
         puts "Do you want to select an exam from a list (enter LIST), or do you want to type in your own details (enter NEW)?"
         choice = gets.chomp
 
+        # Only return value if user selected one of the two provided options; otherwise, recursively recall function
         if choice == "LIST" || choice == "NEW"
             return choice
         else
@@ -33,18 +34,28 @@ class SalesforceCertificationCalculator::UI
     # 
     # @return [Exam] object with name, file, and section details for selected exam
     def select_specific_exam(exams)
+        exams_length = exams.length
+
         puts "Your choices are:"
 
+        # List exam options
         exams.each do |exam|
             puts "#{exams.find_index(exam) + 1} - #{exam.title}"
         end
 
+        # Add option to let user enter details manually if exam not listed
+        puts "#{exams_length + 1} - NOT LISTED"
         puts "Which one would you like to select? Enter the number before the exam name:"
         choice = gets.chomp.to_i
 
-        if choice.between?(1, exams.length)
+        if choice.between?(1, exams_length)
+            # Only return value if user inputted number within range
             return exams[choice - 1]
+        elsif choice == exams_length + 1
+            # Enter details manually if exam not included in list
+            provide_all_details_manually()
         else
+            # Recursively recall function if invalid input
             select_specific_exam(exams)
         end
     end
@@ -65,6 +76,7 @@ class SalesforceCertificationCalculator::UI
     def provide_scores(exam)
         sections = exam.sections
 
+        # Get scores for each section from the user
         sections.each do |section|
             puts "#{section.name} is worth #{section.weight}%"
             puts "What score did you get on that section? (enter an integer)"
@@ -90,6 +102,7 @@ class SalesforceCertificationCalculator::UI
         puts "How many sections does it have?"
         length = gets.chomp.to_i
 
+        # Get names, weights, and scores for each section of the exam from the user
         (1..length).each do |i|
             puts "What is the name of Section #{i}?"
             name = gets.chomp

data/lib/salesforce_certification_calculator.rb

@@ -66,15 +66,21 @@ class SalesforceCertificationCalculator
         choice = @ui.select_list_or_new
 
         if choice == "LIST"
+            # Get list of exams, prompt user to select one, then require user to provide their scores for all the exam's sections
             @exams = @reader.generate_exams_list
             @exam = @ui.select_specific_exam(@exams)
-            @exam = @reader.extract_initial_exam_data(@exam)
 
-            puts "You selected: #{@exam.title}"
-            puts "Enter your scores for each of the exam's #{@exam.sections.length} sections in the order you are prompted"
-            
-            @exam = @ui.provide_scores(@exam)
+            # Only proceed if user did not end up entering data manually after not finding their exam listed
+            if @exam.sections.length == 0
+                @exam = @reader.extract_initial_exam_data(@exam)
+    
+                puts "You selected: #{@exam.title}"
+                puts "Enter your scores for each of the exam's #{@exam.sections.length} sections in the order you are prompted"
+                
+                @exam = @ui.provide_scores(@exam)
+            end
         else
+            # Allow user to manually enter all data themselves without the aid of the data already stored in the module's XML files
             @exam = @ui.provide_all_details_manually
         end
 

data/test/test_salesforce_certification_calculator.rb

@@ -186,4 +186,26 @@ class SalesforceTest < Minitest::Test
 
         assert_equal prompts, result[1].scan("?").length, "should prompt user for input 3 more than 3 times the number of sections in exam when call determine_percentage_manually and NEW selected"
     end
+    
+    def test_determine_percentage_manually_handles_not_listed_option
+        calculator = SFC.new
+        calculator.generate_exams_list
+
+        result = OStreamCatcher.catch do
+            string_io = StringIO.new
+            string_io.puts "LIST"
+            string_io.puts "#{calculator.exams.length + 1}"
+            string_io.puts "My Test"
+            string_io.puts "1"
+            string_io.puts "Section 1"
+            string_io.puts "100"
+            string_io.puts "70"
+            string_io.rewind
+            $stdin = string_io
+            result = calculator.determine_percentage_manually
+            $stdin = STDIN
+        end
+
+        assert_equal 1, result[1].scan("What is the title of this exam?").length, "should prompt user for title of new test if user selects NOT LISTED after initially selecting LIST"
+    end
 end

data/test/test_u_i.rb

@@ -184,6 +184,28 @@ class UITest < Minitest::Test
         assert_equal 1, result[1].scan("Which one would you like to select").length, "should call select_specific_exam only once if user inputs 2"
     end
 
+    def test_select_specific_exam_call_provide_manually
+        result = OStreamCatcher.catch do
+            string_io = StringIO.new
+            string_io.puts "#{@@exams.length + 1}"
+            string_io.puts "My Test"
+            string_io.puts "4"
+
+            (1..4).each do |i|
+                string_io.puts "Section #{i}"
+                string_io.puts "25"
+                string_io.puts "80"
+            end
+
+            string_io.rewind
+            $stdin = string_io
+            @@ui.select_specific_exam(@@exams)
+            $stdin = STDIN
+        end
+
+        assert_equal 1, result[1].scan("What is the title of this exam?").length, "should call provide_all_details_manually if user enters NOT LISTED option"
+    end
+
     def test_select_specific_exam_recursion_greater
         result = OStreamCatcher.catch do
             string_io = StringIO.new
@@ -212,6 +234,34 @@ class UITest < Minitest::Test
         assert_operator result[1].scan("Which one would you like to select").length, :>, 1, "should call select_specific_exam more than once if user inputs 0"
     end
 
+    def test_select_specific_exam_recursion_letter
+        result = OStreamCatcher.catch do
+            string_io = StringIO.new
+            string_io.puts "a"
+            string_io.puts "1"
+            string_io.rewind
+            $stdin = string_io
+            @@ui.select_specific_exam(@@exams)
+            $stdin = STDIN
+        end
+
+        assert_operator result[1].scan("Which one would you like to select").length, :>, 1, "should call select_specific_exam more than once if user inputs letter"
+    end
+
+    def test_select_specific_exam_recursion_title
+        result = OStreamCatcher.catch do
+            string_io = StringIO.new
+            string_io.puts "Advanced Administrator"
+            string_io.puts "1"
+            string_io.rewind
+            $stdin = string_io
+            @@ui.select_specific_exam(@@exams)
+            $stdin = STDIN
+        end
+
+        assert_operator result[1].scan("Which one would you like to select").length, :>, 1, "should call select_specific_exam more than once if user inputs title of exam instead of number"
+    end
+
     def test_provide_scores_returns_exam
         result = {}
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: salesforce_certification_calculator
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.6
 platform: ruby
 authors:
 - Jackson Reeves