drf-yasg
pages-gem
drf-yasg | pages-gem | |
---|---|---|
8 | 587 | |
3,351 | 1,809 | |
- | 0.0% | |
1.0 | 8.1 | |
22 days ago | 2 months ago | |
Python | Ruby | |
GNU General Public License v3.0 or later | MIT 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.
drf-yasg
-
Swagger for Django api
I believe drf-yasg what you need. You can create a schema manually and define request and response types for your small API.
-
How can one enable the html for apis that are not apiviewsets using django rest framework?
Check this out: https://drf-yasg.readthedocs.io/en/stable/
-
Separate project vs multiple apps on a single project
There's also the caveat of having different API documentation for both the frontend solution and the API-only solution, since I don't want to expose the frontend-specific endpoints to the API-only endpoints, but I think that might just take some time playing around with swagger: https://drf-yasg.readthedocs.io/en/stable/
-
Deploying Django Rest Framework with Postgres on fly.io
Swagger and OpenAPI capabilities using drf-yasg, where you can only see endpoints and Swagger docs if you have a valid Token
- does anyone find a way to use swagger ui
-
Beautiful Hackernews UI: Working with Hackernews API in Python (Django)
The major apps are news and accounts. While the former handles almost all the physical functionalities of the system, the latter only does user stuff. The api app exposes the data for consumption. It is documented using drf-yasg, a Swagger generation tool implemented without using the schema generation provided by Django Rest Framework. The api has a token-based authentication which requires that all POST requests must provide a token to be accepted, otherwise a not too interesting response:
-
Keeping Documentation Debt At Bay & Clients Happy
Our RESTful API was actually the easiest to document, because we were able to rely on third-party libraries from the start. It was a Python Django and Django REST Framework project that leveraged the drf-yasg OpenAPI generator library to create OpenAPI and Swagger compatible documentation.
-
Documenting Django Rest Framework API
This post will go through how to document your DRF APIs using https://github.com/axnsan12/drf-yasg/ package.
pages-gem
-
How to build your interactive resume in 4 simple and 2 easy steps
It's super easy to publish a static site like the resume with GitHub Pages. Just check out the docs.
-
100+ FREE Resources Every Web Developer Must Try
GitHub Pages: Host your static websites directly from your GitHub repository.
-
Ask HN: Looking for lightweight personal blogging platform
As per many other comments, it sounds like a static site generator like Hugo (https://gohugo.io/) or Jekyll (https://jekyllrb.com/), hosted on GitHub Pages (https://pages.github.com/) or GitLab Pages (https://about.gitlab.com/stages-devops-lifecycle/pages/), would be a good match. If you set up GitHub Actions or GitLab CI/CD to do the build and deploy (see e.g. https://gohugo.io/hosting-and-deployment/hosting-on-github/), your normal workflow will simply be to edit markdown and do a git push to make your changes live. There are a number of pre-built themes (e.g. https://themes.gohugo.io/) you can use, and these are realtively straightforward to tweak to your requirements.
-
Top 20 Free Static Web Hosting Services in 2024 ⚡️
Ideal for open source projects, docs sites, and portfolios. GitHub Pages
-
Creating an Engaging Curriculum vitae using Github Pages: A Step-by-Step Guide
Github Pages: Link to Github Pages
-
Different Levels of Project Documentation
Once you have all the documentation worked out a place to host it will be necessary. Some documentation generation may have ties in with specific hosting sites. Read The Docs' support for Sphinx and other documentation tools is one example. GitHub pages can be useful for GitHub hosted projects as it integrates well with GitHub Actions CI/CD deployments.
-
The minimalist guide to deploying a website in 2023 🧘
If you use GitHub and need to host a static website, consider GitHub Pages. Free for one site Stored on a GitHub public respository Deploy via web interface, or Git 100GB/month free bandwidth
-
I made a simple website 100% for FREE! 🤯
https://pages.github.com/ https://docs.github.com/en/pages https://docs.github.com/en/pages/quickstart https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll
-
How to host my own website from GitHub
There are plenty of other hosting options you could use instead, such as GitHub Pages.
-
A page to see all revealed Affliction Gems at once
Functionally github.io just presents whatever you throw into the repository as the root directory of a site, github themselves host a very good, basic outline of how to set up a site on github.io.
What are some alternatives?
drf-spectacular - Sane and flexible OpenAPI 3 schema generation for Django REST framework.
al-folio - A beautiful, simple, clean, and responsive Jekyll theme for academics
Django REST Swagger - Swagger Documentation Generator for Django REST Framework: deprecated
neocities - Neocities.org - the web site. Yep, the backend is open source!
swagger-ui - Swagger UI is a collection of HTML, JavaScript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.
Jekyll - :globe_with_meridians: Jekyll is a blog-aware static site generator in Ruby
redoc - 📘 OpenAPI/Swagger-generated API Reference Documentation
Hugo - The world’s fastest framework for building websites.
dj-rest-auth - Authentication for Django Rest Framework
Docusaurus - Easy to maintain open source documentation websites.
drf-nested-routers - Nested Routers for Django Rest Framework
git - A fork of Git containing Windows-specific patches.