change_case 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f240fbb77b9026f45150f376112764a7c23e671bf115c463f6c4dec454a1c8c0
-  data.tar.gz: c477ff5d1e5a0948d4dbf4472eea2225ac1ae7a072fe7a96de8214d48cb10b22
+  metadata.gz: 3cc32b4cba960d81ff1c275a32d3184fa6bba468fa38dc020eebb86d95ced60d
+  data.tar.gz: a98036290d52e34276bbbc74f64326fff3056e65135311130c27d58a1e88ae56
 SHA512:
-  metadata.gz: 79932561ce0d27c2e3ecac78fe58de6175cdba32c22a502b58c38291d54982566a4490306ad07332e188650a31e1b6900ebf0308206522c9015cf964d98fe1f7
-  data.tar.gz: 17e94b4d0572d548f83601a388719ff2fea1ef55b3ec2528106973943dd2bd659979ce1b9ea6b2b4048cfe97a44e33460870da64c3e274317566bc1cdb2f3e17
+  metadata.gz: de7d6787223100cd5d4efe747b72e100258c551e828e0bdb9896608a4c4774bc39324ae82349eeb3caf899e1bb51ff1604ed871a0b3d82383e91705934b730fb
+  data.tar.gz: fe3cbe4baab5e60ddbfdb82ac927d1d08dfd42be08d7ea8173f929e2f03a5d5a3fed3b26f83121fabcd0ec35ca30981ca3455cab42f83949c5a157f466e38d55

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+## [0.3.0] - 2025-01-16
+
+- Include case methods to String class
+
+## [0.2.0] - 2025-01-12
+
+- All case methods and refactor code
+
+## [0.1.0] - 2025-01-10
+
+- Initial release

data/README.md

@@ -0,0 +1,64 @@
+# ChangeCase
+
+Transform a string between `camelCase`, `PascalCase`, `Capital Case`, `snake_case`, `kebab-case`, `CONSTANT_CASE` and others.
+
+[![Build Status](https://github.com/javoeria/change_case/actions/workflows/main.yml/badge.svg)](https://github.com/javoeria/change_case/actions/workflows/main.yml)
+[![Gem Version](https://badge.fury.io/rb/change_case.svg)](https://rubygems.org/gems/change_case)
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add change_case
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install change_case
+```
+
+## Usage
+
+```ruby
+require "change_case"
+
+ChangeCase.camel("TEST_VALUE") #=> "testValue"
+# OR
+"TEST_VALUE".camelcase #=> "testValue"
+```
+
+Included case methods:
+
+| ChangeCase     | String         | Result      |
+| -------------- | -------------- | ----------- |
+| `camel`        | `camelcase`    | `twoWords`  |
+| `capital`      | `capitalcase`  | `Two Words` |
+| `constant`     | `constantcase` | `TWO_WORDS` |
+| `dot`          | `dotcase`      | `two.words` |
+| `kebab`        | `kebabcae`     | `two-words` |
+| `no`           | `nocase`       | `two words` |
+| `pascal`       | `pascalcase`   | `TwoWords`  |
+| `pascal_snake` | `pascalcase`   | `Two_Words` |
+| `path`         | `pathcase`     | `two/words` |
+| `sentence`     | `sentencecase` | `Two words` |
+| `snake`        | `snakecase`    | `two_words` |
+| `train`        | `traincase`    | `Two-Words` |
+| `title`        | `titlecase`    | `Two Words` |
+| `swap`         | `swapcase`     | `tWO wORDS` |
+| `sponge`       | `spongecase`   | `TwO wORdS` |
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. 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/javoeria/change_case.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/change_case/string.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# Add ChangeCase methods on the String class by monkey patching.
+class String
+  # Converts the string to camel case.
+  def camelcase
+    ChangeCase.camel(self)
+  end
+
+  # Converts the string to capital case.
+  def capitalcase
+    ChangeCase.capital(self)
+  end
+
+  # Converts the string to constant case.
+  def constantcase
+    ChangeCase.constant(self)
+  end
+
+  # Converts the string to dot case.
+  def dotcase
+    ChangeCase.dot(self)
+  end
+
+  # Converts the string to kebab/param case.
+  def kebabcase
+    ChangeCase.kebab(self)
+  end
+
+  # Converts the string to space separated lowercase.
+  def nocase
+    ChangeCase.no(self)
+  end
+
+  # Converts the string to pascal case.
+  def pascalcase(snake: false)
+    snake ? ChangeCase.pascal_snake(self) : ChangeCase.pascal(self)
+  end
+
+  # Converts the string to path case.
+  def pathcase
+    ChangeCase.path(self)
+  end
+
+  # Converts the string to sentence case.
+  def sentencecase
+    ChangeCase.sentence(self)
+  end
+
+  # Converts the string to snake case.
+  def snakecase
+    ChangeCase.snake(self)
+  end
+
+  # Converts the string to train/header case.
+  def traincase
+    ChangeCase.train(self)
+  end
+
+  # Converts the string to title case.
+  def titlecase
+    ChangeCase.title(self)
+  end
+
+  # Converts the string with random capitalization applied.
+  def spongecase
+    ChangeCase.sponge(self)
+  end
+end

data/lib/change_case/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ChangeCase
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/change_case.rb

@@ -1,53 +1,108 @@
 # frozen_string_literal: true
 
 require_relative "change_case/version"
+require_relative "change_case/string"
 
+# Module used for converting strings to any case.
 module ChangeCase
+  # Converts the string to camel case.
   def self.camel(input)
-    underscore(input).split(/[^a-z0-9]+/).map.with_index { |word, i| i.zero? ? word : word.capitalize }.join
+    split_string(input).map.with_index { |word, i| i.zero? ? word : word.capitalize }.join
   end
 
+  # Converts the string to capital case.
   def self.capital(input)
-    underscore(input).split(/[^a-z0-9]+/).map(&:capitalize).join(" ")
+    split_string(input).map(&:capitalize).join(" ")
   end
 
+  # Converts the string to constant case.
   def self.constant(input)
-    underscore(input).gsub(/[^a-z0-9]+/, "_").upcase
+    split_string(input).join("_").upcase
   end
 
+  # Converts the string to dot case.
   def self.dot(input)
-    underscore(input).gsub(/[^a-z0-9]+/, ".")
+    split_string(input).join(".")
   end
 
+  # Converts the string to kebab/param case.
   def self.kebab(input)
-    underscore(input).gsub(/[^a-z0-9]+/, "-")
+    split_string(input).join("-")
   end
 
+  # Converts the string to space separated lowercase.
   def self.no(input)
-    underscore(input).gsub(/[^a-z0-9]+/, " ")
+    split_string(input).join(" ")
   end
 
+  # Converts the string to pascal case.
   def self.pascal(input)
-    underscore(input).split(/[^a-z0-9]+/).map(&:capitalize).join
+    split_string(input).map(&:capitalize).join
   end
 
+  # Converts the string to pascal snake case.
+  def self.pascal_snake(input)
+    split_string(input).map(&:capitalize).join("_")
+  end
+
+  # Converts the string to path case.
   def self.path(input)
-    underscore(input).gsub(/[^a-z0-9]+/, "/")
+    split_string(input).join("/")
   end
 
+  # Converts the string to sentence case.
   def self.sentence(input)
-    underscore(input).gsub(/[^a-z0-9]+/, " ").capitalize
+    split_string(input).join(" ").capitalize
   end
 
+  # Converts the string to snake case.
   def self.snake(input)
-    underscore(input).gsub(/[^a-z0-9]+/, "_")
+    split_string(input).join("_")
   end
 
+  # Converts the string to train/header case.
   def self.train(input)
-    underscore(input).split(/[^a-z0-9]+/).map(&:capitalize).join("-")
+    split_string(input).map(&:capitalize).join("-")
+  end
+
+  # Converts the string to title case.
+  def self.title(input)
+    small_words = %w[a an and as at because but by en for if in neither nor of on or only over per so some that than the to up upon vs versus via when with without yet]
+    split_string(input).map.with_index { |word, i| small_words.include?(word) && i.positive? ? word : word.capitalize }.join(" ")
+  end
+
+  # Converts the string with uppercase characters to lowercase and vice versa.
+  def self.swap(input)
+    input.swapcase
+  end
+
+  # Converts the string with random capitalization applied.
+  def self.sponge(input)
+    input.chars.map { |char| rand(2).zero? ? char.downcase : char.upcase }.join
+  end
+
+  # Converts the first character in the string to uppercase.
+  def self.upper_first(input)
+    input.empty? ? "" : input[0].upcase.concat(input[1..])
+  end
+
+  # Converts the first character in the string to lowercase.
+  def self.lower_first(input)
+    input.empty? ? "" : input[0].downcase.concat(input[1..])
+  end
+
+  # Returns +true+ if the string is uppercase only.
+  def self.upper?(input)
+    input == input.upcase
+  end
+
+  # Returns +true+ if the string is lowercase only.
+  def self.lower?(input)
+    input == input.downcase
   end
 
-  private_class_method def self.underscore(input)
-    input.to_s.strip.gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2').gsub(/([a-z0-9])([A-Z])/, '\1_\2').downcase
+  private_class_method def self.split_string(input)
+    input.to_s.strip.gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2').gsub(/([a-z0-9])([A-Z])/, '\1_\2')
+         .downcase.split(/[^a-z0-9']+/).reject(&:empty?)
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: change_case
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Javier Rosales
 bindir: bin
 cert_chain: []
-date: 2025-01-10 00:00:00.000000000 Z
+date: 2025-01-16 00:00:00.000000000 Z
 dependencies: []
 email:
 - javier.rb_96@hotmail.com
@@ -15,12 +15,16 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- README.md
 - lib/change_case.rb
+- lib/change_case/string.rb
 - lib/change_case/version.rb
 homepage: https://github.com/javoeria/change_case
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/javoeria/change_case
 rdoc_options: []
 require_paths:
 - lib