408 lines
		
	
	
		
			13 KiB
		
	
	
	
		
			HTML
		
	
	
		
			Executable File
		
	
	
	
	
			
		
		
	
	
			408 lines
		
	
	
		
			13 KiB
		
	
	
	
		
			HTML
		
	
	
		
			Executable File
		
	
	
	
	
| <!doctype html>
 | |
| 
 | |
| <title>CodeMirror: Dylan mode</title>
 | |
| <meta charset="utf-8"/>
 | |
| <link rel=stylesheet href="../../doc/docs.css">
 | |
| 
 | |
| <link rel="stylesheet" href="../../lib/codemirror.css">
 | |
| <script src="../../lib/codemirror.js"></script>
 | |
| <script src="../../addon/edit/matchbrackets.js"></script>
 | |
| <script src="../../addon/comment/continuecomment.js"></script>
 | |
| <script src="../../addon/comment/comment.js"></script>
 | |
| <script src="dylan.js"></script>
 | |
| <style type="text/css">.CodeMirror {border-top: 1px solid black; border-bottom: 1px solid black;}</style>
 | |
| <div id=nav>
 | |
|   <a href="http://codemirror.net"><h1>CodeMirror</h1><img id=logo src="../../doc/logo.png"></a>
 | |
| 
 | |
|   <ul>
 | |
|     <li><a href="../../index.html">Home</a>
 | |
|     <li><a href="../../doc/manual.html">Manual</a>
 | |
|     <li><a href="https://github.com/codemirror/codemirror">Code</a>
 | |
|   </ul>
 | |
|   <ul>
 | |
|     <li><a href="../index.html">Language modes</a>
 | |
|     <li><a class=active href="#">Dylan</a>
 | |
|   </ul>
 | |
| </div>
 | |
| 
 | |
| <article>
 | |
| <h2>Dylan mode</h2>
 | |
| 
 | |
| 
 | |
| <div><textarea id="code" name="code">
 | |
| Module:       locators-internals
 | |
| Synopsis:     Abstract modeling of locations
 | |
| Author:       Andy Armstrong
 | |
| Copyright:    Original Code is Copyright (c) 1995-2004 Functional Objects, Inc.
 | |
|               All rights reserved.
 | |
| License:      See License.txt in this distribution for details.
 | |
| Warranty:     Distributed WITHOUT WARRANTY OF ANY KIND
 | |
| 
 | |
| define open generic locator-server
 | |
|     (locator :: <locator>) => (server :: false-or(<server-locator>));
 | |
| define open generic locator-host
 | |
|     (locator :: <locator>) => (host :: false-or(<string>));
 | |
| define open generic locator-volume
 | |
|     (locator :: <locator>) => (volume :: false-or(<string>));
 | |
| define open generic locator-directory
 | |
|     (locator :: <locator>) => (directory :: false-or(<directory-locator>));
 | |
| define open generic locator-relative?
 | |
|     (locator :: <locator>) => (relative? :: <boolean>);
 | |
| define open generic locator-path
 | |
|     (locator :: <locator>) => (path :: <sequence>);
 | |
| define open generic locator-base
 | |
|     (locator :: <locator>) => (base :: false-or(<string>));
 | |
| define open generic locator-extension
 | |
|     (locator :: <locator>) => (extension :: false-or(<string>));
 | |
| 
 | |
| /// Locator classes
 | |
| 
 | |
| define open abstract class <directory-locator> (<physical-locator>)
 | |
| end class <directory-locator>;
 | |
| 
 | |
| define open abstract class <file-locator> (<physical-locator>)
 | |
| end class <file-locator>;
 | |
| 
 | |
| define method as
 | |
|     (class == <directory-locator>, string :: <string>)
 | |
|  => (locator :: <directory-locator>)
 | |
|   as(<native-directory-locator>, string)
 | |
| end method as;
 | |
| 
 | |
| define method make
 | |
|     (class == <directory-locator>,
 | |
|      #key server :: false-or(<server-locator>) = #f,
 | |
|           path :: <sequence> = #[],
 | |
|           relative? :: <boolean> = #f,
 | |
|           name :: false-or(<string>) = #f)
 | |
|  => (locator :: <directory-locator>)
 | |
|   make(<native-directory-locator>,
 | |
|        server:    server,
 | |
|        path:      path,
 | |
|        relative?: relative?,
 | |
|        name:      name)
 | |
| end method make;
 | |
| 
 | |
| define method as
 | |
|     (class == <file-locator>, string :: <string>)
 | |
|  => (locator :: <file-locator>)
 | |
|   as(<native-file-locator>, string)
 | |
| end method as;
 | |
| 
 | |
| define method make
 | |
|     (class == <file-locator>,
 | |
|      #key directory :: false-or(<directory-locator>) = #f,
 | |
|           base :: false-or(<string>) = #f,
 | |
|           extension :: false-or(<string>) = #f,
 | |
|           name :: false-or(<string>) = #f)
 | |
|  => (locator :: <file-locator>)
 | |
|   make(<native-file-locator>,
 | |
|        directory: directory,
 | |
|        base:      base,
 | |
|        extension: extension,
 | |
|        name:      name)
 | |
| end method make;
 | |
| 
 | |
| /// Locator coercion
 | |
| 
 | |
| //---*** andrewa: This caching scheme doesn't work yet, so disable it.
 | |
| define constant $cache-locators?        = #f;
 | |
| define constant $cache-locator-strings? = #f;
 | |
| 
 | |
| define constant $locator-to-string-cache = make(<object-table>, weak: #"key");
 | |
| define constant $string-to-locator-cache = make(<string-table>, weak: #"value");
 | |
| 
 | |
| define open generic locator-as-string
 | |
|     (class :: subclass(<string>), locator :: <locator>)
 | |
|  => (string :: <string>);
 | |
| 
 | |
| define open generic string-as-locator
 | |
|     (class :: subclass(<locator>), string :: <string>)
 | |
|  => (locator :: <locator>);
 | |
| 
 | |
| define sealed sideways method as
 | |
|     (class :: subclass(<string>), locator :: <locator>)
 | |
|  => (string :: <string>)
 | |
|   let string = element($locator-to-string-cache, locator, default: #f);
 | |
|   if (string)
 | |
|     as(class, string)
 | |
|   else
 | |
|     let string = locator-as-string(class, locator);
 | |
|     if ($cache-locator-strings?)
 | |
|       element($locator-to-string-cache, locator) := string;
 | |
|     else
 | |
|       string
 | |
|     end
 | |
|   end
 | |
| end method as;
 | |
| 
 | |
| define sealed sideways method as
 | |
|     (class :: subclass(<locator>), string :: <string>)
 | |
|  => (locator :: <locator>)
 | |
|   let locator = element($string-to-locator-cache, string, default: #f);
 | |
|   if (instance?(locator, class))
 | |
|     locator
 | |
|   else
 | |
|     let locator = string-as-locator(class, string);
 | |
|     if ($cache-locators?)
 | |
|       element($string-to-locator-cache, string) := locator;
 | |
|     else
 | |
|       locator
 | |
|     end
 | |
|   end
 | |
| end method as;
 | |
| 
 | |
| /// Locator conditions
 | |
| 
 | |
| define class <locator-error> (<format-string-condition>, <error>)
 | |
| end class <locator-error>;
 | |
| 
 | |
| define function locator-error
 | |
|     (format-string :: <string>, #rest format-arguments)
 | |
|   error(make(<locator-error>, 
 | |
|              format-string:    format-string,
 | |
|              format-arguments: format-arguments))
 | |
| end function locator-error;
 | |
| 
 | |
| /// Useful locator protocols
 | |
| 
 | |
| define open generic locator-test
 | |
|     (locator :: <directory-locator>) => (test :: <function>);
 | |
| 
 | |
| define method locator-test
 | |
|     (locator :: <directory-locator>) => (test :: <function>)
 | |
|   \=
 | |
| end method locator-test;
 | |
| 
 | |
| define open generic locator-might-have-links?
 | |
|     (locator :: <directory-locator>) => (links? :: <boolean>);
 | |
| 
 | |
| define method locator-might-have-links?
 | |
|     (locator :: <directory-locator>) => (links? :: singleton(#f))
 | |
|   #f
 | |
| end method locator-might-have-links?;
 | |
| 
 | |
| define method locator-relative?
 | |
|     (locator :: <file-locator>) => (relative? :: <boolean>)
 | |
|   let directory = locator.locator-directory;
 | |
|   ~directory | directory.locator-relative?
 | |
| end method locator-relative?;
 | |
| 
 | |
| define method current-directory-locator?
 | |
|     (locator :: <directory-locator>) => (current-directory? :: <boolean>)
 | |
|   locator.locator-relative?
 | |
|     & locator.locator-path = #[#"self"]
 | |
| end method current-directory-locator?;
 | |
| 
 | |
| define method locator-directory
 | |
|     (locator :: <directory-locator>) => (parent :: false-or(<directory-locator>))
 | |
|   let path = locator.locator-path;
 | |
|   unless (empty?(path))
 | |
|     make(object-class(locator),
 | |
|          server:    locator.locator-server,
 | |
|          path:      copy-sequence(path, end: path.size - 1),
 | |
|          relative?: locator.locator-relative?)
 | |
|   end
 | |
| end method locator-directory;
 | |
| 
 | |
| /// Simplify locator
 | |
| 
 | |
| define open generic simplify-locator
 | |
|     (locator :: <physical-locator>)
 | |
|  => (simplified-locator :: <physical-locator>);
 | |
| 
 | |
| define method simplify-locator
 | |
|     (locator :: <directory-locator>)
 | |
|  => (simplified-locator :: <directory-locator>)
 | |
|   let path = locator.locator-path;
 | |
|   let relative? = locator.locator-relative?;
 | |
|   let resolve-parent? = ~locator.locator-might-have-links?;
 | |
|   let simplified-path
 | |
|     = simplify-path(path, 
 | |
|                     resolve-parent?: resolve-parent?,
 | |
|                     relative?: relative?);
 | |
|   if (path ~= simplified-path)
 | |
|     make(object-class(locator),
 | |
|          server:    locator.locator-server,
 | |
|          path:      simplified-path,
 | |
|          relative?: locator.locator-relative?)
 | |
|   else
 | |
|     locator
 | |
|   end
 | |
| end method simplify-locator;
 | |
| 
 | |
| define method simplify-locator
 | |
|     (locator :: <file-locator>) => (simplified-locator :: <file-locator>)
 | |
|   let directory = locator.locator-directory;
 | |
|   let simplified-directory = directory & simplify-locator(directory);
 | |
|   if (directory ~= simplified-directory)
 | |
|     make(object-class(locator),
 | |
|          directory: simplified-directory,
 | |
|          base:      locator.locator-base,
 | |
|          extension: locator.locator-extension)
 | |
|   else
 | |
|     locator
 | |
|   end
 | |
| end method simplify-locator;
 | |
| 
 | |
| /// Subdirectory locator
 | |
| 
 | |
| define open generic subdirectory-locator
 | |
|     (locator :: <directory-locator>, #rest sub-path)
 | |
|  => (subdirectory :: <directory-locator>);
 | |
| 
 | |
| define method subdirectory-locator
 | |
|     (locator :: <directory-locator>, #rest sub-path)
 | |
|  => (subdirectory :: <directory-locator>)
 | |
|   let old-path = locator.locator-path;
 | |
|   let new-path = concatenate-as(<simple-object-vector>, old-path, sub-path);
 | |
|   make(object-class(locator),
 | |
|        server:    locator.locator-server,
 | |
|        path:      new-path,
 | |
|        relative?: locator.locator-relative?)
 | |
| end method subdirectory-locator;
 | |
| 
 | |
| /// Relative locator
 | |
| 
 | |
| define open generic relative-locator
 | |
|     (locator :: <physical-locator>, from-locator :: <physical-locator>)
 | |
|  => (relative-locator :: <physical-locator>);
 | |
| 
 | |
| define method relative-locator
 | |
|     (locator :: <directory-locator>, from-locator :: <directory-locator>)
 | |
|  => (relative-locator :: <directory-locator>)
 | |
|   let path = locator.locator-path;
 | |
|   let from-path = from-locator.locator-path;
 | |
|   case
 | |
|     ~locator.locator-relative? & from-locator.locator-relative? =>
 | |
|       locator-error
 | |
|         ("Cannot find relative path of absolute locator %= from relative locator %=",
 | |
|          locator, from-locator);
 | |
|     locator.locator-server ~= from-locator.locator-server =>
 | |
|       locator;
 | |
|     path = from-path =>
 | |
|       make(object-class(locator),
 | |
|            path: vector(#"self"),
 | |
|            relative?: #t);
 | |
|     otherwise =>
 | |
|       make(object-class(locator),
 | |
|            path: relative-path(path, from-path, test: locator.locator-test),
 | |
|            relative?: #t);
 | |
|   end
 | |
| end method relative-locator;
 | |
| 
 | |
| define method relative-locator
 | |
|     (locator :: <file-locator>, from-directory :: <directory-locator>)
 | |
|  => (relative-locator :: <file-locator>)
 | |
|   let directory = locator.locator-directory;
 | |
|   let relative-directory = directory & relative-locator(directory, from-directory);
 | |
|   if (relative-directory ~= directory)
 | |
|     simplify-locator
 | |
|       (make(object-class(locator),
 | |
|             directory: relative-directory,
 | |
|             base:      locator.locator-base,
 | |
|             extension: locator.locator-extension))
 | |
|   else
 | |
|     locator
 | |
|   end
 | |
| end method relative-locator;
 | |
| 
 | |
| define method relative-locator
 | |
|     (locator :: <physical-locator>, from-locator :: <file-locator>)
 | |
|  => (relative-locator :: <physical-locator>)
 | |
|   let from-directory = from-locator.locator-directory;
 | |
|   case
 | |
|     from-directory =>
 | |
|       relative-locator(locator, from-directory);
 | |
|     ~locator.locator-relative? =>
 | |
|       locator-error
 | |
|         ("Cannot find relative path of absolute locator %= from relative locator %=",
 | |
|          locator, from-locator);
 | |
|     otherwise =>
 | |
|       locator;
 | |
|   end
 | |
| end method relative-locator;
 | |
| 
 | |
| /// Merge locators
 | |
| 
 | |
| define open generic merge-locators
 | |
|     (locator :: <physical-locator>, from-locator :: <physical-locator>)
 | |
|  => (merged-locator :: <physical-locator>);
 | |
| 
 | |
| /// Merge locators
 | |
| 
 | |
| define method merge-locators
 | |
|     (locator :: <directory-locator>, from-locator :: <directory-locator>)
 | |
|  => (merged-locator :: <directory-locator>)
 | |
|   if (locator.locator-relative?)
 | |
|     let path = concatenate(from-locator.locator-path, locator.locator-path);
 | |
|     simplify-locator
 | |
|       (make(object-class(locator),
 | |
|             server:    from-locator.locator-server,
 | |
|             path:      path,
 | |
|             relative?: from-locator.locator-relative?))
 | |
|   else
 | |
|     locator
 | |
|   end
 | |
| end method merge-locators;
 | |
| 
 | |
| define method merge-locators
 | |
|     (locator :: <file-locator>, from-locator :: <directory-locator>)
 | |
|  => (merged-locator :: <file-locator>)
 | |
|   let directory = locator.locator-directory;
 | |
|   let merged-directory 
 | |
|     = if (directory)
 | |
|         merge-locators(directory, from-locator)
 | |
|       else
 | |
|         simplify-locator(from-locator)
 | |
|       end;
 | |
|   if (merged-directory ~= directory)
 | |
|     make(object-class(locator),
 | |
|          directory: merged-directory,
 | |
|          base:      locator.locator-base,
 | |
|          extension: locator.locator-extension)
 | |
|   else
 | |
|     locator
 | |
|   end
 | |
| end method merge-locators;
 | |
| 
 | |
| define method merge-locators
 | |
|     (locator :: <physical-locator>, from-locator :: <file-locator>)
 | |
|  => (merged-locator :: <physical-locator>)
 | |
|   let from-directory = from-locator.locator-directory;
 | |
|   if (from-directory)
 | |
|     merge-locators(locator, from-directory)
 | |
|   else
 | |
|     locator
 | |
|   end
 | |
| end method merge-locators;
 | |
| 
 | |
| /// Locator protocols
 | |
| 
 | |
| define sideways method supports-open-locator?
 | |
|     (locator :: <file-locator>) => (openable? :: <boolean>)
 | |
|   ~locator.locator-relative?
 | |
| end method supports-open-locator?;
 | |
| 
 | |
| define sideways method open-locator
 | |
|     (locator :: <file-locator>, #rest keywords, #key, #all-keys)
 | |
|  => (stream :: <stream>)
 | |
|   apply(open-file-stream, locator, keywords)
 | |
| end method open-locator;
 | |
| </textarea></div>
 | |
| 
 | |
|     <script>
 | |
|       var editor = CodeMirror.fromTextArea(document.getElementById("code"), {
 | |
|         mode: "text/x-dylan",
 | |
|         lineNumbers: true,
 | |
|         matchBrackets: true,
 | |
|         continueComments: "Enter",
 | |
|         extraKeys: {"Ctrl-Q": "toggleComment"},
 | |
|         tabMode: "indent",
 | |
|         indentUnit: 2
 | |
|       });
 | |
|     </script>
 | |
| 
 | |
|     <p><strong>MIME types defined:</strong> <code>text/x-dylan</code>.</p>
 | |
| </article>
 |