|
|
|
;;; phpinspect-project.el --- PHP parsing and completion package -*- lexical-binding: t; -*-
|
|
|
|
|
|
|
|
;; Copyright (C) 2021 Free Software Foundation, Inc
|
|
|
|
|
|
|
|
;; Author: Hugo Thunnissen <devel@hugot.nl>
|
|
|
|
;; Keywords: php, languages, tools, convenience
|
|
|
|
;; Version: 0
|
|
|
|
|
|
|
|
;; This program is free software; you can redistribute it and/or modify
|
|
|
|
;; it under the terms of the GNU General Public License as published by
|
|
|
|
;; the Free Software Foundation, either version 3 of the License, or
|
|
|
|
;; (at your option) any later version.
|
|
|
|
|
|
|
|
;; This program is distributed in the hope that it will be useful,
|
|
|
|
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
;; GNU General Public License for more details.
|
|
|
|
|
|
|
|
;; You should have received a copy of the GNU General Public License
|
|
|
|
;; along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
|
|
|
|
;;; Commentary:
|
|
|
|
|
|
|
|
;;; Code:
|
|
|
|
|
|
|
|
(require 'phpinspect-class)
|
|
|
|
(require 'phpinspect-type)
|
|
|
|
(require 'phpinspect-fs)
|
|
|
|
(require 'filenotify)
|
|
|
|
|
|
|
|
(defvar phpinspect-auto-reindex nil
|
|
|
|
"Whether or not phpinspect should automatically search for new
|
|
|
|
files. The current implementation is clumsy and can result in
|
|
|
|
serious performance hits. Enable at your own risk (:")
|
|
|
|
|
|
|
|
(defvar phpinspect-project-root-function #'phpinspect--find-project-root
|
|
|
|
"Function that phpinspect uses to find the root directory of a project.")
|
|
|
|
|
|
|
|
(defvar-local phpinspect--buffer-project nil
|
|
|
|
"The root directory of the PHP project that this buffer belongs to")
|
|
|
|
|
|
|
|
(defsubst phpinspect-current-project-root ()
|
|
|
|
"Call `phpinspect-project-root-function' with ARGS as arguments."
|
|
|
|
(unless (and (boundp 'phpinspect--buffer-project) phpinspect--buffer-project)
|
|
|
|
(set (make-local-variable 'phpinspect--buffer-project) (funcall phpinspect-project-root-function)))
|
|
|
|
phpinspect--buffer-project)
|
|
|
|
|
|
|
|
(cl-defstruct (phpinspect-project (:constructor phpinspect--make-project))
|
|
|
|
(class-index (make-hash-table :test 'eq :size 100 :rehash-size 1.5)
|
|
|
|
:type hash-table
|
|
|
|
:documentation
|
|
|
|
"A `hash-table` that contains all of the currently
|
|
|
|
indexed classes in the project")
|
|
|
|
(function-index (make-hash-table :test 'eq :size 100 :rehash-size 2.0)
|
|
|
|
:type hash-table
|
|
|
|
:documentation
|
|
|
|
"A hash able that contains all of the currently indexed functions
|
|
|
|
in the project")
|
|
|
|
(fs nil
|
|
|
|
:type phpinspect-fs
|
|
|
|
:documentation
|
|
|
|
"The filesystem object through which this project's files
|
|
|
|
can be accessed.")
|
|
|
|
(autoload nil
|
|
|
|
:type phpinspect-autoload
|
|
|
|
:documentation
|
|
|
|
"The autoload object through which this project's type
|
|
|
|
definitions can be retrieved")
|
|
|
|
(worker (phpinspect-make-dynamic-worker)
|
|
|
|
:type phpinspect-worker
|
|
|
|
:documentation
|
|
|
|
"The worker that this project may queue tasks for")
|
|
|
|
(root nil
|
|
|
|
:type string
|
|
|
|
:documentation
|
|
|
|
"The root directory of this project")
|
|
|
|
(purged nil
|
|
|
|
:type boolean
|
|
|
|
:documentation "Whether or not the project has been purged or not.
|
|
|
|
Projects get purged when they are removed from the global cache.")
|
|
|
|
(file-watchers (make-hash-table :test #'equal :size 10000 :rehash-size 10000)
|
|
|
|
:type hash-table
|
|
|
|
:documentation "All active file watchers in this project,
|
|
|
|
indexed by the absolute paths of the files they're watching."))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-purge ((project phpinspect-project))
|
|
|
|
"Disable all background processes for project and put it in a `purged` state."
|
|
|
|
(maphash (lambda (_ watcher) (file-notify-rm-watch watcher))
|
|
|
|
(phpinspect-project-file-watchers project))
|
|
|
|
|
|
|
|
(setf (phpinspect-project-file-watchers project)
|
|
|
|
(make-hash-table :test #'equal :size 10000 :rehash-size 10000))
|
|
|
|
(setf (phpinspect-project-purged project) t))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-watch-file ((project phpinspect-project)
|
|
|
|
filepath
|
|
|
|
callback)
|
|
|
|
(let ((watcher (file-notify-add-watch filepath '(change) callback)))
|
|
|
|
(puthash filepath watcher (phpinspect-project-file-watchers project))))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-add-return-types-to-index-queueue
|
|
|
|
((project phpinspect-project) methods)
|
|
|
|
(dolist (method methods)
|
|
|
|
(when (phpinspect--function-return-type method)
|
|
|
|
(phpinspect-project-enqueue-if-not-present
|
|
|
|
project
|
|
|
|
(phpinspect--function-return-type method)))))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-add-variable-types-to-index-queue
|
|
|
|
((project phpinspect-project) variables)
|
|
|
|
(dolist (var variables)
|
|
|
|
(when (phpinspect--variable-type var)
|
|
|
|
(phpinspect-project-enqueue-if-not-present project (phpinspect--variable-type var)))))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-enqueue-if-not-present
|
|
|
|
((project phpinspect-project) (type phpinspect--type))
|
|
|
|
(unless (phpinspect--type-is-native type)
|
|
|
|
(let ((class (phpinspect-project-get-class project type)))
|
|
|
|
(when (or (not class)
|
|
|
|
(not (or (phpinspect--class-initial-index class))))
|
|
|
|
(when (not class)
|
|
|
|
(setq class (phpinspect-project-create-class project type)))
|
|
|
|
(unless (or (phpinspect--type= phpinspect--null-type type)
|
|
|
|
(phpinspect--type-is-native type))
|
|
|
|
(phpinspect--log "Adding unpresent class %s to index queue" type)
|
|
|
|
(phpinspect-worker-enqueue (phpinspect-project-worker project)
|
|
|
|
(phpinspect-make-index-task project type)))))))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-add-class-attribute-types-to-index-queue
|
|
|
|
((project phpinspect-project) (class phpinspect--class))
|
|
|
|
(phpinspect-project-add-return-types-to-index-queueue
|
|
|
|
project
|
|
|
|
(phpinspect--class-get-method-list class))
|
|
|
|
(phpinspect-project-add-return-types-to-index-queueue
|
|
|
|
project
|
|
|
|
(phpinspect--class-get-static-method-list class))
|
|
|
|
(phpinspect-project-add-variable-types-to-index-queue
|
|
|
|
project
|
|
|
|
(phpinspect--class-variables class)))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-add-index
|
|
|
|
((project phpinspect-project) (index (head phpinspect--root-index)) &optional index-imports)
|
|
|
|
(when index-imports
|
|
|
|
(phpinspect-project-enqueue-imports project (alist-get 'imports (cdr index))))
|
|
|
|
|
|
|
|
(dolist (indexed-class (alist-get 'classes (cdr index)))
|
|
|
|
(phpinspect-project-add-class project (cdr indexed-class) index-imports))
|
|
|
|
|
|
|
|
(dolist (func (alist-get 'functions (cdr index)))
|
|
|
|
(phpinspect-project-set-function project func)))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-set-function
|
|
|
|
((project phpinspect-project) (func phpinspect--function))
|
|
|
|
(puthash (phpinspect--function-name-symbol func) func
|
|
|
|
(phpinspect-project-function-index project)))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-get-function
|
|
|
|
((project phpinspect-project) (name symbol))
|
|
|
|
(gethash name (phpinspect-project-function-index project)))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-get-functions ((project phpinspect-project))
|
|
|
|
(let ((funcs))
|
|
|
|
(maphash
|
|
|
|
(lambda (_name func) (push func funcs))
|
|
|
|
(phpinspect-project-function-index project))
|
|
|
|
|
|
|
|
funcs))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-enqueue-imports
|
|
|
|
((project phpinspect-project) imports)
|
|
|
|
(dolist (import imports)
|
|
|
|
(when import
|
|
|
|
(phpinspect--log "Adding import to index queue: %s" import)
|
|
|
|
(phpinspect-project-enqueue-if-not-present project (cdr import)))))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-add-class
|
|
|
|
((project phpinspect-project) (indexed-class (head phpinspect--indexed-class)) &optional index-imports)
|
|
|
|
(let* ((class-name (phpinspect--type-name-symbol
|
|
|
|
(alist-get 'class-name (cdr indexed-class))))
|
|
|
|
(class (gethash class-name
|
|
|
|
(phpinspect-project-class-index project))))
|
|
|
|
(unless class
|
|
|
|
(setq class (phpinspect--make-class-generated :project project)))
|
|
|
|
|
|
|
|
(when index-imports
|
|
|
|
(phpinspect-project-enqueue-imports
|
|
|
|
project (alist-get 'imports (cdr indexed-class))))
|
|
|
|
|
|
|
|
(phpinspect--class-set-index class indexed-class)
|
|
|
|
(puthash class-name class (phpinspect-project-class-index project))
|
|
|
|
(phpinspect-project-add-class-attribute-types-to-index-queue project class)))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-set-class
|
|
|
|
((project phpinspect-project) (class-fqn phpinspect--type) (class phpinspect--class))
|
|
|
|
(puthash (phpinspect--type-name-symbol class-fqn)
|
|
|
|
class
|
|
|
|
(phpinspect-project-class-index project)))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-create-class
|
|
|
|
((project phpinspect-project) (class-fqn phpinspect--type))
|
|
|
|
(let ((class (phpinspect--make-class-generated :project project)))
|
|
|
|
(phpinspect-project-set-class project class-fqn class)
|
|
|
|
class))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-get-class-create
|
|
|
|
((project phpinspect-project) (class-fqn phpinspect--type))
|
|
|
|
(let ((class (phpinspect-project-get-class project class-fqn)))
|
|
|
|
(unless class
|
|
|
|
(setq class (phpinspect-project-create-class project class-fqn))
|
|
|
|
(phpinspect-project-enqueue-if-not-present project class-fqn))
|
|
|
|
class))
|
|
|
|
|
|
|
|
(defalias 'phpinspect-project-add-class-if-missing #'phpinspect-project-get-class-create)
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-get-class
|
|
|
|
((project phpinspect-project) (class-fqn phpinspect--type))
|
|
|
|
"Get indexed class by name of CLASS-FQN stored in PROJECT."
|
|
|
|
(gethash (phpinspect--type-name-symbol class-fqn)
|
|
|
|
(phpinspect-project-class-index project)))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-get-type-filepath
|
|
|
|
((project phpinspect-project) (type phpinspect--type) &optional index-new)
|
|
|
|
"Retrieve filepath to TYPE definition file.
|
|
|
|
|
|
|
|
when INDEX-NEW is non-nil, new files are added to the index
|
|
|
|
before the search is executed."
|
|
|
|
(let* ((autoloader (phpinspect-project-autoload project)))
|
|
|
|
(when (eq index-new 'index-new)
|
|
|
|
(phpinspect-autoloader-refresh autoloader))
|
|
|
|
(let* ((result (phpinspect-autoloader-resolve
|
|
|
|
autoloader (phpinspect--type-name-symbol type))))
|
|
|
|
(if (not result)
|
|
|
|
;; Index new files and try again if not done already.
|
|
|
|
(if (eq index-new 'index-new)
|
|
|
|
nil
|
|
|
|
(when phpinspect-auto-reindex
|
|
|
|
(phpinspect--log "Failed finding filepath for type %s. Retrying with reindex."
|
|
|
|
(phpinspect--type-name type))
|
|
|
|
(phpinspect-project-get-type-filepath project type 'index-new)))
|
|
|
|
result))))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-index-type-file
|
|
|
|
((project phpinspect-project) (type phpinspect--type))
|
|
|
|
"Index the file that TYPE is expected to be defined in."
|
|
|
|
|
|
|
|
(condition-case error
|
|
|
|
(let* ((file (phpinspect-project-get-type-filepath project type))
|
|
|
|
(visited-buffer (when file (find-buffer-visiting file))))
|
|
|
|
(when file
|
|
|
|
(if visited-buffer
|
|
|
|
(with-current-buffer visited-buffer (phpinspect-index-current-buffer))
|
|
|
|
(with-temp-buffer (phpinspect-project-index-file project file)))))
|
|
|
|
(file-missing
|
|
|
|
(phpinspect--log "Failed to find file for type %s: %s" type error)
|
|
|
|
nil)))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-index-file
|
|
|
|
((project phpinspect-project) (filename string))
|
|
|
|
"Index "
|
|
|
|
(let ((fs (phpinspect-project-fs project)))
|
|
|
|
(with-temp-buffer
|
|
|
|
(phpinspect-fs-insert-file-contents fs filename 'prefer-async)
|
|
|
|
(phpinspect-index-current-buffer))))
|
|
|
|
|
|
|
|
(cl-defmethod phpinspect-project-add-file-index ((project phpinspect-project) (filename string))
|
|
|
|
(phpinspect-project-add-index project (phpinspect-project-index-file project filename)))
|
|
|
|
|
|
|
|
(defun phpinspect-project-enqueue-include-dirs (project)
|
|
|
|
(interactive (list (phpinspect--cache-get-project-create
|
|
|
|
(phpinspect--get-or-create-global-cache)
|
|
|
|
(phpinspect-current-project-root))))
|
|
|
|
(let ((dirs (alist-get 'include-dirs
|
|
|
|
(alist-get (phpinspect-project-root project)
|
|
|
|
phpinspect-projects
|
|
|
|
nil nil #'string=))))
|
|
|
|
(dolist (dir dirs)
|
|
|
|
(message "enqueueing dir %s" dir)
|
|
|
|
(phpinspect-worker-enqueue
|
|
|
|
(phpinspect-project-worker project)
|
|
|
|
(phpinspect-make-index-dir-task :dir dir :project project)))))
|
|
|
|
|
|
|
|
(defgroup phpinspect '((phpinspect-projects custom-variable))
|
|
|
|
"PHPInspect Configuration")
|
|
|
|
|
|
|
|
(defcustom phpinspect-projects nil
|
|
|
|
"PHPInspect Projects."
|
|
|
|
:type '(alist :key-type string
|
|
|
|
:value-type (alist :key-type symbol
|
|
|
|
:options ((include-dirs (repeat string))))))
|
|
|
|
|
|
|
|
(defun phpinspect-project-add-include-dir (dir)
|
|
|
|
"Configure DIR as an include dir for the current project."
|
|
|
|
(interactive (list (read-directory-name "Include Directory: ")))
|
|
|
|
(custom-set-variables '(phpinspect-projects))
|
|
|
|
(let ((existing
|
|
|
|
(alist-get (phpinspect-current-project-root) phpinspect-projects nil #'string=)))
|
|
|
|
(if existing
|
|
|
|
(push dir (alist-get 'include-dirs existing))
|
|
|
|
(push `(,(phpinspect-current-project-root) . ((include-dirs . (,dir)))) phpinspect-projects)))
|
|
|
|
|
|
|
|
(customize-save-variable 'phpinspect-projects phpinspect-projects)
|
|
|
|
|
|
|
|
(phpinspect-project-enqueue-include-dirs (phpinspect--cache-get-project-create
|
|
|
|
(phpinspect--get-or-create-global-cache)
|
|
|
|
(phpinspect-current-project-root))))
|
|
|
|
|
|
|
|
|
|
|
|
(provide 'phpinspect-project)
|
|
|
|
;;; phpinspect-project.el ends here
|