qiniu_rails 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 951bcaaabf4916cde148a73220655fca777830f85a6a84452431031189fe7327
-  data.tar.gz: c8d16a925bd663d5db119eb4003ead716287f04a31f26ad15d3e3fa28064f6ff
+  metadata.gz: 699a3030b08ab1cb791159418bfb390fd4a3a041a554331c57c4d89fd9b16eb0
+  data.tar.gz: 243a8bad83670aceb3ee7ba963311d834bf09c373c77e91127aab08d7b37c14b
 SHA512:
-  metadata.gz: 4418d2b01656effd8fd64f15c7e8f831459b33e7b1cd0c2caa2182d15dea2eddc954b5c66cc9df3a2c356d552d3b2d69133e1659ac22ccb8df5a8bc35b3d45b6
-  data.tar.gz: bd32f965f8d6107aeaf8d25af920566701f46bda8b10a7463338a556abe975395202a2835bd49881bf535e16e98107f2766061182cc4a75e43e2d0e7c4456933
+  metadata.gz: 8f57cfb3f363426e8c7047bb0389827df7b61bec91bd690c29294bdb606f445bf1d183570c346afcbe0ecfb011ffccced37e1ed41126cedfb4a5877bfca53c34
+  data.tar.gz: f30f5daa0aca5b8c594baddfa1f94e490a08aa5729c3f1ff7263152534120ca3e3fc0d99083c402219d8bf2d0beef6b55a026baa56ddd16e7a395a156c10fb76

data/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/README.md

@@ -1,24 +1,49 @@
-# ActivestorageQiniu
-qiniu backend for activestore
+# Qiniu Rails
+qiniu backend for activestorage and more
 
+## Features
+* Qiniu backend for activestorage;
+* QiniuHelper for simple independent use;
+* Qiniu extends for sprockets
 
-## Usage
-
+## Config
 
 ```yaml
+# config/qiniu.yml
+default: &default
+  host: http://examples.com/
+  bucket: 
+  access_key: 
+  secret_key: 
+
+development:
+  <<: *default
+
+staging:
+  <<: *default
+
+test:
+  <<: *default
+
+production:
+  <<: *default
+  host: http://assets.yigexiangfa.com/
+  bucket: example
+  
+# config/storage.yml
 qiniu:
   service: Qiniu
   host: xxxx.com1.z0.glb.clouddn.com  
   access_key: iX6NuM1xN04Wdh-DogI0F3jLVpc-A4CsTHETssss
   secret_key: aN44R3yzJFaeswbyM4Y8YaJvnkmsssssssss
-  bucket: xxxx
+  bucket: xxxx  
 ```
 
 ## Installation
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'activestorage_qiniu'
+gem 'qiniu_rails'
 ```
 
 And then execute:
@@ -28,9 +53,16 @@ $ bundle
 
 Or install it yourself as:
 ```bash
-$ gem install activestorage_qiniu
+$ gem install qiniu_rails
 ```
 
+## Direct Upload
+* dependent on JS http client sdk `axios`, please add it to your rails project first;
+* then `require qiniu_direct_upload` in js file where you used qiniu direct upload;
+
+## Assets Sync(Sprockets) support
+* add `Sprockets.sync = 'qiniu'` to your initializers file
+
 ## Contributing
 Contribution directions go here.
 

data/lib/active_storage/analyzer/qiniu_image_analyzer.rb

@@ -0,0 +1,14 @@
+module ActiveStorage
+  class Analyzer
+    class QiniuImageAnalyzer < ImageAnalyzer
+
+      def metadata
+        code, result, res = Qiniu::HTTP.api_get(blob.service.url(blob.key, fop: 'imageInfo'))
+        result.symbolize_keys
+      rescue
+        {}
+      end
+
+    end
+  end
+end

data/lib/active_storage/analyzer/qiniu_video_analyzer.rb

@@ -0,0 +1,46 @@
+module ActiveStorage
+  class Analyzer
+    class QiniuVideoAnalyzer < VideoAnalyzer
+
+      def metadata
+        {
+          width: width,
+          height: height,
+          duration: duration,
+          aspect_ratio: aspect_ratio
+        }.compact
+      rescue
+        {}
+      end
+
+      private
+
+      def width
+        video_stream['width']
+      end
+
+      def height
+        video_stream['height']
+      end
+
+      def duration
+        video_stream['duration']
+      end
+
+      def aspect_ratio
+        video_stream['display_aspect_ratio']
+      end
+
+      def streams
+        @streams ||= begin
+          code, result, res = Qiniu::HTTP.api_get(blob.service.url(blob.key, fop: 'avinfo'))
+          result['streams']
+        end
+      end
+
+      def video_stream
+        @video_stream ||= streams.detect { |stream| stream['codec_type'] == 'video' } || {}
+      end
+    end
+  end
+end

data/lib/active_storage/service/qiniu_service.rb

@@ -1,17 +1,23 @@
 # frozen_string_literal: true
-require 'activestorage_qiniu/qiniu_common'
+require 'qiniu_rails/qiniu_common'
 
 module ActiveStorage
   # Wraps the Qiniu Cloud Storage as an Active Storage service. See ActiveStorage::Service for the generic API
   # documentation that applies to all services.
   class Service::QiniuService < Service
     include QiniuCommon
-    attr_reader :client
+    attr_reader :client, :protocol
 
     def initialize(host:, secret_key:, access_key:, bucket:, **options)
-      @client = Qiniu.establish_connection!(access_key: access_key, secret_key: secret_key)
       @host = host
       @bucket = bucket
+      @protocol = (options.delete(:protocol) || 'https').to_sym
+      @client = Qiniu.establish_connection!(
+        access_key: access_key,
+        secret_key: secret_key,
+        protocal: @protocal,
+        **options
+      )
     end
 
     def upload(key, io, checksum: nil, **options)
@@ -36,6 +42,12 @@ module ActiveStorage
       end
     end
 
+    def delete_prefixed(prefix)
+      instrument :delete_prefixed, prefix: prefix do
+        file_for(prefix).each { |item| delete item['key'] }
+      end
+    end
+
     def exist?(key)
       instrument :exist, key: key do |payload|
         answer = file_for(key)
@@ -43,14 +55,80 @@ module ActiveStorage
       end
     end
 
+    def download(key, &block)
+      if block_given?
+        instrument :streaming_download, key: key do
+          open(url(key, attname: key)) do |file|
+            while data = file.read(64.kilobytes)
+              yield data
+            end
+          end
+        end
+      else
+        instrument :download, key: key do
+          open(url(key, attname: key)).read
+        end
+      end
+    end
+
+    def download_chunk(key, range)
+      instrument :download_chunk, key: key, range: range do
+        uri = URI(url(key, attname: key))
+        Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |client|
+          client.get(uri, 'Range' => "bytes=#{range.begin}-#{range.exclude_end? ? range.end - 1 : range.end}").body
+        end
+      end
+    end
+
     def url(key, **options)
       instrument :url, key: key do |payload|
-        Qiniu::Auth.authorize_download_url_2(host, key)
+        if options[:filename].present?
+          options[:fop] ||= ''
+          options[:fop] = options[:fop] + '&' unless options[:fop].blank? || options[:fop].end_with?('&')
+          options[:fop] = options[:fop] + "attname=#{URI.escape(options[:filename].to_s)}"
+        end
+        url = Qiniu::Auth.authorize_download_url_2(host, key, fop: options[:fop], expires_in: options[:expires_in], schema: protocol)
+        payload[:url] = url
+        url
+      end
+    end
+
+    def url_for_direct_upload(key, expires_in:, content_type:, content_length:, checksum:)
+      instrument :url, key: key do |payload|
+        url = Qiniu::Config.up_host(bucket) + "/mkblk/#{content_length}"
+        payload[:url] = url
+        url
       end
     end
 
-    def headers_for_direct_upload(key, content_type:, checksum:, **)
-      { 'Content-Type' => content_type, 'Content-MD5' => checksum, 'x-token' => generate_uptoken(key) }
+    def headers_for_direct_upload(key, filename:, content_type:, content_length:, checksum:)
+      uptoken = generate_uptoken(key)
+      _url = url(key, filename: filename)
+      {
+        'Content-Type' => 'application/octet-stream',
+        'Content-MD5' => checksum,
+        'Authorization' => "UpToken #{uptoken}",
+        'Up-Token' => uptoken,
+        'Content-Url' => _url
+      }
+    end
+
+    def method_for_direct_upload
+      'POST'
+    end
+
+    private
+    # Reads the object for the given key in chunks, yielding each to the block.
+    def stream(key)
+      object = object_for(key)
+
+      chunk_size = 5.megabytes
+      offset = 0
+
+      while offset < object.content_length
+        yield object.get(range: "bytes=#{offset}-#{offset + chunk_size - 1}").body.read.force_encoding(Encoding::BINARY)
+        offset += chunk_size
+      end
     end
 
   end

data/lib/assets/javascripts/qiniu_direct_upload.js

@@ -0,0 +1,31 @@
+//= require axios/dist/axios.min
+addEventListener('direct-upload:before-blob-request', function(event){
+  var xhr = event.detail.xhr;
+  var file_size = event.detail.file.size;
+  xhr.addEventListener('load', function(event) {
+    var _headers = this.response.direct_upload.headers;
+    var key = this.response.key;
+    _headers['Content-Type'] = 'text/plain';
+    var url = 'http://up.qiniu.com/mkfile/' + file_size + '/key/' + btoa(key);
+    window.storage_options =  {
+      url: url,
+      headers: _headers
+    };
+  });
+});
+
+addEventListener('direct-upload:before-storage-request', function(event){
+  var xhr = event.detail.xhr;
+  xhr.addEventListener('load', function(event) {
+    var options = window.storage_options;
+    var res = JSON.parse(this.response);
+    options.method = 'post';
+    options.data = res.ctx;
+
+    axios(options).then(function(response) {
+      console.log(response);
+    }).catch(function(ex) {
+      console.log(ex);
+    })
+  });
+});

data/lib/qiniu_rails.rb

@@ -1,4 +1,13 @@
 require 'active_storage/service/qiniu_service'
+
+require 'active_storage/analyzer/qiniu_image_analyzer'
+require 'active_storage/analyzer/qiniu_video_analyzer'
+
+require 'qiniu_rails/sprockets'
+require 'qiniu_rails/engine'
+require 'qiniu_rails/variant'
+
 autoload :QiniuHelper, 'qiniu_rails/qiniu_helper'
+
 module QiniuRails
 end

data/lib/qiniu_rails/engine.rb

@@ -0,0 +1,21 @@
+module QiniuRails
+  class Engine < ::Rails::Engine
+
+    initializer 'qiniu_rails.variant' do
+      require 'active_storage/variant'
+      if ActiveStorage::Blob.service.is_a?(ActiveStorage::Service::QiniuService)
+        ActiveStorage::Variant.prepend QiniuRails::Variant
+      end
+    end
+
+    initializer 'qiniu_rails.analyzers' do |app|
+      if ActiveStorage::Blob.service.is_a?(ActiveStorage::Service::QiniuService)
+        app.config.active_storage.analyzers = [
+          ActiveStorage::Analyzer::QiniuImageAnalyzer,
+          ActiveStorage::Analyzer::QiniuVideoAnalyzer
+        ]
+      end
+    end
+
+  end
+end

data/lib/qiniu_rails/qiniu_common.rb

@@ -3,7 +3,6 @@ require 'qiniu'
 module QiniuCommon
   attr_reader :host, :bucket
 
-  private
   def upload_verbose(local_file, key = nil, **options)
     code, result, response_headers = Qiniu::Storage.upload_with_token_2(
       generate_uptoken(key, options),

data/lib/qiniu_rails/qiniu_helper.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 require 'qiniu'
-require 'activestorage_qiniu'
+require 'qiniu_rails/qiniu_common'
 
 module QiniuHelper
   extend QiniuCommon

data/lib/qiniu_rails/sprockets.rb

@@ -0,0 +1,14 @@
+require 'qiniu_rails/sprockets/qiniu_exporter'
+require 'qiniu_rails/sprockets/qiniu_non_digest_assets'
+
+module Sprockets
+
+  def self.sync
+    config[:sync]
+  end
+
+  def self.sync=(sync)
+    self.config = hash_reassoc(config, :sync) { sync.dup }
+  end
+
+end

data/lib/qiniu_rails/sprockets/qiniu_exporter.rb

@@ -0,0 +1,21 @@
+require 'sprockets/exporters/base'
+
+# Writes a an asset file to Qiniu
+class QiniuExporter < Sprockets::Exporters::Base
+
+  def skip?(logger)
+    if Sprockets.config[:sync].to_s == 'qiniu'
+      logger.info "==> To Upload to Qiniu: #{ target }"
+      false
+    else
+      true
+    end
+  end
+
+  def call
+    QiniuHelper.upload target, 'assets/' + asset.digest_path.to_s
+  end
+
+end
+
+Sprockets.register_exporter '*/*', QiniuExporter

data/lib/qiniu_rails/sprockets/qiniu_non_digest_assets.rb

@@ -0,0 +1,31 @@
+require 'sprockets/manifest'
+
+module QiniuNonDigestAssets
+
+  def compile(*args)
+    super
+
+    environment.paths.find_all { |i| i.include? 'nondigest_assets' }.each do |src|
+      if Sprockets.config[:sync].to_s == 'qiniu'
+        f_src = src.to_s + '/**/*'
+        path_src = Pathname.new src
+        Dir.glob(f_src).select { |f| File.file?(f) }.each do |file|
+          key = Pathname.new(file).relative_path_from(path_src)
+          QiniuHelper.upload file, 'assets/' + key.to_s
+        end
+      end
+    end
+  end
+
+  def remove(filename)
+    super
+
+    if Sprockets.config[:sync].to_s == 'qiniu'
+      QiniuHelper.delete 'assets/' + filename.to_s
+      logger.info "--> Removed from Qiniu: #{ filename }"
+    end
+  end
+
+end
+
+Sprockets::Manifest.send(:prepend, QiniuNonDigestAssets)

data/lib/qiniu_rails/variant.rb

@@ -0,0 +1,18 @@
+module QiniuRails::Variant
+
+  def key
+    "#{blob.key}"
+  end
+
+  def mode_1
+    h, w = variation.transformations.fetch(:resize, '35x35').split('x')
+    "imageView2/1/w/#{w}/h/#{h}"
+  end
+
+  def service_url(expires_in: service.url_expires_in, disposition: :inline)
+    service.url key, fop: mode_1, expires_in: expires_in, disposition: disposition, filename: filename, content_type: content_type
+  end
+
+end
+
+

data/lib/qiniu_rails/version.rb

@@ -1,3 +1,3 @@
 module QiniuRails
-  VERSION = '0.1.0'
+  VERSION = '1.0.0'
 end

metadata

@@ -1,29 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: qiniu_rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - qinmingyuan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-18 00:00:00.000000000 Z
+date: 2018-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: activestorage
+  name: qiniu
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.2.0.rc1
+        version: '6.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.2.0.rc1
+        version: '6.9'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
 description: Description of ActivestorageQiniu.
 email:
 - mingyuan0715@foxmail.com
@@ -31,18 +45,26 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- MIT-LICENSE
+- LICENSE
 - README.md
 - Rakefile
+- lib/active_storage/analyzer/qiniu_image_analyzer.rb
+- lib/active_storage/analyzer/qiniu_video_analyzer.rb
 - lib/active_storage/service/qiniu_service.rb
+- lib/assets/javascripts/qiniu_direct_upload.js
 - lib/qiniu_rails.rb
+- lib/qiniu_rails/engine.rb
 - lib/qiniu_rails/qiniu_common.rb
 - lib/qiniu_rails/qiniu_helper.rb
+- lib/qiniu_rails/sprockets.rb
+- lib/qiniu_rails/sprockets/qiniu_exporter.rb
+- lib/qiniu_rails/sprockets/qiniu_non_digest_assets.rb
+- lib/qiniu_rails/variant.rb
 - lib/qiniu_rails/version.rb
 - lib/tasks/activestorage_qiniu_tasks.rake
 homepage: https://github.com/qinmingyuan/qiniu_rails
 licenses:
-- MIT
+- LGPL-3.0
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -60,8 +82,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.3
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
-summary: qiniu backend for activestore
+summary: qiniu backend for activestorage
 test_files: []

data/MIT-LICENSE

@@ -1,20 +0,0 @@
-Copyright 2017 qinmingyuan
-
-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.