(eval-when-compile
(require 'cl))
(defgroup glasses nil
"Make unreadable code likeThis(one) readable."
:version "21.1"
:group 'tools)
(defcustom glasses-separator "_"
"*String to be displayed as a visual separator in unreadable identifiers."
:group 'glasses
:type 'string
:set 'glasses-custom-set
:initialize 'custom-initialize-default)
(defcustom glasses-face nil
"*Face to be put on capitals of an identifier looked through glasses.
If it is nil, no face is placed at the capitalized letter.
For example, you can set `glasses-separator' to an empty string and
`glasses-face' to `bold'. Then unreadable identifiers will have no separators,
but will have their capitals in bold."
:group 'glasses
:type 'symbol
:set 'glasses-custom-set
:initialize 'custom-initialize-default)
(defcustom glasses-separate-parentheses-p t
"*If non-nil, ensure space between an identifier and an opening parenthesis."
:group 'glasses
:type 'boolean)
(defcustom glasses-uncapitalize-p nil
"*If non-nil, downcase embedded capital letters in identifiers.
Only identifiers starting with lower case letters are affected, letters inside
other identifiers are unchanged."
:group 'glasses
:type 'boolean
:set 'glasses-custom-set
:initialize 'custom-initialize-default)
(defcustom glasses-uncapitalize-regexp "[a-z]"
"*Regexp matching beginnings of words to be uncapitalized.
Only words starting with this regexp are uncapitalized.
The regexp is case sensitive.
It has any effect only when `glasses-uncapitalize-p' is non-nil."
:group 'glasses
:type 'regexp
:set 'glasses-custom-set
:initialize 'custom-initialize-default)
(defcustom glasses-convert-on-write-p nil
"*If non-nil, remove separators when writing glasses buffer to a file.
If you are confused by glasses so much, that you write the separators into code
during coding, set this variable to t. The separators will be removed on each
file write then.
Note the removal action does not try to be much clever, so it can remove real
separators too."
:group 'glasses
:type 'boolean)
(defun glasses-custom-set (symbol value)
"Set value of the variable SYMBOL to VALUE and update overlay categories.
Used in :set parameter of some customized glasses variables."
(set-default symbol value)
(glasses-set-overlay-properties))
(defun glasses-set-overlay-properties ()
"Set properties of glasses overlays.
Consider current setting of user variables."
(put 'glasses 'evaporate t)
(put 'glasses 'before-string glasses-separator)
(put 'glasses 'face glasses-face)
(put 'glasses-init 'evaporate t)
(put 'glasses-init 'face glasses-face)
(put 'glasses-parenthesis 'evaporate t)
(put 'glasses-parenthesis 'before-string " "))
(glasses-set-overlay-properties)
(defun glasses-overlay-p (overlay)
"Return whether OVERLAY is an overlay of glasses mode."
(memq (overlay-get overlay 'category)
'(glasses glasses-init glasses-parenthesis)))
(defun glasses-make-overlay (beg end &optional category)
"Create and return readability overlay over the region from BEG to END.
CATEGORY is the overlay category. If it is nil, use the `glasses' category."
(let ((overlay (make-overlay beg end)))
(overlay-put overlay 'category (or category 'glasses))
overlay))
(defun glasses-make-readable (beg end)
"Make identifiers in the region from BEG to END readable."
(let ((case-fold-search nil))
(save-excursion
(save-match-data
(goto-char beg)
(while (re-search-forward
"\\<\\([A-Z]\\)[a-zA-Z]*\\([a-z][A-Z]\\|[A-Z][a-z]\\)"
end t)
(glasses-make-overlay (match-beginning 1) (match-end 1)
'glasses-init))
(goto-char beg)
(while (re-search-forward "[a-z]\\([A-Z]\\)\\|[A-Z]\\([A-Z]\\)[a-z]"
end t)
(let* ((n (if (match-string 1) 1 2))
(o (glasses-make-overlay (match-beginning n) (match-end n))))
(goto-char (match-beginning n))
(when (and glasses-uncapitalize-p
(save-match-data
(looking-at "[A-Z]\\($\\|[^A-Z]\\)"))
(save-excursion
(save-match-data
(re-search-backward "\\<.")
(looking-at glasses-uncapitalize-regexp))))
(overlay-put o 'invisible t)
(overlay-put o 'after-string (downcase (match-string n))))))
(when glasses-separate-parentheses-p
(goto-char beg)
(while (re-search-forward "[a-zA-Z]_*\\(\(\\)" end t)
(glasses-make-overlay (match-beginning 1) (match-end 1)
'glasses-parenthesis)))))))
(defun glasses-make-unreadable (beg end)
"Return identifiers in the region from BEG to END to their unreadable state."
(dolist (o (overlays-in beg end))
(when (glasses-overlay-p o)
(delete-overlay o))))
(defun glasses-convert-to-unreadable ()
"Convert current buffer to unreadable identifiers and return nil.
This function modifies buffer contents, it removes all the separators,
recognized according to the current value of the variable `glasses-separator'."
(when (and glasses-convert-on-write-p
(not (string= glasses-separator "")))
(let ((case-fold-search nil)
(separator (regexp-quote glasses-separator)))
(save-excursion
(goto-char (point-min))
(while (re-search-forward
(format "[a-z]\\(%s\\)[A-Z]\\|[A-Z]\\(%s\\)[A-Z][a-z]"
separator separator)
nil t)
(let ((n (if (match-string 1) 1 2)))
(replace-match "" t nil nil n)
(goto-char (match-end n))))
(when glasses-separate-parentheses-p
(goto-char (point-min))
(while (re-search-forward "[a-zA-Z]_*\\( \\)\(" nil t)
(replace-match "" t nil nil 1))))))
nil)
(defun glasses-change (beg end &optional old-len)
"After-change function updating glass overlays."
(let ((beg-line (save-excursion (goto-char beg) (line-beginning-position)))
(end-line (save-excursion (goto-char end) (line-end-position))))
(glasses-make-unreadable beg-line end-line)
(glasses-make-readable beg-line end-line)))
(define-minor-mode glasses-mode
"Minor mode for making identifiers likeThis readable.
When this mode is active, it tries to add virtual separators (like underscores)
at places they belong to."
nil " o^o" nil
(save-excursion
(save-restriction
(widen)
(glasses-make-unreadable (point-min) (point-max))
(if glasses-mode
(progn
(jit-lock-register 'glasses-change)
(add-hook 'local-write-file-hooks
'glasses-convert-to-unreadable nil t))
(jit-lock-unregister 'glasses-change)
(remove-hook 'local-write-file-hooks
'glasses-convert-to-unreadable t)))))
(provide 'glasses)