actionpack 5.2.7.1 → 6.0.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35274ebf243c146d9a4f8149f58fc852b8fa419d0d98fe5d25c93c2ffb849ac7
-  data.tar.gz: c3a86d6c25830b42c0dafa3e82322645fda469867cebe955cd58bd8d17081edd
+  metadata.gz: df5b083c08009f1025bfbf541400a4819b5620f5bb49aa3d4bbe0c056eae44b3
+  data.tar.gz: '0374579e1273c1d727e0bc94d7a73b3933d8c0f54e7196beedc61ea30d88209f'
 SHA512:
-  metadata.gz: c548347dc7b568341963f1f19fff93422e6a01100ca15704d43ec7832094be42036dfe08004663cc0aa6e6dfade65c1c6a7c7aa99fdac3476f4feec65dcb8738
-  data.tar.gz: f379d596f2899db4ff5f80a317d44bbb0eed5e67af7d208b97b148a566c53b51b586c960051aff203593985b35ac95ae1272a67f78366336e8244263dd001dd9
+  metadata.gz: cb0e467dc8c10baa42df2d08d79b2f5caedad996d247523abf54713a542f6d49a01f120ca0b0faa6930ea89592bfe074979201adec97d33135a5877391a5d4bb
+  data.tar.gz: dee5cf35ce9af7e795d65bb2a44d5edb229439f5fbde0dde1c35e8d3cf2564c49ddf929a9d5499b3aa6248c42cf6f61ca2c75c85a623ba51f1dd6106750d3267

data/CHANGELOG.md

@@ -1,148 +1,66 @@
-## Rails 5.2.7.1 (April 26, 2022) ##
+## Rails 6.0.0.beta1 (January 18, 2019) ##
 
-*   Allow Content Security Policy DSL to generate for API responses.
+*   Remove deprecated `fragment_cache_key` helper in favor of `combined_fragment_cache_key`.
 
-    *Tim Wade*
-
-## Rails 5.2.7 (March 10, 2022) ##
-
-*   No changes.
-
-## Rails 5.2.6.3 (March 08, 2022) ##
-
-*   No changes.
-
-
-## Rails 5.2.6.2 (February 11, 2022) ##
-
-*   No changes.
+    *Rafael Mendonça França*
 
+*   Remove deprecated methods in `ActionDispatch::TestResponse`.
 
-## Rails 5.2.6.1 (February 11, 2022) ##
+    `#success?`, `missing?` and `error?` were deprecated in Rails 5.2 in favor of
+    `#successful?`, `not_found?` and `server_error?`.
 
-*   Under certain circumstances, the middleware isn't informed that the
-    response body has been fully closed which result in request state not
-    being fully reset before the next request
+    *Rafael Mendonça França*
 
-    [CVE-2022-23633]
+*   Ensure external redirects are explicitly allowed
 
+    Add `fallback_location` and `allow_other_host` options to `redirect_to`.
 
-## Rails 5.2.6 (May 05, 2021) ##
+    *Gannon McGibbon*
 
-*   Accept base64_urlsafe CSRF tokens to make forward compatible.
+*   Introduce ActionDispatch::HostAuthorization
 
-    Base64 strict-encoded CSRF tokens are not inherently websafe, which makes
-    them difficult to deal with. For example, the common practice of sending
-    the CSRF token to a browser in a client-readable cookie does not work properly
-    out of the box: the value has to be url-encoded and decoded to survive transport.
+    This is a new middleware that guards against DNS rebinding attacks by
+    white-listing the allowed hosts a request can be made to.
 
-    In this version, we generate Base64 urlsafe-encoded CSRF tokens, which are inherently
-    safe to transport. Validation accepts both urlsafe tokens, and strict-encoded
-    tokens for backwards compatibility.
+    Each host is checked with the case operator (`#===`) to support `RegExp`,
+    `Proc`, `IPAddr` and custom objects as host allowances.
 
-    How the tokes are encoded is controllr by the `action_controller.urlsafe_csrf_tokens`
-    config.
+    *Genadi Samokovarov*
 
-    In Rails 5.2.5, the CSRF token format was accidentally changed to urlsafe-encoded.
+*   Allow using `parsed_body` in `ActionController::TestCase`.
 
-    **Atention**: If you already upgraded your application to 5.2.5, set the config
-    `urlsafe_csrf_tokens` to `true`, otherwise your form submission will start to fail
-    during the deploy of this new version.
+    In addition to `ActionDispatch::IntegrationTest`, allow using
+    `parsed_body` in `ActionController::TestCase`:
 
-    ```ruby
-    Rails.application.config.action_controller.urlsafe_csrf_tokens = true
+    ```
+    class SomeControllerTest < ActionController::TestCase
+      def test_some_action
+        post :action, body: { foo: 'bar' }
+        assert_equal({ "foo" => "bar" }, response.parsed_body)
+      end
+    end
     ```
 
-    If you are upgrading from 5.2.4.x, you don't need to change this configuration.
-
-    *Scott Blum*, *Étienne Barrié*
-
-
-## Rails 5.2.5 (March 26, 2021) ##
-
-*   No changes.
-
-
-## Rails 5.2.4.6 (May 05, 2021) ##
-
-*   Prevent regex DoS in HTTP token authentication
-    CVE-2021-22904
+    Fixes #34676.
 
-*   Prevent string polymorphic route arguments.
+    *Tobias Bühlmann*
 
-    `url_for` supports building polymorphic URLs via an array
-    of arguments (usually symbols and records). If a developer passes a
-    user input array, strings can result in unwanted route helper calls.
+*   Raise an error on root route naming conflicts.
 
-    CVE-2021-22885
+    Raises an ArgumentError when multiple root routes are defined in the
+    same context instead of assigning nil names to subsequent roots.
 
     *Gannon McGibbon*
 
-## Rails 5.2.4.5 (February 10, 2021) ##
-
-*   No changes.
-
-
-## Rails 5.2.4.4 (September 09, 2020) ##
-
-*   No changes.
-
-
-## Rails 5.2.4.3 (May 18, 2020) ##
-
-*   [CVE-2020-8166] HMAC raw CSRF token before masking it, so it cannot be used to reconstruct a per-form token
-
-*   [CVE-2020-8164] Return self when calling #each, #each_pair, and #each_value instead of the raw @parameters hash
-
-
-## Rails 5.2.4.2 (March 19, 2020) ##
-
-*   No changes.
-
-
-## Rails 5.2.4.1 (December 18, 2019) ##
-
-*   Fix possible information leak / session hijacking vulnerability.
-
-    The `ActionDispatch::Session::MemcacheStore` is still vulnerable given it requires the
-    gem dalli to be updated as well.
-
-    _Breaking changes:_
-    *   `session.id` now returns an instance of `Rack::Session::SessionId` and not a String (use `session.id.public_id` to restore the old behaviour, see #38063)
-    *   Accessing the session id using `session[:session_id]`/`session['session_id']` no longer works with
-        ruby 2.2 (see https://github.com/rails/rails/commit/2a52a38cb51b65d71cf91fc960777213cf96f962#commitcomment-37929811)
-
-    CVE-2019-16782.
-
-
-## Rails 5.2.4 (November 27, 2019) ##
-
-*   No changes.
-
-
-## Rails 5.2.3 (March 27, 2019) ##
-
-*   Allow using `public` and `no-cache` together in the the Cache Control header.
-
-    Before this change, even if `public` was specified in the Cache Control header,
-    it was excluded when `no-cache` was included. This change preserves the
-    `public` value as is.
-
-    Fixes #34780.
-
-    *Yuji Yaginuma*
-
-*   Allow `nil` params for `ActionController::TestCase`.
-
-    *Ryo Nakamura*
-
-
-## Rails 5.2.2.1 (March 11, 2019) ##
-
-*   No changes.
+*   Allow rescue from parameter parse errors:
 
+    ```
+    rescue_from ActionDispatch::Http::Parameters::ParseError do
+      head :unauthorized
+    end
+    ```
 
-## Rails 5.2.2 (December 04, 2018) ##
+    *Gannon McGibbon*, *Josh Cheek*
 
 *   Reset Capybara sessions if failed system test screenshot raising an exception.
 
@@ -178,402 +96,121 @@
 
     *Andrew White*
 
-*   Fix `rails routes -c` for controller name consists of multiple word.
-
-    *Yoshiyuki Kinjo*
-
-*   Call the `#redirect_to` block in controller context.
-
-    *Steven Peckins*
-
-
-## Rails 5.2.1.1 (November 27, 2018) ##
-
-*   No changes.
-
-
-## Rails 5.2.1 (August 07, 2018) ##
-
-*   Prevent `?null=` being passed on JSON encoded test requests.
-
-    `RequestEncoder#encode_params` won't attempt to parse params if
-    there are none.
-
-    So call like this will no longer append a `?null=` query param.
-
-        get foos_url, as: :json
-
-    *Alireza Bashiri*
-
-*   Ensure `ActionController::Parameters#transform_values` and
-    `ActionController::Parameters#transform_values!` converts hashes into
-    parameters.
-
-    *Kevin Sjöberg*
-
-*   Fix strong parameters `permit!` with nested arrays.
-
-    Given:
-    ```
-    params = ActionController::Parameters.new(nested_arrays: [[{ x: 2, y: 3 }, { x: 21, y: 42 }]])
-    params.permit!
-    ```
-
-    `params[:nested_arrays][0][0].permitted?` will now return `true` instead of `false`.
-
-    *Steve Hull*
-
-*   Reset `RAW_POST_DATA` and `CONTENT_LENGTH` request environment between test requests in
-    `ActionController::TestCase` subclasses.
-
-    *Eugene Kenny*
-
-*   Output only one Content-Security-Policy nonce header value per request.
-
-    Fixes #32597.
-
-    *Andrey Novikov*, *Andrew White*
-
-*   Only disable GPUs for headless Chrome on Windows.
-
-    It is not necessary anymore for Linux and macOS machines.
-
-    https://bugs.chromium.org/p/chromium/issues/detail?id=737678#c1
-
-    *Stefan Wrobel*
-
-*   Fix system tests transactions not closed between examples.
-
-    *Sergey Tarasov*
-
-
-## Rails 5.2.0 (April 09, 2018) ##
-
-*   Check exclude before flagging cookies as secure.
-
-    *Catherine Khuu*
-
-*   Always yield a CSP policy instance from `content_security_policy`
-
-    This allows a controller action to enable the policy individually
-    for a controller and/or specific actions.
-
-    *Andrew White*
-
-*   Add the ability to disable the global CSP in a controller, e.g:
-
-        class LegacyPagesController < ApplicationController
-          content_security_policy false, only: :index
-        end
-
-    *Andrew White*
-
-*   Add alias method `to_hash` to `to_h` for `cookies`.
-    Add alias method `to_h` to `to_hash` for `session`.
-
-    *Igor Kasyanchuk*
+*   Add `ActionController::Parameters#each_value`.
 
-*   Update the default HSTS max-age value to 31536000 seconds (1 year)
-    to meet the minimum max-age requirement for https://hstspreload.org/.
+    *Lukáš Zapletal*
 
-    *Grant Bourque*
+*   Deprecate `ActionDispatch::Http::ParameterFilter` in favor of `ActiveSupport::ParameterFilter`.
 
-*   Add support for automatic nonce generation for Rails UJS.
-
-    Because the UJS library creates a script tag to process responses it
-    normally requires the script-src attribute of the content security
-    policy to include 'unsafe-inline'.
-
-    To work around this we generate a per-request nonce value that is
-    embedded in a meta tag in a similar fashion to how CSRF protection
-    embeds its token in a meta tag. The UJS library can then read the
-    nonce value and set it on the dynamically generated script tag to
-    enable it to execute without needing 'unsafe-inline' enabled.
+    *Yoshiyuki Kinjo*
 
-    Nonce generation isn't 100% safe - if your script tag is including
-    user generated content in someway then it may be possible to exploit
-    an XSS vulnerability which can take advantage of the nonce. It is
-    however an improvement on a blanket permission for inline scripts.
+*   Encode Content-Disposition filenames on `send_data` and `send_file`.
+    Previously, `send_data 'data', filename: "\u{3042}.txt"` sends
+    `"filename=\"\u{3042}.txt\""` as Content-Disposition and it can be
+    garbled.
+    Now it follows [RFC 2231](https://tools.ietf.org/html/rfc2231) and
+    [RFC 5987](https://tools.ietf.org/html/rfc5987) and sends
+    `"filename=\"%3F.txt\"; filename*=UTF-8''%E3%81%82.txt"`.
+    Most browsers can find filename correctly and old browsers fallback to ASCII
+    converted name.
 
-    It is also possible to use the nonce within your own script tags by
-    using `nonce: true` to set the nonce value on the tag, e.g
+    *Fumiaki Matsushima*
 
-        <%= javascript_tag nonce: true do %>
-          alert('Hello, World!');
-        <% end %>
+*   Expose `ActionController::Parameters#each_key` which allows iterating over
+    keys without allocating an array.
 
-    Fixes #31689.
+    *Richard Schneeman*
 
-    *Andrew White*
+*   Purpose metadata for signed/encrypted cookies.
 
-*   Matches behavior of `Hash#each` in `ActionController::Parameters#each`.
+    Rails can now thwart attacks that attempt to copy signed/encrypted value
+    of a cookie and use it as the value of another cookie.
 
-    Rails 5.0 introduced a bug when looping through controller params using `each`. Only the keys of params hash were passed to the block, e.g.
+    It does so by stashing the cookie-name in the purpose field which is
+    then signed/encrypted along with the cookie value. Then, on a server-side
+    read, we verify the cookie-names and discard any attacked cookies.
 
-        # Parameters: {"param"=>"1", "param_two"=>"2"}
-        def index
-          params.each do |name|
-            puts name
-          end
-        end
+    Enable `action_dispatch.use_cookies_with_metadata` to use this feature, which
+    writes cookies with the new purpose and expiry metadata embedded.
 
-        # Prints
-        # param
-        # param_two
+    *Assain Jaleel*
 
-    In Rails 5.2 the bug has been fixed and name will be an array (which was the behavior for all versions prior to 5.0), instead of a string.
+*   Raises `ActionController::RespondToMismatchError` with confliciting `respond_to` invocations.
 
-    To fix the code above simply change as per example below:
+    `respond_to` can match multiple types and lead to undefined behavior when
+    multiple invocations are made and the types do not match:
 
-        # Parameters: {"param"=>"1", "param_two"=>"2"}
-        def index
-          params.each do |name, value|
-            puts name
+        respond_to do |outer_type|
+          outer_type.js do
+            respond_to do |inner_type|
+              inner_type.html { render body: "HTML" }
+            end
           end
         end
 
-        # Prints
-        # param
-        # param_two
-
-    *Dominic Cleal*
-
-*   Add `Referrer-Policy` header to default headers set.
+    *Patrick Toomey*
 
-    *Guillermo Iguaran*
+*   `ActionDispatch::Http::UploadedFile` now delegates `to_path` to its tempfile.
 
-*   Changed the system tests to set Puma as default server only when the
-    user haven't specified manually another server.
+    This allows uploaded file objects to be passed directly to `File.read`
+    without raising a `TypeError`:
 
-    *Guillermo Iguaran*
+        uploaded_file = ActionDispatch::Http::UploadedFile.new(tempfile: tmp_file)
+        File.read(uploaded_file)
 
-*   Add secure `X-Download-Options` and `X-Permitted-Cross-Domain-Policies` to
-    default headers set.
+    *Aaron Kromer*
 
-    *Guillermo Iguaran*
+*   Pass along arguments to underlying `get` method in `follow_redirect!`.
 
-*   Add headless firefox support to System Tests.
+    Now all arguments passed to `follow_redirect!` are passed to the underlying
+    `get` method. This for example allows to set custom headers for the
+    redirection request to the server.
 
-    *bogdanvlviv*
+        follow_redirect!(params: { foo: :bar })
 
-*   Changed the default system test screenshot output from `inline` to `simple`.
+    *Remo Fritzsche*
 
-    `inline` works well for iTerm2 but not everyone uses iTerm2. Some terminals like
-    Terminal.app ignore the `inline` and output the path to the file since it can't
-    render the image. Other terminals, like those on Ubuntu, cannot handle the image
-    inline, but also don't handle it gracefully and instead of outputting the file
-    path, it dumps binary into the terminal.
+*   Introduce a new error page to when the implicit render page is accessed in the browser.
 
-    Commit 9d6e28 fixes this by changing the default for screenshot to be `simple`.
+    Now instead of showing an error page that with exception and backtraces we now show only
+    one informative page.
 
-    *Eileen M. Uchitelle*
-
-*   Register most popular audio/video/font mime types supported by modern browsers.
-
-    *Guillermo Iguaran*
-
-*   Fix optimized url helpers when using relative url root.
-
-    Fixes #31220.
-
-    *Andrew White*
+    *Vinicius Stock*
 
-*   Add DSL for configuring Content-Security-Policy header.
+*   Introduce `ActionDispatch::DebugExceptions.register_interceptor`.
 
-    The DSL allows you to configure a global Content-Security-Policy
-    header and then override within a controller. For more information
-    about the Content-Security-Policy header see MDN:
+    Exception aware plugin authors can use the newly introduced
+    `.register_interceptor` method to get the processed exception, instead of
+    monkey patching DebugExceptions.
 
-    https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy
-
-    Example global policy:
-
-        # config/initializers/content_security_policy.rb
-        Rails.application.config.content_security_policy do |p|
-          p.default_src :self, :https
-          p.font_src    :self, :https, :data
-          p.img_src     :self, :https, :data
-          p.object_src  :none
-          p.script_src  :self, :https
-          p.style_src   :self, :https, :unsafe_inline
-        end
-
-    Example controller overrides:
-
-        # Override policy inline
-        class PostsController < ApplicationController
-          content_security_policy do |p|
-            p.upgrade_insecure_requests true
-          end
-        end
-
-        # Using literal values
-        class PostsController < ApplicationController
-          content_security_policy do |p|
-            p.base_uri "https://www.example.com"
-          end
-        end
-
-        # Using mixed static and dynamic values
-        class PostsController < ApplicationController
-          content_security_policy do |p|
-            p.base_uri :self, -> { "https://#{current_user.domain}.example.com" }
-          end
+        ActionDispatch::DebugExceptions.register_interceptor do |request, exception|
+          HypoteticalPlugin.capture_exception(request, exception)
         end
 
-    Allows you to also only report content violations for migrating
-    legacy content using the `content_security_policy_report_only`
-    configuration attribute, e.g;
-
-        # config/initializers/content_security_policy.rb
-        Rails.application.config.content_security_policy_report_only = true
-
-        # controller override
-        class PostsController < ApplicationController
-          content_security_policy_report_only only: :index
-        end
-
-    Note that this feature does not validate the header for performance
-    reasons since the header is calculated at runtime.
-
-    *Andrew White*
-
-*   Make `assert_recognizes` to traverse mounted engines.
-
-    *Yuichiro Kaneko*
-
-*   Remove deprecated `ActionController::ParamsParser::ParseError`.
-
-    *Rafael Mendonça França*
+    *Genadi Samokovarov*
 
-*   Add `:allow_other_host` option to `redirect_back` method.
-
-    When `allow_other_host` is set to `false`, the `redirect_back` will not allow redirecting from a
-    different host. `allow_other_host` is `true` by default.
-
-    *Tim Masliuchenko*
-
-*   Add headless chrome support to System Tests.
-
-    *Yuji Yaginuma*
-
-*   Add ability to enable Early Hints for HTTP/2
-
-    If supported by the server, and enabled in Puma this allows H2 Early Hints to be used.
-
-    The `javascript_include_tag` and the `stylesheet_link_tag` automatically add Early Hints if requested.
-
-    *Eileen M. Uchitelle*, *Aaron Patterson*
-
-*   Simplify cookies middleware with key rotation support
-
-    Use the `rotate` method for both `MessageEncryptor` and
-    `MessageVerifier` to add key rotation support for encrypted and
-    signed cookies. This also helps simplify support for legacy cookie
-    security.
-
-    *Michael J Coyne*
-
-*   Use Capybara registered `:puma` server config.
-
-    The Capybara registered `:puma` server ensures the puma server is run in process so
-    connection sharing and open request detection work correctly by default.
-
-    *Thomas Walpole*
-
-*   Cookies `:expires` option supports `ActiveSupport::Duration` object.
-
-        cookies[:user_name] = { value: "assain", expires: 1.hour }
-        cookies[:key] = { value: "a yummy cookie", expires: 6.months }
-
-    Pull Request: #30121
-
-    *Assain Jaleel*
-
-*   Enforce signed/encrypted cookie expiry server side.
-
-    Rails can thwart attacks by malicious clients that don't honor a cookie's expiry.
-
-    It does so by stashing the expiry within the written cookie and relying on the
-    signing/encrypting to vouch that it hasn't been tampered with. Then on a
-    server-side read, the expiry is verified and any expired cookie is discarded.
-
-    Pull Request: #30121
-
-    *Assain Jaleel*
-
-*   Make `take_failed_screenshot` work within engine.
-
-    Fixes #30405.
-
-    *Yuji Yaginuma*
-
-*   Deprecate `ActionDispatch::TestResponse` response aliases.
-
-    `#success?`, `#missing?` & `#error?` are not supported by the actual
-    `ActionDispatch::Response` object and can produce false-positives. Instead,
-    use the response helpers provided by `Rack::Response`.
-
-    *Trevor Wistaff*
-
-*   Protect from forgery by default
-
-    Rather than protecting from forgery in the generated `ApplicationController`,
-    add it to `ActionController::Base` depending on
-    `config.action_controller.default_protect_from_forgery`. This configuration
-    defaults to false to support older versions which have removed it from their
-    `ApplicationController`, but is set to true for Rails 5.2.
-
-    *Lisa Ugray*
-
-*   Fallback `ActionController::Parameters#to_s` to `Hash#to_s`.
-
-    *Kir Shatrov*
-
-*   `driven_by` now registers poltergeist and capybara-webkit.
-
-    If poltergeist or capybara-webkit are set as drivers is set for System Tests,
-    `driven_by` will register the driver and set additional options passed via
-    the `:options` parameter.
-
-    Refer to the respective driver's documentation to see what options can be passed.
-
-    *Mario Chavez*
-
-*   AEAD encrypted cookies and sessions with GCM.
-
-    Encrypted cookies now use AES-GCM which couples authentication and
-    encryption in one faster step and produces shorter ciphertexts. Cookies
-    encrypted using AES in CBC HMAC mode will be seamlessly upgraded when
-    this new mode is enabled via the
-    `action_dispatch.use_authenticated_cookie_encryption` configuration value.
-
-    *Michael J Coyne*
+*   Output only one Content-Security-Policy nonce header value per request.
 
-*   Change the cache key format for fragments to make it easier to debug key churn. The new format is:
+    Fixes #32597.
 
-        views/template/action.html.erb:7a1156131a6928cb0026877f8b749ac9/projects/123
-              ^template path           ^template tree digest            ^class   ^id
+    *Andrey Novikov*, *Andrew White*
 
-    *DHH*
+*   Move default headers configuration into their own module that can be included in controllers.
 
-*   Add support for recyclable cache keys with fragment caching. This uses the new versioned entries in the
-    `ActiveSupport::Cache` stores and relies on the fact that Active Record has split `#cache_key` and `#cache_version`
-    to support it.
+    *Kevin Deisz*
 
-    *DHH*
+*   Add method `dig` to `session`.
 
-*   Add `action_controller_api` and `action_controller_base` load hooks to be called in `ActiveSupport.on_load`
+    *claudiob*, *Takumi Shotoku*
 
-    `ActionController::Base` and `ActionController::API` have differing implementations. This means that
-    the one umbrella hook `action_controller` is not able to address certain situations where a method
-    may not exist in a certain implementation.
+*   Controller level `force_ssl` has been deprecated in favor of
+    `config.force_ssl`.
 
-    This is fixed by adding two new hooks so you can target `ActionController::Base` vs `ActionController::API`
+    *Derek Prior*
 
-    Fixes #27013.
+*   Rails 6 requires Ruby 2.5.0 or newer.
 
-    *Julian Nadeau*
+    *Jeremy Daer*, *Kasper Timm Hansen*
 
 
-Please check [5-1-stable](https://github.com/rails/rails/blob/5-1-stable/actionpack/CHANGELOG.md) for previous changes.
+Please check [5-2-stable](https://github.com/rails/rails/blob/5-2-stable/actionpack/CHANGELOG.md) for previous changes.

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2004-2018 David Heinemeier Hansson
+Copyright (c) 2004-2019 David Heinemeier Hansson
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the