[elpa] externals/hcel 027fe02f5d: Adding a function to go from hcel to haddorg

[ELPA Syncer]

branch: externals/hcel
commit 027fe02f5d577c5d0d1e78b84ed20287ce02972a
Author: Yuchen Pei <hi@ypei.me>
Commit: Yuchen Pei <hi@ypei.me>

    Adding a function to go from hcel to haddorg
---
 hcel-haddorg.el | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/hcel-haddorg.el b/hcel-haddorg.el
index 0662b5ddb4..f757e24388 100644
--- a/hcel-haddorg.el
+++ b/hcel-haddorg.el
@@ -21,6 +21,15 @@
 (require 'hcel-utils)
 (require 'org)
 
+(defcustom hcel-haddorg-dir "~/Projects/sedoc/haddock/org-output"
+  "Directory of haddorg org files.")
+
+(defcustom hcel-haddorg-lax-version t
+  "If non-nil, match highest version if no exact match found.
+
+Say we have ghc-8.6.5.org and ghc-9.2.2.org.  If the definition
+is in ghc-8.10.1, hcel will attempt to look up in ghc-9.2.2.org.")
+
 (defun hcel-haddorg-to-hcel-definition ()
   (interactive)
   (save-excursion
@@ -44,5 +53,44 @@
                   (hcel-api-definition-site
                    package-id "lib" module-name entity name))))))
 
+(defun hcel-identifier-at-point-to-haddorg ()
+  (interactive)
+  (when-let* ((identifier (hcel-text-property-near-point 'identifier))
+              (external-id (alist-get 'externalId
+                                      (alist-get (intern identifier)
+                                                 hcel-identifiers))))
+    (let* ((splitted (split-string external-id "|"))
+           (package-id (car splitted))
+           (module-name (cadr splitted))
+           (entity (cond ((equal (caddr splitted) "Typ") "t")
+                         ((equal (caddr splitted) "Val") "v")
+                         (t nil)))
+           (name (cadddr splitted))
+           (file-name (hcel-haddorg-fuzzy-version-match package-id))
+           (custom-id (concat module-name "/" entity "/" name)))
+      (unless file-name
+        (error "Cannot find org file for %s" package-id))
+      (org-link-open-from-string
+       (format "[[file:%s::#%s]]" file-name custom-id)))))
+
+(defun hcel-haddorg-fuzzy-version-match (package-id)
+  (let ((exact-match
+         (expand-file-name (format "%s/%s.org" hcel-haddorg-dir package-id))))
+    (cond ((file-exists-p exact-match) exact-match)
+          (hcel-haddorg-lax-version
+           (when-let ((files
+                       (sort (directory-files
+                              hcel-haddorg-dir t
+                              (format "^%s\\(-[0-9.]+\\)?\\.org$"
+                                      (car (split-string package-id "-"))))
+                             (lambda (x y)
+                               (string> (file-name-base x)
+                                        (file-name-base y))))))
+             (message
+              "Cannot find org file for %s, opening instead that of the 
highest available version %s."
+              package-id (file-name-base (car files)))
+             (car files)))
+          (t nil))))
+
 (provide 'hcel-haddorg)
 ;;; hcel-haddorg.el ends here.