MrMurano 1.6.3 → 1.7.0

data/spec/Solution-ServiceConfig_spec.rb

@@ -0,0 +1,198 @@
+require 'MrMurano/version'
+require 'MrMurano/Solution-ServiceConfig'
+require 'tempfile'
+
+RSpec.describe MrMurano::ServiceConfig do
+  before(:example) do
+    $cfg = MrMurano::Config.new
+    $cfg.load
+    $cfg['net.host'] = 'bizapi.hosted.exosite.io'
+    $cfg['solution.id'] = 'XYZ'
+
+    @srv = MrMurano::ServiceConfig.new
+    allow(@srv).to receive(:token).and_return("TTTTTTTTTT")
+  end
+
+  it "initializes" do
+    uri = @srv.endPoint('/')
+    expect(uri.to_s).to eq("https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/")
+  end
+
+  it "lists" do
+    body = {:items=>[{:id=>"9K0",
+             :name=>"debug",
+             :alias=>"XYZ_debug",
+             :solution_id=>"XYZ",
+             :service=>"device",
+             :status=>"ready",
+             :created_at=>"2016-07-07T19:16:19.479Z",
+             :updated_at=>"2016-09-12T13:26:55.868Z",
+             :deleted_at=>nil}],
+            :total=>1}
+    stub_request(:get, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig").
+      with(:headers=>{'Authorization'=>'token TTTTTTTTTT',
+                      'Content-Type'=>'application/json'}).
+      to_return(body: body.to_json)
+
+    ret = @srv.list()
+    expect(ret).to eq(body[:items])
+  end
+
+  it "fetches" do
+    body = {:id=>"9K0",
+             :name=>"debug",
+             :alias=>"XYZ_debug",
+             :solution_id=>"XYZ",
+             :service=>"device",
+             :status=>"ready",
+             :created_at=>"2016-07-07T19:16:19.479Z",
+             :updated_at=>"2016-09-12T13:26:55.868Z"
+    }
+    stub_request(:get, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/9K0").
+      with(:headers=>{'Authorization'=>'token TTTTTTTTTT',
+                      'Content-Type'=>'application/json'}).
+      to_return(body: body.to_json)
+
+    ret = @srv.fetch('9K0')
+    expect(ret).to eq(body)
+  end
+
+  it "gets id from service" do
+    body = {:items=>[{:id=>"9K0",
+             :name=>"debug",
+             :alias=>"XYZ_debug",
+             :solution_id=>"XYZ",
+             :service=>"device",
+             :status=>"ready",
+             :created_at=>"2016-07-07T19:16:19.479Z",
+             :updated_at=>"2016-09-12T13:26:55.868Z",
+             :deleted_at=>nil}],
+            :total=>1}
+    stub_request(:get, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig").
+      with(:headers=>{'Authorization'=>'token TTTTTTTTTT',
+                      'Content-Type'=>'application/json'}).
+      to_return(body: body.to_json)
+
+    ret = @srv.scid_for_name('device')
+    expect(ret).to eq("9K0")
+  end
+
+  it "gets nil if not there" do
+    body = {:items=>[{:id=>"9K0",
+             :name=>"debug",
+             :alias=>"XYZ_debug",
+             :solution_id=>"XYZ",
+             :service=>"device",
+             :status=>"ready",
+             :created_at=>"2016-07-07T19:16:19.479Z",
+             :updated_at=>"2016-09-12T13:26:55.868Z",
+             :deleted_at=>nil}],
+            :total=>1}
+    stub_request(:get, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig").
+      with(:headers=>{'Authorization'=>'token TTTTTTTTTT',
+                      'Content-Type'=>'application/json'}).
+      to_return(body: body.to_json)
+
+    ret = @srv.scid_for_name('debug')
+    expect(ret).to eq(nil)
+  end
+
+  it "gets info" do
+    body = {:calls=>{:daily=>0, :monthly=>0, :total=>0}}
+    stub_request(:get, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/9K0/info").
+      with(:headers=>{'Authorization'=>'token TTTTTTTTTT',
+                      'Content-Type'=>'application/json'}).
+      to_return(body: body.to_json)
+
+    ret = @srv.info('9K0')
+    expect(ret).to eq(body)
+  end
+
+  context "calls" do
+    before(:example) do
+      allow(@srv).to receive(:scid).and_return("9K0")
+    end
+    it "a get" do
+      body = {:calls=>{:daily=>0, :monthly=>0, :total=>0}}
+      stub_request(:get, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/9K0/call/info").
+        with(:headers=>{'Authorization'=>'token TTTTTTTTTT',
+                        'Content-Type'=>'application/json'}).
+                        to_return(body: body.to_json)
+
+      ret = @srv.call(:info)
+      expect(ret).to eq(body)
+    end
+
+    it "a get with query" do
+      body = {:calls=>{:daily=>0, :monthly=>0, :total=>0}}
+      stub_request(:get, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/9K0/call/ask?q=what").
+        with(:headers=>{'Authorization'=>'token TTTTTTTTTT',
+                        'Content-Type'=>'application/json'}).
+                        to_return(body: body.to_json)
+
+      ret = @srv.call(:ask, :get, {:q=>'what'})
+      expect(ret).to eq(body)
+    end
+
+    it "a post" do
+      body = {:calls=>{:daily=>0, :monthly=>0, :total=>0}}
+      stub_request(:post, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/9K0/call/ask").
+        with(:body => JSON.generate({:q=> 'what'}),
+          :headers=>{'Authorization'=>'token TTTTTTTTTT',
+                        'Content-Type'=>'application/json'}).
+                        to_return(body: body.to_json)
+
+      ret = @srv.call(:ask, :post, {:q=>'what'})
+      expect(ret).to eq(body)
+    end
+
+    it "a post without data" do
+      body = {:calls=>{:daily=>0, :monthly=>0, :total=>0}}
+      stub_request(:post, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/9K0/call/ask").
+        with(:body => JSON.generate({}),
+          :headers=>{'Authorization'=>'token TTTTTTTTTT',
+                        'Content-Type'=>'application/json'}).
+                        to_return(body: body.to_json)
+
+      ret = @srv.call(:ask, :post)
+      expect(ret).to eq(body)
+    end
+
+    it "a put" do
+      body = {:calls=>{:daily=>0, :monthly=>0, :total=>0}}
+      stub_request(:put, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/9K0/call/ask").
+        with(:body => JSON.generate({:q=> 'what'}),
+          :headers=>{'Authorization'=>'token TTTTTTTTTT',
+                        'Content-Type'=>'application/json'}).
+                        to_return(body: body.to_json)
+
+      ret = @srv.call(:ask, :put, {:q=>'what'})
+      expect(ret).to eq(body)
+    end
+
+    it "a put without data" do
+      body = {:calls=>{:daily=>0, :monthly=>0, :total=>0}}
+      stub_request(:put, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/9K0/call/ask").
+        with(:body => JSON.generate({}),
+          :headers=>{'Authorization'=>'token TTTTTTTTTT',
+                        'Content-Type'=>'application/json'}).
+                        to_return(body: body.to_json)
+
+      ret = @srv.call(:ask, :put)
+      expect(ret).to eq(body)
+    end
+
+    it "a delete" do
+      body = {:calls=>{:daily=>0, :monthly=>0, :total=>0}}
+      stub_request(:delete, "https://bizapi.hosted.exosite.io/api:1/solution/XYZ/serviceconfig/9K0/call/gone").
+        with(:headers=>{'Authorization'=>'token TTTTTTTTTT',
+                        'Content-Type'=>'application/json'}).
+                        to_return(body: body.to_json)
+
+      ret = @srv.call(:gone, :delete)
+      expect(ret).to eq(body)
+    end
+  end
+
+end
+#  vim: set ai et sw=2 ts=2 :

data/spec/SyncRoot_spec.rb

@@ -0,0 +1,74 @@
+require 'MrMurano/version'
+require 'MrMurano/Config'
+require 'MrMurano/SyncUpDown'
+
+RSpec.describe MrMurano::SyncRoot do
+
+  after(:example) do
+    MrMurano::SyncRoot.reset
+  end
+
+  it "Adds" do
+    class User
+    end
+    class Role
+    end
+    MrMurano::SyncRoot.add('user', User, 'U', "describe user")
+    MrMurano::SyncRoot.add('role', Role, 'R', "describe role")
+  end
+
+  context "b" do
+    before(:example) do
+      class User
+      end
+      class Role
+      end
+      MrMurano::SyncRoot.add('user', User, 'U', "describe user", true)
+      MrMurano::SyncRoot.add('role', Role, 'R', "describe role")
+
+      @options = {}
+      @options.define_singleton_method(:method_missing) do |mid,*args|
+        if mid.to_s.match(/^(.+)=$/) then
+          self[$1.to_sym] = args.first
+        else
+          self[mid]
+        end
+      end
+
+    end
+
+    it "iterrates on each" do
+      ret=[]
+      MrMurano::SyncRoot.each{|a,b,c| ret << a}
+      expect(ret).to eq(["user", "role"])
+    end
+
+    it "iterrates only on selected" do
+      @options.role = true
+      ret=[]
+      MrMurano::SyncRoot.each_filtered(@options) {|a,b,c| ret << a}
+      expect(ret).to eq(["role"])
+    end
+
+    it "selects all" do
+      @options.all = true
+      MrMurano::SyncRoot.checkSAME(@options)
+      expect(@options).to eq({:all=>true, :user=>true, :role=>true})
+    end
+
+    it "selects defaults when none" do
+      MrMurano::SyncRoot.checkSAME(@options)
+      expect(@options).to eq({:user=>true})
+    end
+
+    it "builds option params" do
+      ret=[]
+      MrMurano::SyncRoot.each_option do |s,l,d|
+        ret << [s,l,d]
+      end
+      expect(ret).to eq([["-u", "--[no-]user", "describe user"], ["-r", "--[no-]role", "describe role"]])
+    end
+
+  end
+end
+#  vim: set ai et sw=2 ts=2 :

data/spec/cmd_config_spec.rb

@@ -0,0 +1,51 @@
+require 'tmpdir'
+require 'open3'
+require 'fileutils'
+
+RSpec.describe 'mr config' do
+
+  pref = "ruby -Ilib bin/"
+  around(:example) do |ex|
+    Dir.mktmpdir do |dir|
+      @tmpdir = dir
+      ex.run
+    end
+  end
+
+  it "Needs a key" do
+    out, err, status = Open3.capture3("#{pref}mr config")
+    expect(status).to eq(0)
+    expect(out).to eq("\e[31mNeed a config key\e[0m\n")
+    expect(err).to eq('')
+  end
+
+  it "Sets a key" do
+    out, err, status = Open3.capture3("#{pref}mr config bob build")
+    expect(status).to eq(0)
+    expect(out).to eq('')
+    expect(err).to eq('')
+  end
+
+  it "Reads a key" do
+    FileUtils.copy_file 'spec/fixtures/.mrmuranorc', File.join(@tmpdir, '.mrmuranorc'), :verbose => true
+    out, err, status = Open3.capture3("#{pref}mr config --project doThisTest.bob")
+    expect(status).to eq(0)
+    expect(out).to eq('')
+    expect(err).to eq('')
+  end
+
+  it "Removes a key" do
+    rcf = File.join(@tmpdir, '.mrmuranorc')
+    FileUtils.copy_file 'spec/fixtures/.mrmuranorc', rcf, :verbose => true
+    out, err, status = Open3.capture3(%{#{pref}mr config --project --unset doThisTest.bob})
+    expect(status).to eq(0)
+    expect(out).to eq('')
+    expect(err).to eq('')
+
+    afile = IO.read(rcf)
+    bfile = IO.read('spec/fixtures/.mrmuranorc')
+    expect(afile).to eq(bfile)
+  end
+end
+
+#  vim: set ai et sw=2 ts=2 :

data/spec/fixtures/.mrmuranorc

@@ -0,0 +1,9 @@
+[solution]
+id = XXXXXXXXXX
+
+[doThisTest]
+bob = build
+
+[s-fDEADBEEFGAEG]
+spec = bobo.yaml
+

data/spec/fixtures/mrmuranorc_deleted_bob

@@ -0,0 +1,8 @@
+[solution]
+id = XXXXXXXXXX
+
+[doThisTest]
+
+[s-fDEADBEEFGAEG]
+spec = bobo.yaml
+

data/spec/fixtures/product_spec_files/example.exoline.spec.yaml

@@ -0,0 +1,116 @@
+
+# Example client specification file
+# Specification files are in YAML format (a superset of JSON
+# with more readable syntax and support for comments) and
+# look like this. They may contain comments that begin
+# with a # sign.
+
+# Device client model information
+device:
+    model: "myModel"
+    vendor: "myVendor"
+
+# list of dataports that must exist
+dataports:
+      # this the absolute minimum needed to specify a
+      # dataport.
+    - alias: mystring
+      # names are created, but not compared
+    - name: Temperature
+      # aliases, type, and format are created
+      # and compared
+      alias: temp
+      format: float
+      unit: °F
+    - name: LED Control
+      alias: led6
+      format: integer
+    - alias: config
+      # format should be string, and parseable JSON
+      format: string/json
+      # initial value (if no other value is read back)
+      initial: '{"text": "555-555-1234", "email": "jeff@555.com"}'
+    - alias: person
+      format: string/json
+      # JSON schema specified inline (http://json-schema.org/)
+      # format must be string/json to do validate
+      # you may also specify a string to reference schema in an
+      # external file. E.g. jsonschema: personschema.json
+      jsonschema: {"title": "Person Schema",
+                   "type": "object",
+                   "properties": {"name": {"type": "string"}},
+                   "required": ["name"]}
+      initial: '{"name":"John Doe"}'
+    - alias: place
+      # An description of the dataport.
+      description: 'This is a place I have been'
+      # Dataports are not public by default,
+      # but if you want to share one with the world
+      public: true
+
+    # any dataports not listed but found in the client
+    # are ignored. The spec command does not delete things.
+
+# list of script datarules that must exist
+scripts:
+    # by default, scripts are datarules with
+    # names and aliases set to the file name
+    - file: test/files/helloworld.lua
+    # you can also set them explicitly
+    - file: test/files/helloworld.lua
+      alias: greeting
+    # you can also place lua code inline
+    - alias: singleLineScript
+      code: debug('hello from inside lua!')
+    # multiline lua scripts should start with | and
+    # be indented inside the "code:" key.
+    - alias: multilineScript
+      code: |
+        for x=1,10 do
+            debug('hello from for loop ' .. x)
+        end
+    # simple templating for script aliases and
+    # content is also supported.
+    - file: test/files/convert.lua
+      # if <% id %> is embedded in aliases
+      # or script content, the --ids parameter must
+      # be passed in. The spec command then expects
+      # a script or dataport resource per id passed, substituting
+      # each ID for <% id %>. In this example, if the command was:
+      #
+      # $ exo spec mysensor sensorspec.yaml --ids=A,B
+      #
+      # ...then the spec command looks for *two* script datarules
+      # in mysensor, with aliases convertA.lua and convertB.lua.
+      # Additionally, any instances of <% id %> in the content of
+      # convert.lua are substituted with A and B before being
+      # written to each script datarule.
+      #
+      alias: convert<% id %>.lua
+
+# list of dispatches that must exist
+dispatches:
+    - alias: myDispatch
+      # email | http_get | http_post | http_put | sms | xmpp
+      method: email
+      recipient: support@exosite.com
+      message: hello from Exoline spec example!
+      subject: hello!
+      # may be an RID or alias
+      subscribe: mystring
+
+# list of simple datarules that must exist.
+# scripts may go here too, but it's better to
+# to put them under scripts (above)
+datarules:
+    - alias: highTemp
+      format: float
+      subscribe: temp
+      rule: {
+        "simple": {
+          "comparison": "gt",
+          "constant": 80,
+          "repeat": true
+        }
+      }
+

data/spec/fixtures/product_spec_files/example.murano.spec.yaml

@@ -0,0 +1,14 @@
+---
+resources:
+- alias: mystring
+- alias: temp
+  format: float
+- alias: led6
+  format: integer
+- alias: config
+  format: string
+  initial: '{"text": "555-555-1234", "email": "jeff@555.com"}'
+- alias: person
+  format: string
+  initial: '{"name":"John Doe"}'
+- alias: place

data/spec/fixtures/product_spec_files/gwe.exoline.spec.yaml

@@ -0,0 +1,21 @@
+---
+dataports:
+    - alias: engine_fetch
+      format: string/json
+    - alias: sensors_report
+      format: string/json
+    - alias: update_interval
+      format: string
+    - alias: device_info
+      format: string/json
+    - alias: usage_report
+      format: string/json
+    - alias: fetch_status
+      format: string/json
+    - alias: engine_report
+      format: string/json
+      jsonschema: {"title": "Person Schema",
+                   "type": "object",
+                   "properties": {"name": {"type": "string"}},
+                   "required": ["name"]}
+

data/spec/fixtures/product_spec_files/gwe.murano.spec.yaml

@@ -0,0 +1,16 @@
+---
+resources:
+- alias: engine_fetch
+  format: string
+- alias: sensors_report
+  format: string
+- alias: update_interval
+  format: string
+- alias: device_info
+  format: string
+- alias: usage_report
+  format: string
+- alias: fetch_status
+  format: string
+- alias: engine_report
+  format: string

data/spec/spec_helper.rb

@@ -51,18 +51,18 @@ RSpec.configure do |config|
 
 # The settings below are suggested to provide a good initial experience
 # with RSpec, but feel free to customize to your heart's content.
-=begin
+
   # This allows you to limit a spec run to individual examples or groups
   # you care about by tagging them with `:focus` metadata. When nothing
   # is tagged with `:focus`, all examples get run. RSpec also provides
   # aliases for `it`, `describe`, and `context` that include `:focus`
   # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
-  config.filter_run_when_matching :focus
+  #config.filter_run_when_matching :focus
 
   # Allows RSpec to persist some state between runs in order to support
   # the `--only-failures` and `--next-failure` CLI options. We recommend
   # you configure your source control system to ignore this file.
-  config.example_status_persistence_file_path = "spec/examples.txt"
+  #config.example_status_persistence_file_path = "spec/examples.txt"
 
   # Limits the available syntax to the non-monkey patched syntax that is
   # recommended. For more details, see:
@@ -101,5 +101,5 @@ RSpec.configure do |config|
   # test failures related to randomization by passing the same `--seed` value
   # as the one that triggered the failure.
   Kernel.srand config.seed
-=end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: MrMurano
 version: !ruby/object:Gem::Version
-  version: 1.6.3
+  version: 1.7.0
 platform: ruby
 authors:
 - Michael Conrad Tadpol Tilstra
@@ -24,6 +24,20 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: 4.4.0
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.8
 - !ruby/object:Gem::Dependency
   name: terminal-table
   requirement: !ruby/object:Gem::Requirement
@@ -94,20 +108,6 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.0.1
-- !ruby/object:Gem::Dependency
-  name: rainbow
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 2.1.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 2.1.0
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement
@@ -200,16 +200,20 @@ files:
 - lib/MrMurano.rb
 - lib/MrMurano/Account.rb
 - lib/MrMurano/Config.rb
+- lib/MrMurano/Product-Resources.rb
 - lib/MrMurano/Product.rb
+- lib/MrMurano/Solution-Cors.rb
 - lib/MrMurano/Solution-Endpoint.rb
 - lib/MrMurano/Solution-File.rb
 - lib/MrMurano/Solution-ServiceConfig.rb
 - lib/MrMurano/Solution-Services.rb
 - lib/MrMurano/Solution-Users.rb
 - lib/MrMurano/Solution.rb
+- lib/MrMurano/SyncUpDown.rb
 - lib/MrMurano/commands.rb
 - lib/MrMurano/commands/account.rb
 - lib/MrMurano/commands/assign.rb
+- lib/MrMurano/commands/completion.rb
 - lib/MrMurano/commands/config.rb
 - lib/MrMurano/commands/content.rb
 - lib/MrMurano/commands/cors.rb
@@ -229,6 +233,8 @@ files:
 - lib/MrMurano/commands/status.rb
 - lib/MrMurano/commands/sync.rb
 - lib/MrMurano/commands/timeseries.rb
+- lib/MrMurano/commands/tsdb.rb
+- lib/MrMurano/commands/zshcomplete.erb
 - lib/MrMurano/hash.rb
 - lib/MrMurano/http.rb
 - lib/MrMurano/makePretty.rb
@@ -240,12 +246,23 @@ files:
 - spec/MakePretties_spec.rb
 - spec/ProductBase_spec.rb
 - spec/ProductContent_spec.rb
+- spec/ProductResources_spec.rb
 - spec/Product_spec.rb
+- spec/Solution-Cors_spec.rb
+- spec/Solution-ServiceConfig_spec.rb
 - spec/Solution-ServiceEventHandler_spec.rb
 - spec/Solution-ServiceModules_spec.rb
-- spec/lightbulb.yaml
+- spec/SyncRoot_spec.rb
+- spec/cmd_config_spec.rb
+- spec/fixtures/.mrmuranorc
+- spec/fixtures/configfile
+- spec/fixtures/mrmuranorc_deleted_bob
+- spec/fixtures/product_spec_files/example.exoline.spec.yaml
+- spec/fixtures/product_spec_files/example.murano.spec.yaml
+- spec/fixtures/product_spec_files/gwe.exoline.spec.yaml
+- spec/fixtures/product_spec_files/gwe.murano.spec.yaml
+- spec/fixtures/product_spec_files/lightbulb.yaml
 - spec/spec_helper.rb
-- spec/testfiles/configfile
 homepage: https://github.com/tadpol/MrMurano
 licenses:
 - MIT
@@ -277,9 +294,20 @@ test_files:
 - spec/MakePretties_spec.rb
 - spec/ProductBase_spec.rb
 - spec/ProductContent_spec.rb
+- spec/ProductResources_spec.rb
 - spec/Product_spec.rb
+- spec/Solution-Cors_spec.rb
+- spec/Solution-ServiceConfig_spec.rb
 - spec/Solution-ServiceEventHandler_spec.rb
 - spec/Solution-ServiceModules_spec.rb
-- spec/lightbulb.yaml
+- spec/SyncRoot_spec.rb
+- spec/cmd_config_spec.rb
+- spec/fixtures/.mrmuranorc
+- spec/fixtures/configfile
+- spec/fixtures/mrmuranorc_deleted_bob
+- spec/fixtures/product_spec_files/example.exoline.spec.yaml
+- spec/fixtures/product_spec_files/example.murano.spec.yaml
+- spec/fixtures/product_spec_files/gwe.exoline.spec.yaml
+- spec/fixtures/product_spec_files/gwe.murano.spec.yaml
+- spec/fixtures/product_spec_files/lightbulb.yaml
 - spec/spec_helper.rb
-- spec/testfiles/configfile