about summary refs log tree commit diff
path: root/lisp/f/main.lisp
blob: a51c381278150a60e3b7899dc9f32bdf266bd8d1 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
(in-package #:cl-user)
(defpackage #:main
  (:documentation "Modern API for working with files and directories.")
  (:use #:cl)
  (:shadow #:type))
(in-package #:main)

;; Common Lisp distinguishes between `namestrings` and `pathnames` as two types
;; of filename representations.
;;
;; A `pathname` is a structured representation of the name of a file, which
;; consists of six parts:
;; 1. host
;; 2. device
;; 3. directory
;; 4. name
;; 5. type
;; 6. version

;; TODO: Should I be using `string` as a type or `namestring`?

(defmacro type (name in out)
  `(declaim (ftype (function ,in ,out) ,name)))

(type join (&rest namestring) pathname)
(defun join (&rest args)
  "Join ARGS to a single path."
  (apply #'merge-pathnames args))

(type ext (pathname) string)
(defun ext (path)
  "Return the file extension of PATH."
  (pathname-type path))

;; TODO: Define these tests elsewhere.

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Tests
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

;; join
(string= (join "path") "path")
(string= (join "path" "to") "path/to")
(string= (join "/" "path" "to" "heaven") "/path/to/heaven")

;; ext
(string= (ext #p"path/to/file.ext") "ext")
(string= (ext #p"path/to/directory") nil)