cgpa_calculator 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 18965c9536ae0e7dce1d40c3947a80c7aecb895e07bea9fbe856409edc230f5f
+  data.tar.gz: 7cb91a77c5994a415f79ab31f6466c5927adb70dc3b425a1832e89be30a7d9fb
+SHA512:
+  metadata.gz: 06062f1f180125176c11749f298d8d455965b53271a9cee926e1de7d1054d4c90cf981472117ac73bb34a65be13b507b75f043282d897fc69631995922e0f756
+  data.tar.gz: 0e861acf9f1b4a1104a2e1e003fec1cc4c71d35da4e7cece5eb858d931fdebc96ac96f7fb31bf8ffaa61942554eddb3f00b6a719bf1fdea60e306c75bc8f995f

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GPA Calculator Team
+
+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/README.md

@@ -0,0 +1,62 @@
+# CGPA Calculator
+
+A lightweight Ruby library for calculating GPA, CGPA, and SGPA. Supports 4.0 and 5.0 grading scales used by universities worldwide.
+
+**Try the online tool: [gpacalc.app](https://gpacalc.app)**
+
+## Installation
+
+```ruby
+gem install cgpa_calculator
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'cgpa_calculator'
+```
+
+## Usage
+
+```ruby
+require 'cgpa_calculator'
+
+# Calculate semester GPA
+courses = [
+  { grade: "A", credits: 3 },
+  { grade: "B+", credits: 4 },
+  { grade: "A-", credits: 3 }
+]
+gpa = CgpaCalculator.calculate_gpa(courses)
+puts gpa # => 3.59
+
+# Calculate cumulative GPA
+semesters = [
+  { gpa: 3.5, credits: 15 },
+  { gpa: 3.8, credits: 16 }
+]
+cgpa = CgpaCalculator.calculate_cgpa(semesters)
+puts cgpa # => 3.66
+
+# Convert percentage to GPA
+gpa = CgpaCalculator.percentage_to_gpa(88)
+puts gpa # => 3.3
+
+# Convert GPA to letter grade
+letter = CgpaCalculator.gpa_to_letter(3.5)
+puts letter # => "A-"
+```
+
+## 5.0 Scale
+
+```ruby
+courses = [
+  { grade: "A", credits: 3 },
+  { grade: "B", credits: 4 }
+]
+gpa = CgpaCalculator.calculate_gpa(courses, scale: 5.0)
+```
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

data/lib/cgpa_calculator.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+# CGPA Calculator - A lightweight Ruby library for calculating GPA, CGPA, and SGPA.
+# Supports 4.0 and 5.0 grading scales.
+#
+# Homepage: https://gpacalc.app
+module CgpaCalculator
+  VERSION = "1.0.0"
+
+  GRADE_POINTS_4 = {
+    "A+" => 4.0, "A" => 4.0, "A-" => 3.7,
+    "B+" => 3.3, "B" => 3.0, "B-" => 2.7,
+    "C+" => 2.3, "C" => 2.0, "C-" => 1.7,
+    "D+" => 1.3, "D" => 1.0, "D-" => 0.7,
+    "F" => 0.0
+  }.freeze
+
+  GRADE_POINTS_5 = {
+    "A" => 5.0, "B" => 4.0, "C" => 3.0,
+    "D" => 2.0, "E" => 1.0, "F" => 0.0
+  }.freeze
+
+  class << self
+    # Calculate GPA for a list of courses
+    # @param courses [Array<Hash>] each with :grade (String) and :credits (Numeric)
+    # @param scale [Float] 4.0 or 5.0 (default: 4.0)
+    # @return [Float] the calculated GPA
+    def calculate_gpa(courses, scale: 4.0)
+      raise ArgumentError, "courses must be a non-empty array" if courses.nil? || courses.empty?
+
+      grade_map = scale == 5.0 ? GRADE_POINTS_5 : GRADE_POINTS_4
+      total_points = 0.0
+      total_credits = 0.0
+
+      courses.each do |course|
+        grade = course[:grade].to_s.upcase.strip
+        credits = course[:credits].to_f
+        raise ArgumentError, "Unknown grade: #{grade}" unless grade_map.key?(grade)
+        raise ArgumentError, "Credits must be positive" unless credits > 0
+
+        total_points += grade_map[grade] * credits
+        total_credits += credits
+      end
+
+      (total_points / total_credits).round(2)
+    end
+
+    # Calculate cumulative GPA across multiple semesters
+    # @param semesters [Array<Hash>] each with :gpa (Float) and :credits (Numeric)
+    # @return [Float] the cumulative GPA
+    def calculate_cgpa(semesters)
+      raise ArgumentError, "semesters must be a non-empty array" if semesters.nil? || semesters.empty?
+
+      total_points = 0.0
+      total_credits = 0.0
+
+      semesters.each do |sem|
+        gpa = sem[:gpa].to_f
+        credits = sem[:credits].to_f
+        total_points += gpa * credits
+        total_credits += credits
+      end
+
+      (total_points / total_credits).round(2)
+    end
+
+    # Convert a percentage score to GPA on a 4.0 scale
+    # @param percentage [Numeric] the percentage score (0-100)
+    # @return [Float] the equivalent GPA
+    def percentage_to_gpa(percentage)
+      raise ArgumentError, "Percentage must be between 0 and 100" unless percentage.between?(0, 100)
+
+      case percentage
+      when 93..100 then 4.0
+      when 90..92 then 3.7
+      when 87..89 then 3.3
+      when 83..86 then 3.0
+      when 80..82 then 2.7
+      when 77..79 then 2.3
+      when 73..76 then 2.0
+      when 70..72 then 1.7
+      when 67..69 then 1.3
+      when 63..66 then 1.0
+      when 60..62 then 0.7
+      else 0.0
+      end
+    end
+
+    # Convert a GPA to a letter grade
+    # @param gpa [Float] the GPA value
+    # @return [String] the letter grade
+    def gpa_to_letter(gpa)
+      case gpa
+      when 3.85..4.0 then "A"
+      when 3.5...3.85 then "A-"
+      when 3.15...3.5 then "B+"
+      when 2.85...3.15 then "B"
+      when 2.5...2.85 then "B-"
+      when 2.15...2.5 then "C+"
+      when 1.85...2.15 then "C"
+      when 1.5...1.85 then "C-"
+      when 1.15...1.5 then "D+"
+      when 0.85...1.15 then "D"
+      when 0.5...0.85 then "D-"
+      else "F"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: cgpa_calculator
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- GPA Calculator Team
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-04-09 00:00:00.000000000 Z
+dependencies: []
+description: Calculate semester GPA, cumulative GPA (CGPA), and convert between percentage
+  and GPA. Supports 4.0 and 5.0 grading scales used by universities worldwide.
+email:
+- contact@gpacalc.app
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/cgpa_calculator.rb
+homepage: https://gpacalc.app
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://gpacalc.app
+  source_code_uri: https://github.com/gpacalcteam/cgpa-calculator-ruby
+  changelog_uri: https://github.com/gpacalcteam/cgpa-calculator-ruby/blob/main/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: A lightweight Ruby library for calculating GPA, CGPA, and SGPA.
+test_files: []