living_document 1.1.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b46000477f0e791df373e18f40d772cc23ace4ade6c28a6ad03a2380e1fb94a
-  data.tar.gz: ddb0ea02b80c748c7ce66f148551d13f1c508cb6fd8008fa10e306a31f2f49bd
+  metadata.gz: fd6766fedfe5bb15663673387072f43334a43fe590b5651721439c16c9b6d5d8
+  data.tar.gz: c561e58301674a99838f44c7b14b12474708dc3182b7efc1df6c6572315135bb
 SHA512:
-  metadata.gz: 110ae630a49333ac60af0291d35e087e157a4cdbea1bb22507419f66e61bfb47d71c4e8b72a0babc27fc24de93b33f47bc558645446a85d4246ceae70a344475
-  data.tar.gz: 3b7d7ca65e03271992e59fe599104dd0eaf1da6671767773f5eb549fc9871dcb73b645b982105153567a0fda2bcd6e3bf8048edba91967aebf41449f0fc5480b
+  metadata.gz: bf6d65cf5d6e555dfd490e5bc7275d818a4713670995ec26c8794102cd9d069a28abd73eadba0975c2aacda87a2d4fca1f5e32de0df3d30fcbced4e622053c45
+  data.tar.gz: ebc0761b7f74e662d7eb7b32cb6509926504237c7437b47be53b20dd14074a6fda5a8d529eb4ae1a335f56d2e7bed1b3cb0f49c6b5fb225e8194184f4f5ff221

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## v2.0.0 (2025-02-05)
+- **BREAKING:** Use `rb-inotify` (not `listen`) to watch for file changes. This means that the gem is now only compatible with Linux.
+- Support listening to files outside of the current directory.
+
+## v1.1.1 (2025-01-30)
+- Fix exception when evaluating an empty target file. https://github.com/davidrunger/living_document/pull/608
+
 ## v1.1.0 (2025-01-29)
 - Support `-h`/`--help` and `-v`/`--version` CLI flags.
 

data/Gemfile

@@ -9,14 +9,10 @@ gemspec
 
 group :development, :test do
   gem 'amazing_print'
-  # Remove if/when byebug brings in this dependency for us.
-  gem 'irb'
   gem 'pry'
   # Go back to upstream if/when https://github.com/deivid-rodriguez/pry-byebug/pull/ 428 is merged.
   gem 'pry-byebug', github: 'davidrunger/pry-byebug'
   gem 'rake'
-  # Remove if/when byebug brings in this dependency for us.
-  gem 'reline'
   gem 'rubocop', require: false
   gem 'rubocop-performance', require: false
   gem 'rubocop-rake', require: false

data/Gemfile.lock

@@ -1,18 +1,18 @@
 GIT
   remote: https://github.com/davidrunger/pry-byebug.git
-  revision: f6f73023ba081630ddee32ae4399fb31706f074f
+  revision: 3ac27ef70a1b16a461db9f7572d3fe1a205effd4
   specs:
     pry-byebug (3.10.1)
-      byebug (>= 11.0)
       pry (>= 0.13)
+      runger_byebug (>= 11.0)
 
 PATH
   remote: .
   specs:
-    living_document (1.1.0)
+    living_document (2.0.0)
       activesupport (>= 6)
-      listen (>= 3.2)
       memo_wise (>= 1.7)
+      rb-inotify (>= 0.11.1)
       timecop (>= 0.9.10)
 
 GEM
@@ -36,7 +36,6 @@ GEM
     base64 (0.2.0)
     benchmark (0.4.0)
     bigdecimal (3.1.9)
-    byebug (11.1.3)
     coderay (1.1.3)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.0)
@@ -64,15 +63,12 @@ GEM
       reline (>= 0.4.2)
     json (2.9.1)
     language_server-protocol (3.17.0.4)
-    listen (3.9.0)
-      rb-fsevent (~> 0.10, >= 0.10.3)
-      rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.6.5)
     memo_wise (1.10.0)
     method_source (1.1.0)
     minitest (5.25.4)
     parallel (1.26.3)
-    parser (3.3.7.0)
+    parser (3.3.7.1)
       ast (~> 2.4.1)
       racc
     pp (0.6.2)
@@ -88,7 +84,6 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.2.1)
-    rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
     rdoc (6.11.0)
@@ -110,14 +105,14 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.2)
-    rubocop (1.71.0)
+    rubocop (1.71.2)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.36.2, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
     rubocop-ast (1.38.0)
@@ -128,12 +123,15 @@ GEM
     rubocop-rake (0.6.0)
       rubocop (~> 1.0)
     ruby-progressbar (1.13.0)
-    runger_release_assistant (0.14.0)
+    runger_byebug (11.3.0)
+      irb
+      reline
+    runger_release_assistant (2.0.0)
       activesupport (>= 6)
       memo_wise (>= 1.7)
       rainbow (>= 3.0)
       slop (~> 4.8)
-    runger_style (4.2.2)
+    runger_style (4.3.0)
       prism (>= 0.24.0)
       rubocop (>= 1.68.0)
     securerandom (0.4.1)
@@ -171,12 +169,10 @@ PLATFORMS
 
 DEPENDENCIES
   amazing_print
-  irb
   living_document!
   pry
   pry-byebug!
   rake
-  reline
   rspec
   rubocop
   rubocop-performance
@@ -192,7 +188,6 @@ CHECKSUMS
   base64 (0.2.0) sha256=0f25e9b21a02a0cc0cea8ef92b2041035d39350946e8789c562b2d1a3da01507
   benchmark (0.4.0) sha256=0f12f8c495545e3710c3e4f0480f63f06b4c842cc94cec7f33a956f5180e874a
   bigdecimal (3.1.9) sha256=2ffc742031521ad69c2dfc815a98e426a230a3d22aeac1995826a75dabfad8cc
-  byebug (11.1.3) sha256=2485944d2bb21283c593d562f9ae1019bf80002143cc3a255aaffd4e9cf4a35b
   coderay (1.1.3) sha256=dc530018a4684512f8f38143cd2a096c9f02a1fc2459edcfe534787a7fc77d4b
   concurrent-ruby (1.3.5) sha256=813b3e37aca6df2a21a3b9f1d497f8cbab24a2b94cab325bffe65ee0f6cbebc6
   connection_pool (2.5.0) sha256=233b92f8d38e038c1349ccea65dd3772727d669d6d2e71f9897c8bf5cd53ebfc
@@ -216,14 +211,13 @@ CHECKSUMS
   irb (1.15.1) sha256=d9bca745ac4207a8b728a52b98b766ca909b86ff1a504bcde3d6f8c84faae890
   json (2.9.1) sha256=d2bdef4644052fad91c1785d48263756fe32fcac08b96a20bb15840e96550d11
   language_server-protocol (3.17.0.4) sha256=c484626478664fd13482d8180947c50a8590484b1258b99b7aedb3b69df89669
-  listen (3.9.0) sha256=db9e4424e0e5834480385197c139cb6b0ae0ef28cc13310cfd1ca78377d59c67
-  living_document (1.1.0)
+  living_document (2.0.0)
   logger (1.6.5) sha256=c3cfe56d01656490ddd103d38b8993d73d86296adebc5f58cefc9ec03741e56b
   memo_wise (1.10.0) sha256=ae40ff8e7799697ff5d59d739b8766f76be22eba69c7c8468edb42ab83c94c3f
   method_source (1.1.0) sha256=181301c9c45b731b4769bc81e8860e72f9161ad7d66dd99103c9ab84f560f5c5
   minitest (5.25.4) sha256=9cf2cae25ac4dfc90c988ebc3b917f53c054978b673273da1bd20bcb0778f947
   parallel (1.26.3) sha256=d86babb7a2b814be9f4b81587bf0b6ce2da7d45969fab24d8ae4bf2bb4d4c7ef
-  parser (3.3.7.0) sha256=7449011771e3e7881297859b849de26a6f4fccd515bece9520a87e7d2116119b
+  parser (3.3.7.1) sha256=7dbe61618025519024ac72402a6677ead02099587a5538e84371b76659e6aca1
   pp (0.6.2) sha256=947ec3120c6f92195f8ee8aa25a7b2c5297bb106d83b41baa02983686577b6ff
   prettyprint (0.2.0) sha256=2bc9e15581a94742064a3cc8b0fb9d45aae3d03a1baa6ef80922627a0766f193
   prism (1.3.0) sha256=b11620829831b1cb7e6c9b46c81ff8a6e36ccb3f888f164485eb7351f386273a
@@ -233,7 +227,6 @@ CHECKSUMS
   racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
   rake (13.2.1) sha256=46cb38dae65d7d74b6020a4ac9d48afed8eb8149c040eccf0523bec91907059d
-  rb-fsevent (0.11.2) sha256=43900b972e7301d6570f64b850a5aa67833ee7d87b458ee92805d56b7318aefe
   rb-inotify (0.11.1) sha256=a0a700441239b0ff18eb65e3866236cd78613d6b9f78fea1f9ac47a85e47be6e
   rdoc (6.11.0) sha256=bec66fb9b019be64f7ba7d2cd2aecb283a3a01fef23a95b33e2349c6d1aa0040
   regexp_parser (2.10.0) sha256=cb6f0ddde88772cd64bff1dbbf68df66d376043fe2e66a9ef77fcb1b0c548c61
@@ -244,13 +237,14 @@ CHECKSUMS
   rspec-expectations (3.13.3) sha256=0e6b5af59b900147698ea0ff80456c4f2e69cac4394fbd392fbd1ca561f66c58
   rspec-mocks (3.13.2) sha256=2327335def0e1665325a9b617e3af9ae20272741d80ac550336309a7c59abdef
   rspec-support (3.13.2) sha256=cea3a2463fd9b84b9dcc9685efd80ea701aa8f7b3decb3b3ce795ed67737dbec
-  rubocop (1.71.0) sha256=e19679efd447346ac476122313d3788ae23c38214790bcf660e984c747608bf0
+  rubocop (1.71.2) sha256=9a7b7501aac661a338ed7ff2a5eba78e581759e1f0d3c82362b2ca217ed3f97f
   rubocop-ast (1.38.0) sha256=4fdf6792fe443a9a18acb12dbc8225d0d64cd1654e41fedb30e79c18edbb26ae
   rubocop-performance (1.23.1) sha256=f22f86a795f5e6a6180aac2c6fc172534b173a068d6ed3396d6460523e051b82
   rubocop-rake (0.6.0) sha256=56b6f22189af4b33d4f4e490a555c09f1281b02f4d48c3a61f6e8fe5f401d8db
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
-  runger_release_assistant (0.14.0) sha256=7abc5eb1e0f63d8d611691bc21698d2b3b8f148a5f47cacd8dd32c21d16ee9be
-  runger_style (4.2.2) sha256=23bb4c2b8875d79113f72179a7e4ad96bd5ecde8d7a54bd18f4e60c2ab65dd64
+  runger_byebug (11.3.0) sha256=5728ac0a94daa88e36de256976d59e9308f67bbb8c73b3e42de7cf52de53b9aa
+  runger_release_assistant (2.0.0) sha256=f4f5708291eaeef1b881208f87a494877fe768739d6e96b7293fc335b28a3865
+  runger_style (4.3.0) sha256=543c2414626d9084fef8fd057bf561c702e395f35e7af4ee6ee403276cf60614
   securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
   simplecov (0.22.0) sha256=fe2622c7834ff23b98066bb0a854284b2729a569ac659f82621fc22ef36213a5
   simplecov-cobertura (2.1.0) sha256=2c6532e34df2e38a379d72cef9a05c3b16c64ce90566beebc6887801c4ad3f02

data/README.md

@@ -1,8 +1,12 @@
 [![codecov](https://codecov.io/gh/davidrunger/living_document/branch/main/graph/badge.svg)](https://codecov.io/gh/davidrunger/living_document)
 
+<p align="center">
+  <img src="https://david-runger-public-uploads.s3.us-east-1.amazonaws.com/living_document.gif" />
+</p>
+
 # LivingDocument
 
-LivingDocument evaluates Ruby statements inline in your code editor, which can be particularly useful when writing examples of Ruby code for documentation purposes.
+LivingDocument evaluates Ruby code live and inline in your editor while you edit a Ruby file, or a Markdown file that includes Ruby code snippets. This is useful for quickly exploring ideas in Ruby code, since it can be faster and more convenient than working in IRB or running a Ruby script repeatedly as you edit it. It's also great for editing README.md documentation while ensuring the accuracy of example code snippets.
 
 For example, if you write this in your editor...
 
@@ -32,6 +36,7 @@ In other words, the special markers `###` and `# =>` tell LivingDocument to eval
 <!--ts-->
 * [LivingDocument](#livingdocument)
    * [Table of Contents](#table-of-contents)
+   * [Linux only <g-emoji class="g-emoji" alias="warning">⚠️</g-emoji>](#️-linux-only-️)
    * [Installation](#installation)
    * [Usage](#usage)
    * [Markdown support](#markdown-support)
@@ -41,10 +46,14 @@ In other words, the special markers `###` and `# =>` tell LivingDocument to eval
    * [License](#license)
 
 <!-- Created by https://github.com/ekalinin/github-markdown-toc -->
-<!-- Added by: david, at: Wed Jan 29 07:45:21 PM CST 2025 -->
+<!-- Added by: david, at: Wed Feb  5 09:31:36 PM CST 2025 -->
 
 <!--te-->
 
+## ⚠️ Linux only ⚠️
+
+`living_document` relies on [`rb-inotify`](https://github.com/guard/rb-inotify), which provides efficient file system event notifications using the Linux inotify API. Since inotify is exclusive to the Linux kernel, the functionality provided by `rb-inotify` cannot be replicated on other operating systems. Since `living_document` relies on `rb-inotify` for efficient file system watching, `living_document` also only works on Linux.
+
 ## Installation
 
 ```

data/exe/livdoc

@@ -2,8 +2,8 @@
 
 # frozen_string_literal: true
 
-require 'listen'
 require 'optparse'
+require 'rb-inotify'
 
 require_relative '../lib/living_document.rb'
 
@@ -15,17 +15,24 @@ end
 parser.parse!
 
 # rubocop:disable Style/TopLevelMethodDefinition
-def evaluate_code_and_update_source_file(file_path)
-  puts('Running code...')
+def evaluate_code_and_update_source_file(file_path, evaluation_reason:)
+  print("#{Time.now.iso8601} #{evaluation_reason} ... ")
+  # NOTE: This sleep seems to be necessary to interact reliably with VS Code.
+  sleep(0.015)
   code_in_file = File.read(file_path)
+
+  print('running code ... ')
   code_to_write =
     LivingDocument::DocumentEvaluator.new(
       document: code_in_file,
     ).evaluated_document
 
-  $printed_objects_last_run = []
-  puts("Writing file! #{Time.now}")
+  # NOTE: This sleep seems to be necessary to interact reliably with VS Code.
+  sleep(0.015)
+  print('writing file ... ')
   File.write(file_path, code_to_write)
+
+  puts('waiting for changes.')
 end
 # rubocop:enable Style/TopLevelMethodDefinition
 
@@ -36,27 +43,31 @@ if file_path.nil?
   exit(1)
 end
 
+expanded_path = File.expand_path(file_path)
+notifier = INotify::Notifier.new
 last_file_update = Time.now
-listener =
-  Listen.to(Dir.pwd, only: /\A#{Regexp.escape(file_path)}\z/) do |_modified, _added, _removed|
-    # Don't enter infinitely recursive loop, since the code below triggers file updates.
-    # After file has been updated, wait at least 0.5 seconds before listener processes again.
-    next if (Time.now - last_file_update) < 0.5
 
-    evaluate_code_and_update_source_file(file_path)
+notifier.watch(expanded_path, :modify) do |_event|
+  # Don't enter infinitely recursive loop, since the code below triggers file updates.
+  # After file has been updated, wait at least 0.2 seconds before listener processes again.
+  next if (Time.now - last_file_update) < 0.2
 
-    last_file_update = Time.now
-  end
+  evaluate_code_and_update_source_file(expanded_path, evaluation_reason: 'Detected file change')
 
-listener.start
-system('clear')
-evaluate_code_and_update_source_file(file_path)
-puts('Waiting for file changes...')
+  last_file_update = Time.now
+end
 
 at_exit do
   print('Stopping listener ... ')
-  listener.stop
+  notifier.close
   puts('done.')
 end
 
-sleep
+system('clear')
+evaluate_code_and_update_source_file(expanded_path, evaluation_reason: 'Launching')
+
+begin
+  notifier.run
+rescue Interrupt
+  # Exit gracefully, having run `at_exit` block.
+end

data/lib/living_document/code_evaluator.rb

@@ -13,6 +13,8 @@ class LivingDocument::CodeEvaluator
   end
 
   def evaluated_code
+    save_original_stdout
+
     Timecop.freeze do
       printed_code_segments.each_with_index do |printed_code_segment, index|
         $printed_output = ''
@@ -20,34 +22,45 @@ class LivingDocument::CodeEvaluator
 
         result =
           begin
-            # we need to namespace any constants that would otherwise leak and persist globally
-            new_namespace.instance_eval(code_to_eval(index)).inspect.squish
+            # We need to namespace any constants that would otherwise leak and persist globally.
+            new_namespace.
+              instance_eval(code_to_eval(index)).
+              inspect.
+              squish.
+              then do |evaluated_result|
+                if newly_printed_output.present?
+                  result_for_printed_output
+                else
+                  formatted_evaluated_result(evaluated_result)
+                end
+              end
           rescue => error
-            # Comment these lines back in for debugging:
-            # puts("ERROR: #{error.class}:#{error.message}")
-            # puts(error.backtrace)
             @known_erroring_segment_indexes << index
+
             "raises #{error.class} (#{error.message})"
           end
 
-        if newly_printed_output.present?
-          result = result_for_printed_output
-        elsif result.include?('\"')
-          result = "'#{result.gsub('\"', '"')[1...-1]}'"
-        end
-        remember_printed_objects
+        remember_printed_output
 
         swap_in_evaluated_code(printed_code_segment, result)
       end
     end
 
-    restore_original_stdout
-
     @code
+  ensure
+    restore_original_stdout
   end
 
   private
 
+  def formatted_evaluated_result(evaluated_result)
+    if evaluated_result.include?('\"') && !evaluated_result.include?("'")
+      "'#{evaluated_result.gsub('\"', '"')[1...-1]}'"
+    else
+      evaluated_result
+    end
+  end
+
   def result_for_printed_output
     if newly_printed_output[0..-2].include?("\n")
       %(prints:\n#{commented_output(newly_printed_output)})
@@ -64,17 +77,22 @@ class LivingDocument::CodeEvaluator
     COMMENTED_OUTPUT
   end
 
-  def set_up_capturing_stdout
+  def save_original_stdout
     @original_stdout = $stdout
+  end
+
+  def set_up_capturing_stdout
     $stdout = StringIO.new
   end
 
   def restore_original_stdout
-    $stdout = @original_stdout
+    if @original_stdout.present?
+      $stdout = @original_stdout
+    end
   end
 
   def code_segments_to_eval(current_index)
-    printed_code_segments_to_eval(current_index)
+    printed_code_segments.values_at(*indexes_to_eval(current_index))
   end
 
   def code_to_eval(current_index)
@@ -104,11 +122,7 @@ class LivingDocument::CodeEvaluator
     @code.scan(/(?:(?!###|# =>).)*(?:###|# =>)[^\n]*\s*/mi)
   end
 
-  def printed_code_segments_to_eval(current_index)
-    printed_code_segments.values_at(*indexes_to_eval(current_index))
-  end
-
-  def remember_printed_objects
+  def remember_printed_output
     $printed_output_last_run = $printed_output
   end
 

data/lib/living_document/platform_check.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module LivingDocument
+  def self.check_platform!
+    if !RUBY_PLATFORM.include?('linux')
+      raise('Sorry, but living_document only works on Linux')
+    end
+  end
+end

data/lib/living_document/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LivingDocument
-  VERSION = '1.1.0'
+  VERSION = '2.0.0'
 end

data/lib/living_document.rb

@@ -8,3 +8,5 @@ require 'timecop'
 module LivingDocument ; end
 
 Dir["#{File.dirname(__FILE__)}/living_document/**/*.rb"].each { |file| require file }
+
+LivingDocument.check_platform!

data/living_document.gemspec

@@ -1,8 +1,11 @@
 # frozen_string_literal: true
 
+require_relative 'lib/living_document/platform_check'
 require_relative 'lib/living_document/version'
 
 Gem::Specification.new do |spec|
+  LivingDocument.check_platform!
+
   spec.name          = 'living_document'
   spec.version       = LivingDocument::VERSION
   spec.authors       = ['David Runger']
@@ -31,7 +34,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
 
   spec.add_dependency('activesupport', '>= 6')
-  spec.add_dependency('listen', '>= 3.2')
   spec.add_dependency('memo_wise', '>= 1.7')
+  spec.add_dependency('rb-inotify', '>= 0.11.1')
   spec.add_dependency('timecop', '>= 0.9.10')
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: living_document
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 2.0.0
 platform: ruby
 authors:
 - David Runger
 bindir: exe
 cert_chain: []
-date: 2025-01-30 00:00:00.000000000 Z
+date: 2025-02-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -24,33 +24,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '6'
 - !ruby/object:Gem::Dependency
-  name: listen
+  name: memo_wise
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '1.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '1.7'
 - !ruby/object:Gem::Dependency
-  name: memo_wise
+  name: rb-inotify
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: 0.11.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: 0.11.1
 - !ruby/object:Gem::Dependency
   name: timecop
   requirement: !ruby/object:Gem::Requirement
@@ -97,6 +97,7 @@ files:
 - lib/living_document.rb
 - lib/living_document/code_evaluator.rb
 - lib/living_document/document_evaluator.rb
+- lib/living_document/platform_check.rb
 - lib/living_document/version.rb
 - living_document.gemspec
 homepage: https://github.com/davidrunger/living_document