forked from zaclys/searxng
		
	
		
			
				
	
	
		
			265 lines
		
	
	
	
		
			6.9 KiB
		
	
	
	
		
			Makefile
		
	
	
	
	
	
			
		
		
	
	
			265 lines
		
	
	
	
		
			6.9 KiB
		
	
	
	
		
			Makefile
		
	
	
	
	
	
| # -*- coding: utf-8; mode: makefile-gmake -*-
 | |
| .DEFAULT_GOAL=help
 | |
| 
 | |
| include utils/makefile.include
 | |
| 
 | |
| PYOBJECTS = searx
 | |
| DOC       = docs
 | |
| PY_SETUP_EXTRAS ?= \[test\]
 | |
| PYLINT_SEARX_DISABLE_OPTION := I,C,R,W0105,W0212,W0511,W0603,W0613,W0621,W0702,W0703,W1401,E1136
 | |
| PYLINT_ADDITIONAL_BUILTINS_FOR_ENGINES := supported_languages,language_aliases
 | |
| 
 | |
| include utils/makefile.python
 | |
| include utils/makefile.sphinx
 | |
| 
 | |
| all: clean install
 | |
| 
 | |
| PHONY += help-min help-all help
 | |
| 
 | |
| help: help-min
 | |
| 	@echo  ''
 | |
| 	@echo  'to get more help:  make help-all'
 | |
| 
 | |
| help-min:
 | |
| 	@echo  '  test      - run developer tests'
 | |
| 	@echo  '  docs      - build documentation'
 | |
| 	@echo  '  docs-live - autobuild HTML documentation while editing'
 | |
| 	@echo  '  run       - run developer instance'
 | |
| 	@echo  '  install   - developer install (./local)'
 | |
| 	@echo  '  uninstall - uninstall (./local)'
 | |
| 	@echo  '  gh-pages  - build docs & deploy on gh-pages branch'
 | |
| 	@echo  '  clean     - drop builds and environments'
 | |
| 	@echo  '  project   - re-build generic files of the searx project'
 | |
| 	@echo  '  buildenv  - re-build environment files (aka brand)'
 | |
| 	@echo  '  themes    - re-build build the source of the themes'
 | |
| 	@echo  '  docker    - build Docker image'
 | |
| 	@echo  '  node.env  - download & install npm dependencies locally'
 | |
| 	@echo  ''
 | |
| 	@$(MAKE) -e -s make-help
 | |
| 
 | |
| help-all: help-min
 | |
| 	@echo  ''
 | |
| 	@$(MAKE) -e -s python-help
 | |
| 	@echo  ''
 | |
| 	@$(MAKE) -e -s docs-help
 | |
| 
 | |
| PHONY += install
 | |
| install: buildenv pyenvinstall
 | |
| 
 | |
| PHONY += uninstall
 | |
| uninstall: pyenvuninstall
 | |
| 
 | |
| PHONY += clean
 | |
| clean: pyclean docs-clean node.clean test.clean
 | |
| 	$(call cmd,common_clean)
 | |
| 
 | |
| PHONY += run
 | |
| run:  buildenv pyenvinstall
 | |
| 	$(Q) ( \
 | |
| 	sleep 2 ; \
 | |
| 	xdg-open http://127.0.0.1:8888/ ; \
 | |
| 	) &
 | |
| 	SEARX_DEBUG=1 $(PY_ENV)/bin/python ./searx/webapp.py
 | |
| 
 | |
| # docs
 | |
| # ----
 | |
| 
 | |
| sphinx-doc-prebuilds:: buildenv pyenvinstall prebuild-includes
 | |
| 
 | |
| PHONY += docs
 | |
| docs:  sphinx-doc-prebuilds
 | |
| 	$(call cmd,sphinx,html,docs,docs)
 | |
| 
 | |
| PHONY += docs-live
 | |
| docs-live:  sphinx-doc-prebuilds
 | |
| 	$(call cmd,sphinx_autobuild,html,docs,docs)
 | |
| 
 | |
| PHONY += prebuild-includes
 | |
| prebuild-includes:
 | |
| 	$(Q)mkdir -p $(DOCS_BUILD)/includes
 | |
| 	$(Q)./utils/searx.sh doc | cat > $(DOCS_BUILD)/includes/searx.rst
 | |
| 	$(Q)./utils/filtron.sh doc | cat > $(DOCS_BUILD)/includes/filtron.rst
 | |
| 	$(Q)./utils/morty.sh doc | cat > $(DOCS_BUILD)/includes/morty.rst
 | |
| 
 | |
| 
 | |
| $(GH_PAGES)::
 | |
| 	@echo "doc available at --> $(DOCS_URL)"
 | |
| 
 | |
| # update project files
 | |
| # --------------------
 | |
| 
 | |
| PHONY += project engines.languages useragents.update buildenv
 | |
| 
 | |
| project: buildenv useragents.update engines.languages
 | |
| 
 | |
| engines.languages:  pyenvinstall
 | |
| 	$(Q)echo "fetch languages .."
 | |
| 	$(Q)$(PY_ENV_ACT); python ./searx_extra/update/update_languages.py
 | |
| 	$(Q)echo "updated searx/data/engines_languages.json"
 | |
| 	$(Q)echo "updated searx/languages.py"
 | |
| 
 | |
| useragents.update:  pyenvinstall
 | |
| 	$(Q)echo "fetch useragents .."
 | |
| 	$(Q)$(PY_ENV_ACT); python ./searx_extra/update/update_firefox_version.py
 | |
| 	$(Q)echo "updated searx/data/useragents.json with the most recent versions of Firefox."
 | |
| 
 | |
| buildenv: pyenv
 | |
| 	$(Q)$(PY_ENV_ACT); SEARX_DEBUG=1 python utils/build_env.py
 | |
| 
 | |
| # node / npm
 | |
| # ----------
 | |
| 
 | |
| node.env: buildenv
 | |
| 	$(Q)./manage.sh npm_packages
 | |
| 
 | |
| node.clean:
 | |
| 	$(Q)echo "CLEAN     locally installed npm dependencies"
 | |
| 	$(Q)rm -rf \
 | |
| 	  ./node_modules  \
 | |
| 	  ./package-lock.json \
 | |
| 	  ./searx/static/themes/oscar/package-lock.json \
 | |
| 	  ./searx/static/themes/oscar/node_modules \
 | |
| 	  ./searx/static/themes/simple/package-lock.json \
 | |
| 	  ./searx/static/themes/simple/node_modules
 | |
| 
 | |
| # build themes
 | |
| # ------------
 | |
| 
 | |
| PHONY += themes themes.oscar themes.simple
 | |
| themes: buildenv themes.oscar themes.simple
 | |
| 
 | |
| quiet_cmd_lessc = LESSC     $3
 | |
|       cmd_lessc = PATH="$$(npm bin):$$PATH" \
 | |
| 	lessc --clean-css="--s1 --advanced --compatibility=ie9" "searx/static/$2" "searx/static/$3"
 | |
| 
 | |
| quiet_cmd_grunt = GRUNT     $2
 | |
|       cmd_grunt = PATH="$$(npm bin):$$PATH" \
 | |
| 	grunt --gruntfile  "$2"
 | |
| 
 | |
| themes.oscar: node.env
 | |
| 	$(Q)echo '[!] build oscar theme'
 | |
| 	$(call cmd,grunt,searx/static/themes/oscar/gruntfile.js)
 | |
| 
 | |
| themes.simple: node.env
 | |
| 	$(Q)echo '[!] build simple theme'
 | |
| 	$(call cmd,grunt,searx/static/themes/simple/gruntfile.js)
 | |
| 
 | |
| 
 | |
| # docker
 | |
| # ------
 | |
| 
 | |
| PHONY += docker
 | |
| docker: buildenv
 | |
| 	$(Q)./manage.sh docker_build
 | |
| 
 | |
| docker.push: buildenv
 | |
| 	$(Q)./manage.sh docker_build push
 | |
| 
 | |
| # gecko
 | |
| # -----
 | |
| 
 | |
| PHONY += gecko.driver
 | |
| gecko.driver:
 | |
| 	$(PY_ENV_ACT); ./manage.sh install_geckodriver
 | |
| 
 | |
| # search.checker
 | |
| # --------------
 | |
| 
 | |
| search.checker: pyenvinstall
 | |
| 	$(Q)$(PY_ENV_ACT); searx-checker -v
 | |
| 
 | |
| ENGINE_TARGETS=$(patsubst searx/engines/%.py,search.checker.%,$(wildcard searx/engines/[!_]*.py))
 | |
| 
 | |
| $(ENGINE_TARGETS): pyenvinstall
 | |
| 	$(Q)$(PY_ENV_ACT); searx-checker -v "$(subst _, ,$(patsubst search.checker.%,%,$@))"
 | |
| 
 | |
| 
 | |
| # test
 | |
| # ----
 | |
| 
 | |
| PHONY += test test.sh test.pylint test.pep8 test.unit test.coverage test.robot
 | |
| test: buildenv test.pylint test.pep8 test.unit gecko.driver test.robot
 | |
| 
 | |
| PYLINT_FILES=\
 | |
| 	searx/preferences.py \
 | |
| 	searx/testing.py \
 | |
| 	searx/engines/gigablast.py \
 | |
| 	searx/engines/deviantart.py \
 | |
| 	searx/engines/digg.py \
 | |
| 	searx/engines/google.py \
 | |
| 	searx/engines/google_news.py \
 | |
| 	searx/engines/google_videos.py \
 | |
| 	searx/engines/google_images.py \
 | |
| 	searx/engines/mediathekviewweb.py \
 | |
| 	searx/engines/solidtorrents.py \
 | |
| 	searx/engines/solr.py \
 | |
| 	searx/engines/google_scholar.py \
 | |
| 	searx/engines/yahoo_news.py \
 | |
| 	searx/engines/apkmirror.py \
 | |
| 	searx_extra/update/update_external_bangs.py
 | |
| 
 | |
| test.pylint: pyenvinstall
 | |
| 	$(call cmd,pylint,$(PYLINT_FILES))
 | |
| 	$(call cmd,pylint,\
 | |
| 		--disable=$(PYLINT_SEARX_DISABLE_OPTION) \
 | |
| 		--additional-builtins=$(PYLINT_ADDITIONAL_BUILTINS_FOR_ENGINES) \
 | |
| 		searx/engines \
 | |
| 	)
 | |
| 	$(call cmd,pylint,\
 | |
| 		--disable=$(PYLINT_SEARX_DISABLE_OPTION) \
 | |
| 		--ignore=searx/engines \
 | |
| 		searx tests \
 | |
| 	)
 | |
| 
 | |
| # ignored rules:
 | |
| #  E402 module level import not at top of file
 | |
| #  W503 line break before binary operator
 | |
| 
 | |
| # ubu1604: uses shellcheck v0.3.7 (from 04/2015), no longer supported!
 | |
| test.sh:
 | |
| 	shellcheck -x -s bash utils/brand.env
 | |
| 	shellcheck -x utils/lib.sh
 | |
| 	shellcheck -x utils/filtron.sh
 | |
| 	shellcheck -x utils/searx.sh
 | |
| 	shellcheck -x utils/morty.sh
 | |
| 	shellcheck -x utils/lxc.sh
 | |
| 	shellcheck -x utils/lxc-searx.env
 | |
| 	shellcheck -x .config.sh
 | |
| 
 | |
| test.pep8: pyenvinstall
 | |
| 	@echo "TEST      pycodestyle (formerly pep8)"
 | |
| 	$(Q)$(PY_ENV_ACT); pycodestyle --exclude='searx/static, searx/languages.py, $(foreach f,$(PYLINT_FILES),$(f),)' \
 | |
|         --max-line-length=120 --ignore "E117,E252,E402,E722,E741,W503,W504,W605" searx tests
 | |
| 
 | |
| test.unit: pyenvinstall
 | |
| 	@echo "TEST      tests/unit"
 | |
| 	$(Q)$(PY_ENV_ACT); python -m nose2 -s tests/unit
 | |
| 
 | |
| test.coverage:  pyenvinstall
 | |
| 	@echo "TEST      unit test coverage"
 | |
| 	$(Q)$(PY_ENV_ACT); \
 | |
| 	python -m nose2 -C --log-capture --with-coverage --coverage searx -s tests/unit \
 | |
| 	&& coverage report \
 | |
| 	&& coverage html \
 | |
| 
 | |
| test.robot: pyenvinstall gecko.driver
 | |
| 	@echo "TEST      robot"
 | |
| 	$(Q)$(PY_ENV_ACT); PYTHONPATH=. python searx/testing.py robot
 | |
| 
 | |
| test.clean:
 | |
| 	@echo "CLEAN     intermediate test stuff"
 | |
| 	$(Q)rm -rf geckodriver.log .coverage coverage/
 | |
| 
 | |
| 
 | |
| # travis
 | |
| # ------
 | |
| 
 | |
| PHONY += ci.test
 | |
| ci.test:
 | |
| 	$(PY_ENV_BIN)/python -c "import yaml"  || make clean
 | |
| 	$(MAKE) test
 | |
| 
 | |
| travis.codecov:
 | |
| 	$(Q)$(PY_ENV_BIN)/python -m pip install codecov
 | |
| 
 | |
| .PHONY: $(PHONY)
 | 
