phyks
/
cuizin
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
cuizin/README.md

2.2 KiB
Raw Blame History

Cuizin

Cuizin is a tool wrapping around Web Outside Of Browsers to help you sort and organize recipes you find online. You can also manually add new recipes.

Installation

$ git clone …  # Clone this repository
$ pip install -r requirements.txt  # Install Python dependencies
$ npm install  # Install JS dependencies for the frontend
$ npm run build  # Build the JS dependencies

Ideally, Python dependencies should be installed in a virtual environment.

TODO:

  • npm run build should handle prefix

Usage

Run python -m cuizin to run the built-in webserver. Conversely, you can use WSGI to serve the application directly (application variable is exported in cuizin/__main__.py).

You can customize the behavior of the app by passing environment variables:

  • HOST to set the host on which the webserver should listen to (defaults to localhost only). Use HOST=0.0.0.0 to make it world-accessible.
  • PORT to set the port on which the webserver should listen. Defaults to 8080.
  • DEBUG to enable or disable the debug from Bottle (defaults to False).
  • WEBOOB_MODULES_PATH to set the path to the local clone of the Weboob modules. Default to using the weboob-modules package installed by pip (and which you should regularly update with pip install --upgrade weboob-modules).

If you serve the app with a reverse proxy, you should serve the content of cuizin/dist (static frontend files) directly, without passing it down to the Bottle webserver.

Contributing

All contributions are welcome, feel free to open a MR. Just in case, if you plan on working on some major new feature, please open an issue before to get some feedbacks.

All the code lies under cuizin directory. Frontend code lies under cuizin/js_src. build and config folders at the root of this repository are used for the frontend build.

Additionnally, you can use make dev to spawn a development webserver to serve the JS frontend and auto-update/auto-reload when you make changes. The spawned JS server will be set up at localhost:8081 and you should start the backend Python server at localhost:8080 with python -m cuizin along it.

License

This software is released under an MIT License.