Yes, I know it’s used a lot in the Python community in combination with reStructured Text. If you're wondering why I didn’t go for Readthedocs + Sphinx, here are a few reasons:
1) I really prefer writing Markdown to rST, and I found no way of making Sphinx work with Markdown.
2) I find Vuepress a pleasure to use overall :)
3) I wanted to have a theme that sticked out from the classic readthedocs/Albatross themes.
4) Vuepress has a ton of unique features that greatly simplify writing great docs (custom navbar, custom colors, built-in Algolia search integration…).
1) I really prefer writing Markdown to rST, and I found no way of making Sphinx work with Markdown.
2) I find Vuepress a pleasure to use overall :)
3) I wanted to have a theme that sticked out from the classic readthedocs/Albatross themes.
4) Vuepress has a ton of unique features that greatly simplify writing great docs (custom navbar, custom colors, built-in Algolia search integration…).
I have to bench readthrdocs / vuepress / gitbook
but later ...
but readthedocs and sphinx support markdown
Do you refer to https://www.sphinx-doc.org/en/master/usage/markdown.html? :-) For some reason I didn’t find that page while looking for solutions! It supports CommonMark though, and the Vuepress Markdown is supercharged in comparison — you can write Vue components and use them right into the Markdown page.
@florimondmanca I ran this command to install bocadillo:
pip install bocadilloAfter installed bocadillo and run the app.py starter file are getting this error message:
Traceback (most recent call last):
File "app.py", line 1, in <module>
from bocadillo import App, Templates
ImportError: cannot import name 'App'There are something that I'm forget about it?
It just outputs the version.
That
__version__ attribute error is very odd. Bocadillo has had that exposed since 0.1!
Greetings. I have starting to think about some web based projects using Bocadillo as well as async desktop utility type apps that query REST interfaces on the web. I was starting with aiohttp but now that requests-async is out I'm inclined to switch. It looks like Bocadillo is using Starlette to manage requests but I'd like to develop libraries that I can use for both my desktop utilities and Bocadillo. I'm a hardware guy who likes to play with software so this may be an obvious guestion, but if I start working in requests-async, can I drop the code into a Bocadillo project? Or is the interface so similar that I can design it to work with both?
Hi @EricE! Welcome :) requests-async and Bocadillo are 100% compatible. Requests-async allows to make HTTP requests asynchronously and Bocadillo is asynchronous at its core. So yep, you should be able to drop requests-async code into a Bocadillo project.
From your last sentence I’m not sure I fully understood your question though — feel free to ping back if there’s anything unclear!
From your last sentence I’m not sure I fully understood your question though — feel free to ping back if there’s anything unclear!
I ran :
sudo apt-get install python3.6-dev libssl-devto be able install bocadillo without errors..
WIll whether is good point out this libs when install it?
Good stuff @Marlysson! I think we could add this to a troubleshooting section in the FAQ.
Would you mind opening an issue with as many details as you can on the problem and your setup (OS, Python version before/after the fix, any tracebacks, etc)? It would be better than handling this via the chat.
If you know how to use Docker you can try to reproduce the issue in a Linux container, and post the Dockerfile so that we can see how/why this happens. Otherwise I can have a shoot at it myself. :)
I can create files/folders organization and import in main .py file ?
or anything need to be in the same file ?
like flask
Hi @lucawen, route registration is indeed Flask-style, so you can register routes anywhere you have access to an app. You can use recipes to separate an app into multiple sub-apps. We also have #234 open for module-based route registration. If that doesn't fit your use case feel free to open a feature request :)
Hey Alfred, I’m not sure how big of a structure you’re looking for. An example real-life application is TermPair, made by @cs01: https://github.com/cs01/termpair Not sure it qualifies as « large », though. If you think there should be some hints in the docs about this, feel free to open an issue!
By the way everyone, I’ll be on vacation for the next 7 days so might not be able to respond right away. Feel free to help each other out as you can. :-)
How can I clone and built/customize bocadillo locally on my own computer
So that I can contribute
ubuntu*
@zowhair_twitter The contributing guide should help you get started :) https://github.com/bocadilloproject/bocadillo/blob/master/CONTRIBUTING.md
As for your question about Python, I’m not an Ubuntu user but I guess you should be able to find an answer by a bit of googling 👍
As for your question about Python, I’m not an Ubuntu user but I guess you should be able to find an answer by a bit of googling 👍
Thanks for the updated documentation on async. In https://bocadilloproject.github.io/guides/async.html#converting-a-regular-function-to-an-asynchronous-function, if compute is slow, the I assume you would wrap it in run_in_threadpool since wrapping it in an async function doesn't protect you?
@alfredchiesa Coming back to your question on larger project structures last time, you may want to check out the new Bocadillo CLI and fiddle around with the
We’re still working towards being able to easily split an app into multiple files :)
create command, it should give you an example of a full-featured project file structure: https://github.com/bocadilloproject/bocadillo-cliWe’re still working towards being able to easily split an app into multiple files :)
^For example via #261
Thanks for the update! For truly CPU bound applications, wouldn't you want to use ProcessPoolExecutor instead of ThreadPoolExecutor (unfortunately not in starlette)? Seems like you would slow down your asyncio app using the ThreadPoolExecutor but have minimal impact with ProcessPoolExecutor. I know it can be more limiting to work with Processes over Threads (pickling) but for maximum speed using ThreadPoolExecutor seems better.
If I only knew how to use Github :) I just downloaded their desktop app, I'll see if I can figure it out. The hardware guys at my company still use SVN for our FPGA files, etc., and I use it for my Python projects. Our SW guys are switching to Git and it is clearly the winner so time to switch...
Ah right, you’re into hardware! This website helped me a lot when starting with git two years ago :) http://rogerdudler.github.io/git-guide/
Hi ! I am reading about ASGI servers more precisely on Uvicorn and a framework using it (Starlette.io). It turns out that in their section 'Third Party Packages' they quote you with another framework (FastAPI), so Bocadillo is a framework of another framework? Would not this add unnecessary overlays rather than contribute directly to the Starlette.io project?
Anyway good job, there are features that look cool
Anyway good job, there are features that look cool