Warning: This page has not been updated in over over a year and may be outdated or deprecated.
development:recommended_tools
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
vufind2:recommended_tools [2015/12/10 20:00] – [Meeting Project Standards] demiankatz | development:recommended_tools [2018/09/27 14:06] – demiankatz | ||
---|---|---|---|
Line 11: | Line 11: | ||
===== Version Control ===== | ===== Version Control ===== | ||
- | It is strongly recommended that you use some sort of version control software to keep track of revisions while programming. This provides a valuable safety net for reverting bad changes, remembering why particular adjustments were made, etc. In the case of [[Git]], the tool used by VuFind, it also offers powerful collaboration and sharing capabilities. Whether you plan to work locally or share with the local community, [[Git]] is a tool worth learning more about, as is the [[http:// | + | It is strongly recommended that you use some sort of version control software to keep track of revisions while programming. This provides a valuable safety net for reverting bad changes, remembering why particular adjustments were made, etc. In the case of [[development: |
+ | ===== Dependency Management ===== | ||
+ | |||
+ | VuFind loads its external dependencies using [[development: | ||
+ | |||
+ | ===== Grunt ===== | ||
+ | |||
+ | VuFind, as of version 3.1, ships with a Gruntfile to help manage front end tasks like compiling less/scss, compressing js, and checking coding standards. [[development: | ||
===== Meeting Project Standards ===== | ===== Meeting Project Standards ===== | ||
Line 19: | Line 26: | ||
==== Tests ==== | ==== Tests ==== | ||
- | The [[development: | + | The [[development: |
==== Style ==== | ==== Style ==== | ||
- | For style compliance, | + | For style compliance, |
- | To test style compliance with PHP_CodeSniffer, | + | To test style compliance with PHP_CodeSniffer |
< | < | ||
- | phpcs --standard=PEAR [file] | + | vendor/bin/phpcs --standard=PEAR [file] |
</ | </ | ||
- | To automatically fix certain PHP_CodeSniffer issues, you can run: | + | Or, through [[https:// |
< | < | ||
- | phpcbf | + | vendor/ |
</ | </ | ||
- | To automatically fix additional | + | To automatically fix certain PHP_CodeSniffer |
< | < | ||
- | phing php-cs-fixer | + | vendor/bin/phing phpcbf |
</ | </ | ||
- | (Note that this assumes that the php-cs-fixer | + | To automatically fix additional issues with php-cs-fixer, from the base of your VuFind directory, run: |
+ | |||
+ | < | ||
+ | vendor/ | ||
+ | </ | ||
If you are unwilling or unable to run these tools locally, note that if you open a pull request against the [[https:// | If you are unwilling or unable to run these tools locally, note that if you open a pull request against the [[https:// |
development/recommended_tools.txt · Last modified: 2023/10/20 12:02 by demiankatz