cleanio 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b2f0e7b2724b16024bbe777ea410ef369495f544ebcc3ca40f3cdd98219b18af
+  data.tar.gz: dfe2856b027bff85005a3957b44283544ba7ca171d3f010a7481a4f4c2f28814
+SHA512:
+  metadata.gz: aaf2ea9478bc1a29d8bbd7198fd31315f22f79f59c51e8db3f88473abd0a5808f12ab5e50be920ccf3eff714bc9c9ea71aa696f979832bbebbdc5e230f4f845b
+  data.tar.gz: 71f9d89066caa22d6c24ba2f1a33937215f2e7594b73969153586a3c57439a8646b7020e40acacd9e5036cba3eaef52b00a160f7e8153bc1ff781bb15ce3f06d

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,24 @@
+require:
+  - rubocop-rspec
+  - rubocop-rake
+
+AllCops:
+  TargetRubyVersion: 3.2
+  NewCops: enable
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/cleanio/**/*'
+
+Style/Documentation:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Exclude:
+    - 'spec/cleanio/**/*'

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Justyna Wojtczak
+
+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/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Justyna
+
+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,89 @@
+# Cleanio
+
+`cleanio` is a simple Ruby gem that removes comments from `.rb` files. It can handle single-line comments and inline comments, leaving your code clean and readable.
+
+---
+
+## Table of Contents
+
+1. [Installation](#installation)
+2. [Usage](#usage)
+3. [Testing](#testing)
+4. [Contribution](#contribution)
+5. [License](#license)
+6. [TODO](#todo)
+
+---
+
+## Installation
+
+To install `cleanio`, add it to your Gemfile:
+
+```ruby
+gem 'cleanio'
+```
+Then execute:
+
+```bash
+bundle install
+```
+Or install it yourself using the following command:
+
+```bash
+gem install cleanio
+```
+
+
+## Usage
+To clean up comments from a .rb file, simply run:
+
+```ruby
+require 'cleanio'
+
+Cleanio::Remover.clean('path/to/your_file.rb')
+```
+Alternatively, you can use the command line tool:
+
+```bash
+cleanio -f path/to/your_file.rb
+```
+This will remove all comments from the specified Ruby file.
+
+## Testing
+Cleanio uses RSpec for testing. To run the tests, first make sure all dependencies are installed:
+
+```bash
+bundle install
+```
+Then, run the tests with:
+
+```bash
+bundle exec rspec
+```
+All tests are located in the spec directory and cover the main functionality of the gem, ensuring it properly removes comments from Ruby files.
+
+## Contribution
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/justi/cleanio.
+
+To contribute:
+
+Fork the repository.
+Create a new branch (git checkout -b feature-branch).
+Make your changes.
+Commit your changes (git commit -m 'Add new feature').
+Push to the branch (git push origin feature-branch).
+Open a pull request.
+
+Please ensure that your code follows the existing style and that all tests pass.
+
+## License
+The gem is available as open source under the terms of the MIT License.
+
+
+## TODO
+- Add support multi-line comments (`=begin`...`=end`)
+- Option to stay documentation comments (e.g. `# @param`) https://www.rubydoc.info/gems/rubocop/RuboCop/Cop/Style/Documentation
+- Option to recursively clean all files in a directory
+- Option to clean all files in a directory except for a specified file
+- Option for audit mode (show what would be removed without actually removing it)

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/exe/cleanio

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+require "cleanio"
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = "Usage: cleanio -f FILE"
+
+  opts.on("-f", "--file FIle", "Path to .rb file") do |file|
+    options[:file] = file
+  end
+end.parse!
+
+if options[:file]
+  begin
+    Cleanio::Remover.clean(options[:file])
+    puts "The comments were removed from #{options[:file]}"
+  rescue StandardError => e
+    puts "Error: #{e.message}"
+  end
+else
+  puts "You need to provide a file path with -f option"
+end

data/lib/cleanio/version.rb

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

data/lib/cleanio.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "cleanio/version"
+require "ripper"
+
+module Cleanio
+  class Remover
+    def self.clean(file_path)
+      validate_file_extension(file_path)
+      file_content = File.read(file_path)
+      content_cleaned = remove_comments(file_content)
+      File.write(file_path, content_cleaned)
+    end
+
+    def self.validate_file_extension(file_path)
+      raise "Only Ruby files are supported" unless file_path.end_with?(".rb")
+    end
+
+    def self.remove_comments(content)
+      comments = extract_comments(content)
+      content = process_comments(content, comments)
+      remove_empty_lines(content)
+    end
+
+    def self.extract_comments(content)
+      Ripper.lex(content).select { |_pos, type, _tok, _| type == :on_comment }
+    end
+
+    def self.process_comments(content, comments)
+      comments.sort_by { |(pos, _, _, _)| [pos[0], pos[1]] }.reverse.each do |(pos, _, _, _)|
+        line, col = pos
+        lines = content.lines
+        lines[line - 1] = process_comment_line(lines[line - 1], col)
+        content = lines.join
+      end
+      content
+    end
+
+    def self.process_comment_line(line, col)
+      if line[col..].strip.start_with?("#")
+        "#{line[0...col].rstrip}\n"
+      else
+        "\n"
+      end
+    end
+
+    def self.remove_empty_lines(content)
+      content.gsub(/^\s*$\n/, "")
+    end
+  end
+end

data/sig/cleanio.rbs

@@ -0,0 +1,4 @@
+module Cleanio
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: cleanio
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Justyna
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-11-15 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+- justine84@gmail.com
+executables:
+- cleanio
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- LICENSE
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/cleanio
+- lib/cleanio.rb
+- lib/cleanio/version.rb
+- sig/cleanio.rbs
+homepage:
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Remove comments from Ruby files
+test_files: []