apiclarity
github-docs
apiclarity | github-docs | |
---|---|---|
9 | 44 | |
476 | 15,549 | |
1.5% | 0.8% | |
3.4 | 10.0 | |
4 days ago | 2 days ago | |
Go | JavaScript | |
Apache License 2.0 | Creative Commons Attribution 4.0 |
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.
apiclarity
-
Two approaches to make your APIs more secure
We'll install APIClarity into a Kubernetes cluster to test our API documentation. We're using a Kind cluster for demonstration purposes. Of course, if you have another Kubernetes cluster up and running elsewhere, all steps also work there.
-
How to Get Started with Open Source
If you go to APIClarity, the first thing you’ll see is the source code (Figure 1), followed by some documentation at the bottom.
-
Risk scoring your API Specification with Panoptica
This feature is available in the open-source tool APIClarity, as part of the OpenClarity initiative.
-
Show HN: Mitmproxy2swagger – Automagically reverse-engineer REST APIs
Hi, I would also like to add another tool I'm contributing to at work (cisco) called APIClarity [1]. It aims at reconstructing swagger specifications of REST microservices running in K8S, but can also be run locally.
This is a challenging task and we don't support OpenAPI v3 specs yet (we are working on it).
Feel free to have a look, and get ideas from it :)
We'll also be presenting it at next Kubecon 2022.
[1]: https://github.com/openclarity/apiclarity
- Microservices API challenges
-
How to Use OpenAPI for Secure and Robust API Integration
For example, APIClarity is a tool that observes all of the API traffic within your Kubernetes environment. Based on traffic observation, APIClarity infers an OpenAPI description for those APIs. This is especially helpful if the API creator never defined or provided such a description. It also surfaces potential problems with existing APIs, such as requests made to undocumented, shadow APIs or continued use of deprecated, zombie APIs. If you’re getting started on the path toward OAS compliance, then tools like APIClarity can be a great source of insight and observability.
-
Watching the Requests Go By: Reconstructing an API Spec with APIClarity
The fundamental first step to solving this problem is to create an API spec and use it to audit and document the APIs your apps use. Ideally, we would create an API spec simply by observing API traffic in real-world applications. In the past, there was no simple, scalable, and open-source tooling capable of doing this. Now, we have APIClarity—an open-source API traffic visibility tool for Kubernetes (K8s) clusters. It’s purpose-built to address the gap and enable API reconstruction through observation.
- Reconstruct Open API Specifications from real-time workload traffic seamlessly
github-docs
-
5 Tips For Writing Technical Documentation That Developers Love
In college, an English professor would ask me and other students the following question when reviewing our essays, “Where are the examples?” Developers ask the same question when reading your documentation. To write good technical writing documents, include examples that developers can see themselves implementing in their work. How can this be done? By adding examples from your product’s codebase! 🙂 Let’s look at this code snippet from my contribution to GitHub’s documentation:
-
Get People Interested in Contributing to Your Open Project
Need an example? Check the GitHub docs contributing guide.
-
Launch HN: Diversion (YC S22) – Cloud-Native Git Alternative
git clone https://github.com/github/docs.git 123.57s user 37.02s system 74% cpu 3:35.73 total
git clone --depth 1 https://github.com/github/docs.git 3.37s user 1.83s system 35% cpu 14.521 total
Not a scientific test at all, but the second one was literally 35x faster, wall clock time.
-
ice-blockchain
Docs
- Musk vs. Zuck Poll
- docs/browser.js at dependabot/github_actions/actions/github-script-98814c53be79b1d30f795b907e553d8679345975 · github/docs
-
Cannot reach github.com from Starlink
The strange thing is that I only have this problem with github, all other websites work just fine. And even docs.github.com works fine...
- GitHub outage again, even basic pages give HTTP 500
-
Yet another GitHub Outage..
99.9 at best for enterprise cloud: https://github.com/github/docs/blob/main/content/site-policy/site-policy-deprecated/github-enterprise-service-level-agreement.md
-
How to Get Started with Open Source
A project repository typically has a license file at the top-level indicating which license the code falls under. See here for an example license file.
What are some alternatives?
oasdiff - OpenAPI Diff and Breaking Changes
jeecg-boot - 🔥「企业级低代码平台」前后端分离架构SpringBoot 2.x/3.x,SpringCloud,Ant Design&Vue,Mybatis,Shiro,JWT。强大的代码生成器让前后端代码一键生成,无需写任何代码! 引领新的开发模式OnlineCoding->代码生成->手工MERGE,帮助Java项目解决70%重复工作,让开发更关注业务,既能快速提高效率,帮助公司节省成本,同时又不失灵活性。
Nacos - an easy-to-use dynamic service discovery, configuration and service management platform for building cloud native applications.
dxvk-async
api-firewall - Fast and light-weight API proxy firewall for request and response validation by OpenAPI specs.
vkBasalt - a vulkan post processing layer for linux
microservices-demo - Deployment scripts & config for Sock Shop
CSharpFunctionalExtensions - Functional extensions for C#
kusk - CLI for Kusk Gateway related functionality
mall - mall项目是一套电商系统,包括前台商城系统及后台管理系统,基于SpringBoot+MyBatis实现,采用Docker容器化部署。 前台商城系统包含首页门户、商品推荐、商品搜索、商品展示、购物车、订单流程、会员中心、客户服务、帮助中心等模块。 后台管理系统包含商品管理、订单管理、会员管理、促销管理、运营管理、内容管理、统计报表、财务管理、权限管理、设置等模块。
openapi-preprocessor - An authoring tool for OpenAPI specifications
codeql - CodeQL: the libraries and queries that power security researchers around the world, as well as code scanning in GitHub Advanced Security