crypto-unit 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2de75699f62f03becfbc70ccee8a49f134a5c0a1
+  data.tar.gz: 0450a1a6a2d3ffad8feec23b219122e74ed1eee1
+SHA512:
+  metadata.gz: bfcd8106763223c3135301730eeb04d0eafa28bee87c91fd18eba21ff96df3d2054c2d5d197c63a6c31b6a144b62121bfec5807e41f58668cedf2c41a2c176dd
+  data.tar.gz: a88588c40850735ba067c2c26198e02323b93bc0f9e0c93bc2589ea15e80ad5ae01fcb09a11e35e53a5d56320afec4f43af981eb886095c1b6dd51fcbe9d94f2

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+group :development do
+  gem "bundler", "~> 1.0"
+  gem "jeweler", "~> 2.1.2"
+  gem "rspec"
+end

data/Gemfile.lock

@@ -0,0 +1,75 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.5.0)
+      public_suffix (~> 2.0, >= 2.0.2)
+    builder (3.2.2)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.2.5)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    git (1.3.0)
+    github_api (0.11.3)
+      addressable (~> 2.3)
+      descendants_tracker (~> 0.0.1)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 1.2)
+      multi_json (>= 1.7.5, < 2.0)
+      nokogiri (~> 1.6.0)
+      oauth2
+    hashie (3.4.6)
+    highline (1.7.8)
+    jeweler (2.1.2)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api (~> 0.11.0)
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+      semver
+    jwt (1.5.6)
+    mini_portile2 (2.1.0)
+    multi_json (1.12.1)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.8.1)
+      mini_portile2 (~> 2.1.0)
+    oauth2 (1.2.0)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    public_suffix (2.0.3)
+    rack (2.0.1)
+    rake (11.3.0)
+    rdoc (5.0.0)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.4)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    semver (1.0.1)
+    thread_safe (0.3.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0)
+  jeweler (~> 2.1.2)
+  rspec
+
+BUNDLED WITH
+   1.12.4

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2014 Roman Snitko
+
+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,69 @@
+Crypto Unit
+================
+This tiny gem allows you to make easy conversions from one Bitcoin or Litecoin denomination into another.
+It provides a class, which objects would essentially represent an amount of litecoins measured
+in the smallest possible denomination, which is Satoshi for BTC and Litoshi for LTC. You can then call methods on these objects
+to convert it various other denominations.
+
+### Installation
+
+    gem install crypto-unit
+
+### Usage
+
+Here's how it might look:
+
+    s = Satoshi.new(1) # By default, it accepts amounts in BTC denomination
+    s.to_i             # => 100000000 (in Satoshis)
+    s.to_milli          # => 1000.0
+    s.to_standart           # => 1.0
+    
+When creating a Satoshi / Litoshi object, you can also specify which unit is being used to pass the amount,
+for example:
+
+    s = Litoshi.new(1, from_unit: :milli)
+    
+    s.to_i    # => 100000
+    s.to_milli # => 1.0
+    s.to_standart  # => 0.001
+    
+There's also a special method which is called `#to_unit`, it always converts to the denomination
+specified in the `:to_unit` option in the constructor. It becomes really handy when you want to
+specify your preferred denomination used througout the program in just one place
+(to be able to change it later):
+
+    DENOMINATION = :milli
+    s = Litoshi.new(1, from_unit: DENOMINATION, to_unit: DENOMINATION)
+    s.to_unit # => 1.0 (in mLTC)
+    
+This can be shortened to just the `:unit` option:
+
+    s = Litoshi.new(1, unit: DENOMINATION)
+    
+But, of course, if you want your "from" denomination and "to" denomination to be different, then
+you'd have to pass them both manually:
+
+    s = Satoshi.new(1, from_unit: :milli, to_unit: :standart)
+    s.to_unit # => 0.001
+
+
+
+###Comparing units
+
+CryptoUnit objects come with methods and coercions for comparing itself with both other CyptoUnit objects and also numeric values:
+
+    s1 = Litoshi.new(1)
+    s2 = Litoshi.new(2)
+    
+    s1 > s2  # => false
+    s1 < s2  # => true
+    s1 == s2 # => false
+    
+    s1 > 1  # => true
+    1  > s2 # => false
+
+
+### Unit tests
+
+
+Run `rspec spec`. Pull requests with more unit tests are welcome.

data/Rakefile

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://guides.rubygems.org/specification-reference/ for more options
+  gem.name = "crypto-unit"
+  gem.homepage = "http://github.com/mgpnd/crypto-unit"
+  gem.license = "MIT"
+  gem.summary = %Q{Converts various BTC and LTC denominations}
+  gem.description = %Q{Converts various BTC and LTC denominations}
+  gem.email = "roman.snitko@gmail.com"
+  gem.authors = ["Roman Snitko"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new

data/VERSION

@@ -0,0 +1 @@
+0.3.0

data/crypto-unit.gemspec

@@ -0,0 +1,60 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: crypto-unit 0.3.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "crypto-unit".freeze
+  s.version = "0.3.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib".freeze]
+  s.authors = ["Roman Snitko".freeze]
+  s.date = "2017-07-18"
+  s.description = "Converts various BTC and LTC denominations".freeze
+  s.email = "roman.snitko@gmail.com".freeze
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "crypto-unit.gemspec",
+    "lib/crypto-unit.rb",
+    "lib/crypto_unit_base.rb",
+    "lib/litoshi.rb",
+    "lib/satoshi.rb",
+    "spec/crypto_unit_base_spec.rb"
+  ]
+  s.homepage = "http://github.com/mgpnd/crypto-unit".freeze
+  s.licenses = ["MIT".freeze]
+  s.rubygems_version = "2.6.12".freeze
+  s.summary = "Converts various BTC and LTC denominations".freeze
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<bundler>.freeze, ["~> 1.0"])
+      s.add_development_dependency(%q<jeweler>.freeze, ["~> 2.1.2"])
+      s.add_development_dependency(%q<rspec>.freeze, [">= 0"])
+    else
+      s.add_dependency(%q<bundler>.freeze, ["~> 1.0"])
+      s.add_dependency(%q<jeweler>.freeze, ["~> 2.1.2"])
+      s.add_dependency(%q<rspec>.freeze, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<bundler>.freeze, ["~> 1.0"])
+    s.add_dependency(%q<jeweler>.freeze, ["~> 2.1.2"])
+    s.add_dependency(%q<rspec>.freeze, [">= 0"])
+  end
+end
+

data/lib/crypto-unit.rb

@@ -0,0 +1,7 @@
+# This is just a file of the same name as gem so that it is
+# auto required when the gem is loaded and we load existing crypto units.
+
+require 'bigdecimal'
+require_relative './crypto_unit_base'
+require_relative './satoshi'
+require_relative './litoshi'

data/lib/crypto_unit_base.rb

@@ -0,0 +1,164 @@
+class CryptoUnit
+  # Says how many digits after the decimal point
+  # a denomination has.
+  UNIT_DENOMINATIONS = {
+    standart: 8,
+    milli: 5,
+    primary: 0,
+  }
+
+  MAX_VALUE = 0
+  NAME = ''
+
+  class TooManyDigitsAfterDecimalPoint < Exception;end
+  class TooLarge                       < Exception;end
+
+  attr_reader :value, :from_unit, :to_unit
+
+  def initialize(n=nil, from_unit: 'standart', to_unit: 'standart', unit: nil)
+    n = 0 if n.nil?
+    if unit
+      @from_unit = @to_unit = unit.downcase.to_sym
+    else
+      @from_unit = from_unit.downcase.to_sym
+      @to_unit   = to_unit.downcase.to_sym
+    end
+    @value = convert_to_primary(n) if n
+  end
+
+  def to_standart(as: :number)
+    to_denomination(UNIT_DENOMINATIONS[:standart], as: as)
+  end
+
+  def to_milli(as: :number)
+    to_denomination(UNIT_DENOMINATIONS[:milli], as: as)
+  end
+
+  def to_unit(as: :number)
+    to_denomination(UNIT_DENOMINATIONS[@to_unit], as: as)
+  end
+
+  def to_i
+    return 0 if @value.nil?
+    @value
+  end
+  alias :primary_value :to_i 
+
+  def to_s
+    to_unit.to_s
+  end
+
+  def value=(n)
+    n = 0 if n.nil?
+    @value = convert_to_primary(n)
+  end
+
+  def primary_value=(v)
+    @value = v
+  end
+
+  def >(i)
+    self.to_i > i
+  end
+
+  def <(i)
+    self.to_i < i
+  end
+
+  def >=(i)
+    self.to_i >= i
+  end
+
+  def <=(i)
+    self.to_i <= i
+  end
+
+  def ==(i)
+    self.to_i == i
+  end
+
+  def +(i)
+    if i.kind_of?(CryptoUnit)
+      self.class.new(self.to_i + i, from_unit: :primary)
+    else
+      self.to_i + i
+    end
+  end
+
+  def -(i)
+    if i.kind_of?(CryptoUnit)
+      self.class.new(self.to_i - i, from_unit: :primary)
+    else
+      self.to_i - i
+    end
+  end
+
+  # IMPORTANT: multiplication is done on primary units, not standart.
+  # 0.01*0.02 will be a larger value.
+  def *(i)
+    if i.kind_of?(CryptoUnit)
+      self.class.new(self.to_i * i, from_unit: :primary)
+    else
+      self.to_i * i
+    end
+  end
+
+  def coerce(other)
+    if other.kind_of?(Integer)
+      [other, self.to_i]
+    else
+      raise TypeError, message: "CryptoUnit cannot be coerced into anything but Integer"
+    end
+  end
+
+  protected
+  
+    def to_denomination(digits_after_delimiter, as: :number)
+      sign  = @value < 0 ? -1 : 1
+      val   = @value.abs
+      return val if digits_after_delimiter <= 0
+      leading_zeros = "0"*(18-val.to_s.length)
+      result = leading_zeros + val.to_s
+      result.reverse!
+      result = result.slice(0..digits_after_delimiter-1) + '.' + result.slice(digits_after_delimiter..17)
+      result.reverse!
+      result = result.sub(/\A0*/, '').sub(/0*\Z/, '') # remove zeros on both sides
+      if as == :number
+        result.to_f*sign 
+      else
+        if result == '.'
+          result = '0.0'
+        elsif result =~ /\A\./
+          result = "0#{result}"
+        end
+        sign == -1 ? "-#{result}" : result
+      end
+    end
+
+    def convert_to_primary(n)
+      n = BigDecimal.new(n.to_s)
+
+      decimal_part_length = n.to_s("F").split(".")[1]
+      decimal_part_length = if decimal_part_length
+        decimal_part_length.sub(/0*\Z/, "").length
+      else
+        0
+      end
+
+      if decimal_part_length > UNIT_DENOMINATIONS[@from_unit]
+        raise TooManyDigitsAfterDecimalPoint,
+          "Too many digits (#{decimal_part_length}) after decimal point used for #{@from_unit} value, while #{UNIT_DENOMINATIONS[@from_unit]} allowed" 
+      end
+
+      n = ("%.#{UNIT_DENOMINATIONS[@from_unit]}f" % n) # otherwise we might see a scientific notation
+      n = n.split('.')
+      n[1] ||= '' # in the case where there's no decimal part
+      n[1] += "0"*(UNIT_DENOMINATIONS[@from_unit]-n[1].length) if n[1]
+
+      if(n.join.to_i > self.class::MAX_VALUE)
+        raise TooLarge, "Max value for #{self.class::NAME} is #{self.class::MAX_VALUE}"
+      end
+
+      n.join.to_i
+    end
+end

data/lib/litoshi.rb

@@ -0,0 +1,4 @@
+class LitoshiUnit < CryptoUnit
+  NAME = "Litoshi"
+  MAX_VALUE = 84_000_000_00000000
+end

data/lib/satoshi.rb

@@ -0,0 +1,4 @@
+class SatoshiUnit < CryptoUnit
+  NAME = "Satoshi"
+  MAX_VALUE = 21_000_000_00000000
+end

data/spec/crypto_unit_base_spec.rb

@@ -0,0 +1,96 @@
+require_relative '../lib/crypto-unit'
+require_relative '../lib/satoshi'
+require_relative '../lib/litoshi'
+
+describe CryptoUnit do
+
+  it "creates a Bignum representing value in primary units" do
+    expect(Satoshi.new(1.00).to_i).to eq(100000000)
+  end
+
+  it "takes care of the sign before the value" do
+    expect(Satoshi.new(-1.00).to_i).to eq(-100000000)
+  end
+
+  it "converts primary unit back to some more common denomination" do
+    expect(Satoshi.new(1.00).to_standart).to eq(1)
+    expect(Satoshi.new(1.08763).to_standart).to eq(1.08763)
+    expect(Satoshi.new(1.08763).to_milli).to eq(1087.63)
+    expect(Satoshi.new(-1.08763).to_milli).to eq(-1087.63)
+    expect(Satoshi.new(0.00000001).to_i).to eq(1)
+    expect(Satoshi.new(0.00000001).to_milli).to eq(0.00001)
+  end
+   
+  it "converts from various source denominations" do
+    expect(Satoshi.new(1, unit: 'milli').to_standart).to      eq(0.001)
+    expect(Satoshi.new(1, unit: 'milli').to_unit).to     eq(1)
+    expect(Satoshi.new(10000000, unit: 'milli').to_unit).to eq(10000000)
+    satoshi = Satoshi.new(10000000, unit: 'milli')
+    satoshi.primary_value = 1
+    expect(satoshi.to_unit).to eq(0.00001)
+    expect(Satoshi.new(100, unit: 'milli').to_i).to eq(10000000)
+  end
+
+  it "treats nil in value as 0" do
+    expect(Satoshi.new < 1).to be_truthy
+    expect(Satoshi.new > 1).to be_falsy
+    expect(Satoshi.new == 0).to be_truthy
+  end
+
+  it "converts negative values correctly" do
+    expect(Satoshi.new(-1.00, unit: :milli).to_standart).to eq(-0.001)
+  end
+
+  it "converts zero values correctly" do
+    expect(Satoshi.new(0, unit: :milli).to_unit).to eq(0)
+  end
+
+  it "converts nil values correctly" do
+    s = Satoshi.new(nil, unit: :milli)
+    expect(s.value).to eq(0)
+    s.value = nil
+    expect(s.to_unit).to eq(0)
+  end
+
+  it "displays one primary unit in human form, not math form" do
+    one_satoshi = Satoshi.new(1, from_unit: :primary, to_unit: :standart)
+    expect(one_satoshi.to_unit(as: :string)).not_to eq('1.0e-08')
+    expect(one_satoshi.to_unit(as: :string)).to eq('0.00000001')
+  end
+
+  it "displays zero units in human form, not math form" do
+    zero_satoshi = Satoshi.new(0, from_unit: :primary, to_unit: :standart)
+    expect(zero_satoshi.to_unit(as: :string)).to eq('0.0')
+  end
+
+  it "raises exception if decimal part contains more digits than allowed by from_value" do
+    expect( -> { Satoshi.new(0.001000888888888888888, from_unit: :standart).to_unit }).to raise_exception(CryptoUnit::TooManyDigitsAfterDecimalPoint)
+    expect( -> { Satoshi.new("0.001000999999999999999", from_unit: :standart).to_unit }).to raise_exception(CryptoUnit::TooManyDigitsAfterDecimalPoint)
+    expect( -> { Satoshi.new(0.001000999, from_unit: :standart).to_unit }).to raise_exception(CryptoUnit::TooManyDigitsAfterDecimalPoint)
+    expect( -> { Satoshi.new(0.00100099, from_unit: :standart).to_unit }).not_to raise_exception
+    expect( -> { Satoshi.new(0.123456789, from_unit: :standart) }).to raise_exception(CryptoUnit::TooManyDigitsAfterDecimalPoint)
+    expect( -> { Satoshi.new(0.12345678, from_unit: :standart).to_unit }).not_to raise_exception
+    expect( -> { Satoshi.new(nil, from_unit: :standart).to_unit }).not_to raise_exception
+  end
+
+  it "Satoshi dissallows to create values more than 21mil BTC" do
+    expect( -> { Satoshi.new(21_000_001) }).to raise_exception(CryptoUnit::TooLarge)
+    expect( -> { Satoshi.new(21_000_000) }).not_to raise_exception
+  end
+
+  it "Litoshi disallows to create values more than 84mil LTC" do
+    expect( -> { Litoshi.new(84_000_001) }).to raise_exception(CryptoUnit::TooLarge)
+    expect( -> { Litoshi.new(84_000_000) }).not_to raise_exception
+  end
+
+  it "returns CryptoUnit for +,- and * methods if both operands are CryptoUnit" do
+    s1 = Satoshi.new(0.001, from_unit: :standart)
+    s2 = Satoshi.new(0.002, from_unit: :standart)
+    expect(s1+s2).to be_kind_of(Satoshi)
+    expect((s1+s2).to_unit).to eq(0.003)
+    expect(s2-s1).to be_kind_of(Satoshi)
+    expect((s2-s1).to_unit).to eq(0.001)
+    expect(s2*s1).to be_kind_of(Satoshi)
+    expect((s2*s1).to_unit).to eq(200)
+  end
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: crypto-unit
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: ruby
+authors:
+- Roman Snitko
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-07-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Converts various BTC and LTC denominations
+email: roman.snitko@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- ".document"
+- ".rspec"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- crypto-unit.gemspec
+- lib/crypto-unit.rb
+- lib/crypto_unit_base.rb
+- lib/litoshi.rb
+- lib/satoshi.rb
+- spec/crypto_unit_base_spec.rb
+homepage: http://github.com/mgpnd/crypto-unit
+licenses:
+- MIT
+metadata: {}
+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: []
+rubyforge_project: 
+rubygems_version: 2.6.12
+signing_key: 
+specification_version: 4
+summary: Converts various BTC and LTC denominations
+test_files: []