noones-search/docs
Markus Heiser e9157b3c1a [fix] issues when launching a local development server
A local development server can be launched by one of these command lines::

    $ flask --app searx.webapp run
    $ python -m searx.webapp

The different ways of starting the server should lead to the same result, which
is generally the case.  However, if the modules are reloaded after code
changes (reload option), it must be avoided that the application is initialized
twice at startup.  We have already discussed this in 2022 [1][2].

Further information on this topic can be found in [3][4][5].

To test a bash in the ./local environment was started and the follwing commands
had been executed::

    $ ./manage pyenv.cmd bash --norc --noprofile
    (py3) SEARXNG_DEBUG=1 flask --app searx.webapp run --reload
    (py3) SEARXNG_DEBUG=1 python -m searx.webapp

Since the generic parts of the docs also initialize the app to generate doc from
it, the build of the docs was also tested::

    $ make docs.clean docs.live

[1] https://github.com/searxng/searxng/pull/1656#issuecomment-1214198941
[2] https://github.com/searxng/searxng/pull/1616#issuecomment-1206137468
[3] https://flask.palletsprojects.com/en/stable/api/#flask.Flask.run
[4] https://github.com/pallets/flask/issues/5307#issuecomment-1774646119
[5] https://stackoverflow.com/a/25504196

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
2025-04-22 14:26:11 +02:00
..
_themes/searxng [dev-env] upgrade Sphinx-doc 7.2.3 and unpin at v7.1.2 on py3.8 2023-08-27 17:22:45 +02:00
admin [fix] issues when launching a local development server 2025-04-22 14:26:11 +02:00
build-templates [mod] py3.8 EOL / upgrade to actions/setup-python@v5 2024-10-03 13:05:43 +02:00
dev [fix] docs: changed "many" to "some" for clarity in contribution guide's privacy by design section 2025-04-17 16:47:52 +02:00
src [refactor] typification of SearXNG (initial) / result items (part 1) 2025-01-28 07:07:08 +01:00
user [fix] various issues in the documentation 2025-02-26 07:15:39 +01:00
utils [fix] spelling 2023-09-18 16:20:27 +02:00
conf.py [fix] make docs - ERROR: Unknown target name: "auth_key" 2025-04-09 17:28:18 +02:00
index.rst [doc] update quantities on the intro page 2024-11-23 16:33:08 +01:00
own-instance.rst Update own-instance.rst 2024-09-22 07:28:32 +02:00