human_file_size 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c8c762080085db0816483fce60f174eaddb63803e8c280574bfeea9feeda0acf
+  data.tar.gz: f08ca29cc3b2fffbf1e35f6622c7e3e7bab266cf5ecf01280c6094fc37f26be3
+SHA512:
+  metadata.gz: 55bfb51d38a30c359d8755a449feef2b9d8cdbf232901a5498cc94e55fe5c1de93a53306d15c8e689d02d11a4dc334ccc8f0608a4300ed024eae9b1625292456
+  data.tar.gz: 19809421d18313b9a06c54a406d3ca2358497a5f372050b20dd6615521a5809a3be224df1b43e014f425749b796e318ff975e63e7869fd00bfd5ad4ef76f9fec

data/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

data/.idea/human_file_size.iml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="jdk" jdkName="ruby-3.3.8-p144" jdkType="RUBY_SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.6.8, ruby-3.3.8-p144) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="minitest (v5.25.5, ruby-3.3.8-p144) [gem]" level="application" />
+  </component>
+</module>

data/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/human_file_size.iml" filepath="$PROJECT_DIR$/.idea/human_file_size.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+gemspec
+gem 'minitest'

data/Gemfile.lock

@@ -0,0 +1,19 @@
+PATH
+  remote: .
+  specs:
+    human_file_size (0.1.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    minitest (5.25.5)
+
+PLATFORMS
+  x64-mingw-ucrt
+
+DEPENDENCIES
+  human_file_size!
+  minitest
+
+BUNDLED WITH
+   2.6.8

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Andrii Stavskyi
+
+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,34 @@
+# Human File Size
+A simple Gem for formatting file sizes into a human-readable format.
+
+## Installation
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem 'human_file_size'
+```
+
+And then execute:
+```bash
+bundle install
+```
+
+Or install it yourself as:
+```bash
+gem install human_file_size
+```
+
+## Usage
+```ruby
+require 'human_file_size'
+
+HumanFileSize.format(100)          # => "100.00 B"
+HumanFileSize.format(1024)         # => "1.00 KB"
+HumanFileSize.format(1536)         # => "1.50 KB"
+HumanFileSize.format(1048576)      # => "1.00 MB"
+HumanFileSize.format(2621440, precision: 1) # => "2.5 MB"
+HumanFileSize.format(1572864576)   # => "1.50 GB"
+```
+
+## License
+This Gem is distributed under the MIT License. See the [LICENSE.txt](LICENSE) fire for details

data/human_file_size.gemspec

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative 'lib/human_file_size/version'
+
+Gem::Specification.new do |spec|
+  spec.name        = "human_file_size"
+  spec.version     = HumanFileSize::VERSION
+  spec.authors     = ["Andrii Stavskyi"]
+  spec.email       = ["an.stawski@outlook.com"]
+
+  spec.summary     = "Formats file sizes into a human-readable format."
+  spec.description = "Accepts a file size in bytes and returns a string with the appropriate prefix (e.g., '1.5 MB', '1024 KB')."
+  spec.homepage    = "https://github.com/stkossman/human_file_size"
+  spec.license     = "MIT"
+
+  spec.files         = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/stkossman/human_file_size"
+end

data/lib/human_file_size/version.rb

@@ -0,0 +1,3 @@
+module HumanFileSize
+  VERSION = "0.1.0"
+end

data/lib/human_file_size.rb

@@ -0,0 +1,16 @@
+module HumanFileSize
+  UNITS = %w[B KB MB GB TB PB EB ZB YB].freeze
+  BASE = 1024
+
+  def self.format(bytes, precision: 2)
+    return "0 B" if bytes.nil? || bytes.zero?
+
+    units = %w[B KB MB GB TB PB]
+    exponent = bytes.zero? ? 0 : (Math.log(bytes) / Math.log(1024)).to_i
+    exponent = [exponent, units.size - 1].min
+    value = bytes.to_f / (1024 ** exponent)
+
+    formatted_value = "%.#{precision}f" % value
+    "#{formatted_value} #{units[exponent]}"
+  end
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification
+name: human_file_size
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andrii Stavskyi
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-05-12 00:00:00.000000000 Z
+dependencies: []
+description: Accepts a file size in bytes and returns a string with the appropriate
+  prefix (e.g., '1.5 MB', '1024 KB').
+email:
+- an.stawski@outlook.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".idea/.gitignore"
+- ".idea/human_file_size.iml"
+- ".idea/modules.xml"
+- ".idea/vcs.xml"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- human_file_size.gemspec
+- lib/human_file_size.rb
+- lib/human_file_size/version.rb
+homepage: https://github.com/stkossman/human_file_size
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/stkossman/human_file_size
+  source_code_uri: https://github.com/stkossman/human_file_size
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Formats file sizes into a human-readable format.
+test_files: []