django-singlefile
iommi
django-singlefile | iommi | |
---|---|---|
1 | 3 | |
85 | 637 | |
- | 1.4% | |
6.7 | 9.0 | |
about 2 months ago | 29 days ago | |
Python | Python | |
- | BSD 3-clause "New" or "Revised" License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
django-singlefile
-
Building a full Django project, starting with a single file
The app-based model is really baked into Django. As we've seen from a bunch of examples, especially recently, it's not too hard to build out a single-file project that serves a simple home page with a brief message. As soon as you want to support a full actual page, and a set of pages, you really have to figure out a well-thought-out plan for how people will expand the project.
If you're still interested in this work, I suggest checking out nanodjango, which was mentioned earlier in this thread. That project is new, but there's a plan from the outset for how people can transition from the single-file based version to a standard Django project. You might also want to check out Andrew Godwin's django-singlefile project. It's meant to support small flask-like projects, where you don't have any intention of expanding out into a standard Django project.
Both of these projects have their own code that takes what's included in the small file and tells Django how to make sense of it. That's much different than the projects that are only trying to make use of what's included in Django itself.
(I'm the author of the Django from first principles series that was submitted here, but I didn't see it on HN until this morning.)
nanodjango: https://github.com/radiac/nanodjango
django-singlefile: https://github.com/andrewgodwin/django-singlefile
iommi
-
Building a full Django project, starting with a single file
It's not really tied to manage.py no. And in any case that's a trivial 3 lines of code (plus imports, blank lines: https://github.com/iommirocks/iommi/blob/master/examples/man...).
I think you're overdramatizing 3 lines of code...
-
Beyond OpenAPI
It's all about the tooling. I wrote my own for iommi where the html output of some code gets saved in a defined place, and then the finished documentation page embeds that html in an iframe. It's not only WAY WAY easier to maintain than a bunch of screenshots, but I found a ton of issues with the documentation after I made it so it runs all the examples and I can look at the output.
example: https://docs.iommi.rocks/en/latest/cookbook_forms.html
corresponding documentation/tests: https://github.com/iommirocks/iommi/blob/master/docs/test_do...
my evil hack to get this working: https://github.com/iommirocks/iommi/blob/master/make_doc_rst... and https://github.com/iommirocks/iommi/blob/master/iommi/docs.p...
-
Markdown, Asciidoc, or reStructuredText – a tale of docs-as-code
is generated from this pytest source: https://github.com/TriOptima/iommi/blob/master/docs/test_doc...
Is that how rust documentation works?
What are some alternatives?
diataxis-documentation-framework - A systematic approach to creating better documentation.
katt - KATT (Klarna API Testing Tool) is an HTTP-based API testing tool for Erlang.
eleventy-plugin-asciidoc - Eleventy plugin to add support for AsciiDoc.
pytest-doctestplus - Pytest plugin providing advanced doctest features
notebook
httpyac - Command Line Interface for *.http and *.rest files. Connect with http, gRPC, WebSocket and MQTT
book - The Rust Programming Language
djot - A light markup language
KeenWrite - Free, open-source, cross-platform desktop Markdown text editor with live preview, string interpolation, and math.
restclient.el - HTTP REST client tool for emacs
vscode-restclient - REST Client Extension for Visual Studio Code