virtfs 0.0.1

data/spec/nativefs_local_root_spec.rb

@@ -0,0 +1,132 @@
+require 'spec_helper'
+
+describe "NativeFS local root (mount subdurectory)" do
+  before(:all) do
+    @root           = VfsRealFile::SEPARATOR
+    @mnt            = VfsRealDir.mktmpdir
+    @top_dir        = "Dir1"
+
+    @rb_file        = "hello_world.rb"
+    @lib_name       = "hello_world"
+    @module_name    = 'HelloWorld'
+
+    @rb_code = <<-END_OF_CODE
+      module #{@module_name}
+        def self.hello
+          "Hello World!"
+        end
+      end
+    END_OF_CODE
+
+    reset_context
+
+    @native_fs1  = nativefs_class.new
+    VirtFS.mount(@native_fs1, @root) # mount / on /
+  end
+
+  after(:all) do
+    VirtFS.umount(@root) if VirtFS.mounted?(@root)
+    VfsRealDir.rmdir(@mnt)
+  end
+
+  before(:each) do
+    @tmp_dir = VfsRealDir.mktmpdir # The subdirectory to mount
+
+    @native_fs2  = nativefs_class.new(@tmp_dir)
+    VirtFS.mount(@native_fs2, @mnt)  # mount @tmp_dir on @mnt
+  end
+
+  after(:each) do
+    VirtFS.umount(@mnt) if VirtFS.mounted?(@mnt)
+    FileUtils.remove_dir(@tmp_dir)
+  end
+
+  context "Directory access -" do
+    it "Directories created through the subdir should be visible through the mount point" do
+      VirtFS::VDir.chdir(@tmp_dir) do
+        mk_dir_tree(VirtFS::VDir, "Dir1", 4, 3)
+        expect(check_dir_tree(VirtFS::VDir, "Dir1", 4, 3)).to be_nil
+      end
+      VirtFS::VDir.chdir(@mnt) do
+        expect(check_dir_tree(VirtFS::VDir, "Dir1", 4, 3)).to be_nil
+      end
+    end
+
+    it "Directories created through the mount point should be visible through the subdir" do
+      VirtFS::VDir.chdir(@mnt) do
+        mk_dir_tree(VirtFS::VDir, "Dir1", 4, 3)
+        expect(check_dir_tree(VirtFS::VDir, "Dir1", 4, 3)).to be_nil
+      end
+      VirtFS::VDir.chdir(@tmp_dir) do
+        expect(check_dir_tree(VirtFS::VDir, "Dir1", 4, 3)).to be_nil
+      end
+    end
+
+    it "After unmount, directories should no longer be visible under mount point" do
+      VirtFS::VDir.chdir(@mnt) do
+        mk_dir_tree(VirtFS::VDir, "Dir1", 4, 3)
+        expect(check_dir_tree(VirtFS::VDir, "Dir1", 4, 3)).to be_nil
+      end
+
+      VirtFS.umount(@mnt)
+
+      VirtFS::VDir.chdir(@mnt) do
+        expect do
+          check_dir_tree(VirtFS::VDir, "Dir1", 4, 3)
+        end.to raise_error(
+          RuntimeError, "Expected directory Dir1 does not exist"
+        )
+      end
+    end
+  end
+
+  context "File access -" do
+    it "Files created through the subdir should be visible through the mount point" do
+      VirtFS::VDir.chdir(@tmp_dir) do
+        VirtFS::VFile.open(@rb_file, "w") do |f|
+          f.write(@rb_code)
+        end
+        expect(VirtFS::VFile.exist?(@rb_file)).to be true
+      end
+      VirtFS::VDir.chdir(@mnt) do
+        expect(VirtFS::VFile.exist?(@rb_file)).to be true
+      end
+    end
+
+    it "Directories created through the mount point should be visible through the subdir" do
+      VirtFS::VDir.chdir(@mnt) do
+        VirtFS::VFile.open(@rb_file, "w") do |f|
+          f.write(@rb_code)
+        end
+        expect(VirtFS::VFile.exist?(@rb_file)).to be true
+      end
+      VirtFS::VDir.chdir(@tmp_dir) do
+        expect(VirtFS::VFile.exist?(@rb_file)).to be true
+      end
+    end
+
+    it "After unmount, directories should no longer be visible under mount point" do
+      VirtFS::VDir.chdir(@mnt) do
+        VirtFS::VFile.open(@rb_file, "w") do |f|
+          f.write(@rb_code)
+        end
+        expect(VirtFS::VFile.exist?(@rb_file)).to be true
+      end
+
+      VirtFS.umount(@mnt)
+
+      VirtFS::VDir.chdir(@mnt) do
+        expect(VirtFS::VFile.exist?(@rb_file)).to be false
+      end
+    end
+
+    it "Reading file should return the expected data" do
+      VirtFS::VDir.chdir(@mnt) do
+        VirtFS::VFile.open(@rb_file, "w") do |f|
+          f.write(@rb_code)
+        end
+        expect(VirtFS::VFile.read(@rb_file)).to eq(@rb_code)
+      end
+    end
+  end
+end

data/spec/path_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe VirtFS, "path support methods (#{$fs_interface} interface)" do
+  before(:all) do
+    @full_path = File.expand_path(__FILE__)
+    @rel_path  = File.basename(@full_path)
+    @this_dir  = File.dirname(@full_path)
+  end
+
+  before(:each) do
+    reset_context
+  end
+
+  describe ".dir_getwd" do
+    it "should default to '/'" do
+      expect(VirtFS.dir_getwd).to eq('/')
+    end
+
+    it "return the value set by .dir_chdir" do
+      VirtFS.cwd = @this_dir
+      expect(VirtFS.dir_getwd).to eq(@this_dir)
+    end
+  end
+
+  describe ".normalize_path" do
+    it "should return full path, given full path" do
+      expect(VirtFS.normalize_path(@full_path)).to eq(@full_path)
+    end
+
+    it "should return full path, given relative path" do
+      expect(VirtFS.normalize_path(@rel_path, @this_dir)).to eq(@full_path)
+    end
+
+    it "should return full path, given relative path (based on cwd)" do
+      VirtFS.cwd = @this_dir
+      expect(VirtFS.normalize_path(@rel_path)).to eq(@full_path)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,126 @@
+require "tmpdir"
+require "tempfile"
+require "find"
+require "virtfs"
+
+if ENV['FS_INTERFACE'] && ENV['FS_INTERFACE'].downcase == "thick"
+  $fs_interface = "Thick" # rubocop:disable Style/GlobalVars
+  require "virtfs-nativefs-thick"
+else
+  $fs_interface = "Thin" # rubocop:disable Style/GlobalVars
+  require "virtfs-nativefs-thin"
+end
+
+def nativefs_class
+  if $fs_interface == "Thin" # rubocop:disable Style/GlobalVars
+    VirtFS::NativeFS::Thin
+  else
+    VirtFS::NativeFS::Thick
+  end
+end
+
+def reset_context
+  VirtFS.deactivate! if VirtFS.activated?
+  VirtFS.context_manager.reset_all
+end
+
+def buffer_test_sizes
+  [1024 * 32, 1]
+end
+
+def temp_name(pfx = "", sfx = "")
+  VfsRealDir::Tmpname.create([pfx, sfx]) {}
+end
+
+def block_dev_file
+  dev_dir = "/dev"
+  return nil unless VfsRealDir.exist?(dev_dir)
+  Find.find(dev_dir) do |f|
+    next unless VfsRealFile.blockdev?(f)
+    return f
+  end
+  nil
+end
+
+def char_dev_file
+  dev_dir = "/dev"
+  return nil unless VfsRealDir.exist?(dev_dir)
+  Find.find(dev_dir) do |f|
+    next unless VfsRealFile.chardev?(f)
+    return f
+  end
+  nil
+end
+
+def mk_dir_tree(dir_class, prefix, breadth, depth, lvl = 0)
+  return if lvl >= depth
+  dir_class.mkdir(prefix)
+  dir_class.chdir(prefix) do
+    (1..breadth).each do |idx|
+      mk_dir_tree(dir_class, "#{prefix}.#{idx}", breadth, depth, lvl + 1)
+    end
+  end
+  nil
+end
+
+def check_dir_tree(dir_class, prefix, breadth, depth, lvl = 0)
+  return if lvl >= depth
+  raise "Expected directory #{prefix} does not exist" unless dir_class.exist?(prefix)
+  dir_class.chdir(prefix) do
+    (1..breadth).each do |idx|
+      check_dir_tree(dir_class, "#{prefix}.#{idx}", breadth, depth, lvl + 1)
+    end
+  end
+  nil
+end
+
+def rm_dir_tree(dir_class, prefix, breadth, depth, lvl = 0)
+  return if lvl >= depth
+  raise "Expected directory #{prefix} does not exist" unless dir_class.exist?(prefix)
+  dir_class.chdir(prefix) do
+    (1..breadth).each do |idx|
+      rm_dir_tree(dir_class, "#{prefix}.#{idx}", breadth, depth, lvl + 1)
+    end
+  end
+  dir_class.delete(prefix)
+  nil
+end
+
+def write_test_file(file_class, path, start_marker:, end_marker:, data1:, data2:) # rubocop:disable ParameterLists
+  size = start_marker.bytesize + end_marker.bytesize
+  file_class.open(path, "w") do |file|
+    file.write(start_marker)
+    (0..9).each do
+      file.write(data1)
+      size += data1.bytesize
+      file.write(data2)
+      size += data2.bytesize
+    end
+    file.write(end_marker)
+  end
+  size
+end
+
+def check_test_file(file_class, path, start_marker:, end_marker:, data1:, data2:) # rubocop:disable ParameterLists
+  file_class.open(path, "r") do |file|
+    check_str(file.read(start_marker.bytesize), start_marker)
+    (0..9).each do
+      check_str(file.read(data1.bytesize), data1)
+      check_str(file.read(data2.bytesize), data2)
+    end
+    check_str(file.read(end_marker.bytesize), end_marker)
+  end
+  nil
+end
+
+def check_str(s1, s2)
+  raise "Unexpected file contents, expected: #{s1} got #{s2}" unless s1 == s2
+end
+
+def suppress_warnings
+  original_verbosity = $VERBOSE
+  $VERBOSE = nil
+  result = yield
+  $VERBOSE = original_verbosity
+  result
+end

data/tasks/rspec.rake

@@ -0,0 +1,3 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)

data/tasks/yard.rake

@@ -0,0 +1,7 @@
+require 'yard'
+
+YARD::Rake::YardocTask.new do |t|
+  t.files         = ['lib/**/*.rb']
+  t.options       = ['--any', '--extra', '--opts']
+  t.stats_options = ['--list-undoc']
+end

data/test/UTF-8-demo.txt

@@ -0,0 +1,212 @@
+
+UTF-8 encoded sample plain-text file
+‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
+
+Markus Kuhn [ˈmaʳkʊs kuːn] <http://www.cl.cam.ac.uk/~mgk25/> — 2002-07-25
+
+
+The ASCII compatible UTF-8 encoding used in this plain-text file
+is defined in Unicode, ISO 10646-1, and RFC 2279.
+
+
+Using Unicode/UTF-8, you can write in emails and source code things such as
+
+Mathematics and sciences:
+
+  ∮ E⋅da = Q,  n → ∞, ∑ f(i) = ∏ g(i),      ⎧⎡⎛┌─────┐⎞⎤⎫
+                                            ⎪⎢⎜│a²+b³ ⎟⎥⎪
+  ∀x∈ℝ: ⌈x⌉ = −⌊−x⌋, α ∧ ¬β = ¬(¬α ∨ β),    ⎪⎢⎜│───── ⎟⎥⎪
+                                            ⎪⎢⎜⎷ c₈   ⎟⎥⎪
+  ℕ ⊆ ℕ₀ ⊂ ℤ ⊂ ℚ ⊂ ℝ ⊂ ℂ,                   ⎨⎢⎜       ⎟⎥⎬
+                                            ⎪⎢⎜ ∞     ⎟⎥⎪
+  ⊥ < a ≠ b ≡ c ≤ d ≪ ⊤ ⇒ (⟦A⟧ ⇔ ⟪B⟫),      ⎪⎢⎜ ⎲     ⎟⎥⎪
+                                            ⎪⎢⎜ ⎳aⁱ-bⁱ⎟⎥⎪
+  2H₂ + O₂ ⇌ 2H₂O, R = 4.7 kΩ, ⌀ 200 mm     ⎩⎣⎝i=1    ⎠⎦⎭
+
+Linguistics and dictionaries:
+
+  ði ıntəˈnæʃənəl fəˈnɛtık əsoʊsiˈeıʃn
+  Y [ˈʏpsilɔn], Yen [jɛn], Yoga [ˈjoːgɑ]
+
+APL:
+
+  ((V⍳V)=⍳⍴V)/V←,V    ⌷←⍳→⍴∆∇⊃‾⍎⍕⌈
+
+Nicer typography in plain text files:
+
+  ╔══════════════════════════════════════════╗
+  ║                                          ║
+  ║   • ‘single’ and “double” quotes         ║
+  ║                                          ║
+  ║   • Curly apostrophes: “We’ve been here” ║
+  ║                                          ║
+  ║   • Latin-1 apostrophe and accents: '´`  ║
+  ║                                          ║
+  ║   • ‚deutsche‘ „Anführungszeichen“       ║
+  ║                                          ║
+  ║   • †, ‡, ‰, •, 3–4, —, −5/+5, ™, …      ║
+  ║                                          ║
+  ║   • ASCII safety test: 1lI|, 0OD, 8B     ║
+  ║                      ╭─────────╮         ║
+  ║   • the euro symbol: │ 14.95 € │         ║
+  ║                      ╰─────────╯         ║
+  ╚══════════════════════════════════════════╝
+
+Combining characters:
+
+  STARGΛ̊TE SG-1, a = v̇ = r̈, a⃑ ⊥ b⃑
+
+Greek (in Polytonic):
+
+  The Greek anthem:
+
+  Σὲ γνωρίζω ἀπὸ τὴν κόψη
+  τοῦ σπαθιοῦ τὴν τρομερή,
+  σὲ γνωρίζω ἀπὸ τὴν ὄψη
+  ποὺ μὲ βία μετράει τὴ γῆ.
+
+  ᾿Απ᾿ τὰ κόκκαλα βγαλμένη
+  τῶν ῾Ελλήνων τὰ ἱερά
+  καὶ σὰν πρῶτα ἀνδρειωμένη
+  χαῖρε, ὦ χαῖρε, ᾿Ελευθεριά!
+
+  From a speech of Demosthenes in the 4th century BC:
+
+  Οὐχὶ ταὐτὰ παρίσταταί μοι γιγνώσκειν, ὦ ἄνδρες ᾿Αθηναῖοι,
+  ὅταν τ᾿ εἰς τὰ πράγματα ἀποβλέψω καὶ ὅταν πρὸς τοὺς
+  λόγους οὓς ἀκούω· τοὺς μὲν γὰρ λόγους περὶ τοῦ
+  τιμωρήσασθαι Φίλιππον ὁρῶ γιγνομένους, τὰ δὲ πράγματ᾿
+  εἰς τοῦτο προήκοντα,  ὥσθ᾿ ὅπως μὴ πεισόμεθ᾿ αὐτοὶ
+  πρότερον κακῶς σκέψασθαι δέον. οὐδέν οὖν ἄλλο μοι δοκοῦσιν
+  οἱ τὰ τοιαῦτα λέγοντες ἢ τὴν ὑπόθεσιν, περὶ ἧς βουλεύεσθαι,
+  οὐχὶ τὴν οὖσαν παριστάντες ὑμῖν ἁμαρτάνειν. ἐγὼ δέ, ὅτι μέν
+  ποτ᾿ ἐξῆν τῇ πόλει καὶ τὰ αὑτῆς ἔχειν ἀσφαλῶς καὶ Φίλιππον
+  τιμωρήσασθαι, καὶ μάλ᾿ ἀκριβῶς οἶδα· ἐπ᾿ ἐμοῦ γάρ, οὐ πάλαι
+  γέγονεν ταῦτ᾿ ἀμφότερα· νῦν μέντοι πέπεισμαι τοῦθ᾿ ἱκανὸν
+  προλαβεῖν ἡμῖν εἶναι τὴν πρώτην, ὅπως τοὺς συμμάχους
+  σώσομεν. ἐὰν γὰρ τοῦτο βεβαίως ὑπάρξῃ, τότε καὶ περὶ τοῦ
+  τίνα τιμωρήσεταί τις καὶ ὃν τρόπον ἐξέσται σκοπεῖν· πρὶν δὲ
+  τὴν ἀρχὴν ὀρθῶς ὑποθέσθαι, μάταιον ἡγοῦμαι περὶ τῆς
+  τελευτῆς ὁντινοῦν ποιεῖσθαι λόγον.
+
+  Δημοσθένους, Γ´ ᾿Ολυνθιακὸς
+
+Georgian:
+
+  From a Unicode conference invitation:
+
+  გთხოვთ ახლავე გაიაროთ რეგისტრაცია Unicode-ის მეათე საერთაშორისო
+  კონფერენციაზე დასასწრებად, რომელიც გაიმართება 10-12 მარტს,
+  ქ. მაინცში, გერმანიაში. კონფერენცია შეჰკრებს ერთად მსოფლიოს
+  ექსპერტებს ისეთ დარგებში როგორიცაა ინტერნეტი და Unicode-ი,
+  ინტერნაციონალიზაცია და ლოკალიზაცია, Unicode-ის გამოყენება
+  ოპერაციულ სისტემებსა, და გამოყენებით პროგრამებში, შრიფტებში,
+  ტექსტების დამუშავებასა და მრავალენოვან კომპიუტერულ სისტემებში.
+
+Russian:
+
+  From a Unicode conference invitation:
+
+  Зарегистрируйтесь сейчас на Десятую Международную Конференцию по
+  Unicode, которая состоится 10-12 марта 1997 года в Майнце в Германии.
+  Конференция соберет широкий круг экспертов по  вопросам глобального
+  Интернета и Unicode, локализации и интернационализации, воплощению и
+  применению Unicode в различных операционных системах и программных
+  приложениях, шрифтах, верстке и многоязычных компьютерных системах.
+
+Thai (UCS Level 2):
+
+  Excerpt from a poetry on The Romance of The Three Kingdoms (a Chinese
+  classic 'San Gua'):
+
+  [----------------------------|------------------------]
+    ๏ แผ่นดินฮั่นเสื่อมโทรมแสนสังเวช  พระปกเกศกองบู๊กู้ขึ้นใหม่
+  สิบสองกษัตริย์ก่อนหน้าแลถัดไป       สององค์ไซร้โง่เขลาเบาปัญญา
+    ทรงนับถือขันทีเป็นที่พึ่ง           บ้านเมืองจึงวิปริตเป็นนักหนา
+  โฮจิ๋นเรียกทัพทั่วหัวเมืองมา         หมายจะฆ่ามดชั่วตัวสำคัญ
+    เหมือนขับไสไล่เสือจากเคหา      รับหมาป่าเข้ามาเลยอาสัญ
+  ฝ่ายอ้องอุ้นยุแยกให้แตกกัน          ใช้สาวนั้นเป็นชนวนชื่นชวนใจ
+    พลันลิฉุยกุยกีกลับก่อเหตุ          ช่างอาเพศจริงหนาฟ้าร้องไห้
+  ต้องรบราฆ่าฟันจนบรรลัย           ฤๅหาใครค้ำชูกู้บรรลังก์ ฯ
+
+  (The above is a two-column text. If combining characters are handled
+  correctly, the lines of the second column should be aligned with the
+  | character above.)
+
+Ethiopian:
+
+  Proverbs in the Amharic language:
+
+  ሰማይ አይታረስ ንጉሥ አይከሰስ።
+  ብላ ካለኝ እንደአባቴ በቆመጠኝ።
+  ጌጥ ያለቤቱ ቁምጥና ነው።
+  ደሀ በሕልሙ ቅቤ ባይጠጣ ንጣት በገደለው።
+  የአፍ ወለምታ በቅቤ አይታሽም።
+  አይጥ በበላ ዳዋ ተመታ።
+  ሲተረጉሙ ይደረግሙ።
+  ቀስ በቀስ፥ ዕንቁላል በእግሩ ይሄዳል።
+  ድር ቢያብር አንበሳ ያስር።
+  ሰው እንደቤቱ እንጅ እንደ ጉረቤቱ አይተዳደርም።
+  እግዜር የከፈተውን ጉሮሮ ሳይዘጋው አይድርም።
+  የጎረቤት ሌባ፥ ቢያዩት ይስቅ ባያዩት ያጠልቅ።
+  ሥራ ከመፍታት ልጄን ላፋታት።
+  ዓባይ ማደሪያ የለው፥ ግንድ ይዞ ይዞራል።
+  የእስላም አገሩ መካ የአሞራ አገሩ ዋርካ።
+  ተንጋሎ ቢተፉ ተመልሶ ባፉ።
+  ወዳጅህ ማር ቢሆን ጨርስህ አትላሰው።
+  እግርህን በፍራሽህ ልክ ዘርጋ።
+
+Runes:
+
+  ᚻᛖ ᚳᚹᚫᚦ ᚦᚫᛏ ᚻᛖ ᛒᚢᛞᛖ ᚩᚾ ᚦᚫᛗ ᛚᚪᚾᛞᛖ ᚾᚩᚱᚦᚹᛖᚪᚱᛞᚢᛗ ᚹᛁᚦ ᚦᚪ ᚹᛖᛥᚫ
+
+  (Old English, which transcribed into Latin reads 'He cwaeth that he
+  bude thaem lande northweardum with tha Westsae.' and means 'He said
+  that he lived in the northern land near the Western Sea.')
+
+Braille:
+
+  ⡌⠁⠧⠑ ⠼⠁⠒  ⡍⠜⠇⠑⠹⠰⠎ ⡣⠕⠌
+
+  ⡍⠜⠇⠑⠹ ⠺⠁⠎ ⠙⠑⠁⠙⠒ ⠞⠕ ⠃⠑⠛⠔ ⠺⠊⠹⠲ ⡹⠻⠑ ⠊⠎ ⠝⠕ ⠙⠳⠃⠞
+  ⠱⠁⠞⠑⠧⠻ ⠁⠃⠳⠞ ⠹⠁⠞⠲ ⡹⠑ ⠗⠑⠛⠊⠌⠻ ⠕⠋ ⠙⠊⠎ ⠃⠥⠗⠊⠁⠇ ⠺⠁⠎
+  ⠎⠊⠛⠝⠫ ⠃⠹ ⠹⠑ ⠊⠇⠻⠛⠹⠍⠁⠝⠂ ⠹⠑ ⠊⠇⠻⠅⠂ ⠹⠑ ⠥⠝⠙⠻⠞⠁⠅⠻⠂
+  ⠁⠝⠙ ⠹⠑ ⠡⠊⠑⠋ ⠍⠳⠗⠝⠻⠲ ⡎⠊⠗⠕⠕⠛⠑ ⠎⠊⠛⠝⠫ ⠊⠞⠲ ⡁⠝⠙
+  ⡎⠊⠗⠕⠕⠛⠑⠰⠎ ⠝⠁⠍⠑ ⠺⠁⠎ ⠛⠕⠕⠙ ⠥⠏⠕⠝ ⠰⡡⠁⠝⠛⠑⠂ ⠋⠕⠗ ⠁⠝⠹⠹⠔⠛ ⠙⠑
+  ⠡⠕⠎⠑ ⠞⠕ ⠏⠥⠞ ⠙⠊⠎ ⠙⠁⠝⠙ ⠞⠕⠲
+
+  ⡕⠇⠙ ⡍⠜⠇⠑⠹ ⠺⠁⠎ ⠁⠎ ⠙⠑⠁⠙ ⠁⠎ ⠁ ⠙⠕⠕⠗⠤⠝⠁⠊⠇⠲
+
+  ⡍⠔⠙⠖ ⡊ ⠙⠕⠝⠰⠞ ⠍⠑⠁⠝ ⠞⠕ ⠎⠁⠹ ⠹⠁⠞ ⡊ ⠅⠝⠪⠂ ⠕⠋ ⠍⠹
+  ⠪⠝ ⠅⠝⠪⠇⠫⠛⠑⠂ ⠱⠁⠞ ⠹⠻⠑ ⠊⠎ ⠏⠜⠞⠊⠊⠥⠇⠜⠇⠹ ⠙⠑⠁⠙ ⠁⠃⠳⠞
+  ⠁ ⠙⠕⠕⠗⠤⠝⠁⠊⠇⠲ ⡊ ⠍⠊⠣⠞ ⠙⠁⠧⠑ ⠃⠑⠲ ⠔⠊⠇⠔⠫⠂ ⠍⠹⠎⠑⠇⠋⠂ ⠞⠕
+  ⠗⠑⠛⠜⠙ ⠁ ⠊⠕⠋⠋⠔⠤⠝⠁⠊⠇ ⠁⠎ ⠹⠑ ⠙⠑⠁⠙⠑⠌ ⠏⠊⠑⠊⠑ ⠕⠋ ⠊⠗⠕⠝⠍⠕⠝⠛⠻⠹
+  ⠔ ⠹⠑ ⠞⠗⠁⠙⠑⠲ ⡃⠥⠞ ⠹⠑ ⠺⠊⠎⠙⠕⠍ ⠕⠋ ⠳⠗ ⠁⠝⠊⠑⠌⠕⠗⠎
+  ⠊⠎ ⠔ ⠹⠑ ⠎⠊⠍⠊⠇⠑⠆ ⠁⠝⠙ ⠍⠹ ⠥⠝⠙⠁⠇⠇⠪⠫ ⠙⠁⠝⠙⠎
+  ⠩⠁⠇⠇ ⠝⠕⠞ ⠙⠊⠌⠥⠗⠃ ⠊⠞⠂ ⠕⠗ ⠹⠑ ⡊⠳⠝⠞⠗⠹⠰⠎ ⠙⠕⠝⠑ ⠋⠕⠗⠲ ⡹⠳
+  ⠺⠊⠇⠇ ⠹⠻⠑⠋⠕⠗⠑ ⠏⠻⠍⠊⠞ ⠍⠑ ⠞⠕ ⠗⠑⠏⠑⠁⠞⠂ ⠑⠍⠏⠙⠁⠞⠊⠊⠁⠇⠇⠹⠂ ⠹⠁⠞
+  ⡍⠜⠇⠑⠹ ⠺⠁⠎ ⠁⠎ ⠙⠑⠁⠙ ⠁⠎ ⠁ ⠙⠕⠕⠗⠤⠝⠁⠊⠇⠲
+
+  (The first couple of paragraphs of "A Christmas Carol" by Dickens)
+
+Compact font selection example text:
+
+  ABCDEFGHIJKLMNOPQRSTUVWXYZ /0123456789
+  abcdefghijklmnopqrstuvwxyz £©µÀÆÖÞßéöÿ
+  –—‘“”„†•…‰™œŠŸž€ ΑΒΓΔΩαβγδω АБВГДабвгд
+  ∀∂∈ℝ∧∪≡∞ ↑↗↨↻⇣ ┐┼╔╘░►☺♀ fi�⑀₂ἠḂӥẄɐː⍎אԱა
+
+Greetings in various languages:
+
+  Hello world, Καλημέρα κόσμε, コンニチハ
+
+Box drawing alignment tests:                                          █
+                                                                      ▉
+  ╔══╦══╗  ┌──┬──┐  ╭──┬──╮  ╭──┬──╮  ┏━━┳━━┓  ┎┒┏┑   ╷  ╻ ┏┯┓ ┌┰┐    ▊ ╱╲╱╲╳╳╳
+  ║┌─╨─┐║  │╔═╧═╗│  │╒═╪═╕│  │╓─╁─╖│  ┃┌─╂─┐┃  ┗╃╄┙  ╶┼╴╺╋╸┠┼┨ ┝╋┥    ▋ ╲╱╲╱╳╳╳
+  ║│╲ ╱│║  │║   ║│  ││ │ ││  │║ ┃ ║│  ┃│ ╿ │┃  ┍╅╆┓   ╵  ╹ ┗┷┛ └┸┘    ▌ ╱╲╱╲╳╳╳
+  ╠╡ ╳ ╞╣  ├╢   ╟┤  ├┼─┼─┼┤  ├╫─╂─╫┤  ┣┿╾┼╼┿┫  ┕┛┖┚     ┌┄┄┐ ╎ ┏┅┅┓ ┋ ▍ ╲╱╲╱╳╳╳
+  ║│╱ ╲│║  │║   ║│  ││ │ ││  │║ ┃ ║│  ┃│ ╽ │┃  ░░▒▒▓▓██ ┊  ┆ ╎ ╏  ┇ ┋ ▎
+  ║└─╥─┘║  │╚═╤═╝│  │╘═╪═╛│  │╙─╀─╜│  ┃└─╂─┘┃  ░░▒▒▓▓██ ┊  ┆ ╎ ╏  ┇ ┋ ▏
+  ╚══╩══╝  └──┴──┘  ╰──┴──╯  ╰──┴──╯  ┗━━┻━━┛  ▗▄▖▛▀▜   └╌╌┘ ╎ ┗╍╍┛ ┋  ▁▂▃▄▅▆▇█
+                                               ▝▀▘▙▄▟