diff --git a/.codeclimate.yml b/.codeclimate.yml index afc2bb1f..0b6935d2 100644 --- a/.codeclimate.yml +++ b/.codeclimate.yml @@ -18,5 +18,3 @@ engines: ratings: paths: - "**.go" -exclude_paths: -- vendor/ diff --git a/.github/ISSUE_TEMPLATE/awesome-go-com.md b/.github/ISSUE_TEMPLATE/awesome-go-com.md deleted file mode 100644 index 33c6f51f..00000000 --- a/.github/ISSUE_TEMPLATE/awesome-go-com.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -name: awesome-go.com -about: website-related -title: "[awesome-go.com]: issue title here" -labels: awesome-go.com -assignees: '' - ---- - - diff --git a/.github/ISSUE_TEMPLATE/awesome-go-related-topic.md b/.github/ISSUE_TEMPLATE/awesome-go-related-topic.md deleted file mode 100644 index 2dd422f1..00000000 --- a/.github/ISSUE_TEMPLATE/awesome-go-related-topic.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -name: awesome-go related topic -about: Create a report to help us improve -title: '' -labels: help wanted -assignees: '' - ---- - - diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml new file mode 100644 index 00000000..69c606f1 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug.yml @@ -0,0 +1,27 @@ +name: Bug Report +description: Report a bug encountered +labels: ["bug", "pending-review"] +body: + - type: markdown + attributes: + value: | + Thank you very much for opening a bug report at awesome-go. + + If you have a feature idea or need help, please go to [our Forum](https://github.com/avelino/awesome-go/discussions). + before opening the issue we recommend that you read our [contribution guide](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md), there we talk about how you can contribute to awesome-go. + - type: checkboxes + id: confirm-search + attributes: + label: Search first + description: Please search [existing issues](https://github.com/avelino/awesome-go/issues) and the [awesome-go forum](https://github.com/avelino/awesome-go/discussions) before reporting. + options: + - label: I searched and no similar issues were found + required: true + - type: textarea + id: problem + attributes: + label: What Happened? + description: | + Please provide as much info as possible. Not doing so may result in your bug not being addressed in a timely manner. + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..1e6d5851 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,7 @@ +contact_links: + - name: Feature request + url: https://github.com/avelino/awesome-go/discussions/new?category=ideas + about: Suggest an idea for awesome-go + - name: Questions & Help + url: https://github.com/avelino/awesome-go/discussions/new?category=q-a + about: Ask a question about awesome-go diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index ec832a2a..860db5d2 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -1,26 +1,40 @@ -> Please check if what you want to add to `awesome-go` list meets [quality standards](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md#quality-standards) before sending pull request. Thanks! +## We want to ensure high quality of the packages. Make sure that you've checked the boxes below before sending a pull request. -**Please provide package links to:** +- [ ] I have read the [Contribution Guidelines](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md#contribution-guidelines) +- [ ] I have read the [Maintainers Note](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md#maintainers) +- [ ] I have read the [Quality Standards](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md#quality-standards) -- repo link (github.com, gitlab.com, etc): -- pkg.go.dev: -- goreportcard.com: -- coverage service link ([codecov](https://codecov.io/), [coveralls](https://coveralls.io/), [gocover](http://gocover.io/) etc.): +_Not every repository (project) will require every option, but most projects should. Check the Contribution Guidelines for details._ -**Note**: _that new categories can be added only when there are 3 packages or more._ - -**Make sure that you've checked the boxes below that apply before you submit PR.** -_Not every repository (project) will require every option, but most projects should. Check the Contribution Guidelines for detials._ - -- [ ] The package has been added to the list in alphabetical order. -- [ ] The package has an appropriate description with correct grammar. -- [ ] As far as I know, the package has not been listed here before. - [ ] The repo documentation has a pkg.go.dev link. - [ ] The repo documentation has a coverage service link. - [ ] The repo documentation has a goreportcard link. - [ ] The repo has a version-numbered release and a go.mod file. -- [ ] I have read the [Contribution Guidelines](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md#contribution-guidelines), [Maintainers Note](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md#maintainers) and [Quality Standards](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md#quality-standards). - [ ] The repo has a continuous integration process that automatically runs tests that must pass before new pull requests are merged. -- [ ] The authors of the project do not commit directly to the repo, but rather use pull requests that run the continuous-integration process. +- [ ] Continuous integration is used to attempt to catch issues prior to releasing this package to end-users. -Thanks for your PR, you're awesome! :+1: +## Please provide some links to your package to ease the review + +- [ ] forge link (github.com, gitlab.com, etc): +- [ ] pkg.go.dev: +- [ ] goreportcard.com: +- [ ] coverage service link ([codecov](https://codecov.io/), [coveralls](https://coveralls.io/), etc.): + +## Pull Request content + +- [ ] The package has been added to the list in alphabetical order. +- [ ] The package has an appropriate description with correct grammar. +- [ ] As far as I know, the package has not been listed here before. + +## Category quality + +_Note that new categories can be added only when there are 3 packages or more._ + +Packages added a long time ago might not meet the current guidelines anymore. It would be very helpful if you could check 3-5 packages above and below your submission to ensure that they also still meet the Quality Standards. + +Please delete one of the following lines: + +- [ ] The packages around my addition still meet the Quality Standards. +- [ ] I removed the following packages around my addition: (please give a short reason for each removal) + +Thanks for your PR, you're awesome! :sunglasses: diff --git a/.github/workflows/check-for-spammy-issues.yml b/.github/workflows/check-for-spammy-issues.yml new file mode 100644 index 00000000..871ecc39 --- /dev/null +++ b/.github/workflows/check-for-spammy-issues.yml @@ -0,0 +1,14 @@ +name: Issues spammy check +on: + issues: + types: [opened] + +jobs: + mark-as-spam: + name: Remove issues with spammy + runs-on: ubuntu-latest + steps: + - name: close issue + uses: balevine/mark-as-spam@v1.0 + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/.github/workflows/pull-request-first-comment.yaml b/.github/workflows/pull-request-first-comment.yaml new file mode 100644 index 00000000..e5f3ac03 --- /dev/null +++ b/.github/workflows/pull-request-first-comment.yaml @@ -0,0 +1,31 @@ +name: First comment in new pull request + +on: + pull_request_target: + types: [opened] + +jobs: + commentCreated: + runs-on: ubuntu-latest + permissions: + pull-requests: write + issues: write + environment: action + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + steps: + - name: first comment + uses: peter-evans/create-or-update-comment@v3 + with: + token: ${{ secrets.GITHUB_TOKEN }} + issue-number: ${{ github.event.pull_request.number }} + body: | + Thank you for contributing to [awesome-go](https://awesome-go.com/). We will review your contribution as soon as possible. + + Make sure you add the links in the body of the pull request that are requested in the [contribution guide](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md): + - repo link + - pkg.go.dev + - goreportcard.com + - coverage + + > Your project is under review. It may take a few days to be approved. diff --git a/.github/workflows/run-check.yaml b/.github/workflows/run-check.yaml index f9cfa9dc..97258613 100644 --- a/.github/workflows/run-check.yaml +++ b/.github/workflows/run-check.yaml @@ -3,16 +3,20 @@ on: workflow_dispatch: schedule: - cron: '0 0 * * 0' + +permissions: + contents: read # to fetch code (actions/checkout) + jobs: build: name: Running test runs-on: ubuntu-latest container: golang:latest steps: - - uses: actions/checkout@1.0.0 + - uses: actions/checkout@v4 - name: Get dependencies run: go get -v -t -d ./... - name: run script - run: go test stale_repositories_test.go scripts.go + run: go test -v -run ^TestStaleRepository$ env: OAUTH_TOKEN: ${{secrets.OAUTH_TOKEN}} diff --git a/.github/workflows/site-deploy.yaml b/.github/workflows/site-deploy.yaml index bc7a2e56..e69802c6 100644 --- a/.github/workflows/site-deploy.yaml +++ b/.github/workflows/site-deploy.yaml @@ -5,6 +5,9 @@ on: branches: - 'main' +permissions: + contents: read # to fetch code (actions/checkout) + jobs: build: name: Make and Deploy site @@ -12,15 +15,15 @@ jobs: environment: netlify container: golang:latest steps: - - uses: actions/checkout@1.0.0 + - uses: actions/checkout@v4 - name: Get dependencies run: go get -v -t -d ./... - name: Make awesome-go.com - run: go run make_site.go scripts.go + run: go run . - name: deploy awesome-go.com uses: jsmrcaga/action-netlify-deploy@v1.1.0 with: NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }} NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }} NETLIFY_DEPLOY_TO_PROD: true - build_directory: tmpl + build_directory: out diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml deleted file mode 100644 index 2e0869ee..00000000 --- a/.github/workflows/stale.yml +++ /dev/null @@ -1,22 +0,0 @@ -name: PR auto close, if you stay more than 8 days open - -on: - workflow_dispatch: - schedule: - - cron: '0 0 * * *' - -jobs: - stale: - runs-on: ubuntu-latest - steps: - - uses: actions/stale@v1 - with: - repo-token: ${{ secrets.GITHUB_TOKEN }} - stale-pr-message: > - This PR has been automatically marked as stale because it has not had - recent activity. They will wait 15 days for your interaction, after - that the PR will be closed. - Please read more in https://github.com/avelino/awesome-go/blob/master/CONTRIBUTING.md - stale-pr-label: 'stale' - days-before-stale: 15 - days-before-close: 7 diff --git a/.github/workflows/tests.yaml b/.github/workflows/tests.yaml index de83e3b6..0ac9bd45 100644 --- a/.github/workflows/tests.yaml +++ b/.github/workflows/tests.yaml @@ -6,14 +6,17 @@ on: - 'main' pull_request: +permissions: + contents: read # to fetch code (actions/checkout) + jobs: build: name: Running test runs-on: ubuntu-latest container: golang:latest steps: - - uses: actions/checkout@1.0.0 + - uses: actions/checkout@v4 - name: Get dependencies run: go get -v -t -d ./... - name: Run tests - run: go test repo_test.go scripts.go + run: go test main_test.go main.go diff --git a/.gitignore b/.gitignore index 9a7c1cec..c43b1528 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,5 @@ -tmpl/index.html +out/ awesome-go -vendor # Folders .idea @@ -9,5 +8,3 @@ test_stale_repositories_log *.exe # Local Netlify folder .netlify -*.html -sitemap.xml diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 9807c1ff..5b85b915 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -12,7 +12,7 @@ We invite all those who participate in Awesome Go to help us create safe and pos A supplemental goal of this Code of Conduct is to increase open source citizenship by encouraging participants to recognize and strengthen the relationships between our actions and their effects on our community. -Communities mirror the societies in which they exist and positive action is essential to counteract the many forms of inequality and abuses of power that exist in society. +Communities mirror the societies in which they exist, and positive action is essential to counteract the many forms of inequality and abuses of power that exist in society. If you see someone who is making an extra effort to ensure our community is welcoming, friendly, and encourages all participants to contribute to the fullest extent, we want to know. @@ -20,28 +20,28 @@ If you see someone who is making an extra effort to ensure our community is welc The following behaviors are expected and requested of all community members: -* Participate in an authentic and active way. In doing so, you contribute to the health and longevity of this community. -* Exercise consideration and respect in your speech and actions. -* Attempt collaboration before conflict. -* Refrain from demeaning, discriminatory, or harassing behavior and speech. -* Be mindful of your surroundings and of your fellow participants. Alert community leaders if you notice a dangerous situation, someone in distress, or violations of this Code of Conduct, even if they seem inconsequential. -* Remember that community event venues may be shared with members of the public; please be respectful to all patrons of these locations. +* Participate in an authentic and active way. In doing so, you contribute to the health and longevity of this community. +* Exercise consideration and respect in your speech and actions. +* Attempt collaboration before conflict. +* Refrain from demeaning, discriminatory, or harassing behavior and speech. +* Be mindful of your surroundings and of your fellow participants. Alert community leaders if you notice a dangerous situation, someone distressed, or violations of this Code of Conduct, even if they seem inconsequential. +* Remember that community event venues may be shared with members of the public; please be respectful to all patrons of these locations. ## 4. Unacceptable Behavior The following behaviors are considered harassment and are unacceptable within our community: -* Violence, threats of violence or violent language directed against another person. -* Sexist, racist, homophobic, transphobic, ableist or otherwise discriminatory jokes and language. -* Posting or displaying sexually explicit or violent material. -* Posting or threatening to post other people’s personally identifying information ("doxing"). -* Personal insults, particularly those related to gender, sexual orientation, race, religion, or disability. -* Inappropriate photography or recording. -* Inappropriate physical contact. You should have someone’s consent before touching them. -* Unwelcome sexual attention. This includes, sexualized comments or jokes; inappropriate touching, groping, and unwelcomed sexual advances. -* Deliberate intimidation, stalking or following (online or in person). -* Advocating for, or encouraging, any of the above behavior. -* Sustained disruption of community events, including talks and presentations. +* Violence, threats of violence or violent language directed against another person. +* Sexist, racist, homophobic, transphobic, ableist or otherwise discriminatory jokes and language. +* Posting or displaying sexually explicit or violent material. +* Posting or threatening to post other people’s personally identifying information ("doxing"). +* Personal insults, particularly those related to gender, sexual orientation, race, religion, or disability. +* Inappropriate photography or recording. +* Inappropriate physical contact. You should have someone’s consent before touching them. +* Unwelcome sexual attention. This includes, sexualized comments or jokes; inappropriate touching, groping, and unwelcomed sexual advances. +* Deliberate intimidation, stalking or following (online or in person). +* Advocating for, or encouraging, any of the above behavior. +* Sustained disruption of community events, including talks and presentations. ## 5. Consequences of Unacceptable Behavior @@ -49,11 +49,11 @@ Unacceptable behavior from any community member, including sponsors and those wi Anyone asked to stop unacceptable behavior is expected to comply immediately. -If a community member engages in unacceptable behavior, the community organizers may take any action they deem appropriate, up to and including a temporary ban or permanent expulsion from the community without warning (and without refund in the case of a paid event). +If a community member engages in unacceptable behavior, the community organizers may take any action they deem appropriate, up to and including a temporary ban or permanent expulsion from the community unexpected (and without refund in the case of a paid event). ## 6. Reporting Guidelines -If you are subject to or witness unacceptable behavior, or have any other concerns, please notify a community organizer as soon as possible. t@avelino.xxx. +If you are subject to or witness unacceptable behavior, or have any other concerns, please notify a community organizer as soon as possible. [Reporting Guidelines](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md#contribution-guidelines) @@ -73,7 +73,7 @@ This code of conduct and its related procedures also applies to unacceptable beh ## 9. Contact info -t@avelino.xxx +avelinorun AT gmail DOT com ## 10. License and attribution @@ -81,4 +81,4 @@ This Code of Conduct is distributed under a [Creative Commons Attribution-ShareA Portions of text derived from the [Django Code of Conduct](https://www.djangoproject.com/conduct/) and the [Geek Feminism Anti-Harassment Policy](http://geekfeminism.wikia.com/wiki/Conference_anti-harassment/Policy). -Retrieved on November 22, 2016 from [http://citizencodeofconduct.org/](http://citizencodeofconduct.org/) +Retrieved on November 22, 2016 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2c325478..2234cfe4 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,22 +1,24 @@ This resource was made by the Go community and wouldn't be possible without you! We appreciate and recognize [all contributors](https://github.com/avelino/awesome-go/graphs/contributors). + # Contribution Guidelines -> Please be aware that we want to accept your contribution, but we have **some rules to keep the minimum quality** -of the packages listed here. All reviews are **not personal feedback**, -even if you are a _developer reviewing your contribution_. **Sorry if we can't meet your expectations, we do our best**. +> Please be aware that we want to accept your contribution, but we have **some rules to keep the minimum quality** of the packages listed here. All reviews are **not personal feedback**, even if you are a _developer reviewing your contribution_. **Sorry, if we can't meet your expectations; we do our best**. - **To add, remove, or change things on the list:** Submit a pull request To set this list apart from and complement the excellent [Go wiki Projects page](https://golang.org/wiki/Projects), -and other lists, awesome-go is a specially curated list for high-quality, actively maintained Go packages and resources. +and other lists, awesome-go is a specially curated list of high-quality, actively maintained Go packages and resources. Please contribute links to packages/projects you have used or are familiar with. This will help ensure high-quality entries. +> the maintainers do not work full-time on the project, meaning that we do not have a set periodicity for reviewing contributions - rest assured that we will do our best to review and eventually accept contributions + + ## Quality standards -To be on the list, project repositories should adhere to the following quality standards +To be on the list, project repositories should adhere to the following quality standards. (https://goreportcard.com/report/github.com/ **github_user** / **github_repo**): - have an **open source license**, [see list of allowed licenses](https://opensource.org/licenses/alphabetical); @@ -26,12 +28,13 @@ To be on the list, project repositories should adhere to the following quality s - regular, recent commits; - or, for finished projects, issues and pull requests are responded to generally within 2 weeks; - be stable or progressing toward stable; -- be thoroughly documented (README, pkg.go.dev doc comments, etc.) in the english language, so everyone is able to understand the project's intention and how it works. All public functions and types should have a Go style documentation header; -- if the library/program is testable, then coverage should be >= 80% for non-data-related packages and >=90% for data related packages. (**Note**: the tests will be reviewed too. We will check your coverage manually if your package's coverage is just a benchmark results); -- have at least one official version-numbered release that allows go.mod files to list the file by version number, of the form vX.X.X. +- be thoroughly documented (README, pkg.go.dev doc comments, etc.) in the English language, so everyone is able to understand the project's intention and how it works. All public functions and types should have a Go-style documentation header; +- if the library/program is testable, then coverage should be >= 80% for non-data-related packages and >=90% for data-related packages. (**Note**: the tests will be reviewed too. We will check your coverage manually if your package's coverage is just a benchmark result); +- have at least one official version-numbered release that allows go.mod files to list the file by version number of the form vX.X.X. Categories must have at least 3 items. + ## Preparing for review Projects listed must have the following in their documentation. When submitting, you will be asked @@ -43,9 +46,10 @@ to provide them. One way to accomplish the above is to add badges to your project's README file. - Use https://pkg.go.dev/badge/ to create the pkg.go.dev link. -- Go to https://goreportcard.com/ to generate a Go Report Card report, then click on the report badge in the upper right corner to see details on how to add the badge to your README. +- Go to https://goreportcard.com/ to generate a Go Report Card report, then click on the report badge in the upper-right corner to see details on how to add the badge to your README. - Codecov, coveralls, and gocover all offer ways to create badges for code coverage reports. Another option is to generate a badge as part of a continuous integration process. See [Code Coverage](COVERAGE.md) for an example. + ## How to add an item to the list Open a pull request against the README.md document that adds the repository to the list. @@ -54,17 +58,17 @@ Open a pull request against the README.md document that adds the repository to t - The added item should be in alphabetical order within its category. - The link should be the name of the package or project. - Descriptions should be clear, concise, and non-promotional. -- Descriptions should follow the link, on the same line and end with a punctuation mark. -- Remember to put a period `.` at end of the project description. +- Descriptions should follow the link on the same line and end with a punctuation mark. +- Remember to put a period `.` at the end of the project description. If you are creating a new category, move the projects that apply to the new category, ensuring -that the resulting list has at least 3 projects in every category and that the categories are alphabetized. +that the resulting list has at least 3 projects in every category, and that the categories are alphabetized. Fill out the template in your PR with the links asked for. If you accidentally remove the PR template from the submission, you can find it [here](https://github.com/avelino/awesome-go/blob/main/.github/PULL_REQUEST_TEMPLATE.md). ## Congrats, your project got accepted - what now? -You are an awesome project now! Feel encouraged to tell others about it by adding one of these badges: +You are an outstanding project now! Feel encouraged to tell others about it by adding one of these badges: [![Mentioned in Awesome Go](https://awesome.re/mentioned-badge.svg)](https://github.com/avelino/awesome-go) [![Mentioned in Awesome Go](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/avelino/awesome-go) @@ -72,43 +76,47 @@ You are an awesome project now! Feel encouraged to tell others about it by addin [![Mentioned in Awesome Go](https://awesome.re/mentioned-badge.svg)](https://github.com/avelino/awesome-go) [![Mentioned in Awesome Go](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/avelino/awesome-go) ``` + + ## Maintenance expectations for projects listed here To prevent removal from awesome-go, your project must maintain the following quality standards. -- Development should be on-going and maintain code quality. Official releases should be at least once a year if the project is ongoing. +- Development should be ongoing and maintain code quality. Official releases should be at least once a year if the project is ongoing. - Or, if development has halted because the project is mature and stable, that can be demonstrated by having no bug reports in the Issues list that are older than 6 months. - All links to quality reports should be to the most recent official release or current ongoing development. Highly recommended but not required: -- A continuous integration process be part of the ongoing development process -- That the project uses a pull-request process and the owners do not commit directly to the repository -- That the pull-request process requires the continuous-integration tests pass before a pull request can be merged +- A continuous integration process to be part of the ongoing development process +- That the project uses a pull-request process, and the owners do not commit directly to the repository +- That the pull-request process requires the continuous-integration tests to pass before a pull request can be merged + ## How to remove an item from the list - Open a pull request that deletes the line of the project in question. - Delete the submission template and substitute a description of which criteria the project is not meeting. It should be a combination of the following. - - The project has not made an official release within the last year and it has open issues. + - The project has not made an official release within the last year and has open issues. - The project is not responding to bug reports issued within 6 months of submission. - The project is not meeting quality standards as indicated by the Go Report Card or Code Coverage tests. - The quality standard links have been removed from the documentation. - The project is no longer open-sourced. - - The project is not compatible with any Go version issued within the last year (there is hopefully an open PR about this at the project). + - The project is incompatible with any Go version issued within the last year (there is hopefully an open PR about this at the project). -If the project is hosted on Github, include a link to the project's submitter and/or author so +If the project is hosted on GitHub, include a link to the project's submitter and/or author so that they will be notified of the desire to remove the project and have an opportunity to respond. The link should be of the form @githubID. -If the project is not hosted on Github, open an issue at the project in question's repository linking to the PR +If the project is not hosted on GitHub, open an issue at the project in question's repository linking to the PR and stating the following: >This project is currently listed at awesome-go at https://github.com/avelino/awesome-go. However, it appears that the project is not maintaining the quality standards required to continue to be listed at the awesome-go project. -This project is schedule to be removed within 2 weeks of this posting. To continue to be listed at awesome-go, please respond at: +This project is scheduled to be removed within 2 weeks of this posting. To continue to be listed at awesome-go, please respond at: -- link to above PR -- Then, comment on your PR at awesome-go with a link to the removal issue at the project. + ## Maintainers To make sure every PR is checked, we have [team maintainers](MAINTAINERS). Every PR MUST be reviewed by at least one maintainer before it can get merged. @@ -120,12 +128,41 @@ that the PR will be closed. ## Reporting issues -Please open an issue if you would like to discuss anything that could be improved or have suggestions for making the list a more valuable resource. We realize sometimes packages fall into abandonment or have breaking builds for extended periods of time, so if you see that, feel free to change its listing or let us know. We also realize that sometimes projects are just going through transitions or are more experimental in nature. These can still be cool, but we can indicate them as transitory or experimental. +Please open an issue if you would like to discuss anything that could be improved or have suggestions for making the list a more valuable resource. We realize sometimes packages fall into abandonment or have breaking builds for extended periods of time, so if you see that, feel free to change its listing, or please let us know. We also realize that sometimes projects are just going through transitions or are more experimental in nature. These can still be cool, but we can indicate them as transitory or experimental. -Removal changes will not be applied until they have been pending for a minimum of 1 week (7 days). This grace window benefits projects that may be going through a temporary transition but are otherwise worthy of being on the list. +Removal changes will not be applied until they have been pending for a minimum of 1 week (7 days). This grace window benefits projects that may be going through a temporary transition, but are otherwise worthy of being on the list. -Thanks everyone! +Thanks, everyone! -## How decision are made + +## How decisions are made The official group of maintainers has the final decision on what PRs are accepted. Discussions are made openly in issues. Decisions are made by consensus. + + +## How to become a contributor? + +awesome-go is an open source project (created and maintained by the community), we are always open to new people to help us review the contributions (pull requests), **you don't need permission** or _name on the maintainers list_ to review a contribution and mark it as **LGTM**. + +> Before you do anything, please read [this topic](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md#quality-standards) very carefully. + +Now that you've read it, let's go! + +Go into the pull requests (PR) and look at the following aspects: + +* **shared links in the body of the PR:** they need to be valid and follow the quality specified above +* **check that the link added to `README.md`** is the same as the link to the repository mentioned in the body of the PR. +* **is it in the correct category?** + +If everything is OK, mark the PR as approved, [read this documentation](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request#starting-a-review) on how to do it. + +**Welcome to awesome-go!** + + +## How to become an ~~"official maintainer"~~? + +We don't give this name to people who are allowed to accept the PR. + +If you are a person who is constantly active in reviewing PR and contributing to the project, you will be invited by a maintainer. + +> **remember:** if you stop contributing with awesome-go for a long time, you will automatically be removed from the list of maintainers. diff --git a/COVERAGE.md b/COVERAGE.md index 62f4931f..dfba16a3 100644 --- a/COVERAGE.md +++ b/COVERAGE.md @@ -1,15 +1,10 @@ # Code Coverage -While we recommend using one of the free websites available for monitoring code coverage -during your continuous integration process, below is an example of how you can incorporate -code coverage during the continuous integration process provided by github actions and -generate a code coverage report without one of those services. +While we recommend using one of the free websites available for monitoring code coverage during your continuous integration process, below is an example of how you can incorporate code coverage during the continuous integration process provided by GitHub actions and generate a code coverage report without one of those services. -This yaml file will run tests on multiple system configurations, but will produce -a code coverage report on only one of those. It will then create a code coverage badge -and add it to the README file. +This `yaml` file will run tests on multiple system configurations, but will produce a code coverage report on only one of those. It will then create a code coverage badge and add it to the README file. -This file should be put in the `.github/workflows` directory of your repo. +This file should be put in the `.github/workflows` directory of your repo: ```yaml name: Go # The name of the workflow that will appear on Github diff --git a/README.md b/README.md index 301f86fa..5a38fcdb 100644 --- a/README.md +++ b/README.md @@ -7,8 +7,9 @@ [![Slack Widget](https://img.shields.io/badge/join-us%20on%20slack-gray.svg?longCache=true&logo=slack&colorB=red)](https://gophers.slack.com/messages/awesome) [![Netlify Status](https://api.netlify.com/api/v1/badges/83a6dcbe-0da6-433e-b586-f68109286bd5/deploy-status)](https://app.netlify.com/sites/awesome-go/deploys) [![Track Awesome List](https://www.trackawesomelist.com/badge.svg)](https://www.trackawesomelist.com/avelino/awesome-go/) +[![Last Commit](https://img.shields.io/github/last-commit/avelino/awesome-go)](https://img.shields.io/github/last-commit/avelino/awesome-go) -We use the _[Golang Bridge](https://github.com/gobridge/about-us/blob/master/README.md)_ community slack for instant communication, follow the [form here to join](https://invite.slack.golangbridge.org/). +We use the _[Golang Bridge](https://github.com/gobridge/about-us/blob/master/README.md)_ community Slack for instant communication, follow the [form here to join](https://invite.slack.golangbridge.org/). awesome-go - Curated list awesome Go frameworks, libraries and software | Product Hunt @@ -20,21 +21,6 @@ _Special thanks to_ - - - -
- -Doppler
-Quit struggling with scattered API keys and access controls.
-Keep your secrets in sync across environments, servers, and teams with Doppler. - -		 - -x-team
-Work from anywhere in the world with top tech companies like Riot Games, Coinbase, and Google. - -
WorkOS
@@ -46,7 +32,7 @@ _Special thanks to_ 		keygen
-A dead-simple software licensing and distribution API built for developers
+An open, source-available software licensing and distribution API.
Securely license and distribute Go applications with a single API.
Add auto updates with only a few lines of code. @@ -63,13 +49,13 @@ _Special thanks to_
-**Awesome Go has no monthly fee**_, but we have employees who **work hard** to keep it running, with money raised we can repay the effort of each person involved! You can see how we calculate our billing and distribution as it is open to the entire community. Want to be a supporter of the project click [here](mailto:avelinorun+oss@gmail.com?subject=awesome-go%3A%20project%20support)._ +**Awesome Go has no monthly fee**_, but we have employees who **work hard** to keep it running. With money raised, we can repay the effort of each person involved! You can see how we calculate our billing and distribution as it is open to the entire community. Want to be a supporter of the project click [here](mailto:avelinorun+oss@gmail.com?subject=awesome-go%3A%20project%20support)._ -> A curated list of awesome Go frameworks, libraries and software. Inspired by [awesome-python](https://github.com/vinta/awesome-python). +> A curated list of awesome Go frameworks, libraries, and software. Inspired by [awesome-python](https://github.com/vinta/awesome-python). **Contributing:** -Please take a quick gander at the [contribution guidelines](https://github.com/avelino/awesome-go/blob/master/CONTRIBUTING.md) first. Thanks to all [contributors](https://github.com/avelino/awesome-go/graphs/contributors); you rock! +Please take a quick gander at the [contribution guidelines](https://github.com/avelino/awesome-go/blob/main/CONTRIBUTING.md) first. Thanks to all [contributors](https://github.com/avelino/awesome-go/graphs/contributors); you rock! > _If you see a package or project here that is no longer maintained or is not a good fit, please submit a pull request to improve this file. Thank you!_ @@ -77,6 +63,7 @@ Please take a quick gander at the [contribution guidelines](https://github.com/a - [Awesome Go](#awesome-go) - [Contents](#contents) + - [Artificial Intelligence](#artificial-intelligence) - [Audio and Music](#audio-and-music) - [Authentication and OAuth](#authentication-and-oauth) - [Blockchain](#blockchain) @@ -88,6 +75,7 @@ Please take a quick gander at the [contribution guidelines](https://github.com/a - [Configuration](#configuration) - [Continuous Integration](#continuous-integration) - [CSS Preprocessors](#css-preprocessors) + - [Data Integration Frameworks](#data-integration-frameworks) - [Data Structures and Algorithms](#data-structures-and-algorithms) - [Bit-packing and Compression](#bit-packing-and-compression) - [Bit Sets](#bit-sets) @@ -166,6 +154,11 @@ Please take a quick gander at the [contribution guidelines](https://github.com/a - [Stream Processing](#stream-processing) - [Template Engines](#template-engines) - [Testing](#testing) + - [Testing Frameworks](#testing-frameworks) + - [Mock](#mock) + - [Fuzzing and delta-debugging/reducing/shrinking](#fuzzing-and-delta-debuggingreducingshrinking) + - [Selenium and browser control tools](#selenium-and-browser-control-tools) + - [Fail injection](#fail-injection) - [Text Processing](#text-processing) - [Formatters](#formatters) - [Markup Languages](#markup-languages) @@ -211,6 +204,17 @@ Please take a quick gander at the [contribution guidelines](https://github.com/a - [Reddit](#reddit) - [Websites](#websites) - [Tutorials](#tutorials) + - [Guided Learning](#guided-learning) + +**[⬆ back to top](#contents)** + +## Artificial Intelligence + +_Libraries for building programs that leverage AI._ + +- [langchaingo](https://github.com/tmc/langchaingo) - LangChainGo is a framework for developing applications powered by language models. +- [LocalAI](https://github.com/mudler/LocalAI) - Open Source OpenAI alternative, self-host AI models. +- [Ollama](https://github.com/jmorganca/ollama) - Run large language models locally. **[⬆ back to top](#contents)** @@ -225,7 +229,6 @@ _Libraries for manipulating audio._ - [id3v2](https://github.com/bogem/id3v2) - ID3 decoding and encoding library for Go. - [malgo](https://github.com/gen2brain/malgo) - Mini audio library. - [minimp3](https://github.com/tosone/minimp3) - Lightweight MP3 decoder library. -- [music-theory](https://github.com/go-music-theory/music-theory) - Music theory models in Go. - [Oto](https://github.com/hajimehoshi/oto) - A low-level library to play sound on multiple platforms. - [PortAudio](https://github.com/gordonklaus/portaudio) - Go bindings for the PortAudio audio I/O library. @@ -233,30 +236,33 @@ _Libraries for manipulating audio._ ## Authentication and OAuth -_Libraries for implementing authentications schemes._ +_Libraries for implementing authentication schemes._ -- [authboss](https://github.com/volatiletech/authboss) - Modular authentication system for the web. It tries to remove as much boilerplate and "hard things" as possible so that each time you start a new web project in Go, you can plug it in, configure, and start building your app without having to build an authentication system each time. +- [authboss](https://github.com/volatiletech/authboss) - Modular authentication system for the web. It tries to remove as much boilerplate and "hard things" as possible so that each time you start a new web project in Go, you can plug it in, configure it, and start building your app without having to build an authentication system each time. - [branca](https://github.com/essentialkaos/branca) - branca token [specification implementation](https://github.com/tuupola/branca-spec) for Golang 1.15+. -- [casbin](https://github.com/hsluoyz/casbin) - Authorization library that supports access control models like ACL, RBAC, ABAC. -- [cookiestxt](https://github.com/mengzhuo/cookiestxt) - provides parser of cookies.txt file format. -- [go-guardian](https://github.com/shaj13/go-guardian) - Go-Guardian is a golang library that provides a simple, clean, and idiomatic way to create powerful modern API and web authentication that supports LDAP, Basic, Bearer token and Certificate based authentication. -- [go-jose](https://github.com/square/go-jose) - Fairly complete implementation of the JOSE working group's JSON Web Token, JSON Web Signatures, and JSON Web Encryption specs. +- [casbin](https://github.com/hsluoyz/casbin) - Authorization library that supports access control models like ACL, RBAC, and ABAC. +- [cookiestxt](https://github.com/mengzhuo/cookiestxt) - provides a parser of cookies.txt file format. +- [go-guardian](https://github.com/shaj13/go-guardian) - Go-Guardian is a golang library that provides a simple, clean, and idiomatic way to create powerful modern API and web authentication that supports LDAP, Basic, Bearer token, and Certificate based authentication. +- [go-jose](https://github.com/go-jose/go-jose) - Fairly complete implementation of the JOSE working group's JSON Web Token, JSON Web Signatures, and JSON Web Encryption specs. - [gologin](https://github.com/dghubble/gologin) - chainable handlers for login with OAuth1 and OAuth2 authentication providers. - [gorbac](https://github.com/mikespook/gorbac) - provides a lightweight role-based access control (RBAC) implementation in Golang. -- [gosession](http://github.com/Kwynto/gosession) - This is quick session for net/http in GoLang. This package is perhaps the best implementation of the session mechanism, at least it tries to become one. +- [gosession](http://github.com/Kwynto/gosession) - This is quick session for net/http in GoLang. This package is perhaps the best implementation of the session mechanism, or at least it tries to become one. - [goth](https://github.com/markbates/goth) - provides a simple, clean, and idiomatic way to use OAuth and OAuth2. Handles multiple providers out of the box. -- [jeff](https://github.com/abraithwaite/jeff) - Simple, flexible, secure and idiomatic web session management with pluggable backends. +- [jeff](https://github.com/abraithwaite/jeff) - Simple, flexible, secure, and idiomatic web session management with pluggable backends. - [jwt](https://github.com/pascaldekloe/jwt) - Lightweight JSON Web Token (JWT) library. -- [jwt](https://github.com/cristalhq/jwt) - Safe, simple and fast JSON Web Tokens for Go. +- [jwt](https://github.com/cristalhq/jwt) - Safe, simple, and fast JSON Web Tokens for Go. - [jwt-auth](https://github.com/adam-hanna/jwt-auth) - JWT middleware for Golang http servers with many configuration options. +- [jwt-go](https://github.com/golang-jwt/jwt) - A full featured implementation of JSON Web Tokens (JWT). This library supports the parsing and verification as well as the generation and signing of JWTs. - [keto](https://github.com/ory/keto) - Open Source (Go) implementation of "Zanzibar: Google's Consistent, Global Authorization System". Ships gRPC, REST APIs, newSQL, and an easy and granular permission language. Supports ACL, RBAC, and other access models. -- [loginsrv](https://github.com/tarent/loginsrv) - JWT login microservice with plugable backends such as OAuth2 (Github), htpasswd, osiam. -- [oauth2](https://github.com/golang/oauth2) - Successor of goauth2. Generic OAuth 2.0 package that comes with JWT, Google APIs, Compute Engine and App Engine support. +- [loginsrv](https://github.com/tarent/loginsrv) - JWT login microservice with pluggable backends such as OAuth2 (Github), htpasswd, osiam. +- [oauth2](https://github.com/golang/oauth2) - Successor of goauth2. Generic OAuth 2.0 package that comes with JWT, Google APIs, Compute Engine, and App Engine support. +- [oidc](https://github.com/zitadel/oidc) - Easy to use OpenID Connect client and server library written for Go and certified by the OpenID Foundation +- [openfga](https://github.com/openfga/openfga) - Implementation of fine-grained authorization based on the "Zanzibar: Google's Consistent, Global Authorization System" paper. Backed by [CNCF](https://www.cncf.io/). - [osin](https://github.com/openshift/osin) - Golang OAuth2 server library. - [otpgen](https://github.com/grijul/otpgen) - Library to generate TOTP/HOTP codes. - [otpgo](https://github.com/jltorresm/otpgo) - Time-Based One-Time Password (TOTP) and HMAC-Based One-Time Password (HOTP) library for Go. - [paseto](https://github.com/o1egl/paseto) - Golang implementation of Platform-Agnostic Security Tokens (PASETO). -- [permissions2](https://github.com/xyproto/permissions2) - Library for keeping track of users, login states and permissions. Uses secure cookies and bcrypt. +- [permissions2](https://github.com/xyproto/permissions2) - Library for keeping track of users, login states, and permissions. Uses secure cookies and bcrypt. - [scope](https://github.com/SonicRoshan/scope) - Easily Manage OAuth2 Scopes In Go. - [scs](https://github.com/alexedwards/scs) - Session Manager for HTTP servers. - [securecookie](https://github.com/chmike/securecookie) - Efficient secure cookie encoding/decoding. @@ -271,9 +277,12 @@ _Libraries for implementing authentications schemes._ _Tools for building blockchains._ +- [cometbft](https://github.com/cometbft/cometbft) - A distributed, Byzantine fault-tolerant, deterministic state machine replication engine. It is a fork of Tendermint Core and implements the Tendermint consensus algorithm. - [cosmos-sdk](https://github.com/cosmos/cosmos-sdk) - A Framework for Building Public Blockchains in the Cosmos Ecosystem. - [go-ethereum](https://github.com/ethereum/go-ethereum) - Official Go implementation of the Ethereum protocol. +- [gosemble](https://github.com/LimeChain/gosemble) - A Go-based framework for building Polkadot/Substrate-compatible runtimes. - [gossamer](https://github.com/ChainSafe/gossamer) - A Go implementation of the Polkadot Host. +- [kubo](https://github.com/ipfs/kubo) - A blockchain framework implemented in Go. It provides content-addressable storage which can be used for decentralized storage in DApps. It is based on the IPFS protocol. - [solana-go](https://github.com/gagliardetto/solana-go) - Go library to interface with Solana JSON RPC and WebSocket interfaces. - [tendermint](https://github.com/tendermint/tendermint) - High-performance middleware for transforming a state machine written in any programming language into a Byzantine Fault Tolerant replicated state machine using the Tendermint consensus and blockchain protocols. @@ -284,12 +293,14 @@ _Tools for building blockchains._ _Libraries for building and working with bots._ - [arikawa](https://github.com/diamondburned/arikawa) - A library and framework for the Discord API. +- [bot](https://github.com/go-telegram/bot) - Zero-dependencies Telegram Bot library with additional UI components - [echotron](https://github.com/NicoNex/echotron) - An elegant and concurrent library for Telegram Bots in Go. - [ephemeral-roles](https://github.com/ewohltman/ephemeral-roles) - A Discord bot for managing ephemeral roles based upon voice channel member presence. - [go-chat-bot](https://github.com/go-chat-bot/bot) - IRC, Slack & Telegram bot written in Go. - [go-joe](https://joe-bot.net) - A general-purpose bot library inspired by Hubot but written in Go. -- [go-sarah](https://github.com/oklahomer/go-sarah) - Framework to build bot for desired chat services including LINE, Slack, Gitter and more. -- [go-tgbot](https://github.com/olebedev/go-tgbot) - Pure Golang Telegram Bot API wrapper, generated from swagger file, session-based router and middleware. +- [go-sarah](https://github.com/oklahomer/go-sarah) - Framework to build a bot for desired chat services including LINE, Slack, Gitter, and more. +- [go-tg](https://github.com/mr-linch/go-tg) - Generated from official docs Go client library for accessing Telegram Bot API, with batteries for building complex bots included. +- [go-tgbot](https://github.com/olebedev/go-tgbot) - Pure Golang Telegram Bot API wrapper, generated from swagger file, session-based router, and middleware. - [go-twitch-irc](https://github.com/gempir/go-twitch-irc) - Library to write bots for twitch.tv chat - [Golang CryptoTrading Bot](https://github.com/saniales/golang-crypto-trading-bot) - A golang implementation of a console-based trading bot for cryptocurrency exchanges. - [govkbot](https://github.com/nikepan/govkbot) - Simple Go [VK](https://vk.com) bot library. @@ -303,7 +314,7 @@ _Libraries for building and working with bots._ - [slacker](https://github.com/shomali11/slacker) - Easy to use framework to create Slack bots. - [slackscot](https://github.com/alexandre-normand/slackscot) - Another framework for building Slack bots. - [tbot](https://github.com/yanzay/tbot) - Telegram bot server with API similar to net/http. -- [telebot](https://github.com/tucnak/telebot) - Telegram bot framework written in Go. +- [telebot](https://github.com/tucnak/telebot) - Telegram bot framework is written in Go. - [telego](https://github.com/mymmrac/telego) - Telegram Bot API library for Golang with full one-to-one API implementation. - [telegram-bot-api](https://github.com/Syfaro/telegram-bot-api) - Simple and clean Telegram bot client. - [teleterm](https://github.com/alfiankan/teleterm) - Telegram Bot Exec Terminal Command. @@ -314,18 +325,21 @@ _Libraries for building and working with bots._ ## Build Automation -_Libraries and tools helping with build automation._ +_Libraries and tools help with build automation._ - [1build](https://github.com/gopinath-langote/1build) - Command line tool to frictionlessly manage project-specific commands. +- [air](https://github.com/cosmtrek/air) - Air - Live reload for Go apps. - [anko](https://github.com/GuilhermeCaruso/anko) - Simple application watcher for multiple programming languages. - [gaper](https://github.com/maxcnunes/gaper) - Builds and restarts a Go project when it crashes or some watched file changes. - [gilbert](https://go-gilbert.github.io) - Build system and task runner for Go projects. +- [gob](https://github.com/kcmvp/gob) - [Gradle](https://docs.gradle.org/)/[Maven](https://maven.apache.org/) like build tool for Go projects. - [goyek](https://github.com/goyek/goyek) - Create build pipelines in Go. - [mage](https://github.com/magefile/mage) - Mage is a make/rake-like build tool using Go. - [mmake](https://github.com/tj/mmake) - Modern Make. -- [realize](https://github.com/tockins/realize) - Go build system with file watchers and live reload. Run, build and watch file changes with custom paths. +- [realize](https://github.com/tockins/realize) - Go build a system with file watchers and live to reload. Run, build and watch file changes with custom paths. - [Task](https://github.com/go-task/task) - simple "Make" alternative. - [taskctl](https://github.com/taskctl/taskctl) - Concurrent task runner. +- [xc](https://github.com/joerdav/xc) - Task runner with README.md defined tasks, executable markdown. **[⬆ back to top](#contents)** @@ -336,8 +350,11 @@ _Libraries and tools helping with build automation._ _Libraries for building Console Applications and Console User Interfaces._ - [asciigraph](https://github.com/guptarohit/asciigraph) - Go package to make lightweight ASCII line graph ╭┈╯ in command line apps with no other dependencies. -- [aurora](https://github.com/logrusorgru/aurora) - ANSI terminal colors that supports fmt.Printf/Sprintf. +- [aurora](https://github.com/logrusorgru/aurora) - ANSI terminal colors that support fmt.Printf/Sprintf. - [box-cli-maker](https://github.com/Delta456/box-cli-maker) - Make Highly Customized Boxes for your CLI. +- [bubble-table](https://github.com/Evertras/bubble-table) - An interactive table component for bubbletea. +- [bubbles](https://github.com/charmbracelet/bubbles) - TUI components for bubbletea. +- [bubbletea](https://github.com/charmbracelet/bubbletea) - Go framework to build terminal apps, based on The Elm Architecture. - [cfmt](https://github.com/mingrammer/cfmt) - Contextual fmt inspired by bootstrap color classes. - [cfmt](https://github.com/i582/cfmt) - Simple and convenient formatted stylized output fully compatible with fmt library. - [chalk](https://github.com/ttacon/chalk) - Intuitive package for prettifying terminal/console output. @@ -348,24 +365,26 @@ _Libraries for building Console Applications and Console User Interfaces._ - [go-colorable](https://github.com/mattn/go-colorable) - Colorable writer for windows. - [go-colortext](https://github.com/daviddengcn/go-colortext) - Go library for color output in terminals. - [go-isatty](https://github.com/mattn/go-isatty) - isatty for golang. +- [go-palette](https://github.com/abusomani/go-palette) - Go library that provides elegant and convenient style definitions using ANSI colors. Fully compatible & wraps the [fmt library](https://pkg.go.dev/fmt) for nice terminal layouts. - [go-prompt](https://github.com/c-bata/go-prompt) - Library for building a powerful interactive prompt, inspired by [python-prompt-toolkit](https://github.com/jonathanslenders/python-prompt-toolkit). - [gocui](https://github.com/jroimartin/gocui) - Minimalist Go library aimed at creating Console User Interfaces. - [gommon/color](https://github.com/labstack/gommon/tree/master/color) - Style terminal text. - [gookit/color](https://github.com/gookit/color) - Terminal color rendering tool library, support 16 colors, 256 colors, RGB color rendering output, compatible with Windows. +- [lipgloss](https://github.com/charmbracelet/lipgloss) - Declaratively define styles for color, format and layout in the terminal. - [marker](https://github.com/cyucelen/marker) - Easiest way to match and mark strings for colorful terminal outputs. - [mpb](https://github.com/vbauerster/mpb) - Multi progress bar for terminal applications. - [progressbar](https://github.com/schollz/progressbar) - Basic thread-safe progress bar that works in every OS. - [pterm](https://github.com/pterm/pterm) - A library to beautify console output on every platform with many combinable components. -- [simpletable](https://github.com/alexeyco/simpletable) - Simple tables in terminal with Go. +- [simpletable](https://github.com/alexeyco/simpletable) - Simple tables in a terminal with Go. - [spinner](https://github.com/briandowns/spinner) - Go package to easily provide a terminal spinner with options. - [tabby](https://github.com/cheynewallace/tabby) - A tiny library for super simple Golang tables. -- [table](https://github.com/tomlazar/table) - Small library for terminal color based tables . +- [table](https://github.com/tomlazar/table) - Small library for terminal color based tables. - [tabular](https://github.com/InVisionApp/tabular) - Print ASCII tables from command line utilities without the need to pass large sets of data to the API. - [termbox-go](https://github.com/nsf/termbox-go) - Termbox is a library for creating cross-platform text-based interfaces. - [termdash](https://github.com/mum4k/termdash) - Go terminal dashboard based on **termbox-go** and inspired by [termui](https://github.com/gizak/termui). - [termenv](https://github.com/muesli/termenv) - Advanced ANSI style & color support for your terminal applications. - [termui](https://github.com/gizak/termui) - Go terminal dashboard based on **termbox-go** and inspired by [blessed-contrib](https://github.com/yaronn/blessed-contrib). -- [uilive](https://github.com/gosuri/uilive) - Library for updating terminal output in realtime. +- [uilive](https://github.com/gosuri/uilive) - Library for updating terminal output in real time. - [uiprogress](https://github.com/gosuri/uiprogress) - Flexible library to render progress bars in terminal applications. - [uitable](https://github.com/gosuri/uitable) - Library to improve readability in terminal apps using tabular data. - [yacspin](https://github.com/theckman/yacspin) - Yet Another CLi Spinner package, for working with terminal spinners. @@ -376,7 +395,7 @@ _Libraries for building Console Applications and Console User Interfaces._ _Libraries for building standard or basic Command Line applications._ -- [acmd](https://github.com/cristalhq/acmd) - Simple, useful and opinionated CLI package in Go. +- [acmd](https://github.com/cristalhq/acmd) - Simple, useful, and opinionated CLI package in Go. - [argparse](https://github.com/akamensky/argparse) - Command line argument parser inspired by Python's argparse module. - [argv](https://github.com/cosiner/argv) - Go library to split command line string as arguments array using the bash syntax. - [carapace](https://github.com/rsteube/carapace) - Command argument completion generator for spf13/cobra. @@ -389,7 +408,7 @@ _Libraries for building standard or basic Command Line applications._ - [cmd](https://github.com/posener/cmd) - Extends the standard `flag` package to support sub commands and more in idiomatic way. - [cmdr](https://github.com/hedzr/cmdr) - A POSIX/GNU style, getopt-like command-line UI Go library. - [cobra](https://github.com/spf13/cobra) - Commander for modern Go CLI interactions. -- [command-chain](https://github.com/rainu/go-command-chain) - A go library for configure and run command chains - such like pipelining in unix shells. +- [command-chain](https://github.com/rainu/go-command-chain) - A go library for configure and run command chains - such as pipelining in unix shells. - [commandeer](https://github.com/jaffee/commandeer) - Dev-friendly CLI apps: sets up flags, defaults, and usage based on struct fields and tags. - [complete](https://github.com/posener/complete) - Write bash completions in Go + Go command bash completion. - [Dnote](https://github.com/dnote/dnote) - A simple command line notebook with multi-device sync. @@ -398,11 +417,11 @@ _Libraries for building standard or basic Command Line applications._ - [flag](https://github.com/cosiner/flag) - Simple but powerful command line option parsing library for Go supporting subcommand. - [flaggy](https://github.com/integrii/flaggy) - A robust and idiomatic flags package with excellent subcommand support. - [flagvar](https://github.com/sgreben/flagvar) - A collection of flag argument types for Go's standard `flag` package. -- [go-andotp](https://github.com/grijul/go-andotp) - A CLI program to encrypt/decrypt [andOTP](https://github.com/andOTP/andOTP) files. Can be used as library as well. +- [go-andotp](https://github.com/grijul/go-andotp) - A CLI program to encrypt/decrypt [andOTP](https://github.com/andOTP/andOTP) files. Can be used as a library as well. - [go-arg](https://github.com/alexflint/go-arg) - Struct-based argument parsing in Go. - [go-commander](https://github.com/yitsushi/go-commander) - Go library to simplify CLI workflow. - [go-flags](https://github.com/jessevdk/go-flags) - go command line option parser. -- [go-getoptions](https://github.com/DavidGamba/go-getoptions) - Go option parser inspired on the flexibility of Perl’s GetOpt::Long. +- [go-getoptions](https://github.com/DavidGamba/go-getoptions) - Go option parser inspired by the flexibility of Perl’s GetOpt::Long. - [gocmd](https://github.com/devfacet/gocmd) - Go library for building command line applications. - [hiboot cli](https://github.com/hidevopsio/hiboot/tree/master/pkg/app/cli) - cli application framework with auto configuration and dependency injection. - [job](https://github.com/liujianping/job) - JOB, make your short-term command as a long-term job. @@ -413,15 +432,18 @@ _Libraries for building standard or basic Command Line applications._ - [mow.cli](https://github.com/jawher/mow.cli) - Go library for building CLI applications with sophisticated flag and argument parsing and validation. - [ops](https://github.com/nanovms/ops) - Unikernel Builder/Orchestrator. - [pflag](https://github.com/spf13/pflag) - Drop-in replacement for Go's flag package, implementing POSIX/GNU-style --flags. +- [readline](https://github.com/reeflective/readline) Shell library with modern and easy to use UI features. - [sand](https://github.com/Zaba505/sand) - Simple API for creating interpreters and so much more. -- [sflags](https://github.com/octago/sflags) - Struct based flags generator for flag, urfave/cli, pflag, cobra, kingpin and other libraries. +- [sflags](https://github.com/octago/sflags) - Struct based flags generator for flag, urfave/cli, pflag, cobra, kingpin, and other libraries. - [strumt](https://github.com/antham/strumt) - Library to create prompt chain. - [subcmd](https://github.com/bobg/subcmd) - Another approach to parsing and running subcommands. Works alongside the standard `flag` package. +- [survey](https://github.com/go-survey/survey) - Build interactive and accessible prompts with full support for windows and posix terminals. - [ts](https://github.com/liujianping/ts) - Timestamp convert & compare tool. - [ukautz/clif](https://github.com/ukautz/clif) - Small command line interface framework. - [urfave/cli](https://github.com/urfave/cli) - Simple, fast, and fun package for building command line apps in Go (formerly codegangsta/cli). +- [version](https://github.com/mszostok/version) - Collects and displays CLI version information in multiple formats along with upgrade notice. - [wlog](https://github.com/dixonwille/wlog) - Simple logging interface that supports cross-platform color and concurrency. -- [wmenu](https://github.com/dixonwille/wmenu) - Easy to use menu structure for cli applications that prompts users to make choices. +- [wmenu](https://github.com/dixonwille/wmenu) - Easy to use menu structure for cli applications that prompt users to make choices. **[⬆ back to top](#contents)** @@ -430,45 +452,49 @@ _Libraries for building standard or basic Command Line applications._ _Libraries for configuration parsing._ - [aconfig](https://github.com/cristalhq/aconfig) - Simple, useful and opinionated config loader. +- [bcl](https://github.com/wkhere/bcl) - BCL is a configuration language similar to HCL. - [cleanenv](https://github.com/ilyakaznacheev/cleanenv) - Minimalistic configuration reader (from files, ENV, and wherever you want). - [config](https://github.com/JeremyLoy/config) - Cloud native application configuration. Bind ENV to structs in only two lines. -- [config](https://github.com/num30/config) - configure you app using file, environment variables, or flags in two lines of code +- [config](https://github.com/num30/config) - configure your app using file, environment variables, or flags in two lines of code - [config](https://github.com/olebedev/config) - JSON or YAML configuration wrapper with environment variables and flags parsing. - [configuration](https://github.com/BoRuDar/configuration) - Library for initializing configuration structs from env variables, files, flags and 'default' tag. - [configure](https://github.com/paked/configure) - Provides configuration through multiple sources, including JSON, flags and environment variables. - [configuro](https://github.com/sherifabdlnaby/configuro) - opinionated configuration loading & validation framework from ENV and Files focused towards 12-Factor compliant applications. +- [confiq](https://github.com/greencoda/confiq) - Structured data format to config struct decoder library for Go - supporting multiple data formats - [confita](https://github.com/heetch/confita) - Load configuration in cascade from multiple backends into a struct. - [conflate](https://github.com/the4thamigo-uk/conflate) - Library/tool to merge multiple JSON/YAML/TOML files from arbitrary URLs, validation against a JSON schema, and application of default values defined in the schema. - [env](https://github.com/caarlos0/env) - Parse environment variables to Go structs (with defaults). - [env](https://github.com/junk1tm/env) - A lightweight package for loading environment variables into structs. -- [envcfg](https://github.com/tomazk/envcfg) - Un-marshaling environment variables to Go structs. -- [envconf](https://github.com/ian-kent/envconf) - Configuration from environment. +- [env](https://github.com/syntaqx/env) - An environment utility package with support for unmarshaling into structs - [envconfig](https://github.com/vrischmann/envconfig) - Read your configuration from environment variables. - [envh](https://github.com/antham/envh) - Helpers to manage environment variables. - [fig](https://github.com/kkyr/fig) - Tiny library for reading configuration from a file and from environment variables (with validation & defaults). -- [gcfg](https://github.com/go-gcfg/gcfg) - read INI-style configuration files into Go structs; supports user-defined types and subsections. - [genv](https://github.com/sakirsensoy/genv) - Read environment variables easily with dotenv support. +- [go-array](https://github.com/deatil/go-array) - A Go package that read or set data from map, slice or json. - [go-aws-ssm](https://github.com/PaddleHQ/go-aws-ssm) - Go package that fetches parameters from AWS System Manager - Parameter Store. +- [go-cfg](https://github.com/dsbasko/go-cfg) - The library provides a unified way to read configuration data into a structure from various sources, such as env, flags, and configuration files (.json, .yaml, .toml, .env). - [go-conf](https://github.com/ThomasObenaus/go-conf) - Simple library for application configuration based on annotated structs. It supports reading the configuration from environment variables, config files and command line parameters. - [go-ini](https://github.com/subpop/go-ini) - A Go package that marshals and unmarshals INI-files. - [go-ssm-config](https://github.com/ianlopshire/go-ssm-config) - Go utility for loading configuration parameters from AWS SSM (Parameter Store). - [go-up](https://github.com/ufoscout/go-up) - A simple configuration library with recursive placeholders resolution and no magic. +- [GoCfg](https://github.com/Jagerente/gocfg) - Config manager with Struct Tags based contracts, custom value providers, parsers, and documentation generation. Customizable yet simple. - [goConfig](https://github.com/crgimenes/goConfig) - Parses a struct as input and populates the fields of this struct with parameters from command line, environment variables and configuration file. - [godotenv](https://github.com/joho/godotenv) - Go port of Ruby's dotenv library (Loads environment variables from `.env`). - [gofigure](https://github.com/ian-kent/gofigure) - Go application configuration made easy. - [GoLobby/Config](https://github.com/golobby/config) - GoLobby Config is a lightweight yet powerful configuration manager for the Go programming language. -- [gone/jconf](https://github.com/One-com/gone/tree/master/jconf) - Modular JSON configuration. Keep you config structs along with the code they configure and delegate parsing to submodules without sacrificing full config serialization. +- [gone/jconf](https://github.com/One-com/gone/tree/master/jconf) - Modular JSON configuration. Keep your config structs along with the code they configure and delegate parsing to submodules without sacrificing full config serialization. - [gonfig](https://github.com/milad-abbasi/gonfig) - Tag-based configuration parser which loads values from different providers into typesafe struct. - [gookit/config](https://github.com/gookit/config) - application config manage(load,get,set). support JSON, YAML, TOML, INI, HCL. multi file load, data override merge. -- [harvester](https://github.com/beatlabs/harvester) - Harvester, a easy to use static and dynamic configuration package supporting seeding, env vars and Consul integration. +- [harvester](https://github.com/beatlabs/harvester) - Harvester, an easy to use static and dynamic configuration package supporting seeding, env vars and Consul integration. - [hjson](https://github.com/hjson/hjson-go) - Human JSON, a configuration file format for humans. Relaxed syntax, fewer mistakes, more comments. - [hocon](https://github.com/gurkankaymak/hocon) - Configuration library for working with the HOCON(a human-friendly JSON superset) format, supports features like environment variables, referencing other values, comments and multiple files. - [ingo](https://github.com/schachmat/ingo) - Flags persisted in an ini-like config file. - [ini](https://github.com/go-ini/ini) - Go package to read and write INI files. -- [ini](https://github.com/wlevene/ini) - INI Parser & Write Library, Unmarshal to Struct,Marshal to Json,Write File,watch file. +- [ini](https://github.com/wlevene/ini) - INI Parser & Write Library, Unmarshal to Struct, Marshal to Json, Write File, watch file. - [joshbetz/config](https://github.com/joshbetz/config) - Small configuration library for Go that parses environment variables, JSON files, and reloads automatically on SIGHUP. - [kelseyhightower/envconfig](https://github.com/kelseyhightower/envconfig) - Go library for managing configuration data from environment variables. - [koanf](https://github.com/knadh/koanf) - Light weight, extensible library for reading config in Go applications. Built in support for JSON, TOML, YAML, env, command line. +- [konf](https://github.com/nil-go/konf) - The simplest API for reading/watching config from file, env, flag and clouds (e.g. AWS, Azure, GCP). - [konfig](https://github.com/lalamove/konfig) - Composable, observable and performant config handling for Go for the distributed processing era. - [kong](https://github.com/alecthomas/kong) - Command-line parser with support for arbitrarily complex command-line structures and additional sources of configuration such as YAML, JSON, TOML, etc (successor to `kingpin`). - [mini](https://github.com/sasbury/mini) - Golang package for parsing ini-style configuration files. @@ -483,6 +509,7 @@ _Libraries for configuration parsing._ - [viper](https://github.com/spf13/viper) - Go configuration with fangs. - [xdg](https://github.com/adrg/xdg) - Go implementation of the [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) and [XDG user directories](https://wiki.archlinux.org/index.php/XDG_user_directories). - [xdg](https://github.com/OpenPeeDeeP/xdg) - Cross platform package that follows the [XDG Standard](https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html). +- [yamagiconf](https://github.com/romshark/yamagiconf) - The "safe subset" of YAML for Go configs. **[⬆ back to top](#contents)** @@ -490,16 +517,20 @@ _Libraries for configuration parsing._ _Tools for help with continuous integration._ +- [Bencher](https://bencher.dev/) - A suite of continuous benchmarking tools designed to catch performance regressions in CI. - [CDS](https://github.com/ovh/cds) - Enterprise-Grade CI/CD and DevOps Automation Open Source Platform. +- [dot](https://github.com/opnlabs/dot) - A minimal, local first continuous integration system that uses Docker to run jobs concurrently in stages. - [drone](https://github.com/drone/drone) - Drone is a Continuous Integration platform built on Docker, written in Go. -- [duci](https://github.com/duck8823/duci) - A simple ci server no needs domain specific languages. +- [go-beautiful-html-coverage](https://github.com/gha-common/go-beautiful-html-coverage) - A GitHub Action to track code coverage in your pull requests, with a beautiful HTML preview, for free. - [go-fuzz-action](https://github.com/jidicula/go-fuzz-action) - Use Go 1.18's built-in fuzz testing in GitHub Actions. +- [go-semver-release](https://github.com/s0ders/go-semver-release) - Automate the semantic versioning of Git repositories. +- [go-test-coverage](https://github.com/vladopajic/go-test-coverage) - Tool and GitHub action which reports issues when test coverage is below set threshold. - [gomason](https://github.com/nikogura/gomason) - Test, Build, Sign, and Publish your go binaries from a clean workspace. -- [gotestfmt](https://github.com/haveyoudebuggedit/gotestfmt) - go test output for humans. +- [gotestfmt](https://github.com/GoTestTools/gotestfmt) - go test output for humans. - [goveralls](https://github.com/mattn/goveralls) - Go integration for Coveralls.io continuous code coverage tracking system. - [overalls](https://github.com/go-playground/overalls) - Multi-Package go project coverprofile for tools like goveralls. - [roveralls](https://github.com/LawrenceWoodman/roveralls) - Recursive coverage testing tool. -- [woodpecker](https://github.com/woodpecker-ci/woodpecker) - Woodpecker is a community fork of the Drone CI system. +- [woodpecker](https://github.com/woodpecker-ci/woodpecker) - Woodpecker is a community fork of the Drone CI system. **[⬆ back to top](#contents)** @@ -512,6 +543,16 @@ _Libraries for preprocessing CSS files._ **[⬆ back to top](#contents)** +## Data Integration Frameworks + +_Frameworks for performing ELT / ETL_ + +- [Benthos](https://github.com/benthosdev/benthos) - A message streaming bridge between a range of protocols. +- [CloudQuery](http://github.com/cloudquery/cloudquery) - A high-performance ELT data integration framework with pluggable architecture. +- [omniparser](https://github.com/jf-tech/omniparser) - A versatile ETL library that parses text input (CSV/txt/JSON/XML/EDI/X12/EDIFACT/etc) in streaming fashion and transforms data into JSON output using data-driven schema. + +**[⬆ back to top](#contents)** + ## Data Structures and Algorithms ### Bit-packing and Compression @@ -535,7 +576,7 @@ _Libraries for preprocessing CSS files._ - [bloom](https://github.com/yourbasic/bloom) - Golang Bloom filter implementation. - [bloomfilter](https://github.com/OldPanda/bloomfilter) - Yet another Bloomfilter implementation in Go, compatible with Java's Guava library. - [boomfilters](https://github.com/tylertreat/BoomFilters) - Probabilistic data structures for processing continuous, unbounded streams. -- [cuckoo-filter](https://github.com/linvon/cuckoo-filter) - Cuckoo filter: a comprehensive cuckoo filter, which is configurable and space optimized compared with other implements, and all features mentioned in original paper is available. +- [cuckoo-filter](https://github.com/linvon/cuckoo-filter) - Cuckoo filter: a comprehensive cuckoo filter, which is configurable and space optimized compared with other implements, and all features mentioned in original paper are available. - [cuckoofilter](https://github.com/seiflotfy/cuckoofilter) - Cuckoo filter: a good alternative to a counting bloom filter implemented in Go. - [ring](https://github.com/TheTannerRyan/ring) - Go implementation of a high performance, thread safe bloom filter. @@ -574,10 +615,12 @@ additional ordered map implementations. - [go-tuple](https://github.com/barweiss/go-tuple) - Generic tuple implementation for Go 1.18+. - [go18ds](https://github.com/daichi-m/go18ds) - Go Data Structures using Go 1.18 generics. - [gofal](https://github.com/xxjwxc/gofal) - fractional api for Go. +- [gogu](https://github.com/esimov/gogu) - A comprehensive, reusable and efficient concurrent-safe generics utility functions and data structures library. - [gota](https://github.com/kniren/gota) - Implementation of dataframes, series, and data wrangling methods for Go. - [hide](https://github.com/emvi/hide) - ID type with marshalling to/from hash to prevent sending IDs to clients. - [hilbert](https://github.com/google/hilbert) - Go package for mapping values to and from space-filling curves, such as Hilbert and Peano curves. - [hyperloglog](https://github.com/axiomhq/hyperloglog) - HyperLogLog implementation with Sparse, LogLog-Beta bias correction and TailCut space reduction. +- [plinko](https://github.com/shipt/plinko) - A finite state machine and workflow orchestrator that compiles for fast execution, easy debugging, auto-generated documentation. Includes advanced features such as side-effect hooks. - [quadtree](https://github.com/s0rg/quadtree) - Generic, zero-alloc, 100%-test covered quadtree. - [slices](https://github.com/srfrog/slices) - Functions that operate on slices; like `package strings` but adapted to work with slices. - [slices](https://github.com/twharmon/slices) - Pure, generic functions for slices. @@ -594,6 +637,7 @@ additional ordered map implementations. - [deque](https://github.com/gammazero/deque) - Fast ring-buffer deque (double-ended queue). - [goconcurrentqueue](https://github.com/enriquebris/goconcurrentqueue) - Concurrent FIFO queue. - [memlog](https://github.com/embano1/memlog) - An easy to use, lightweight, thread-safe and append-only in-memory data structure inspired by Apache Kafka. +- [queue](https://github.com/adrianbrad/queue) - Multiple thread-safe, generic queue implementations for Go. ### Sets @@ -638,26 +682,35 @@ additional ordered map implementations. _Data stores with expiring records, in-memory distributed data stores, or in-memory subsets of file-based databases._ - [2q](https://github.com/floatdrop/2q) - 2Q in-memory cache implementation. -- [bcache](https://github.com/iwanbk/bcache) - Eventually consistent distributed in-memory cache Go library. +- [bcache](https://github.com/iwanbk/bcache) - Eventually consistent distributed in-memory cache Go library. - [BigCache](https://github.com/allegro/bigcache) - Efficient key/value cache for gigabytes of data. - [cache](https://github.com/akyoto/cache) - In-memory key:value store with expiration time, 0 dependencies, <100 LoC, 100% coverage. - [cache2go](https://github.com/muesli/cache2go) - In-memory key:value cache which supports automatic invalidation based on timeouts. - [cachego](https://github.com/faabiosr/cachego) - Golang Cache component for multiple drivers. - [clusteredBigCache](https://github.com/oaStuff/clusteredBigCache) - BigCache with clustering support and individual item expiration. +- [coherence-go-client](https://github.com/oracle/coherence-go-client) - Full implementation of Oracle Coherence cache API for Go applications using gRPC as network transport. - [couchcache](https://github.com/codingsince1985/couchcache) - RESTful caching micro-service backed by Couchbase server. +- [EchoVault](https://github.com/EchoVault/EchoVault) - Embeddable Distributed in-memory data store compatible with Redis clients. - [fastcache](https://github.com/VictoriaMetrics/fastcache) - fast thread-safe inmemory cache for big number of entries. Minimizes GC overhead. - [GCache](https://github.com/bluele/gcache) - Cache library with support for expirable Cache, LFU, LRU and ARC. - [gdcache](https://github.com/ulovecode/gdcache) - A pure non-intrusive cache library implemented by golang, you can use it to implement your own distributed cache. - [go-cache](https://github.com/viney-shih/go-cache) - A flexible multi-layer Go caching library to deal with in-memory and shared cache by adopting Cache-Aside pattern. +- [go-freelru](https://github.com/elastic/go-freelru) A GC-less, fast and generic LRU hashmap library with optional locking, sharding, eviction and expiration. - [go-mcache](https://github.com/OrlovEvgeny/go-mcache) - Fast in-memory key:value store/cache library. Pointer caches. - [gocache](https://github.com/eko/gocache) - A complete Go cache library with multiple stores (memory, memcache, redis, ...), chainable, loadable, metrics cache and more. +- [gocache](https://github.com/yuseferi/gocache) - A data race free Go ache library with high performance and auto pruge functionality - [groupcache](https://github.com/golang/groupcache) - Groupcache is a caching and cache-filling library, intended as a replacement for memcached in many cases. +- [icache](https://github.com/mdaliyan/icache) - A High Performance, Generic, thread-safe, zero-dependency cache package. +- [imcache](https://github.com/erni27/imcache) - A generic in-memory cache Go library. It supports expiration, sliding expiration, max entries limit, eviction callbacks and sharding. +- [nscache](https://github.com/no-src/nscache) - A Go caching framework that supports multiple data source drivers. +- [otter](https://github.com/maypok86/otter) - A high performance lockless cache for Go. Many times faster than Ristretto and friends. - [remember-go](https://github.com/rocketlaunchr/remember-go) - A universal interface for caching slow database queries (backed by redis, memcached, ristretto, or in-memory). +- [sturdyc](https://github.com/creativecreature/sturdyc) - A caching library with advanced concurrency features designed to make I/O heavy applications robust and highly performant. +- [theine](https://github.com/Yiling-J/theine-go) - High performance, near optimal in-memory cache with proactive TTL expiration and generics. - [timedmap](https://github.com/zekroTJA/timedmap) - Map with expiring key-value pairs. - [ttlcache](https://github.com/jellydator/ttlcache) - An in-memory cache with item expiration and generics. - [ttlcache](https://github.com/cheshir/ttlcache) - In-memory key value storage with TTL for each record. - ### Databases Implemented in Go - [badger](https://github.com/dgraph-io/badger) - Fast key-value store in Go. @@ -682,20 +735,26 @@ _Data stores with expiring records, in-memory distributed data stores, or in-mem - [influxdb](https://github.com/influxdb/influxdb) - Scalable datastore for metrics, events, and real-time analytics. - [ledisdb](https://github.com/siddontang/ledisdb) - Ledisdb is a high performance NoSQL like Redis based on LevelDB. - [levigo](https://github.com/jmhodges/levigo) - Levigo is a Go wrapper for LevelDB. +- [libradb](https://github.com/amit-davidson/LibraDB) - LibraDB is a simple database with less than 1000 lines of code for learning. +- [LinDB](https://github.com/lindb/lindb) - LinDB is a scalable, high performance, high availability distributed time series database. - [lotusdb](https://github.com/flower-corp/lotusdb) - Fast k/v database compatible with lsm and b+tree. - [Milvus](https://github.com/milvus-io/milvus) - Milvus is a vector database for embedding management, analytics and search. - [moss](https://github.com/couchbase/moss) - Moss is a simple LSM key-value storage engine written in 100% Go. -- [nutsdb](https://github.com/xujiajun/nutsdb) - Nutsdb is a simple, fast, embeddable, persistent key/value store written in pure Go. It supports fully serializable transactions and many data structures such as list, set, sorted set. +- [nutsdb](https://github.com/xujiajun/nutsdb) - Nutsdb is a simple, fast, embeddable, persistent key/value store written in pure Go. It supports fully serializable transactions and many data structures such as list, set, sorted set. +- [objectbox-go](https://github.com/objectbox/objectbox-go) - High-performance embedded Object Database (NoSQL) with Go API. +- [pebble](https://github.com/cockroachdb/pebble) - RocksDB/LevelDB inspired key-value database in Go. - [piladb](https://github.com/fern4lvarez/piladb) - Lightweight RESTful database engine based on stack data structures. - [pogreb](https://github.com/akrylysov/pogreb) - Embedded key-value store for read-heavy workloads. - [prometheus](https://github.com/prometheus/prometheus) - Monitoring system and time series database. - [pudge](https://github.com/recoilme/pudge) - Fast and simple key/value store written using Go's standard library. +- [regatta](https://github.com/jamf/regatta) - Fast, simple, geo-distributed KV store built for cloud native era. - [rosedb](https://github.com/roseduan/rosedb) - An embedded k-v database based on LSM+WAL, supports string, list, hash, set, zset. +- [rotom](https://github.com/xgzlucario/rotom) - A tiny Redis server built with Golang, compatible with RESP protocols. - [rqlite](https://github.com/rqlite/rqlite) - The lightweight, distributed, relational database built on SQLite. - [tempdb](https://github.com/rafaeljesus/tempdb) - Key-value store for temporary items. - [tidb](https://github.com/pingcap/tidb) - TiDB is a distributed SQL database. Inspired by the design of Google F1. - [tiedot](https://github.com/HouzuoGuo/tiedot) - Your NoSQL database powered by Golang. -- [unitdb](https://github.com/unit-io/unitdb) - Fast timeseries database for IoT, realtime messaging applications. Access unitdb with pubsub over tcp or websocket using github.com/unit-io/unitd application. +- [unitdb](https://github.com/unit-io/unitdb) - Fast timeseries database for IoT, realtime messaging applications. Access unitdb with pubsub over tcp or websocket using github.com/unit-io/unitd application. - [Vasto](https://github.com/chrislusf/vasto) - A distributed high-performance key-value store. On Disk. Eventual consistent. HA. Able to grow or shrink without service interruption. - [VictoriaMetrics](https://github.com/VictoriaMetrics/VictoriaMetrics) - fast, resource-effective and scalable open source time series database. May be used as long-term remote storage for Prometheus. Supports PromQL. @@ -705,6 +764,7 @@ _Data stores with expiring records, in-memory distributed data stores, or in-mem - [avro](https://github.com/khezen/avro) - Discover SQL schemas and convert them to AVRO schemas. Query SQL records into AVRO bytes. - [bytebase](https://github.com/bytebase/bytebase) - Safe database schema change and version control for DevOps teams. - [darwin](https://github.com/GuiaBolso/darwin) - Database schema evolution library for Go. +- [dbmate](https://github.com/amacneil/dbmate) - A lightweight, framework-agnostic database migration tool. - [go-fixtures](https://github.com/RichardKnop/go-fixtures) - Django style fixtures for Golang's excellent built-in database/sql library. - [go-pg-migrate](https://github.com/lawzava/go-pg-migrate) - CLI-friendly package for go-pg migrations management. - [go-pg-migrations](https://github.com/robinjoseph08/go-pg-migrations) - A Go package to help write migrations with go-pg/pg. @@ -713,11 +773,10 @@ _Data stores with expiring records, in-memory distributed data stores, or in-mem - [goose](https://github.com/pressly/goose) - Database migration tool. You can manage your database's evolution by creating incremental SQL or Go scripts. - [gorm-seeder](https://github.com/Kachit/gorm-seeder) - Simple database seeder for Gorm ORM. - [gormigrate](https://github.com/go-gormigrate/gormigrate) - Database schema migration helper for Gorm ORM. -- [libschema](https://github.com/muir/libschema) - Define your migrations separately in each library. Migrations for open source libraries. MySQL & PostgreSQL. +- [libschema](https://github.com/muir/libschema) - Define your migrations separately in each library. Migrations for open source libraries. MySQL & PostgreSQL. - [migrate](https://github.com/golang-migrate/migrate) - Database migrations. CLI and Golang library. - [migrator](https://github.com/lopezator/migrator) - Dead simple Go database migration library. - [migrator](https://github.com/larapulse/migrator) - MySQL database migrator designed to run migrations to your features and manage database schema update with intuitive go code. -- [pravasan](https://github.com/pravasan/pravasan) - Simple Migration tool - currently for MySQL but planning to soon support Postgres, SQLite, MongoDB, etc. - [schema](https://github.com/adlio/schema) - Library to embed schema migrations for database/sql-compatible databases inside your Go binaries. - [skeema](https://github.com/skeema/skeema) - Pure-SQL schema management system for MySQL, with support for sharding and external online schema change tools. - [soda](https://github.com/gobuffalo/pop/tree/master/soda) - Database migration, creation, ORM, etc... for MySQL, PostgreSQL, and SQLite. @@ -728,16 +787,14 @@ _Data stores with expiring records, in-memory distributed data stores, or in-mem - [chproxy](https://github.com/Vertamedia/chproxy) - HTTP proxy for ClickHouse database. - [clickhouse-bulk](https://github.com/nikepan/clickhouse-bulk) - Collects small inserts and sends big requests to ClickHouse servers. -- [datagen](https://github.com/codingconcepts/datagen) - A fast data generator that's multi-table aware and supports multi-row DML. - [dbbench](https://github.com/sj14/dbbench) - Database benchmarking tool with support for several databases and scripts. +- [dg](https://github.com/codingconcepts/dg) - A fast data generator that produces CSV files from generated relational data. - [dynago](https://github.com/twharmon/dynago) - Simplify working with AWS DynamoDB. - [go-mysql](https://github.com/siddontang/go-mysql) - Go toolset to handle MySQL protocol and replication. -- [go-mysql-elasticsearch](https://github.com/siddontang/go-mysql-elasticsearch) - Sync your MySQL data into Elasticsearch automatically. +- [gorm-multitenancy](https://github.com/bartventer/gorm-multitenancy) - Multi-tenancy support for GORM managed databases. - [hasql](https://golang.yandex/hasql) - Library for accessing multi-host SQL database installations. -- [kingshard](https://github.com/flike/kingshard) - kingshard is a high performance proxy for MySQL powered by Golang. -- [myreplication](https://github.com/2tvenom/myreplication) - MySql binary log replication listener. Supports statement and row based replication. - [octillery](https://github.com/knocknote/octillery) - Go package for sharding databases ( Supports every ORM or raw SQL ). -- [orchestrator](https://github.com/github/orchestrator) - MySQL replication topology manager & visualizer. +- [onedump](https://github.com/liweiyi88/onedump) - Database backup from different drivers to different destinations with one command and configuration. - [pg_timetable](https://github.com/cybertec-postgresql/pg_timetable) - Advanced scheduling for PostgreSQL. - [pgweb](https://github.com/sosedoff/pgweb) - Web-based PostgreSQL database browser. - [prep](https://github.com/hexdigest/prep) - Use prepared SQL statements without changing your code. @@ -745,18 +802,22 @@ _Data stores with expiring records, in-memory distributed data stores, or in-mem - [rdb](https://github.com/HDT3213/rdb) - Redis RDB file parser for secondary development and memory analysis. - [rwdb](https://github.com/andizzle/rwdb) - rwdb provides read replica capability for multiple database servers setup. - [vitess](https://github.com/youtube/vitess) - vitess provides servers and tools which facilitate scaling of MySQL databases for large scale web services. +- [wescale](https://github.com/wesql/wescale) - WeScale is a database proxy designed to enhance the scalability, performance, security, and resilience of your applications. ### SQL Query Builders + _Libraries for building and using SQL._ - [bqb](https://github.com/nullism/bqb) - Lightweight and easy to learn query builder. - [buildsqlx](https://github.com/arthurkushman/buildsqlx) - Go database query builder library for PostgreSQL. +- [builq](https://github.com/cristalhq/builq) - Easily build SQL queries in Go. - [dbq](https://github.com/rocketlaunchr/dbq) - Zero boilerplate database operations for Go. - [Dotsql](https://github.com/gchaincl/dotsql) - Go library that helps you keep sql files in one place and use them with ease. - [gendry](https://github.com/didi/gendry) - Non-invasive SQL builder and powerful data binder. - [godbal](https://github.com/xujiajun/godbal) - Database Abstraction Layer (dbal) for go. Support SQL builder and get result easily. - [goqu](https://github.com/doug-martin/goqu) - Idiomatic SQL builder and query library. - [gosql](https://github.com/twharmon/gosql) - SQL Query builder with better null values support. +- [Hotcoal](https://github.com/motrboat/hotcoal) - Secure your handcrafted SQL against injection. - [igor](https://github.com/galeone/igor) - Abstraction layer for PostgreSQL that supports advanced functionality and uses gorm-like syntax. - [jet](https://github.com/go-jet/jet) - Framework for writing type-safe SQL queries in Go, with ability to easily convert database query result into desired arbitrary object structure. - [ormlite](https://github.com/pupizoid/ormlite) - Lightweight package containing some ORM-like features and helpers for sqlite databases. @@ -780,6 +841,8 @@ _Libraries for building and using SQL._ - [cayley](https://github.com/google/cayley) - Graph database with support for multiple backends. - [dsc](https://github.com/viant/dsc) - Datastore connectivity for SQL, NoSQL, structured files. +- [dynamo](https://github.com/fogfish/dynamo) - A simple key-value abstraction to store algebraic and linked-data data types at AWS storage services: AWS DynamoDB and AWS S3. +- [go-transaction-manager](https://github.com/avito-tech/go-transaction-manager) - Transaction manager with multiple adapters (sql, sqlx, gorm, mongo, ...) controls transaction boundaries. - [gokv](https://github.com/philippgille/gokv) - Simple key-value store abstraction and implementations for Go (Redis, Consul, etcd, bbolt, BadgerDB, LevelDB, Memcached, DynamoDB, S3, PostgreSQL, MongoDB, CockroachDB and many more). ### Relational Database Drivers @@ -794,13 +857,13 @@ _Libraries for building and using SQL._ - [go-sqlite3](https://github.com/mattn/go-sqlite3) - SQLite3 driver for go that uses database/sql. - [godror](https://github.com/godror/godror) - Oracle driver for Go, using the ODPI-C driver. - [gofreetds](https://github.com/minus5/gofreetds) - Microsoft MSSQL driver. Go wrapper over [FreeTDS](https://www.freetds.org). -- [Kivik](https://github.com/go-kivik/kivik) - Kivik provides a common Go and GopherJS client library for CouchDB, PouchDB, and similar databases. - [KSQL](https://github.com/VinGarcia/ksql) - A Simple and Powerful Golang SQL Library - [pgx](https://github.com/jackc/pgx) - PostgreSQL driver supporting features beyond those exposed by database/sql. - [pig](https://github.com/alexeyco/pig) - Simple [pgx](https://github.com/jackc/pgx) wrapper to execute and [scan](https://github.com/georgysavva/scany) query results easily. - [pq](https://github.com/lib/pq) - Pure Go Postgres driver for database/sql. - [Sqinn-Go](https://github.com/cvilsmeier/sqinn-go) - SQLite with pure Go. - [sqlhooks](https://github.com/qustavo/sqlhooks) - Attach hooks to any database/sql driver. +- [surrealdb.go](https://github.com/surrealdb/surrealdb.go) - SurrealDB Driver for Go. - [ydb-go-sdk](https://github.com/ydb-platform/ydb-go-sdk) - native and database/sql driver YDB (Yandex Database) ### NoSQL Database Drivers @@ -810,6 +873,7 @@ _Libraries for building and using SQL._ - [asc](https://github.com/viant/asc) - Datastore Connectivity for Aerospike for go. - [forestdb](https://github.com/couchbase/goforestdb) - Go bindings for ForestDB. - [go-couchbase](https://github.com/couchbase/go-couchbase) - Couchbase client in Go. +- [go-mongox](https://github.com/chenmingyong0423/go-mongox) - A Go Mongo library based on the official driver, featuring streamlined document operations, generic binding of structs to collections, built-in CRUD, aggregation, automated field updates, struct validation, hooks, and plugin-based programming. - [go-pilosa](https://github.com/pilosa/go-pilosa) - Go client library for Pilosa. - [go-rejson](https://github.com/nitishm/go-rejson) - Golang client for redislabs' ReJSON module using Redigo golang client. Store and manipulate structs as JSON objects in redis with ease. - [gocb](https://github.com/couchbase/gocb) - Official Couchbase Go SDK. @@ -818,8 +882,10 @@ _Libraries for building and using SQL._ - [godis](https://github.com/piaohao/godis) - redis client implement by golang, inspired by jedis. - [godscache](https://github.com/defcronyke/godscache) - A wrapper for the Google Cloud Platform Go Datastore package that adds caching using memcached. - [gomemcache](https://github.com/bradfitz/gomemcache/) - memcache client library for the Go programming language. +- [gomemcached](https://github.com/aliexpressru/gomemcached) - A binary Memcached client for Go with support for sharding using consistent hashing, along with SASL. - [gorethink](https://github.com/dancannon/gorethink) - Go language driver for RethinkDB. - [goriak](https://github.com/zegl/goriak) - Go language driver for Riak KV. +- [Kivik](https://github.com/go-kivik/kivik) - Kivik provides a common Go and GopherJS client library for CouchDB, PouchDB, and similar databases. - [mgm](https://github.com/kamva/mgm) - MongoDB model-based ODM for Go (based on official MongoDB driver). - [mgo](https://github.com/globalsign/mgo) - (unmaintained) MongoDB driver for the Go language that implements a rich and well tested selection of features under a very simple API following standard Go idioms. - [mongo-go-driver](https://github.com/mongodb/mongo-go-driver) - Official MongoDB driver for the Go language. @@ -829,12 +895,13 @@ _Libraries for building and using SQL._ - [qmgo](https://github.com/qiniu/qmgo) - The MongoDB driver for Go. It‘s based on official MongoDB driver but easier to use like Mgo. - [redeo](https://github.com/bsm/redeo) - Redis-protocol compatible TCP servers/services. - [redigo](https://github.com/gomodule/redigo) - Redigo is a Go client for the Redis database. -- [redis](https://github.com/go-redis/redis) - Redis client for Golang. +- [redis](https://github.com/redis/go-redis) - Redis client for Golang. - [rueidis](http://github.com/rueian/rueidis) - Fast Redis RESP3 client with auto pipelining and server-assisted client side caching. - [xredis](https://github.com/shomali11/xredis) - Typesafe, customizable, clean & easy to use Redis client. ### Search and Analytic Databases +- [clickhouse-go](https://github.com/ClickHouse/clickhouse-go/) - ClickHouse SQL client for Go with a `database/sql` compatibility. - [elastic](https://github.com/olivere/elastic) - Elasticsearch client for Go. - [elasticsql](https://github.com/cch123/elasticsql) - Convert sql to elasticsearch dsl in Go. - [elastigo](https://github.com/mattbaird/elastigo) - Elasticsearch client library. @@ -848,6 +915,7 @@ _Libraries for building and using SQL._ _Libraries for working with dates and times._ +- [approx](https://github.com/goschtalt/approx) - A Duration extension supporting parsing/printing durations in days, weeks and years. - [carbon](https://github.com/golang-module/carbon) - A simple, semantic and developer-friendly golang package for datetime. - [carbon](https://github.com/uniplaces/carbon) - Simple Time extension with a lot of util methods, ported from PHP Carbon library. - [cronrange](https://github.com/1set/cronrange) - Parses Cron-style time range expressions, checks if the given time is within any ranges. @@ -855,6 +923,8 @@ _Libraries for working with dates and times._ - [dateparse](https://github.com/araddon/dateparse) - Parse date's without knowing format in advance. - [durafmt](https://github.com/hako/durafmt) - Time duration formatting library for Go. - [feiertage](https://github.com/wlbr/feiertage) - Set of functions to calculate public holidays in Germany, incl. specialization on the states of Germany (Bundesländer). Things like Easter, Pentecost, Thanksgiving... +- [go-anytime](https://github.com/ijt/go-anytime) - Parse dates/times like "next dec 22nd at 3pm" and ranges like "from today until next thursday" without knowing the format in advance. +- [go-datebin](https://github.com/deatil/go-datebin) - A simple datetime parse pkg. - [go-persian-calendar](https://github.com/yaa110/go-persian-calendar) - The implementation of the Persian (Solar Hijri) Calendar in Go (golang). - [go-str2duration](https://github.com/xhit/go-str2duration) - Convert string to duration. Support time.Duration returned string and more. - [go-sunrise](https://github.com/nathan-osman/go-sunrise) - Calculate the sunrise and sunset times for a given location. @@ -876,6 +946,8 @@ _Libraries for working with dates and times._ _Packages that help with building Distributed Systems._ - [arpc](https://github.com/lesismal/arpc) - More effective network communication, support two-way-calling, notify, broadcast. +- [bedrock](https://github.com/z5labs/bedrock) - Provides a minimal, modular and composable foundation for quickly developing services and more use case specific frameworks in Go. +- [capillaries](https://github.com/capillariesio/capillaries) - distributed batch data processing framework. - [celeriac](https://github.com/svcavallar/celeriac.v1) - Library for adding support for interacting and monitoring Celery workers, tasks and events in Go. - [consistent](https://github.com/buraksezer/consistent) - Consistent hashing with bounded loads. - [consistenthash](https://github.com/mbrostami/consistenthash) - Consistent hashing with configurable replicas. @@ -884,10 +956,12 @@ _Packages that help with building Distributed Systems._ - [dot](https://github.com/dotchain/dot/) - distributed sync using operational transformation/OT. - [doublejump](https://github.com/edwingeng/doublejump) - A revamped Google's jump consistent hash. - [dragonboat](https://github.com/lni/dragonboat) - A feature complete and high performance multi-group Raft library in Go. +- [Dragonfly](https://github.com/dragonflyoss/Dragonfly2) - Provide efficient, stable and secure file distribution and image acceleration based on p2p technology to be the best practice and standard solution in cloud native architectures. - [drmaa](https://github.com/dgruber/drmaa) - Job submission library for cluster schedulers based on the DRMAA standard. - [dynamolock](https://cirello.io/dynamolock) - DynamoDB-backed distributed locking implementation. - [dynatomic](https://github.com/tylfin/dynatomic) - A library for using DynamoDB as an atomic counter. - [emitter-io](https://github.com/emitter-io/emitter) - High performance, distributed, secure and low latency publish-subscribe platform built with MQTT, Websockets and love. +- [evans](https://github.com/ktr0731/evans) - Evans: more expressive universal gRPC client. - [failured](https://github.com/andy2046/failured) - adaptive accrual failure detector for distributed systems. - [flowgraph](https://github.com/vectaport/flowgraph) - flow-based programming package. - [gleam](https://github.com/chrislusf/gleam) - Fast and scalable distributed map/reduce system written in pure Go and Luajit, combining Go's high concurrency with Luajit's high performance, runs standalone or distributed. @@ -907,6 +981,7 @@ _Packages that help with building Distributed Systems._ - [hprose](https://github.com/hprose/hprose-golang) - Very newbility RPC Library, support 25+ languages now. - [jsonrpc](https://github.com/osamingo/jsonrpc) - The jsonrpc package helps implement of JSON-RPC 2.0. - [jsonrpc](https://github.com/ybbus/jsonrpc) - JSON-RPC 2.0 HTTP client implementation. +- [Kitex](https://github.com/cloudwego/kitex) - A high-performance and strong-extensibility Golang RPC framework that helps developers build microservices. If the performance and extensibility are the main concerns when you develop microservices, Kitex can be a good choice. - [Kratos](https://github.com/go-kratos/kratos) - A modular-designed and easy-to-use microservices framework in Go. - [liftbridge](https://github.com/liftbridge-io/liftbridge) - Lightweight, fault-tolerant message streams for NATS. - [lura](https://github.com/luraproject/lura) - Ultra performant API Gateway framework with middlewares. @@ -916,7 +991,7 @@ _Packages that help with building Distributed Systems._ - [pglock](https://cirello.io/pglock) - PostgreSQL-backed distributed locking implementation. - [pjrpc](https://gitlab.com/pjrpc/pjrpc) - Golang JSON-RPC Server-Client with Protobuf spec. - [raft](https://github.com/hashicorp/raft) - Golang implementation of the Raft consensus protocol, by HashiCorp. -- [raft](https://github.com/coreos/etcd/tree/master/raft) - Go implementation of the Raft consensus protocol, by CoreOS. +- [raft](https://github.com/etcd-io/raft) - Go implementation of the Raft consensus protocol, by CoreOS. - [rain](https://github.com/cenkalti/rain) - BitTorrent client and library. - [redis-lock](https://github.com/bsm/redislock) - Simplified distributed locking implementation using Redis. - [resgate](https://resgate.io/) - Realtime API Gateway for building REST, real time, and RPC APIs, where all clients are synchronized seamlessly. @@ -924,7 +999,11 @@ _Packages that help with building Distributed Systems._ - [rpcx](https://github.com/smallnest/rpcx) - Distributed pluggable RPC service framework like alibaba Dubbo. - [Semaphore](https://github.com/jexia/semaphore) - A straightforward (micro) service orchestrator. - [sleuth](https://github.com/ursiform/sleuth) - Library for master-less p2p auto-discovery and RPC between HTTP services (using [ZeroMQ](https://github.com/zeromq/libzmq)). +- [sponge](https://github.com/zhufuyi/sponge) - A distributed development framework that integrates automatic code generation, gin and grpc frameworks, base development frameworks. +- [Tarmac](https://github.com/tarmac-project/tarmac) - Framework for writing functions, microservices, or monoliths with WebAssembly +- [Temporal](https://github.com/temporalio/sdk-go) - Durable execution system for making code fault-tolerant and simple. - [torrent](https://github.com/anacrolix/torrent) - BitTorrent client package. +- [trpc-go](https://github.com/trpc-group/trpc-go) - The Go language implementation of tRPC, which is a pluggable, high-performance RPC framework. **[⬆ back to top](#contents)** @@ -956,9 +1035,11 @@ _Libraries and tools that implement email creation and sending._ - [go-simple-mail](https://github.com/xhit/go-simple-mail) - Very simple package to send emails with SMTP Keep Alive and two timeouts: Connect and Send. - [Hectane](https://github.com/hectane/hectane) - Lightweight SMTP client providing an HTTP API. - [hermes](https://github.com/matcornic/hermes) - Golang package that generates clean, responsive HTML e-mails. +- [Maddy](https://github.com/foxcpp/maddy) - All-in-one (SMTP, IMAP, DKIM, DMARC, MTA-STS, DANE) email server - [mailchain](https://github.com/mailchain/mailchain) - Send encrypted emails to blockchain addresses written in Go. - [mailgun-go](https://github.com/mailgun/mailgun-go) - Go library for sending mail with the Mailgun API. - [MailHog](https://github.com/mailhog/MailHog) - Email and SMTP testing with web and API interface. +- [Mailpit](https://github.com/axllent/mailpit) - Email and SMTP testing tool for developers. - [mailx](https://github.com/valord577/mailx) - Mailx is a library that makes it easier to send email via SMTP. It is an enhancement of the golang standard library `net/smtp`. - [SendGrid](https://github.com/sendgrid/sendgrid-go) - SendGrid's Go library for sending email. - [smtp](https://github.com/mailhog/smtp) - SMTP server protocol state machine. @@ -982,6 +1063,7 @@ _Embedding other languages inside your go code._ - [go-lua](https://github.com/Shopify/go-lua) - Port of the Lua 5.2 VM to pure Go. - [go-php](https://github.com/deuill/go-php) - PHP bindings for Go. - [go-python](https://github.com/sbinet/go-python) - naive go bindings to the CPython C-API. +- [goal](https://codeberg.org/anaseto/goal) - An embeddable scripting array language. - [goja](https://github.com/dop251/goja) - ECMAScript 5.1(+) implementation in Go. - [golua](https://github.com/aarzilli/golua) - Go bindings for Lua C API. - [gopher-lua](https://github.com/yuin/gopher-lua) - Lua 5.1 VM and compiler written in Go. @@ -990,7 +1072,10 @@ _Embedding other languages inside your go code._ - [ngaro](https://github.com/db47h/ngaro) - Embeddable Ngaro VM implementation enabling scripting in Retro. - [prolog](https://github.com/ichiban/prolog) - Embeddable Prolog. - [purl](https://github.com/ian-kent/purl) - Perl 5.18.2 embedded in Go. +- [starlark-go](https://github.com/google/starlark-go) - Go implementation of Starlark: Python-like language with deterministic evaluation and hermetic execution. +- [starlet](https://github.com/1set/starlet) - Go wrapper for [starlark-go](https://github.com/google/starlark-go) that simplifies script execution, offers data conversion, and useful Starlark libraries and extensions. - [tengo](https://github.com/d5/tengo) - Bytecode compiled script language for Go. +- [Wa/凹语言](https://github.com/wa-lang/wa) - The Wa Programming Language embedded in Go. **[⬆ back to top](#contents)** @@ -1002,15 +1087,17 @@ _Libraries for handling errors._ - [eris](https://github.com/rotisserie/eris) - A better way to handle, trace, and log errors in Go. Compatible with the standard error library and github.com/pkg/errors. - [errlog](https://github.com/snwfdhmp/errlog) - Hackable package that determines responsible source code for an error (and some other fast-debugging features). Pluggable to any logger in-place. - [errors](https://github.com/emperror/errors) - Drop-in replacement for the standard library errors package and github.com/pkg/errors. Provides various error handling primitives. -- [errors](https://github.com/pkg/errors) - Package that provides simple error handling primitives. - [errors](https://github.com/neuronlabs/errors) - Simple golang error handling with classification primitives. - [errors](https://github.com/PumpkinSeed/errors) - The most simple error wrapper with awesome performance and minimal memory overhead. +- [errors](https://gitlab.com/tozd/go/errors) - Providing errors with a stack trace and optional structured details. Compatible with github.com/pkg/errors API but does not use it internally. - [errors](https://github.com/bnkamalesh/errors) - Drop-in replacement for builtin Go errors. This is a minimal error handling package with custom error types, user friendly messages, Unwrap & Is. With very easy to use and straightforward helper functions. - [errors](https://github.com/cockroachdb/errors) - Go error library with error portability over the network. - [errorx](https://github.com/joomcode/errorx) - A feature rich error package with stack traces, composition of errors and more. - [exception](https://github.com/rbrahul/exception) - A simple utility package for exception handling with try-catch in Golang. - [Falcon](https://github.com/SonicRoshan/falcon) - A Simple Yet Highly Powerful Package For Error Handling. +- [Fault](https://github.com/Southclaws/fault) - An ergonomic mechanism for wrapping errors in order to facilitate structured metadata and context for error values. - [go-multierror](https://github.com/hashicorp/go-multierror) - Go (golang) package for representing a list of errors as a single error. +- [oops](https://github.com/samber/oops) - Error handling with context, stack trace and source fragments. - [tracerr](https://github.com/ztrue/tracerr) - Golang errors with stack trace and source fragments. **[⬆ back to top](#contents)** @@ -1031,17 +1118,17 @@ _Libraries for handling files and file systems._ - [go-decent-copy](https://github.com/hugocarreira/go-decent-copy) - Copy files for humans. - [go-exiftool](https://github.com/barasher/go-exiftool) - Go bindings for ExifTool, the well-known library used to extract as much metadata as possible (EXIF, IPTC, ...) from files (pictures, PDF, office, ...). - [go-gtfs](https://github.com/artonge/go-gtfs) - Load gtfs files in go. -- [gofs](https://github.com/no-src/gofs) - A file synchronization tool out of the box. +- [gofs](https://github.com/no-src/gofs) - A cross-platform real-time file synchronization tool out of the box. - [gut/yos](https://github.com/1set/gut) - Simple and reliable package for file operations like copy/move/diff/list on files, directories and symbolic links. - [higgs](https://github.com/dastoori/higgs) - A tiny cross-platform Go library to hide/unhide files and directories. +- [iso9660](https://github.com/kdomanski/iso9660) - A package for reading and creating ISO9660 disk images - [notify](https://github.com/rjeczalik/notify) - File system event notification library with simple API, similar to os/signal. - [opc](https://github.com/qmuntal/opc) - Load Open Packaging Conventions (OPC) files for Go. - [parquet](https://github.com/parsyl/parquet) - Read and write [parquet](https://parquet.apache.org) files. - [pathtype](https://github.com/jonchun/pathtype) - Treat paths as their own type instead of using strings. - [pdfcpu](https://github.com/pdfcpu/pdfcpu) - PDF processor. - [skywalker](https://github.com/dixonwille/skywalker) - Package to allow one to concurrently go through a filesystem with ease. -- [stl](https://gitlab.com/russoj88/stl) - Modules to read and write STL (stereolithography) files. Concurrent algorithm for reading. -- [tarfs](https://github.com/posener/tarfs) - Implementation of the [`FileSystem` interface](https://godoc.org/github.com/kr/fs#FileSystem) for tar files. +- [stl](https://gitlab.com/russoj88/stl) - Modules to read and write STL (stereolithography) files. Concurrent algorithm for reading. - [todotxt](https://github.com/1set/todotxt) - Go library for Gina Trapani's [_todo.txt_](http://todotxt.org/) files, supports parsing and manipulating of task lists in the [_todo.txt_ format](https://github.com/todotxt/todo.txt). - [vfs](https://github.com/C2FO/vfs) - A pluggable, extensible, and opinionated set of filesystem functionality for Go across a number of filesystem types such as os, S3, and GCS. @@ -1057,18 +1144,20 @@ _Packages for accounting and finance._ - [currency](https://github.com/bojanz/currency) - Handles currency amounts, provides currency information and formatting. - [currency](https://github.com/bnkamalesh/currency) - High performant & accurate currency computation package. - [decimal](https://github.com/shopspring/decimal) - Arbitrary-precision fixed-point decimal numbers. -- [fastme](https://github.com/newity/fastme) - Fast extensible matching engine Go implementation. +- [decimal](https://github.com/govalues/decimal) - Immutable decimal numbers with panic-free arithmetic. - [fpdecimal](https://github.com/nikolaydubina/fpdecimal) - Fast and precise serialization and arithmetic for small fixed-point decimals - [fpmoney](https://github.com/nikolaydubina/fpmoney) - Fast and simple ISO4217 fixed-point decimal money. -- [go-finance](https://github.com/FlashBoys/go-finance) - Comprehensive financial markets data in Go. - [go-finance](https://github.com/alpeb/go-finance) - Library of financial functions for time value of money (annuities), cash flow, interest rate conversions, bonds and depreciation calculations. - [go-finance](https://github.com/pieterclaerhout/go-finance) - Module to fetch exchange rates, check VAT numbers via VIES and check IBAN bank account numbers. - [go-finnhub](https://github.com/m1/go-finnhub) - Client for stock market, forex and crypto data from finnhub.io. Access real-time financial market data from 60+ stock exchanges, 10 forex brokers, and 15+ crypto exchanges. - [go-money](https://github.com/rhymond/go-money) - Implementation of Fowler's Money pattern. +- [go-nowpayments](https://github.com/matm/go-nowpayments) - Library for the crypto NOWPayments API. +- [money](https://github.com/govalues/money) - Immutable monetary amounts and exchange rates with panic-free arithmetic. - [ofxgo](https://github.com/aclindsa/ofxgo) - Query OFX servers and/or parse the responses (with example command-line client). - [orderbook](https://github.com/i25959341/orderbook) - Matching Engine for Limit Order Book in Golang. - [payme](https://github.com/jovandeginste/payme) - QR code generator (ASCII & PNG) for SEPA payments. - [sleet](https://github.com/BoltApp/sleet) - One unified interface for multiple Payment Service Providers (PsP) to process online payment. +- [swift](https://code.pfad.fr/swift/) - Offline validity check of IBAN (International Bank Account Number) and retrieval of BIC (for some countries). - [techan](https://github.com/sdcoffey/techan) - Technical analysis library with advanced market analysis and trading strategies. - [ticker](https://github.com/achannarasappa/ticker) - Terminal stock watcher and stock position tracker. - [transaction](https://github.com/claygod/transaction) - Embedded transactional database of accounts, running in multithreaded mode. @@ -1082,6 +1171,7 @@ _Libraries for working with forms._ - [bind](https://github.com/robfig/bind) - Bind form data to any Go values. - [binding](https://github.com/mholt/binding) - Binds form and JSON data from net/http Request to struct. +- [checker](https://github.com/cinar/checker) - Checker helps validating user input through rules defined in struct tags or directly through functions. - [conform](https://github.com/leebenson/conform) - Keeps user input in check. Trims, sanitizes & scrubs data based on struct tags. - [form](https://github.com/go-playground/form) - Decodes url.Values into Go value(s) and Encodes Go value(s) into url.Values. Dual Array and Full map support. - [formam](https://github.com/monoculum/formam) - decode form's values into a struct. @@ -1102,6 +1192,7 @@ _Packages to support functional programming in Go._ - [fp-go](https://github.com/repeale/fp-go) - Collection of Functional Programming helpers powered by Golang 1.18+ generics. - [fpGo](https://github.com/TeaEntityLab/fpGo) - Monad, Functional Programming features for Golang. - [fuego](https://github.com/seborama/fuego) - Functional Experiment in Go. +- [go-functional](https://github.com/BooleanCat/go-functional) - Functional programming in Go using generics - [go-underscore](https://github.com/tobyhede/go-underscore) - Useful collection of helpfully functional Go collection utilities. - [gofp](https://github.com/rbrahul/gofp) - A lodash like powerful utility library for Golang. - [mo](https://github.com/samber/mo) - Monads and popular FP abstractions, based on Go 1.18+ Generics (Option, Result, Either...). @@ -1116,6 +1207,7 @@ _Awesome game development libraries._ - [Azul3D](https://github.com/azul3d/engine) - 3D game engine written in Go. - [Ebitengine](https://github.com/hajimehoshi/ebiten) - dead simple 2D game engine in Go. +- [ecs](https://github.com/andygeiss/ecs) - Build your own Game-Engine based on the Entity Component System concept in Golang. - [engo](https://github.com/EngoEngine/engo) - Engo is an open-source 2D game engine written in Go. It follows the Entity-Component-System paradigm. - [fantasyname](https://github.com/s0rg/fantasyname) - Fantasy names generator. - [g3n](https://github.com/g3n/engine) - Go 3D Game Engine. @@ -1124,6 +1216,8 @@ _Awesome game development libraries._ - [go3d](https://github.com/ungerik/go3d) - Performance oriented 2D/3D math package for Go. - [gonet](https://github.com/xtaci/gonet) - Game server skeleton implemented with golang. - [goworld](https://github.com/xiaonanln/goworld) - Scalable game server engine, featuring space-entity framework and hot-swapping. +- [grid](https://github.com/s0rg/grid) - Generic 2D grid with ray-casting, shadow-casting and path finding. +- [Harfang3D](https://github.com/harfang3d/harfang3d) - 3D engine for the Go language, works on Windows and Linux ([Harfang on Go.dev](https://github.com/harfang3d/harfang-go)). - [Leaf](https://github.com/name5566/leaf) - Lightweight game server framework. - [nano](https://github.com/lonng/nano) - Lightweight, facility, high performance golang based game server framework. - [Oak](https://github.com/oakmound/oak) - Pure Go game engine. @@ -1140,17 +1234,18 @@ _Awesome game development libraries._ _Tools that generate Go code._ +- [convergen](https://github.com/reedom/convergen) - Feature rich type-to-type copy code generator. - [copygen](https://github.com/switchupcb/copygen) - Generate type-to-type and type-based code without reflection. - [generis](https://github.com/senselogic/GENERIS) - Code generation tool providing generics, free-form macros, conditional compilation and HTML templating. - [go-enum](https://github.com/abice/go-enum) - Code generation for enums from code comments. - [go-linq](https://github.com/ahmetalpbalkan/go-linq) - .NET LINQ-like query methods for Go. -- [go-xray](https://github.com/pieterclaerhout/go-xray) - Helpers for making the use of reflection easier. - [goderive](https://github.com/awalterschulze/goderive) - Derives functions from input types. - [gotype](https://github.com/wzshiming/gotype) - Golang source code parsing, usage like reflect package. - [goverter](https://github.com/jmattheis/goverter) - Generate converters by defining an interface. - [GoWrap](https://github.com/hexdigest/gowrap) - Generate decorators for Go interfaces using simple templates. - [interfaces](https://github.com/rjeczalik/interfaces) - Command line tool for generating interface definitions. - [jennifer](https://github.com/dave/jennifer) - Generate arbitrary Go code without templates. +- [oapi-codegen](https://github.com/deepmap/oapi-codegen) - This package contains a set of utilities for generating Go boilerplate code for services based on OpenAPI 3.0 API definitions. - [typeregistry](https://github.com/xiaoxin01/typeregistry) - A library to create type dynamically. **[⬆ back to top](#contents)** @@ -1159,10 +1254,11 @@ _Tools that generate Go code._ _Geographic tools and servers_ +- [geoos](https://github.com/spatial-go/geoos) - A library provides spatial data and geometric algorithms. - [geoserver](https://github.com/hishamkaram/geoserver) - geoserver Is a Go Package For Manipulating a GeoServer Instance via the GeoServer REST API. - [gismanager](https://github.com/hishamkaram/gismanager) - Publish Your GIS Data(Vector Data) to PostGIS and Geoserver. - [godal](https://github.com/airbusgeo/godal) - Go wrapper for GDAL. -- [h3-go] - Go bindings for H3, a hierarchical hexagonal geospatial indexing system. +- [H3](https://github.com/uber/h3-go) - Go bindings for H3, a hierarchical hexagonal geospatial indexing system. - [H3 GeoJSON](https://github.com/mmadfox/go-geojson2h3) - Conversion utilities between H3 indexes and GeoJSON. - [H3GeoDist](https://github.com/mmadfox/go-h3geo-dist) - Distribution of Uber H3geo cells by virtual nodes. - [mbtileserver](https://github.com/consbio/mbtileserver) - A simple Go-based server for map tiles stored in mbtiles format. @@ -1196,15 +1292,20 @@ _Tools for managing and working with Goroutines._ - [ants](https://github.com/panjf2000/ants) - A high-performance and low-cost goroutine pool in Go. - [artifex](https://github.com/borderstech/artifex) - Simple in-memory job queue for Golang using worker-based dispatching. +- [async](https://github.com/yaitoo/async) - An asynchronous task package with async/await style for Go. - [async](https://github.com/reugn/async) - An alternative sync library for Go (Future, Promise, Locks). - [async](https://github.com/studiosol/async) - A safe way to execute functions asynchronously, recovering them in case of panic. - [async-job](https://github.com/lab210-dev/async-job) - AsyncJob is an asynchronous queue job manager with light code, clear and speed. - [breaker](https://github.com/kamilsk/breaker) - Flexible mechanism to make execution flow interruptible. - [channelify](https://github.com/ddelizia/channelify) - Transform your function to return channels for easy and powerful parallel processing. -- [concurrency-limiter](https://github.com/vivek-ng/concurrency-limiter) - Concurrency limiter with support for timeouts , dynamic priority and context cancellation of goroutines. +- [conc](https://github.com/sourcegraph/conc) - `conc` is your toolbelt for structured concurrency in go, making common tasks easier and safer. +- [concurrency-limiter](https://github.com/vivek-ng/concurrency-limiter) - Concurrency limiter with support for timeouts, dynamic priority and context cancellation of goroutines. - [conexec](https://github.com/ITcathyh/conexec) - A concurrent toolkit to help execute funcs concurrently in an efficient and safe way. It supports specifying the overall timeout to avoid blocking and uses goroutine pool to improve efficiency. - [cyclicbarrier](https://github.com/marusama/cyclicbarrier) - CyclicBarrier for golang. - [execpool](https://github.com/hexdigest/execpool) - A pool built around exec.Cmd that spins up a given number of processes in advance and attaches stdin and stdout to them when needed. Very similar to FastCGI or Apache Prefork MPM but works for any command. +- [flowmatic](https://github.com/carlmjohnson/flowmatic) - Structured concurrency made easy. +- [go-accumulator](https://github.com/nar10z/go-accumulator) - Solution for accumulation of events and their subsequent processing. +- [go-actor](https://github.com/vladopajic/go-actor) - A tiny library for writing concurrent programs using actor model. - [go-floc](https://github.com/workanator/go-floc) - Orchestrate goroutines with ease. - [go-flow](https://github.com/kamildrazkiewicz/go-flow) - Control goroutines execution order. - [go-tools/multithreading](https://github.com/nikhilsaraf/go-tools) - Manage a pool of goroutines using this lightweight library with a simple API. @@ -1225,11 +1326,11 @@ _Tools for managing and working with Goroutines._ - [kyoo](https://github.com/dirkaholic/kyoo) - Provides an unlimited job queue and concurrent worker pools. - [neilotoole/errgroup](https://github.com/neilotoole/errgroup) - Drop-in alternative to `sync/errgroup`, limited to a pool of N worker goroutines. - [nursery](https://github.com/arunsworld/nursery) - Structured concurrency in Go. -- [oversight](https://cirello.io/oversight) - Oversight is a complete implementation of the Erlang supervision trees. +- [oversight](https://pkg.go.dev/cirello.io/oversight) - Oversight is a complete implementation of the Erlang supervision trees. - [parallel-fn](https://github.com/rafaeljesus/parallel-fn) - Run functions in parallel. - [pond](https://github.com/alitto/pond) - Minimalistic and High-performance goroutine worker pool written in Go. - [pool](https://github.com/go-playground/pool) - Limited consumer goroutine or unlimited goroutine pool for easier goroutine handling and cancellation. -- [queue](https://github.com/AnikHasibul/queue) - Gives you a `sync.WaitGroup` like queue group accessibility. Helps you to throttle and limit goroutines, wait for the end of the all goroutines and much more. +- [rill](https://github.com/destel/rill) - Go concurrency with channel transformations. No boilerplate, type safety, batching and error handling. - [routine](https://github.com/timandy/routine) - `routine` is a `ThreadLocal` for go library. It encapsulates and provides some easy-to-use, non-competitive, high-performance `goroutine` context access interfaces, which can help you access coroutine context information more gracefully. - [routine](https://github.com/x-mod/routine) - go routine control with context, support: Main, Go, Pool and some useful Executors. - [semaphore](https://github.com/kamilsk/semaphore) - Semaphore pattern implementation with timeout of lock/unlock operations based on channel and context. @@ -1249,17 +1350,22 @@ _Libraries for building GUI Applications._ _Toolkits_ - [app](https://github.com/murlokswarm/app) - Package to create apps with GO, HTML and CSS. Supports: MacOS, Windows in progress. +- [Cogent Core](https://github.com/cogentcore/core) - A framework for building 2D and 3D apps that run on macOS, Windows, Linux, iOS, Android, and the web. +- [DarwinKit](https://github.com/progrium/darwinkit) - Build native macOS applications using Go. +- [energy](https://github.com/energye/energy) - Cross-platform based on LCL(Native System UI Control Library) and CEF(Chromium Embedded Framework) (Windows/ macOS / Linux) - [fyne](https://github.com/fyne-io/fyne) - Cross platform native GUIs designed for Go based on Material Design. Supports: Linux, macOS, Windows, BSD, iOS and Android. - [gio](https://gioui.org) - Gio is a library for writing cross-platform immediate mode GUI-s in Go. Gio supports all the major platforms: Linux, macOS, Windows, Android, iOS, FreeBSD, OpenBSD and WebAssembly. -- [go-astilectron](https://github.com/asticode/go-astilectron) - Build cross platform GUI apps with GO and HTML/JS/CSS (powered by Electron). - [go-gtk](https://mattn.github.io/go-gtk/) - Go bindings for GTK. - [go-sciter](https://github.com/sciter-sdk/go-sciter) - Go bindings for Sciter: the Embeddable HTML/CSS/script engine for modern desktop UI development. Cross platform. +- [Goey](https://bitbucket.org/rj/goey/src/master/) - Cross platform UI toolkit aggregator for Windows / Linux / Mac. GTK, Cocoa, Windows API - [goradd/html5tag](https://github.com/goradd/html5tag) - Library for outputting HTML5 tags. - [gotk3](https://github.com/gotk3/gotk3) - Go bindings for GTK3. - [gowd](https://github.com/dtylman/gowd) - Rapid and simple desktop UI development with GO, HTML, CSS and NW.js. Cross platform. - [qt](https://github.com/therecipe/qt) - Qt binding for Go (support for Windows / macOS / Linux / Android / iOS / Sailfish OS / Raspberry Pi). +- [Spot](https://github.com/roblillack/spot) - Reactive, cross-platform desktop GUI toolkit. - [ui](https://github.com/andlabs/ui) - Platform-native GUI library for Go. Cross platform. -- [Wails](https://wails.app) - Mac, Windows, Linux desktop apps with HTML UI using built-in OS HTML renderer. +- [unison](https://github.com/richardwilkes/unison) - A unified graphical user experience toolkit for Go desktop applications. macOS, Windows, and Linux are supported. +- [Wails](https://wails.io) - Mac, Windows, Linux desktop apps with HTML UI using built-in OS HTML renderer. - [walk](https://github.com/lxn/walk) - Windows application library kit for Go. - [webview](https://github.com/zserge/webview) - Cross-platform webview window with simple two-way JavaScript bindings (Windows / macOS / Linux). @@ -1299,6 +1405,7 @@ _Libraries for manipulating images._ - [bimg](https://github.com/h2non/bimg) - Small package for fast and efficient image processing using libvips. - [cameron](https://github.com/aofei/cameron) - An avatar generator for Go. - [canvas](https://github.com/tdewolff/canvas) - Vector graphics to PDF, SVG or rasterized image. +- [color-extractor](https://github.com/marekm4/color-extractor) - Dominant color extractor with no external dependencies. - [darkroom](https://github.com/gojek/darkroom) - An image proxy with changeable storage backends and image processing engines with focus on speed and resiliency. - [draft](https://github.com/lucasepe/draft) - Generate High Level Microservice Architecture diagrams for GraphViz using simple YAML syntax. - [geopattern](https://github.com/pravj/geopattern) - Create beautiful generative image patterns from a string. @@ -1308,7 +1415,6 @@ _Libraries for manipulating images._ - [go-cairo](https://github.com/ungerik/go-cairo) - Go binding for the cairo graphics library. - [go-gd](https://github.com/bolknote/go-gd) - Go binding for GD library. - [go-nude](https://github.com/koyachi/go-nude) - Nudity detection with Go. -- [go-opencv](https://github.com/lazywei/go-opencv) - Go bindings for OpenCV. - [go-webcolors](https://github.com/jyotiska/go-webcolors) - Port of webcolors library from Python to Go. - [go-webp](https://github.com/kolesa-team/go-webp) - Library for encode and decode webp pictures, using libwebp. - [gocv](https://github.com/hybridgroup/gocv) - Go package for computer vision using OpenCV 3.3+. @@ -1329,7 +1435,6 @@ _Libraries for manipulating images._ - [mpo](https://github.com/donatj/mpo) - Decoder and conversion tool for MPO 3D Photos. - [picfit](https://github.com/thoas/picfit) - An image resizing server written in Go. - [pt](https://github.com/fogleman/pt) - Path tracing engine written in Go. -- [resize](https://github.com/nfnt/resize) - Image resizing for Go with common interpolation methods. - [rez](https://github.com/bamiaux/rez) - Image resizing in pure Go and SIMD. - [scout](https://github.com/jonoton/scout) - Scout is a standalone open source software solution for DIY video security. - [smartcrop](https://github.com/muesli/smartcrop) - Finds good crops for arbitrary images and crop sizes. @@ -1337,6 +1442,7 @@ _Libraries for manipulating images._ - [stegify](https://github.com/DimitarPetrov/stegify) - Go tool for LSB steganography, capable of hiding any file within an image. - [svgo](https://github.com/ajstarks/svgo) - Go Language Library for SVG generation. - [tga](https://github.com/ftrvxmtrx/tga) - Package tga is a TARGA image format decoder/encoder. +- [transformimgs](https://github.com/Pixboost/transformimgs) - Transformimgs resizes and optimises images for Web using next-generation formats. - [webp-server](https://github.com/mehdipourfar/webp-server) - Simple and minimal image server capable of storing, resizing, converting and caching images. **[⬆ back to top](#contents)** @@ -1347,6 +1453,7 @@ _Libraries for programming devices of the IoT._ - [connectordb](https://github.com/connectordb/connectordb) - Open-Source Platform for Quantified Self & IoT. - [devices](https://github.com/goiot/devices) - Suite of libraries for IoT devices, experimental for x/exp/io. +- [ekuiper](https://github.com/lf-edge/ekuiper) - Lightweight data stream processing engine for IoT edge. - [eywa](https://github.com/xcodersun/eywa) - Project Eywa is essentially a connection manager that keeps track of connected devices. - [flogo](https://github.com/tibcosoftware/flogo) - Project Flogo is an Open Source Framework for IoT Edge Apps & Integration. - [gatt](https://github.com/paypal/gatt) - Gatt is a Go package for building Bluetooth Low Energy peripherals. @@ -1356,6 +1463,8 @@ _Libraries for programming devices of the IoT._ - [mainflux](https://github.com/Mainflux/mainflux) - Industrial IoT Messaging and Device Management Server. - [periph](https://periph.io/) - Peripherals I/O to interface with low-level board facilities. - [sensorbee](https://github.com/sensorbee/sensorbee) - Lightweight stream processing engine for IoT. +- [shifu](https://github.com/Edgenesis/shifu) - Kubernetes native IoT development framework. +- [smart-home](https://github.com/e154/smart-home) - Software package for IoT automation. **[⬆ back to top](#contents)** @@ -1363,15 +1472,17 @@ _Libraries for programming devices of the IoT._ _Libraries for scheduling jobs._ +- [Cadence-client](https://github.com/uber-go/cadence-client) - A framework for authoring workflows and activities running on top of the Cadence orchestration engine made by Uber. - [cdule](https://github.com/deepaksinghvi/cdule) - Job scheduler library with database support - [cheek](https://github.com/datarootsio/cheek) - A simple crontab like scheduler that aims to offer a KISS approach to job scheduling. - [clockwerk](https://github.com/onatm/clockwerk) - Go package to schedule periodic jobs using a simple, fluent syntax. - [cronticker](https://github.com/krayzpipes/cronticker) - A ticker implementation to support cron schedules. - [Dagu](https://github.com/dagu-go/dagu) - No-code workflow executor. it executes DAGs defined in a simple YAML format. - [go-cron](https://github.com/rk/go-cron) - Simple Cron library for go that can execute closures or functions at varying intervals, from once a second to once a year on a specific date and time. Primarily for web applications and long running daemons. +- [go-dag](https://github.com/rhosocial/go-dag) - A framework developed in Go that manages the execution of workflows described by directed acyclic graphs. - [go-quartz](https://github.com/reugn/go-quartz) - Simple, zero-dependency scheduling library for Go. - [gocron](https://github.com/go-co-op/gocron) - Easy and fluent Go job scheduling. This is an actively maintained fork of [jasonlvhit/gocron](https://github.com/jasonlvhit/gocron). -- [goflow](https://github.com/fieldryand/goflow) - A workflow orchestrator and scheduler for rapid prototyping of ETL/ML/AI pipelines. +- [goflow](https://github.com/fieldryand/goflow) - A simple but powerful DAG scheduler and dashboard. - [gron](https://github.com/roylee0704/gron) - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. - [gronx](https://github.com/adhocore/gronx) - Cron expression parser, task runner and daemon consuming crontab like task list. - [JobRunner](https://github.com/bamzi/jobrunner) - Smart and featureful cron job scheduler with job queuing and live monitoring built in. @@ -1391,14 +1502,17 @@ _Libraries for working with JSON._ - [ask](https://github.com/simonnilsson/ask) - Easy access to nested values in maps and slices. Works in combination with encoding/json and other packages that "Unmarshal" arbitrary data into Go data-types. - [dynjson](https://github.com/cocoonspace/dynjson) - Client-customizable JSON formats for dynamic APIs. - [ej](https://github.com/lucassscaravelli/ej) - Write and read JSON from different sources succinctly. -- [epoch](https://github.com/vtopc/epoch) - Contains primitives for marshaling/unmarshaling Unix timestamp/epoch to/from build-in time.Time type in JSON. +- [epoch](https://github.com/vtopc/epoch) - Contains primitives for marshaling/unmarshalling Unix timestamp/epoch to/from build-in time.Time type in JSON. - [fastjson](https://github.com/valyala/fastjson) - Fast JSON parser and validator for Go. No custom structs, no code generation, no reflection. +- [gabs](https://github.com/Jeffail/gabs) - For parsing, creating and editing unknown or dynamic JSON in Go. - [gjo](https://github.com/skanehira/gjo) - Small utility to create JSON objects. - [GJSON](https://github.com/tidwall/gjson) - Get a JSON value with one line of code. -- [go-jsonerror](https://github.com/ddymko/go-jsonerror) - Go-JsonError is ment to allow us to easily create json response errors that follow the JsonApi spec. +- [go-jsonerror](https://github.com/ddymko/go-jsonerror) - Go-JsonError is meant to allow us to easily create json response errors that follow the JsonApi spec. - [go-respond](https://github.com/nicklaw5/go-respond) - Go package for handling common HTTP JSON responses. +- [gojmapr](https://github.com/limiu82214/gojmapr) - Get simple struct from complex json by json path. - [gojq](https://github.com/elgs/gojq) - JSON query in Golang. - [gojson](https://github.com/ChimeraCoder/gojson) - Automatically generate Go (golang) struct definitions from example JSON. +- [htmljson](https://github.com/nikolaydubina/htmljson) - Rich rendering of JSON as HTML in Go. - [JayDiff](https://github.com/yazgazan/jaydiff) - JSON diff utility written in Go. - [jettison](https://github.com/wI2L/jettison) - Fast and flexible JSON encoder for Go. - [jscan](https://github.com/romshark/jscan) - High performance zero-allocation JSON iterator. @@ -1411,11 +1525,13 @@ _Libraries for working with JSON._ - [jsonf](https://github.com/miolini/jsonf) - Console tool for highlighted formatting and struct query fetching JSON. - [jsongo](https://github.com/ricardolonga/jsongo) - Fluent API to make it easier to create Json objects. - [jsonhal](https://github.com/RichardKnop/jsonhal) - Simple Go package to make custom structs marshal into HAL compatible JSON responses. +- [jsonhandlers](https://github.com/abusomani/jsonhandlers) - JSON library to expose simple handlers that lets you easily read and write json from various sources. - [jsonic](https://github.com/sinhashubham95/jsonic) - Utilities to handle and query JSON without defining structs in a type safe manner. +- [jsonvalue](https://github.com/Andrew-M-C/go.jsonvalue) - A fast and convenient library for unstructured JSON data, replacing `encoding/json`. - [jzon](https://github.com/zerosnake0/jzon) - JSON library with standard compatible API/behavior. - [kazaam](https://github.com/Qntfy/kazaam) - API for arbitrary transformation of JSON documents. - [mapslice-json](https://github.com/mickep76/mapslice-json) - Go MapSlice for ordered marshal/ unmarshal of maps in JSON. -- [marshmallow](https://github.com/PerimeterX/marshmallow) - Performant JSON unmarshaling for flexible use cases. +- [marshmallow](https://github.com/PerimeterX/marshmallow) - Performant JSON unmarshalling for flexible use cases. - [mp](https://github.com/sanbornm/mp) - Simple cli email parser. It currently takes stdin and outputs JSON. - [OjG](https://github.com/ohler55/ojg) - Optimized JSON for Go is a high performance parser with a variety of additional JSON tools including JSONPath. - [omg.jsonparser](https://github.com/dedalqq/omg.jsonparser) - Simple JSON parser with validation by condition via golang struct fields tags. @@ -1438,7 +1554,6 @@ _Libraries for generating and working with log files._ - [go-log](https://github.com/siddontang/go-log) - Log lib supports level and multi handlers. - [go-log](https://github.com/ian-kent/go-log) - Log4j implementation in Go. - [go-logger](https://github.com/apsdehal/go-logger) - Simple logger of Go Programs, with level handlers. -- [gologger](https://github.com/sadlil/gologger) - Simple easy to use log lib for go, logs in Colored Console, Simple Console, File or Elasticsearch. - [gomol](https://github.com/aphistic/gomol) - Multiple-output, structured logging for Go with extensible logging outputs. - [gone/log](https://github.com/One-com/gone/tree/master/log) - Fast, extendable, full-featured, std-lib source compatible log library. - [httpretty](https://github.com/henvic/httpretty) - Pretty-prints your regular HTTP requests on your terminal for debugging (similar to http.DumpRequest). @@ -1449,12 +1564,12 @@ _Libraries for generating and working with log files._ - [log](https://github.com/go-playground/log) - Simple, configurable and scalable Structured Logging for Go. - [log](https://github.com/teris-io/log) - Structured log interface for Go cleanly separates logging facade from its implementation. - [log](https://github.com/heartwilltell/log) - Simple leveled logging wrapper around standard log package. +- [log](https://github.com/no-src/log) - A simple logging framework out of the box. - [log-voyage](https://github.com/firstrow/logvoyage) - Full-featured logging saas written in golang. - [log15](https://github.com/inconshreveable/log15) - Simple, powerful logging for Go. - [logdump](https://github.com/ewwwwwqm/logdump) - Package for multi-level logging. - [logex](https://github.com/chzyer/logex) - Golang log lib, supports tracking and level, wrap by standard log lib. - [logger](https://github.com/azer/logger) - Minimalistic logging library for Go. -- [logmatic](https://github.com/borderstech/logmatic) - Colorized logger for Golang with dynamic log level configuration. - [logo](https://github.com/mbndr/logo) - Golang logger to different configurable writers. - [logrus](https://github.com/Sirupsen/logrus) - Structured logger for Go. - [logrusiowriter](https://github.com/cabify/logrusiowriter) - `io.Writer` implementation using [logrus](https://github.com/sirupsen/logrus) logger. @@ -1468,22 +1583,29 @@ _Libraries for generating and working with log files._ - [onelog](https://github.com/francoispqt/onelog) - Onelog is a dead simple but very efficient JSON logger. It is the fastest JSON logger out there in all scenarios. Also, it is one of the logger with the lowest allocation. - [ozzo-log](https://github.com/go-ozzo/ozzo-log) - High performance logging supporting log severity, categorization, and filtering. Can send filtered log messages to various targets (e.g. console, network, mail). - [phuslu/log](https://github.com/phuslu/log) - High performance structured logging. +- [pp](https://github.com/k0kubun/pp) - Colored pretty printer for Go language. - [rollingwriter](https://github.com/arthurkiller/rollingWriter) - RollingWriter is an auto-rotate `io.Writer` implementation with multi policies to provide log file rotation. - [seelog](https://github.com/cihub/seelog) - Logging functionality with flexible dispatching, filtering, and formatting. - [slf4g](https://github.com/echocat/slf4g) - Simple Logging Facade for Golang: Simple structured logging; but powerful, extendable and customizable, with huge amount of learnings from decades of past logging frameworks. -- [slog](https://github.com/gookit/slog) Lightweight, configurable, extensible logger for Go. +- [slog](https://github.com/gookit/slog) - Lightweight, configurable, extensible logger for Go. +- [slog-formatter](https://github.com/samber/slog-formatter) - Common formatters for slog and helpers to build your own. +- [slog-multi](https://github.com/samber/slog-multi) - Chain of slog.Handler (pipeline, fanout...). +- [slogor](https://gitlab.com/greyxor/slogor) - A colorful slog handler. - [spew](https://github.com/davecgh/go-spew) - Implements a deep pretty printer for Go data structures to aid in debugging. -- [sqldb-logger](https://github.com/simukti/sqldb-logger) - A logger for Go SQL database driver without modify existing *sql.DB stdlib usage. +- [sqldb-logger](https://github.com/simukti/sqldb-logger) - A logger for Go SQL database driver without modify existing \*sql.DB stdlib usage. - [stdlog](https://github.com/alexcesaro/log) - Stdlog is an object-oriented library providing leveled logging. It is very useful for cron jobs. - [structy/log](https://github.com/structy/log) - A simple to use log system, minimalist but with features for debugging and differentiation of messages. - [tail](https://github.com/hpcloud/tail) - Go package striving to emulate the features of the BSD tail program. +- [tint](https://github.com/lmittmann/tint) - A slog.Handler that writes tinted logs. - [xlog](https://github.com/xfxdev/xlog) - Plugin architecture and flexible log system for Go, with level ctrl, multiple log target and custom log format. - [xlog](https://github.com/rs/xlog) - Structured logger for `net/context` aware HTTP handlers with flexible dispatching. - [xylog](https://github.com/xybor-x/xylog) - Leveled and structured logging, dynamic fields, high performance, zone management, simple configuration, and readable syntax. - [yell](https://github.com/jfcg/yell) - Yet another minimalistic logging library. - [zap](https://github.com/uber-go/zap) - Fast, structured, leveled logging in Go. +- [zax](https://github.com/yuseferi/zax) - Integrate Context with Zap logger, which leads to more flexibility in Go logging. - [zerolog](https://github.com/rs/zerolog) - Zero-allocation JSON logger. - [zkits-logger](https://github.com/edoger/zkits-logger) - A powerful zero-dependency JSON logger. +- [zl](https://github.com/nkmr-jp/zl) - High Developer Experience, zap based logger. It offers rich functionality but is easy to configure. **[⬆ back to top](#contents)** @@ -1517,6 +1639,7 @@ _Libraries for Machine Learning._ - [gorse](https://github.com/zhenghaoz/gorse) - An offline recommender system backend based on collaborative filtering written in Go. - [goscore](https://github.com/asafschers/goscore) - Go Scoring API for PMML. - [gosseract](https://github.com/otiai10/gosseract) - Go package for OCR (Optical Character Recognition), by using Tesseract C++ library. +- [hugot](https://github.com/knights-analytics/hugot) - Huggingface transformer pipelines for golang with onnxruntime. - [libsvm](https://github.com/datastream/libsvm) - libsvm golang version derived work based on LIBSVM 3.14. - [m2cgen](https://github.com/BayesWitnesses/m2cgen) - A CLI tool to transpile trained classic ML models into a native Go code with zero dependencies, written in Python with Go language support. - [neat](https://github.com/jinyeom/neat) - Plug-and-play, parallel Go framework for NeuroEvolution of Augmenting Topologies (NEAT). @@ -1541,7 +1664,6 @@ _Libraries that implement messaging systems._ - [APNs2](https://github.com/sideshow/apns2) - HTTP/2 Apple Push Notification provider for Go — Send push notifications to iOS, tvOS, Safari and OSX apps. - [Asynq](https://github.com/hibiken/asynq) - A simple, reliable, and efficient distributed task queue for Go built on top of Redis. - [Beaver](https://github.com/Clivern/Beaver) - A real time messaging server to build a scalable in-app notifications, multiplayer games, chat apps in web and mobile apps. -- [Benthos](https://github.com/Jeffail/benthos) - A message streaming bridge between a range of protocols. - [Bus](https://github.com/mustafaturan/bus) - Minimalist message bus implementation for internal communication. - [Centrifugo](https://github.com/centrifugal/centrifugo) - Real-time messaging (Websockets or SockJS) server in Go. - [Chanify](https://github.com/chanify/chanify) - A push notification server send message to your iOS devices. @@ -1554,6 +1676,8 @@ _Libraries that implement messaging systems._ - [EventBus](https://github.com/asaskevich/EventBus) - The lightweight event bus with async compatibility. - [gaurun-client](https://github.com/osamingo/gaurun-client) - Gaurun Client written in Go. - [Glue](https://github.com/desertbit/glue) - Robust Go and Javascript Socket Library (Alternative to Socket.io). +- [go-eventbus](https://github.com/stanipetrosyan/go-eventbus) - Simple Event Bus package for Go. +- [Go-MediatR](https://github.com/mehdihadeli/Go-MediatR) - A library for handling mediator patterns and simplified CQRS patterns within an event-driven architecture, inspired by csharp MediatR library. - [go-mq](https://github.com/cheshir/go-mq) - RabbitMQ client with declarative configuration. - [go-notify](https://github.com/TheCreeper/go-notify) - Native implementation of the freedesktop notification spec. - [go-nsq](https://github.com/nsqio/go-nsq) - the official Go package for NSQ. @@ -1574,12 +1698,12 @@ _Libraries that implement messaging systems._ - [melody](https://github.com/olahol/melody) - Minimalist framework for dealing with websocket sessions, includes broadcasting and automatic ping/pong handling. - [Mercure](https://github.com/dunglas/mercure) - Server and library to dispatch server-sent updates using the Mercure protocol (built on top of Server-Sent Events). - [messagebus](https://github.com/vardius/message-bus) - messagebus is a Go simple async message bus, perfect for using as event bus when doing event sourcing, CQRS, DDD. -- [mob](https://github.com/erni27/mob) - mob is a generic-based, simple mediator / event aggregator library. It supports in-process requests / events processing. - [NATS Go Client](https://github.com/nats-io/nats) - Lightweight and high performance publish-subscribe and distributed queueing messaging system - this is the Go library. - [nsq-event-bus](https://github.com/rafaeljesus/nsq-event-bus) - A tiny wrapper around NSQ topic and channel. - [oplog](https://github.com/dailymotion/oplog) - Generic oplog/replication system for REST APIs. - [pubsub](https://github.com/tuxychandru/pubsub) - Simple pubsub package for go. - [Quamina](https://github.com/timbray/quamina) - Fast pattern-matching for filtering messages and events. +- [rabbitroutine](https://github.com/furdarius/rabbitroutine) - Lightweight library that handles RabbitMQ auto-reconnect and publishing retries. The library takes into account the need to re-declare entities in RabbitMQ after reconnection. - [rabbus](https://github.com/rafaeljesus/rabbus) - A tiny wrapper over amqp exchanges and queues. - [rabtap](https://github.com/jandelgado/rabtap) - RabbitMQ swiss army knife cli app. - [RapidMQ](https://github.com/sybrexsys/RapidMQ) - RapidMQ is a lightweight and reliable library for managing of the local messages queue. @@ -1588,6 +1712,7 @@ _Libraries that implement messaging systems._ - [rmqconn](https://github.com/sbabiv/rmqconn) - RabbitMQ Reconnection. Wrapper over amqp.Connection and amqp.Dial. Allowing to do a reconnection when the connection is broken before forcing the call to the Close () method to be closed. - [sarama](https://github.com/Shopify/sarama) - Go library for Apache Kafka. - [Uniqush-Push](https://github.com/uniqush/uniqush-push) - Redis backed unified push service for server-side notifications to mobile devices. +- [Watermill](https://github.com/ThreeDotsLabs/watermill) - Working efficiently with message streams. Building event driven applications, enabling event sourcing, RPC over messages, sagas. Can use conventional pub/sub implementations like Kafka or RabbitMQ, but also HTTP or MySQL binlog. - [zmq4](https://github.com/pebbe/zmq4) - Go interface to ZeroMQ version 4. Also available for [version 3](https://github.com/pebbe/zmq3) and [version 2](https://github.com/pebbe/zmq2). **[⬆ back to top](#contents)** @@ -1616,6 +1741,8 @@ _Libraries for working with Microsoft Excel._ _Libraries for working with dependency injection._ - [alice](https://github.com/magic003/alice) - Additive dependency injection container for Golang. +- [boot-go](http://github.com/boot-go/boot) - Component-based development with dependency injection using reflections for Go developers. +- [cosban/di](https://gitlab.com/cosban/di) - A code generation based dependency injection wiring tool. - [di](https://github.com/goava/di) - A dependency injection container for go programming language. - [dig](https://github.com/uber-go/dig) - A reflection based dependency injection toolkit for Go. - [dingo](https://github.com/i-love-flamingo/dingo) - A dependency injection toolkit for Go, based on Guice. @@ -1624,11 +1751,15 @@ _Libraries for working with dependency injection._ - [gocontainer](https://github.com/vardius/gocontainer) - Simple Dependency Injection Container. - [goioc/di](https://github.com/goioc/di) - Spring-inspired Dependency Injection Container. - [GoLobby/Container](https://github.com/golobby/container) - GoLobby Container is a lightweight yet powerful IoC dependency injection container for the Go programming language. +- [gontainer](https://github.com/NVIDIA/gontainer) - A dependency injection service container for Go projects. +- [gontainer/gontainer](https://github.com/gontainer/gontainer) - A YAML-based Dependency Injection container for GO. It supports dependencies' scopes, and auto-detection of circular dependencies. Gontainer is concurrent-safe. - [google/wire](https://github.com/google/wire) - Automated Initialization in Go. - [HnH/di](https://github.com/HnH/di) - DI container library that is focused on clean API and flexibility. - [kinit](https://github.com/go-kata/kinit) - Customizable dependency injection container with the global mode, cascade initialization and panic-safe finalization. +- [kod](https://github.com/go-kod/kod) - A generics based dependency injection framework for Go. - [linker](https://github.com/logrange/linker) - A reflection based dependency injection and inversion of control library with components lifecycle support. - [nject](https://github.com/muir/nject) - A type safe, reflective framework for libraries, tests, http endpoints, and service startup. +- [ore](https://github.com/firasdarwish/ore) - Lightweight, generic & simple dependency injection (DI) container. - [wire](https://github.com/Fs02/wire) - Strict Runtime Dependency Injection for Golang. **[⬆ back to top](#contents)** @@ -1639,6 +1770,8 @@ _**Unofficial** set of patterns for structuring projects._ - [ardanlabs/service](https://github.com/ardanlabs/service) - A [starter kit](https://github.com/ardanlabs/service/wiki) for building production grade scalable web service applications. - [cookiecutter-golang](https://github.com/lacion/cookiecutter-golang) - A Go application boilerplate template for quick starting projects following production best practices. +- [go-blueprint](https://github.com/Melkeydev/go-blueprint) - Allows users to spin up a quick Go project using a popular framework. +- [go-module](https://github.com/octomation/go-module) - Template for a typical module written on Go. - [go-sample](https://github.com/zitryss/go-sample) - A sample layout for Go application projects with the real code. - [go-starter](https://github.com/allaboutapps/go-starter) - An opinionated production-ready RESTful JSON backend template, highly integrated with VSCode DevContainers. - [go-todo-backend](https://github.com/Fs02/go-todo-backend) - Go Todo Backend example using modular project layout for product microservice. @@ -1647,6 +1780,7 @@ _**Unofficial** set of patterns for structuring projects._ - [golang-templates/seed](https://github.com/golang-templates/seed) - Go application GitHub repository template. - [insidieux/inizio](https://github.com/insidieux/inizio) - Golang project layout generator with plugins. - [modern-go-application](https://github.com/sagikazarmark/modern-go-application) - Go application boilerplate and example applying modern practices. +- [nunu](https://github.com/go-nunu/nunu) - Nunu is a scaffolding tool for building Go applications. - [pagoda](https://github.com/mikestefanello/pagoda) - Rapid, easy full-stack web development starter kit built in Go. - [scaffold](https://github.com/catchplay/scaffold) - Scaffold generates a starter Go project layout. Lets you focus on business logic implemented. - [wangyoucao577/go-project-layout](https://github.com/wangyoucao577/go-project-layout) - Set of practices and discussions on how to structure Go project layout. @@ -1657,7 +1791,8 @@ _**Unofficial** set of patterns for structuring projects._ _Libraries for working with strings._ -- [bexp](https://github.com/mkungla/bexp) - Go implementation of Brace Expansion mechanism to generate arbitrary strings. +- [bexp](https://github.com/happy-sdk/happy/tree/main/pkg/strings/bexp) - Go implementation of Brace Expansion mechanism to generate arbitrary strings. +- [caps](https://github.com/chanced/caps) - A case conversion library. - [go-formatter](https://gitlab.com/tymonx/go-formatter) - Implements **replacement fields** surrounded by curly braces `{}` format strings. - [gobeam/Stringy](https://github.com/gobeam/Stringy) - String manipulation library to convert string to camel case, snake case, kebab case / slugify etc. - [strutil](https://github.com/ozgio/strutil) - String utilities. @@ -1682,6 +1817,7 @@ _These libraries were placed here because none of the other categories seemed to - [bitio](https://github.com/icza/bitio) - Highly optimized bit-level Reader and Writer for Go. - [browscap_go](https://github.com/digitalcrab/browscap_go) - GoLang Library for [Browser Capabilities Project](https://browscap.org/). - [captcha](https://github.com/steambap/captcha) - Package captcha provides an easy to use, unopinionated API for captcha generation. +- [common](https://github.com/kubeservice-stack/common) - A library for server framework. - [conv](https://github.com/cstockton/go-conv) - Package conv provides fast and intuitive conversions across Go types. - [datacounter](https://github.com/miolini/datacounter) - Go counters for readers/writer/http.ResponseWriter. - [faker](https://github.com/neotoolkit/faker) - Fake data generator. @@ -1700,7 +1836,7 @@ _These libraries were placed here because none of the other categories seemed to - [gosms](https://github.com/haxpax/gosms) - Your own local SMS gateway in Go that can be used to send SMS. - [gotoprom](https://github.com/cabify/gotoprom) - Type-safe metrics builder wrapper library for the official Prometheus client. - [gountries](https://github.com/pariz/gountries) - Package that exposes country and subdivision data. -- [gtree](https://github.com/ddddddO/gtree) - Provide CLI and Package for tree output and directories creation from Markdown or programmatically. +- [gtree](https://github.com/ddddddO/gtree) - Provide CLI, Package and Web for tree output and directories creation from Markdown or programmatically. - [health](https://github.com/alexliesenfeld/health) - A simple and flexible health check library for Go. - [health](https://github.com/dimiro1/health) - Easy to use, extensible health check library. - [healthcheck](https://github.com/etherlabsio/healthcheck) - An opinionated and concurrent health-check HTTP handler for RESTful services. @@ -1718,6 +1854,7 @@ _These libraries were placed here because none of the other categories seemed to - [shellwords](https://github.com/Wing924/shellwords) - A Golang library to manipulate strings according to the word parsing rules of the UNIX Bourne shell. - [shortid](https://github.com/teris-io/shortid) - Distributed generation of super short, unique, non-sequential, URL friendly IDs. - [shoutrrr](https://github.com/containrrr/shoutrrr) - Notification library providing easy access to various messaging services like slack, mattermost, gotify and smtp among others. +- [sitemap-format](https://github.com/mingard/sitemap-format) - A simple sitemap generator, with a little syntactic sugar. - [stateless](https://github.com/qmuntal/stateless) - A fluent library for creating state machines. - [stats](https://github.com/go-playground/stats) - Monitors Go MemStats + System stats such as Memory, Swap and CPU and sends via UDP anywhere you want for logging etc... - [turtle](https://github.com/hackebrot/turtle) - Emojis for Go. @@ -1741,6 +1878,7 @@ See also [Text Processing](#text-processing) and [Text Analysis](#text-analysis) - [detectlanguage](https://github.com/detectlanguage/detectlanguage-go) - Language Detection API Go Client. Supports batch requests, short phrase or single word language detection. - [getlang](https://github.com/rylans/getlang) - Fast natural language detection package. - [guesslanguage](https://github.com/endeveit/guesslanguage) - Functions to determine the natural language of a unicode text. +- [lingua-go](https://github.com/pemistahl/lingua-go) - An accurate natural language detection library, suitable for long and short text alike. Supports detecting multiple languages in mixed-language text. - [whatlanggo](https://github.com/abadojack/whatlanggo) - Natural language detection package for Go. Supports 84 languages and 24 scripts (writing systems e.g. Latin, Cyrillic, etc). ### Morphological Analyzers @@ -1777,19 +1915,19 @@ See also [Text Processing](#text-processing) and [Text Analysis](#text-analysis) - [MMSEGO](https://github.com/awsong/MMSEGO) - This is a GO implementation of [MMSEG](http://technology.chtsai.org/mmseg/) which a Chinese word splitting algorithm. - [prose](https://github.com/jdkato/prose) - Library for text processing that supports tokenization, part-of-speech tagging, named-entity extraction, and more. English only. - [segment](https://github.com/blevesearch/segment) - Go library for performing Unicode Text Segmentation as described in [Unicode Standard Annex #29](https://www.unicode.org/reports/tr29/) -- [sentences](https://github.com/neurosnap/sentences) - Sentence tokenizer: converts text into a list of sentences. +- [sentences](https://github.com/neurosnap/sentences) - Sentence tokenizer: converts text into a list of sentences. - [shamoji](https://github.com/osamingo/shamoji) - The shamoji is word filtering package written in Go. - [stemmer](https://github.com/dchest/stemmer) - Stemmer packages for Go programming language. Includes English and German stemmers. - [textcat](https://github.com/pebbe/textcat) - Go package for n-gram based text categorization, with support for utf-8 and raw text. ### Translation +- [ctxi18n](https://github.com/invopop/ctxi18n/) - Context aware i18n with a short and consise API, pluralization, interpolation, and `fs.FS` support. YAML locale definitions are based on [Rails i18n](https://guides.rubyonrails.org/i18n.html). - [go-i18n](https://github.com/nicksnyder/go-i18n/) - Package and an accompanying tool to work with localized text. -- [go-localize](https://github.com/m1/go-localize) - Simple and easy to use i18n (Internationalization and localization) engine - used for translating locale strings. - [go-mystem](https://github.com/dveselov/mystem) - CGo bindings to Yandex.Mystem - russian morphology analyzer. - [go-pinyin](https://github.com/mozillazg/go-pinyin) - CN Hanzi to Hanyu Pinyin converter. +- [go-words](https://github.com/saleh-rahimzadeh/go-words) - A words table and text resource library for Golang projects. - [gotext](https://github.com/leonelquinteros/gotext) - GNU gettext utilities for Go. -- [icu](https://github.com/goodsign/icu) - Cgo binding for icu4c C library detection and conversion functions. Guaranteed compatibility with version 50.1. - [iuliia-go](https://github.com/mehanizm/iuliia-go) - Transliterate Cyrillic → Latin in every possible way. - [spreak](https://github.com/vorlif/spreak) - Flexible translation and humanization library for Go, based on the concepts behind gettext. - [t](https://github.com/youthlin/t) - Another i18n pkg for golang, which follows GNU gettext style and supports .po/.mo files: `t.T (gettext)`, `t.N (ngettext)`, etc. And it contains a cmd tool [xtemplate](https://github.com/youthlin/t/blob/main/cmd/xtemplate), which can extract messages as a pot file from text/html template. @@ -1816,24 +1954,27 @@ _Libraries for working with various layers of the network._ - [dnsmonster](https://github.com/mosajjal/dnsmonster) - Passive DNS Capture/Monitoring Framework. - [easytcp](https://github.com/DarthPestilane/easytcp) - A light-weight TCP framework written in Go (Golang), built with message router. EasyTCP helps you build a TCP server easily fast and less painful. - [ether](https://github.com/songgao/ether) - Cross-platform Go package for sending and receiving ethernet frames. -- [ethernet](https://github.com/mdlayher/ethernet) - Package ethernet implements marshaling and unmarshaling of IEEE 802.3 Ethernet II frames and IEEE 802.1Q VLAN tags. +- [ethernet](https://github.com/mdlayher/ethernet) - Package ethernet implements marshaling and unmarshalling of IEEE 802.3 Ethernet II frames and IEEE 802.1Q VLAN tags. +- [event](https://github.com/cheng-zhongliang/event) - Simple I/O event notification library written in Golang. - [fasthttp](https://github.com/valyala/fasthttp) - Package fasthttp is a fast HTTP implementation for Go, up to 10 times faster than net/http. - [fortio](https://github.com/fortio/fortio) - Load testing library and command line tool, advanced echo server and web UI. Allows to specify a set query-per-second load and record latency histograms and other useful stats and graph them. Tcp, Http, gRPC. - [ftp](https://github.com/jlaffaye/ftp) - Package ftp implements a FTP client as described in [RFC 959](https://tools.ietf.org/html/rfc959). - [ftpserverlib](https://github.com/fclairamb/ftpserverlib) - Fully featured FTP server library. - [fullproxy](https://github.com/shoriwe/fullproxy) - A fully featured scriptable and daemon configurable proxy and pivoting toolkit with SOCKS5, HTTP, raw ports and reverse proxy protocols. +- [fwdctl](https://github.com/alegrey91/fwdctl) - A simple and intuitive CLI to manage IPTables forwards in your Linux server. - [gaio](https://github.com/xtaci/gaio) - High performance async-io networking for Golang in proactor mode. - [gev](https://github.com/Allenxuxu/gev) - gev is a lightweight, fast non-blocking TCP network library based on Reactor mode. - [gldap](https://github.com/jimlambrt/gldap) - gldap provides an ldap server implementation and you provide handlers for its ldap operations. - [gmqtt](https://github.com/DrmagicE/gmqtt) - Gmqtt is a flexible, high-performance MQTT broker library that fully implements the MQTT protocol V3.1.1. - [gnet](https://github.com/panjf2000/gnet) - `gnet` is a high-performance, lightweight, non-blocking, event-driven networking framework written in pure Go. +- [gnet](https://github.com/fish-tennis/gnet) - `gnet` is a high-performance networking framework,especially for game servers. - [gNxI](https://github.com/google/gnxi) - A collection of tools for Network Management that use the gNMI and gNOI protocols. - [go-getter](https://github.com/hashicorp/go-getter) - Go library for downloading files or directories from various sources using a URL. +- [go-multiproxy](https://github.com/presbrey/go-multiproxy) - Library for making HTTP requests through a pool of proxies offering fault tolerance, load balancing, automatic retries, cookie management, and more, via http.Get/Post replacement or http.Client RoundTripper drop-in - [go-powerdns](https://github.com/joeig/go-powerdns) - PowerDNS API bindings for Golang. +- [go-sse](https://github.com/lampctl/go-sse) - Go client and server implementation of HTML server-sent events. - [go-stun](https://github.com/ccding/go-stun) - Go implementation of the STUN client (RFC 3489 and RFC 5389). - [gobgp](https://github.com/osrg/gobgp) - BGP implemented in the Go Programming Language. -- [gohooks](https://github.com/averageflow/gohooks) - GoHooks make it easy to send and consume secured web-hooks from a Go application. Inspired by Spatie's Laravel Webhook Client and Server. -- [golibwireshark](https://github.com/sunwxg/golibwireshark) - Package golibwireshark use libwireshark library to decode pcap file and analyse dissection data. - [gopacket](https://github.com/google/gopacket) - Go library for packet processing with libpcap bindings. - [gopcap](https://github.com/akrennmair/gopcap) - Go wrapper for libpcap. - [goshark](https://github.com/sunwxg/goshark) - Package goshark use tshark to decode IP packet and create data struct to analyse packet. @@ -1841,6 +1982,7 @@ _Libraries for working with various layers of the network._ - [gotcp](https://github.com/gansidui/gotcp) - Go package for quickly writing tcp applications. - [grab](https://github.com/cavaliercoder/grab) - Go package for managing file downloads. - [graval](https://github.com/koofr/graval) - Experimental FTP server framework. +- [gws](https://github.com/lxzan/gws) - High-Performance WebSocket Server & Client With AsyncIO Supporting . - [HTTPLab](https://github.com/gchaincl/httplab) - HTTPLabs let you inspect HTTP requests and forge responses. - [httpproxy](https://github.com/wzshiming/httpproxy) - HTTP proxy handler and dialer. - [iplib](https://github.com/c-robinson/iplib) - Library for working with IP addresses (net.IP, net.IPNet), inspired by python [ipaddress](https://docs.python.org/3/library/ipaddress.html) and ruby [ipaddr](https://ruby-doc.org/stdlib-2.5.1/libdoc/ipaddr/rdoc/IPAddr.html) @@ -1852,11 +1994,12 @@ _Libraries for working with various layers of the network._ - [llb](https://github.com/kirillDanshin/llb) - It's a very simple but quick backend for proxy servers. Can be useful for fast redirection to predefined domain with zero memory allocation and fast response. - [mdns](https://github.com/hashicorp/mdns) - Simple mDNS (Multicast DNS) client/server library in Golang. - [mqttPaho](https://eclipse.org/paho/clients/golang/) - The Paho Go Client provides an MQTT client library for connection to MQTT brokers via TCP, TLS or WebSockets. +- [natiu-mqtt](https://github.com/soypat/natiu-mqtt) - A dead-simple, non-allocating, low level implementation of MQTT well suited for embedded systems. - [nbio](https://github.com/lesismal/nbio) - Pure Go 1000k+ connections solution, support tls/http1.x/websocket and basically compatible with net/http, with high-performance and low memory cost, non-blocking, event-driven, easy-to-use. +- [net](https://golang.org/x/net) - This repository holds supplementary Go networking libraries. - [netpoll](https://github.com/cloudwego/netpoll) - A high-performance non-blocking I/O networking framework, which focused on RPC scenarios, developed by ByteDance. - [NFF-Go](https://github.com/intel-go/nff-go) - Framework for rapid development of performant network functions for cloud and bare-metal (former YANFF). - [packet](https://github.com/aerogo/packet) - Send packets over TCP and UDP. It can buffer messages and hot-swap connections if needed. -- [panoptes-stream](https://github.com/yahoo/panoptes-stream) - A cloud native distributed streaming network telemetry (gNMI, Juniper JTI and Cisco MDT). - [peerdiscovery](https://github.com/schollz/peerdiscovery) - Pure Go library for cross-platform local peer discovery using UDP multicast. - [portproxy](https://github.com/aybabtme/portproxy) - Simple TCP proxy which adds CORS support to API's which don't support it. - [publicip](https://github.com/polera/publicip) - Package publicip returns your public facing IPv4 address (internet egress). @@ -1867,6 +2010,7 @@ _Libraries for working with various layers of the network._ - [sslb](https://github.com/eduardonunesp/sslb) - It's a Super Simples Load Balancer, just a little project to achieve some kind of performance. - [stun](https://github.com/go-rtc/stun) - Go implementation of RFC 5389 STUN protocol. - [tcp_server](https://github.com/firstrow/tcp_server) - Go library for building tcp servers faster. +- [tcpack](https://github.com/lim-yoona/tcpack) - tcpack is an application protocol based on TCP to Pack and Unpack bytes stream in go program. - [tspool](https://github.com/two/tspool) - A TCP Library use worker pool to improve performance and protect your server. - [utp](https://github.com/anacrolix/utp) - Go uTP micro transport protocol implementation. - [vssh](https://github.com/yahoo/vssh) - Go library for building network and server automation over SSH protocol. @@ -1881,6 +2025,7 @@ _Libraries for working with various layers of the network._ _Libraries for making HTTP requests._ +- [fast-shot](https://github.com/opus-domini/fast-shot) - Hit your API targets with rapid-fire precision using Go's fastest and simple HTTP Client. - [gentleman](https://github.com/h2non/gentleman) - Full-featured plugin-driven HTTP client library. - [go-cleanhttp](https://github.com/hashicorp/go-cleanhttp) - Get easily stdlib HTTP client, which does not share any state with other clients. - [go-http-client](https://github.com/bozd4g/go-http-client) - Make http calls simply and easily. @@ -1890,7 +2035,6 @@ _Libraries for making HTTP requests._ - [go-zoox/fetch](https://github.com/go-zoox/fetch) - A Powerful, Lightweight, Easy Http Client, inspired by Web Fetch API. - [grequests](https://github.com/levigross/grequests) - A Go "clone" of the great and famous Requests library. - [heimdall](https://github.com/gojektech/heimdall) - An enhanced http client with retry and hystrix capabilities. -- [httpc](https://github.com/valord577/httpc) - A customizable and simple HTTP client library. Only depend on the stdlib HTTP client. - [httpretry](https://github.com/ybbus/httpretry) - Enriches the default go HTTP client with retry functionality. - [pester](https://github.com/sethgrid/pester) - Go HTTP client calls with retries, backoff, and concurrency. - [req](https://github.com/imroc/req) - Simple Go HTTP client with Black Magic (Less code and More efficiency). @@ -1919,11 +2063,13 @@ _Libraries for using OpenGL in Go._ _Libraries that implement Object-Relational Mapping or datamapping techniques._ +- [bob](https://github.com/stephenafamo/bob) - SQL query builder and ORM/Factory generator for Go. Successor of SQLBoiler. - [bun](https://github.com/uptrace/bun) - SQL-first Golang ORM. Successor of go-pg. - [cacheme](https://github.com/Yiling-J/cacheme-go) - Schema based, typed Redis caching/memoize framework for Go. +- [CQL](https://github.com/FrancoLiberali/cql) - Built on top of GORM, adds compile-time verified queries based on auto-generated code. - [ent](https://github.com/facebook/ent) - An entity framework for Go. Simple, yet powerful ORM for modeling and querying data. +- [go-dbw](https://github.com/hashicorp/go-dbw) - A simple package that encapsulates database operations. - [go-firestorm](https://github.com/jschoedt/go-firestorm) - A simple ORM for Google/Firebase Cloud Firestore. -- [go-queryset](https://github.com/jirfag/go-queryset) - 100% type-safe ORM with code generation and MySQL, PostgreSQL, Sqlite3, SQL Server support based on GORM. - [go-sql](https://github.com/rushteam/gosql) - A easy ORM for mysql. - [go-sqlbuilder](https://github.com/huandu/go-sqlbuilder) - A flexible and powerful SQL string builder library plus a zero-config ORM. - [go-store](https://github.com/gosuri/go-store) - Simple and fast Redis backed key-value store library for Go. @@ -1977,6 +2123,7 @@ _Unofficial libraries for package and dependency management._ ## Performance +- [go-instrument](https://github.com/nikolaydubina/go-instrument) - Automatically add spans to all methods and functions. - [jaeger](https://github.com/jaegertracing/jaeger) - A distributed tracing system. - [pixie](https://github.com/pixie-labs/pixie) - No instrumentation tracing for Golang applications via eBPF. - [profile](https://github.com/pkg/profile) - Simple profiling support package for Go. @@ -1992,6 +2139,7 @@ _Unofficial libraries for package and dependency management._ - [gojsonq](https://github.com/thedevsaddam/gojsonq) - A simple Go package to Query over JSON Data. - [goven](https://github.com/SeldonIO/goven) - A drop-in query language for any database schema. - [gqlgen](https://github.com/99designs/gqlgen) - go generate based graphql server library. +- [grapher](https://github.com/reaganiwadha/grapher) - A GraphQL field builder utilizing Go generics with extra utilities and features. - [graphql](https://github.com/tmc/graphql) - graphql parser + utilities. - [graphql](https://github.com/neelance/graphql-go) - GraphQL server with a focus on ease of use. - [graphql-go](https://github.com/graphql-go/graphql) - Implementation of GraphQL for Go. @@ -1999,6 +2147,7 @@ _Unofficial libraries for package and dependency management._ - [jsonpath](https://github.com/AsaiYusuke/jsonpath) - A query library for retrieving part of JSON based on JSONPath syntax. - [jsonql](https://github.com/elgs/jsonql) - JSON query expression library in Golang. - [jsonslice](https://github.com/bhmj/jsonslice) - Jsonpath queries with advanced filters. +- [mql](https://github.com/hashicorp/mql) - Model Query Language (mql) is a query language for your database models. - [rql](https://github.com/a8m/rql) - Resource Query Language for REST API. - [rqp](https://github.com/timsolov/rest-query-parser) - Query Parser for REST API. Filtering, validations, both `AND`, `OR` operations are supported directly in the query. - [straf](https://github.com/SonicRoshan/straf) - Easily Convert Golang structs to GraphQL objects. @@ -2012,7 +2161,7 @@ _Unofficial libraries for package and dependency management._ - [fileb0x](https://github.com/UnnoTed/fileb0x) - Simple tool to embed files in go with focus on "customization" and ease to use. - [go-resources](https://github.com/omeid/go-resources) - Unfancy resources embedding with Go. - [go.rice](https://github.com/GeertJohan/go.rice) - go.rice is a Go package that makes working with resources such as HTML, JS, CSS, images, and templates very easy. -- [mule](https://github.com/wlbr/mule) - Embed external resources like images, movies ... into Go source code to create single file binaries using `go generate`. Focussed on simplicity. +- [mule](https://github.com/wlbr/mule) - Embed external resources like images, movies ... into Go source code to create single file binaries using `go generate`. Focused on simplicity. - [packr](https://github.com/gobuffalo/packr) - The simple and easy way to embed static files into Go binaries. - [rebed](https://github.com/soypat/rebed) - Recreate folder structures and files from Go 1.16's `embed.FS` type - [statics](https://github.com/go-playground/statics) - Embeds static resources into go files for single binary compilation + works with http.FileSystem + symlinks. @@ -2040,6 +2189,7 @@ _Libraries for scientific computing and data analyzing._ - [go-gt](https://github.com/ThePaw/go-gt) - Graph theory algorithms written in "Go" language. - [godesim](https://github.com/soypat/godesim) - Extended/multivariable ODE solver framework for event-based simulations with simple API. - [goent](https://github.com/kzahedi/goent) - GO Implementation of Entropy Measures. +- [gograph](https://github.com/hmdsefi/gograph) - A golang generic graph library that provides mathematical graph-theory and algorithms. - [gohistogram](https://github.com/VividCortex/gohistogram) - Approximate histograms for data streams. - [gonum](https://github.com/gonum/gonum) - Gonum is a set of numeric libraries for the Go programming language. It contains libraries for matrices, statistics, optimization, and more. - [gonum/plot](https://github.com/gonum/plot) - gonum/plot provides an API for building and drawing plots in Go. @@ -2067,36 +2217,44 @@ _Libraries for scientific computing and data analyzing._ _Libraries that are used to help make your application more secure._ - [acmetool](https://github.com/hlandau/acme) - ACME (Let's Encrypt) client tool with automatic renewal. +- [acopw-go](https://sr.ht/~jamesponddotco/acopw-go/) - Small cryptographically secure password generator package for Go. - [acra](https://github.com/cossacklabs/acra) - Network encryption proxy to protect database-based applications from data leaks: strong selective encryption, SQL injections prevention, intrusion detection system. - [age](https://github.com/FiloSottile/age) - A simple, modern and secure encryption tool (and Go library) with small explicit keys, no config options, and UNIX-style composability. - [argon2-hashing](https://github.com/andskur/argon2-hashing) - light wrapper around Go's argon2 package that closely mirrors with Go's standard library Bcrypt and simple-scrypt package. - [argon2pw](https://github.com/raja/argon2pw) - Argon2 password hash generation with constant-time password comparison. -- [autocert](https://godoc.org/golang.org/x/crypto/acme/autocert) - Auto provision Let's Encrypt certificates and start a TLS server. +- [autocert](https://pkg.go.dev/golang.org/x/crypto/acme/autocert) - Auto provision Let's Encrypt certificates and start a TLS server. - [BadActor](https://github.com/jaredfolkins/badactor) - In-memory, application-driven jailer built in the spirit of fail2ban. +- [beelzebub](https://github.com/mariocandela/beelzebub) - A secure low code honeypot framework, leveraging AI for System Virtualization. +- [booster](https://github.com/anatol/booster) - Fast initramfs generator with full-disk encryption support. - [Cameradar](https://github.com/Ullaakut/cameradar) - Tool and library to remotely hack RTSP streams from surveillance cameras. - [certificates](https://github.com/mvmaasakkers/certificates) - An opinionated tool for generating tls certificates. - [CertMagic](https://github.com/caddyserver/certmagic) - Mature, robust, and powerful ACME client integration for fully-managed TLS certificate issuance and renewal. - [Coraza](https://github.com/corazawaf/coraza) - Enterprise-ready, modsecurity and OWASP CRS compatible WAF library. - [dongle](https://github.com/golang-module/dongle) - A simple, semantic and developer-friendly golang package for encoding&decoding and encryption&decryption. +- [encid](https://github.com/bobg/encid) - Encode and decode encrypted integer IDs. - [firewalld-rest](https://github.com/prashantgupta24/firewalld-rest) - A rest application to dynamically update firewalld rules on a linux server. - [go-generate-password](https://github.com/m1/go-generate-password) - Password generator that can be used on the cli or as a library. - [go-htpasswd](https://github.com/tg123/go-htpasswd) - Apache htpasswd Parser for Go. - [go-password-validator](https://github.com/lane-c-wagner/go-password-validator) - Password validator based on raw cryptographic entropy values. +- [go-peer](https://github.com/number571/go-peer) - A software library for creating secure and anonymous decentralized systems. - [go-yara](https://github.com/hillu/go-yara) - Go Bindings for [YARA](https://github.com/plusvic/yara), the "pattern matching swiss knife for malware researchers (and everyone else)". - [goArgonPass](https://github.com/dwin/goArgonPass) - Argon2 password hash and verification designed to be compatible with existing Python and PHP implementations. - [goSecretBoxPassword](https://github.com/dwin/goSecretBoxPassword) - A probably paranoid package for securely hashing and encrypting passwords. -- [Interpol](https://bitbucket.org/vahidi/interpol) - Rule-based data generator for fuzzing and penetration testing. +- [Interpol](https://github.com/avahidi/interpol) - Rule-based data generator for fuzzing and penetration testing. - [lego](https://github.com/go-acme/lego) - Pure Go ACME client library and CLI tool (for use with Let's Encrypt). - [memguard](https://github.com/awnumar/memguard) - A pure Go library for handling sensitive values in memory. +- [multikey](https://github.com/adrianosela/multikey) - An n-out-of-N keys encryption/decryption framework based on Shamir's Secret Sharing algorithm. - [nacl](https://github.com/kevinburke/nacl) - Go implementation of the NaCL set of API's. - [optimus-go](https://github.com/pjebs/optimus-go) - ID hashing and Obfuscation using Knuth's Algorithm. - [passlib](https://github.com/hlandau/passlib) - Futureproof password hashing library. -- [secret](https://github.com/rsjethani/secret) - Prevent your secrets from leaking into logs, std* etc. +- [passwap](https://github.com/zitadel/passwap) - Provides a unified implementation between different password hashing algorithms +- [secret](https://github.com/rsjethani/secret) - Prevent your secrets from leaking into logs, std\* etc. - [secure](https://github.com/unrolled/secure) - HTTP middleware for Go that facilitates some quick security wins. - [secureio](https://github.com/xaionaro-go/secureio) - An keyexchanging+authenticating+encrypting wrapper and multiplexer for `io.ReadWriteCloser` based on XChaCha20-poly1305, ECDH and ED25519. - [simple-scrypt](https://github.com/elithrar/simple-scrypt) - Scrypt package with a simple, obvious API and automatic cost calibration built-in. - [ssh-vault](https://github.com/ssh-vault/ssh-vault) - encrypt/decrypt using ssh keys. - [sslmgr](https://github.com/adrianosela/sslmgr) - SSL certificates made easy with a high level wrapper around acme/autocert. +- [teler-waf](https://github.com/kitabisa/teler-waf) - teler-waf is a Go HTTP middleware that provide teler IDS functionality to protect against web-based attacks and improve the security of Go-based web applications. It is highly configurable and easy to integrate into existing Go applications. - [themis](https://github.com/cossacklabs/themis) - high-level cryptographic library for solving typical data security tasks (secure data storage, secure messaging, zero-knowledge proof authentication), available for 14 languages, best fit for multi-platform apps. **[⬆ back to top](#contents)** @@ -2117,9 +2275,11 @@ _Libraries and tools for binary serialization._ - [fwencoder](https://github.com/o1egl/fwencoder) - Fixed width file parser (encoding and decoding library) for Go. - [go-capnproto](https://github.com/glycerine/go-capnproto) - Cap'n Proto library and parser for go. - [go-codec](https://github.com/ugorji/go) - High Performance, feature-Rich, idiomatic encode, decode and rpc library for msgpack, cbor and json, with runtime-based OR code-generation support. +- [go-csvlib](https://github.com/tiendc/go-csvlib) - High level and rich functionalities CSV serialization/deserialization library. - [go-lctree](https://github.com/sbourlon/go-lctree) - Provides a CLI and primitives to serialize and deserialize [LeetCode binary trees](https://support.leetcode.com/hc/en-us/articles/360011883654-What-does-1-null-2-3-mean-in-binary-tree-representation). - [gogoprotobuf](https://github.com/gogo/protobuf) - Protocol Buffers for Go with Gadgets. - [goprotobuf](https://github.com/golang/protobuf) - Go support, in the form of a library and protocol compiler plugin, for Google's protocol buffers. +- [gotiny](https://github.com/raszia/gotiny) - Efficient Go serialization library, gotiny is almost as fast as serialization libraries that generate code. - [jsoniter](https://github.com/json-iterator/go) - High-performance 100% compatible drop-in replacement of "encoding/json". - [mapstructure](https://github.com/mitchellh/mapstructure) - Go library for decoding generic map values into native Go structures. - [php_session_decoder](https://github.com/yvasiyarov/php_session_decoder) - GoLang library for working with PHP session format and PHP Serialize/Unserialize functions. @@ -2140,19 +2300,21 @@ _Libraries and tools for binary serialization._ - [dudeldu](https://github.com/krotik/dudeldu) - A simple SHOUTcast server. - [dummy](https://github.com/neotoolkit/dummy) - Run mock server based off an API contract with one command. - [Easegress](https://github.com/megaease/easegress) - A cloud native high availability/performance traffic orchestration system with observability and extensibility. -- [etcd](https://github.com/coreos/etcd) - Highly-available key value store for shared configuration and service discovery. +- [etcd](https://github.com/etcd-io/etcd) - Highly-available key value store for shared configuration and service discovery. - [Euterpe](https://github.com/ironsmile/euterpe) - Self-hosted music streaming server with built-in web UI and REST API. - [Fider](https://github.com/getfider/fider) - Fider is an open platform to collect and organize customer feedback. - [Flagr](https://github.com/checkr/flagr) - Flagr is an open-source feature flagging and A/B testing service. - [flipt](https://github.com/markphelps/flipt) - A self contained feature flag solution written in Go and Vue.js -- [go-feature-flag](https://github.com/thomaspoignant/go-feature-flag) - A feature flag solution, with only a YAML file in the backend (S3, GitHub, HTTP, local file ...), no server to install, just add a file in a central system and refer to it. +- [go-feature-flag](https://github.com/thomaspoignant/go-feature-flag) - A simple, complete and lightweight self-hosted feature flag solution 100% Open Source. - [go-proxy-cache](https://github.com/fabiocicerchia/go-proxy-cache) - Simple Reverse Proxy with Caching, written in Go, using Redis. +- [gondola](https://github.com/bmf-san/gondola) - A YAML based golang reverse proxy. - [jackal](https://github.com/ortuman/jackal) - An XMPP server written in Go. - [lets-proxy2](https://github.com/rekby/lets-proxy2) - Reverse proxy for handle https with issue certificates in fly from lets-encrypt. - [minio](https://github.com/minio/minio) - Minio is a distributed object storage server. - [Moxy](https://github.com/sinhashubham95/moxy) - Moxy is a simple mocker and proxy application server, you can create mock endpoints as well as proxy requests in case no mock exists for the endpoint. - [nginx-prometheus](https://github.com/blind-oracle/nginx-prometheus) - Nginx log parser and exporter to Prometheus. - [nsq](https://nsq.io/) - A realtime distributed messaging platform. +- [pocketbase](https://github.com/pocketbase/pocketbase) - PocketBase is a realtime backend in 1 file consisting of embedded database (SQLite) with realtime subscriptions, built-in auth management and much more. - [protoxy](https://github.com/camgraff/protoxy) - A proxy server that converts JSON request bodies to Protocol Buffers. - [psql-streamer](https://github.com/blind-oracle/psql-streamer) - Stream database events from PostgreSQL to Kafka. - [riemann-relay](https://github.com/blind-oracle/riemann-relay) - Relay to load-balance Riemann events and/or convert them to Carbon. @@ -2182,6 +2344,7 @@ _Libraries and tools for templating and lexing._ - [ego](https://github.com/benbjohnson/ego) - Lightweight templating language that lets you write templates in Go. Templates are translated into Go and compiled. - [extemplate](https://github.com/dannyvankooten/extemplate) - Tiny wrapper around html/template to allow for easy file-based template inheritance. - [fasttemplate](https://github.com/valyala/fasttemplate) - Simple and fast template engine. Substitutes template placeholders up to 10x faster than [text/template](https://golang.org/pkg/text/template/). +- [gomponents](https://www.gomponents.com) - HTML 5 components in pure Go, that look something like this: `func(name string) g.Node { return Div(Class("headline"), g.Textf("Hi %v!", name)) }`. - [gospin](https://github.com/m1/gospin) - Article spinning and spintax/spinning syntax engine, useful for A/B, testing pieces of text/articles and creating more natural conversations. - [got](https://github.com/goradd/got) - A Go code generator inspired by Hero and Fasttemplate. Has include files, custom tag definitions, injected Go code, language translation, and more. - [goview](https://github.com/foolin/goview) - Goview is a lightweight, minimalist and idiomatic template library based on golang html/template for building Go web application. @@ -2195,6 +2358,7 @@ _Libraries and tools for templating and lexing._ - [Soy](https://github.com/robfig/soy) - Closure templates (aka Soy templates) for Go, following the [official spec](https://developers.google.com/closure/templates/). - [sprig](https://github.com/Masterminds/sprig) - Useful template functions for Go templates. - [tbd](https://github.com/lucasepe/tbd) - A really simple way to create text templates with placeholders - exposes extra builtin Git repo metadata. +- [templ](https://github.com/a-h/templ) - A HTML templating language that has great developer tooling. **[⬆ back to top](#contents)** @@ -2202,103 +2366,108 @@ _Libraries and tools for templating and lexing._ _Libraries for testing codebases and generating test data._ -- Testing Frameworks - - [apitest](https://apitest.dev) - Simple and extensible behavioural testing library for REST based services or HTTP handlers that supports mocking external http calls and rendering of sequence diagrams. - - [assert](https://github.com/go-playground/assert) - Basic Assertion Library used along side native go testing, with building blocks for custom assertions. - - [badio](https://github.com/cavaliercoder/badio) - Extensions to Go's `testing/iotest` package. - - [baloo](https://github.com/h2non/baloo) - Expressive and versatile end-to-end HTTP API testing made easy. - - [be](https://github.com/carlmjohnson/be) - The minimalist generic test assertion library. - - [biff](https://github.com/fulldump/biff) - Bifurcation testing framework, BDD compatible. - - [charlatan](https://github.com/percolate/charlatan) - Tool to generate fake interface implementations for tests. - - [commander](https://github.com/SimonBaeumer/commander) - Tool for testing cli applications on windows, linux and osx. - - [covergates](https://github.com/covergates/covergates) - Self-hosted code coverage report review and management service. - - [cupaloy](https://github.com/bradleyjkemp/cupaloy) - Simple snapshot testing addon for your test framework. - - [dbcleaner](https://github.com/khaiql/dbcleaner) - Clean database for testing purpose, inspired by `database_cleaner` in Ruby. - - [dsunit](https://github.com/viant/dsunit) - Datastore testing for SQL, NoSQL, structured files. - - [embedded-postgres](https://github.com/fergusstrange/embedded-postgres) - Run a real Postgres database locally on Linux, OSX or Windows as part of another Go application or test. - - [endly](https://github.com/viant/endly) - Declarative end to end functional testing. - - [fixenv](https://github.com/rekby/fixenv) - Fixture manage engine, inspired by pytest fixtures. - - [flute](https://github.com/suzuki-shunsuke/flute) - HTTP client testing framework. - - [frisby](https://github.com/verdverm/frisby) - REST API testing framework. - - [gherkingen](https://github.com/hedhyw/gherkingen) - BDD boilerplate generator and framework. - - [ginkgo](https://onsi.github.io/ginkgo/) - BDD Testing Framework for Go. - - [gnomock](https://github.com/orlangure/gnomock) - integration testing with real dependencies (database, cache, even Kubernetes or AWS) running in Docker, without mocks. - - [go-carpet](https://github.com/msoap/go-carpet) - Tool for viewing test coverage in terminal. - - [go-cmp](https://github.com/google/go-cmp) - Package for comparing Go values in tests. - - [go-hit](https://github.com/Eun/go-hit) - Hit is an http integration test framework written in golang. - - [go-mutesting](https://github.com/zimmski/go-mutesting) - Mutation testing for Go source code. - - [go-mysql-test-container](https://github.com/arikama/go-mysql-test-container) - Golang MySQL testcontainer to help with MySQL integration testing. - - [go-snaps](http://github.com/gkampitakis/go-snaps) - Jest-like snapshot testing in Golang. - - [go-testdeep](https://github.com/maxatome/go-testdeep) - Extremely flexible golang deep comparison, extends the go testing package. - - [go-testpredicate](https://github.com/maargenton/go-testpredicate) - Test predicate style assertions library with extensive diagnostics output. - - [go-vcr](https://github.com/dnaeon/go-vcr) - Record and replay your HTTP interactions for fast, deterministic and accurate tests. - - [goblin](https://github.com/franela/goblin) - Mocha like testing framework fo Go. - - [goc](https://github.com/qiniu/goc) - Goc is a comprehensive coverage testing system for The Go Programming Language. - - [gocheck](https://labix.org/gocheck) - More advanced testing framework alternative to gotest. - - [GoConvey](https://github.com/smartystreets/goconvey/) - BDD-style framework with web UI and live reload. - - [gocrest](https://github.com/corbym/gocrest) - Composable hamcrest-like matchers for Go assertions. - - [godog](https://github.com/DATA-DOG/godog) - Cucumber or Behat like BDD framework for Go. - - [gofight](https://github.com/appleboy/gofight) - API Handler Testing for Golang Router framework. - - [gogiven](https://github.com/corbym/gogiven) - YATSPEC-like BDD testing framework for Go. - - [gomatch](https://github.com/jfilipczyk/gomatch) - library created for testing JSON against patterns. - - [gomega](https://onsi.github.io/gomega/) - Rspec like matcher/assertion library. - - [Gont](https://github.com/stv0g/gont) - Go network testing toolkit for testing building complex network topologies using Linux namespaces. - - [GoSpec](https://github.com/orfjackal/gospec) - BDD-style testing framework for the Go programming language. - - [gospecify](https://github.com/stesla/gospecify) - This provides a BDD syntax for testing your Go code. It should be familiar to anybody who has used libraries such as rspec. - - [gosuite](https://github.com/pavlo/gosuite) - Brings lightweight test suites with setup/teardown facilities to `testing` by leveraging Go1.7's Subtests. - - [got](https://github.com/ysmood/got) - An enjoyable golang test framework. - - [gotest.tools](https://github.com/gotestyourself/gotest.tools) - A collection of packages to augment the go testing package and support common patterns. - - [Hamcrest](https://github.com/rdrdr/hamcrest) - fluent framework for declarative Matcher objects that, when applied to input values, produce self-describing results. - - [httpexpect](https://github.com/gavv/httpexpect) - Concise, declarative, and easy to use end-to-end HTTP and REST API testing. - - [is](https://github.com/matryer/is) - Professional lightweight testing mini-framework for Go. - - [jsonassert](https://github.com/kinbiko/jsonassert) - Package for verifying that your JSON payloads are serialized correctly. - - [omg.testingtools](https://github.com/dedalqq/omg.testingtools) - The simple library for change a values of private fields for testing. - - [restit](https://github.com/yookoala/restit) - Go micro framework to help writing RESTful API integration test. - - [schema](https://github.com/jgroeneveld/schema) - Quick and easy expression matching for JSON schemas used in requests and responses. - - [stop-and-go](https://github.com/elgohr/stop-and-go) - Testing helper for concurrency. - - [testcase](https://github.com/adamluzsi/testcase) - Idiomatic testing framework for Behavior Driven Development. - - [testfixtures](https://github.com/go-testfixtures/testfixtures) - A helper for Rails' like test fixtures to test database applications. - - [Testify](https://github.com/stretchr/testify) - Sacred extension to the standard go testing package. - - [testmd](https://godoc.org/github.com/tvastar/test/cmd/testmd) - Convert markdown snippets into testable go code. - - [testsql](https://github.com/zhulongcheng/testsql) - Generate test data from SQL files before testing and clear it after finished. - - [testza](https://github.com/MarvinJWendt/testza) - Full-featured test framework with nice colorized output. - - [trial](https://github.com/jgroeneveld/trial) - Quick and easy extendable assertions without introducing much boilerplate. - - [Tt](https://github.com/vcaesar/tt) - Simple and colorful test tools. - - [wstest](https://github.com/posener/wstest) - Websocket client for unit-testing a websocket http.Handler. +### Testing Frameworks -- Mock - - [counterfeiter](https://github.com/maxbrunsfeld/counterfeiter) - Tool for generating self-contained mock objects. - - [genmock](https://gitlab.com/so_literate/genmock) - Go mocking system with code generator for building calls of the interface methods. - - [go-localstack](https://github.com/elgohr/go-localstack) - Tool for using localstack in AWS testing. - - [go-sqlmock](https://github.com/DATA-DOG/go-sqlmock) - Mock SQL driver for testing database interactions. - - [go-txdb](https://github.com/DATA-DOG/go-txdb) - Single transaction based database driver mainly for testing purposes. - - [gock](https://github.com/h2non/gock) - Versatile HTTP mocking made easy. - - [gomock](https://github.com/golang/mock) - Mocking framework for the Go programming language. - - [govcr](https://github.com/seborama/govcr) - HTTP mock for Golang: record and replay HTTP interactions for offline testing. - - [hoverfly](https://github.com/SpectoLabs/hoverfly) - HTTP(S) proxy for recording and simulating REST/SOAP APIs with extensible middleware and easy-to-use CLI. - - [httpmock](https://github.com/jarcoal/httpmock) - Easy mocking of HTTP responses from external resources. - - [minimock](https://github.com/gojuno/minimock) - Mock generator for Go interfaces. - - [mockery](https://github.com/vektra/mockery) - Tool to generate Go interfaces. - - [mockhttp](https://github.com/tv42/mockhttp) - Mock object for Go http.ResponseWriter. - - [mockit](https://github.com/pasdam/mockit) - Allows functions and method easy mocking, without defining new types; it's similar to Mockito for Java. - - [mooncake](https://github.com/GuilhermeCaruso/mooncake) - A simple way to generate mocks for multiple purposes - - [timex](https://github.com/cabify/timex) - A test-friendly replacement for the native `time` package. +- [apitest](https://apitest.dev) - Simple and extensible behavioural testing library for REST based services or HTTP handlers that supports mocking external http calls and rendering of sequence diagrams. +- [arch-go](https://github.com/fdaines/arch-go) - Architecture testing tool for Go projects. +- [assert](https://github.com/go-playground/assert) - Basic Assertion Library used along side native go testing, with building blocks for custom assertions. +- [baloo](https://github.com/h2non/baloo) - Expressive and versatile end-to-end HTTP API testing made easy. +- [be](https://github.com/carlmjohnson/be) - The minimalist generic test assertion library. +- [biff](https://github.com/fulldump/biff) - Bifurcation testing framework, BDD compatible. +- [charlatan](https://github.com/percolate/charlatan) - Tool to generate fake interface implementations for tests. +- [commander](https://github.com/SimonBaeumer/commander) - Tool for testing cli applications on windows, linux and osx. +- [cupaloy](https://github.com/bradleyjkemp/cupaloy) - Simple snapshot testing addon for your test framework. +- [dbcleaner](https://github.com/khaiql/dbcleaner) - Clean database for testing purpose, inspired by `database_cleaner` in Ruby. +- [dsunit](https://github.com/viant/dsunit) - Datastore testing for SQL, NoSQL, structured files. +- [embedded-postgres](https://github.com/fergusstrange/embedded-postgres) - Run a real Postgres database locally on Linux, OSX or Windows as part of another Go application or test. +- [endly](https://github.com/viant/endly) - Declarative end to end functional testing. +- [fixenv](https://github.com/rekby/fixenv) - Fixture manage engine, inspired by pytest fixtures. +- [fluentassert](https://github.com/fluentassert/verify) - Extensible, type-safe, fluent assertion Go library. +- [flute](https://github.com/suzuki-shunsuke/flute) - HTTP client testing framework. +- [frisby](https://github.com/verdverm/frisby) - REST API testing framework. +- [gherkingen](https://github.com/hedhyw/gherkingen) - BDD boilerplate generator and framework. +- [ginkgo](https://onsi.github.io/ginkgo/) - BDD Testing Framework for Go. +- [gnomock](https://github.com/orlangure/gnomock) - integration testing with real dependencies (database, cache, even Kubernetes or AWS) running in Docker, without mocks. +- [go-carpet](https://github.com/msoap/go-carpet) - Tool for viewing test coverage in terminal. +- [go-cmp](https://github.com/google/go-cmp) - Package for comparing Go values in tests. +- [go-hit](https://github.com/Eun/go-hit) - Hit is an http integration test framework written in golang. +- [go-mutesting](https://github.com/zimmski/go-mutesting) - Mutation testing for Go source code. +- [go-mysql-test-container](https://github.com/arikama/go-mysql-test-container) - Golang MySQL testcontainer to help with MySQL integration testing. +- [go-snaps](http://github.com/gkampitakis/go-snaps) - Jest-like snapshot testing in Golang. +- [go-testdeep](https://github.com/maxatome/go-testdeep) - Extremely flexible golang deep comparison, extends the go testing package. +- [go-testpredicate](https://github.com/maargenton/go-testpredicate) - Test predicate style assertions library with extensive diagnostics output. +- [go-vcr](https://github.com/dnaeon/go-vcr) - Record and replay your HTTP interactions for fast, deterministic and accurate tests. +- [goblin](https://github.com/franela/goblin) - Mocha like testing framework of Go. +- [goc](https://github.com/qiniu/goc) - Goc is a comprehensive coverage testing system for The Go Programming Language. +- [gocheck](https://labix.org/gocheck) - More advanced testing framework alternative to gotest. +- [GoConvey](https://github.com/smartystreets/goconvey/) - BDD-style framework with web UI and live reload. +- [gocrest](https://github.com/corbym/gocrest) - Composable hamcrest-like matchers for Go assertions. +- [godog](https://github.com/cucumber/godog) - Cucumber BDD framework for Go. +- [gofight](https://github.com/appleboy/gofight) - API Handler Testing for Golang Router framework. +- [gogiven](https://github.com/corbym/gogiven) - YATSPEC-like BDD testing framework for Go. +- [gomatch](https://github.com/jfilipczyk/gomatch) - library created for testing JSON against patterns. +- [gomega](https://onsi.github.io/gomega/) - Rspec like matcher/assertion library. +- [Gont](https://github.com/stv0g/gont) - Go network testing toolkit for testing building complex network topologies using Linux namespaces. +- [gospecify](https://github.com/stesla/gospecify) - This provides a BDD syntax for testing your Go code. It should be familiar to anybody who has used libraries such as rspec. +- [gosuite](https://github.com/pavlo/gosuite) - Brings lightweight test suites with setup/teardown facilities to `testing` by leveraging Go1.7's Subtests. +- [got](https://github.com/ysmood/got) - An enjoyable golang test framework. +- [gotest.tools](https://github.com/gotestyourself/gotest.tools) - A collection of packages to augment the go testing package and support common patterns. +- [Hamcrest](https://github.com/rdrdr/hamcrest) - fluent framework for declarative Matcher objects that, when applied to input values, produce self-describing results. +- [httpexpect](https://github.com/gavv/httpexpect) - Concise, declarative, and easy to use end-to-end HTTP and REST API testing. +- [is](https://github.com/matryer/is) - Professional lightweight testing mini-framework for Go. +- [jsonassert](https://github.com/kinbiko/jsonassert) - Package for verifying that your JSON payloads are serialized correctly. +- [omg.testingtools](https://github.com/dedalqq/omg.testingtools) - The simple library for change a values of private fields for testing. +- [restit](https://github.com/yookoala/restit) - Go micro framework to help writing RESTful API integration test. +- [schema](https://github.com/jgroeneveld/schema) - Quick and easy expression matching for JSON schemas used in requests and responses. +- [stop-and-go](https://github.com/elgohr/stop-and-go) - Testing helper for concurrency. +- [testcase](https://github.com/adamluzsi/testcase) - Idiomatic testing framework for Behavior Driven Development. +- [testcerts](https://github.com/madflojo/testcerts) - Dynamically generate self-signed certificates and certificate authorities within your test functions. +- [testcontainers-go](https://github.com/testcontainers/testcontainers-go) - A Go package that makes it simple to create and clean up container-based dependencies for automated integration/smoke tests. The clean, easy-to-use API enables developers to programmatically define containers that should be run as part of a test and clean up those resources when the test is done. +- [testfixtures](https://github.com/go-testfixtures/testfixtures) - A helper for Rails' like test fixtures to test database applications. +- [Testify](https://github.com/stretchr/testify) - Sacred extension to the standard go testing package. +- [testsql](https://github.com/zhulongcheng/testsql) - Generate test data from SQL files before testing and clear it after finished. +- [testza](https://github.com/MarvinJWendt/testza) - Full-featured test framework with nice colorized output. +- [trial](https://github.com/jgroeneveld/trial) - Quick and easy extendable assertions without introducing much boilerplate. +- [Tt](https://github.com/vcaesar/tt) - Simple and colorful test tools. +- [wstest](https://github.com/posener/wstest) - Websocket client for unit-testing a websocket http.Handler. -- Fuzzing and delta-debugging/reducing/shrinking. - - [go-fuzz](https://github.com/dvyukov/go-fuzz) - Randomized testing system. - - [gofuzz](https://github.com/google/gofuzz) - Library for populating go objects with random values. - - [Tavor](https://github.com/zimmski/tavor) - Generic fuzzing and delta-debugging framework. +### Mock -- Selenium and browser control tools. - - [cdp](https://github.com/mafredri/cdp) - Type-safe bindings for the Chrome Debugging Protocol that can be used with browsers or other debug targets that implement it. - - [chromedp](https://github.com/knq/chromedp) - a way to drive/test Chrome, Safari, Edge, Android Webviews, and other browsers supporting the Chrome Debugging Protocol. - - [ggr](https://github.com/aerokube/ggr) - a lightweight server that routes and proxies Selenium WebDriver requests to multiple Selenium hubs. - - [playwright-go](https://github.com/mxschmitt/playwright-go) - browser automation library to control Chromium, Firefox and WebKit with a single API. - - [rod](https://github.com/go-rod/rod) - A Devtools driver to make web automation and scraping easy. - - [selenoid](https://github.com/aerokube/selenoid) - alternative Selenium hub server that launches browsers within containers. +- [counterfeiter](https://github.com/maxbrunsfeld/counterfeiter) - Tool for generating self-contained mock objects. +- [genmock](https://gitlab.com/so_literate/genmock) - Go mocking system with code generator for building calls of the interface methods. +- [go-localstack](https://github.com/elgohr/go-localstack) - Tool for using localstack in AWS testing. +- [go-sqlmock](https://github.com/DATA-DOG/go-sqlmock) - Mock SQL driver for testing database interactions. +- [go-txdb](https://github.com/DATA-DOG/go-txdb) - Single transaction based database driver mainly for testing purposes. +- [gock](https://github.com/h2non/gock) - Versatile HTTP mocking made easy. +- [gomock](https://github.com/golang/mock) - Mocking framework for the Go programming language. +- [govcr](https://github.com/seborama/govcr) - HTTP mock for Golang: record and replay HTTP interactions for offline testing. +- [hoverfly](https://github.com/SpectoLabs/hoverfly) - HTTP(S) proxy for recording and simulating REST/SOAP APIs with extensible middleware and easy-to-use CLI. +- [httpmock](https://github.com/jarcoal/httpmock) - Easy mocking of HTTP responses from external resources. +- [minimock](https://github.com/gojuno/minimock) - Mock generator for Go interfaces. +- [mockery](https://github.com/vektra/mockery) - Tool to generate Go interfaces. +- [mockhttp](https://github.com/tv42/mockhttp) - Mock object for Go http.ResponseWriter. +- [mooncake](https://github.com/GuilhermeCaruso/mooncake) - A simple way to generate mocks for multiple purposes. +- [moq](https://github.com/matryer/moq) - Utility that generates a struct from any interface. The struct can be used in test code as a mock of the interface. +- [timex](https://github.com/cabify/timex) - A test-friendly replacement for the native `time` package. +- [xgo](https://github.com/xhd2015/xgo) - A general pureposed function mocking library. -- Fail injection - - [failpoint](https://github.com/pingcap/failpoint) - An implementation of [failpoints](https://www.freebsd.org/cgi/man.cgi?query=fail) for Golang. +## Fuzzing and delta-debugging/reducing/shrinking + +- [go-fuzz](https://github.com/dvyukov/go-fuzz) - Randomized testing system. +- [gofuzz](https://github.com/google/gofuzz) - Library for populating go objects with random values. +- [Tavor](https://github.com/zimmski/tavor) - Generic fuzzing and delta-debugging framework. + +## Selenium and browser control tools + +- [cdp](https://github.com/mafredri/cdp) - Type-safe bindings for the Chrome Debugging Protocol that can be used with browsers or other debug targets that implement it. +- [chromedp](https://github.com/knq/chromedp) - a way to drive/test Chrome, Safari, Edge, Android Webviews, and other browsers supporting the Chrome Debugging Protocol. +- [ggr](https://github.com/aerokube/ggr) - a lightweight server that routes and proxies Selenium WebDriver requests to multiple Selenium hubs. +- [playwright-go](https://github.com/mxschmitt/playwright-go) - browser automation library to control Chromium, Firefox and WebKit with a single API. +- [rod](https://github.com/go-rod/rod) - A Devtools driver to make web automation and scraping easy. +- [selenoid](https://github.com/aerokube/selenoid) - alternative Selenium hub server that launches browsers within containers. + +### Fail injection +- [failpoint](https://github.com/pingcap/failpoint) - An implementation of [failpoints](https://www.freebsd.org/cgi/man.cgi?query=fail) for Golang. **[⬆ back to top](#contents)** @@ -2323,13 +2492,14 @@ See also [Natural Language Processing](#natural-language-processing) and [Text A - [bafi](https://github.com/mmalcek/bafi) - Universal JSON, BSON, YAML, XML translator to ANY format using templates. - [bbConvert](https://github.com/CalebQ42/bbConvert) - Converts bbCode to HTML that allows you to add support for custom bbCode tags. - [blackfriday](https://github.com/russross/blackfriday) - Markdown processor in Go. -- [github_flavored_markdown](https://godoc.org/github.com/shurcooL/github_flavored_markdown) - GitHub Flavored Markdown renderer (using blackfriday) with fenced code block highlighting, clickable header anchor links. - [go-output-format](https://github.com/drewstinnett/go-output-format) - Output go structures into multiple formats (YAML/JSON/etc) in your command line app. - [go-toml](https://github.com/pelletier/go-toml) - Go library for the TOML format with query support and handy cli tools. - [goldmark](https://github.com/yuin/goldmark) - A Markdown parser written in Go. Easy to extend, standard (CommonMark) compliant, well structured. -- [goq](https://github.com/andrewstuart/goq) - Declarative unmarshaling of HTML using struct tags with jQuery syntax (uses GoQuery). +- [goq](https://github.com/andrewstuart/goq) - Declarative unmarshalling of HTML using struct tags with jQuery syntax (uses GoQuery). - [html-to-markdown](https://github.com/JohannesKaufmann/html-to-markdown) - Convert HTML to Markdown. Even works with entire websites and can be extended through rules. - [htmlquery](https://github.com/antchfx/htmlquery) - An XPath query package for HTML, lets you extract data or evaluate from HTML documents by an XPath expression. +- [htmlyaml](https://github.com/nikolaydubina/htmlyaml) - Rich rendering of YAML as HTML in Go +- [htree](https://github.com/bobg/htree) - Traverse, navigate, filter, and otherwise process trees of [html.Node](https://pkg.go.dev/golang.org/x/net/html#Node) objects. - [mxj](https://github.com/clbanning/mxj) - Encode / decode XML as JSON or map[string]interface{}; extract values with dot-notation paths and wildcards. Replaces x2j and j2x packages. - [toml](https://github.com/BurntSushi/toml) - TOML configuration format (encoder/decoder with reflection). @@ -2342,20 +2512,22 @@ See also [Natural Language Processing](#natural-language-processing) and [Text A - [doi](https://github.com/hscells/doi) - Document object identifier (doi) parser in Go. - [editorconfig-core-go](https://github.com/editorconfig/editorconfig-core-go) - Editorconfig file parser and manipulator for Go. - [encdec](https://github.com/mickep76/encdec) - Package provides a generic interface to encoders and decoders. -- [go-fasttld](https://github.com/elliotwutingfeng/go-fasttld) - High performance top level domains (TLD) extraction module. +- [go-fasttld](https://github.com/elliotwutingfeng/go-fasttld) - High performance effective top level domains (eTLD) extraction module. - [go-nmea](https://github.com/adrianmo/go-nmea) - NMEA parser library for the Go language. +- [go-querystring](https://github.com/google/go-querystring) - Go library for encoding structs into URL query parameters. - [go-vcard](https://github.com/emersion/go-vcard) - Parse and format vCard. +- [godump](https://github.com/yassinebenaid/godump) - Pretty print any GO variable with ease, an alternative to Go's `fmt.Printf("%#v")`. - [gofeed](https://github.com/mmcdole/gofeed) - Parse RSS and Atom feeds in Go. - [gographviz](https://github.com/awalterschulze/gographviz) - Parses the Graphviz DOT language. - [gonameparts](https://github.com/polera/gonameparts) - Parses human names into individual name parts. - [ltsv](https://github.com/Wing924/ltsv) - High performance [LTSV (Labeled Tab Separated Value)](http://ltsv.org/) reader for Go. - [normalize](https://github.com/avito-tech/normalize) - Sanitize, normalize and compare fuzzy text. -- [omniparser](https://github.com/jf-tech/omniparser) - A versatile ETL library that parses text input (CSV/txt/JSON/XML/EDI/X12/EDIFACT/etc) in streaming fashion and transforms data into JSON output using data-driven schema. - [parseargs-go](https://github.com/nproc/parseargs-go) - string argument parser that understands quotes and backslashes. - [parth](https://github.com/codemodus/parth) - URL path segmentation parsing. +- [prattle](https://github.com/askeladdk/prattle) - Scan and parse LL(1) grammars simply and efficiently. - [sdp](https://github.com/gortc/sdp) - SDP: Session Description Protocol [[RFC 4566](https://tools.ietf.org/html/rfc4566)]. - [sh](https://github.com/mvdan/sh) - Shell parser and formatter. -- [tokenizer](https://github.com/bzick/tokenizer) — Parse any string, slice or infinite buffer to any tokens. +- [tokenizer](https://github.com/bzick/tokenizer) - Parse any string, slice or infinite buffer to any tokens. - [when](https://github.com/olebedev/when) - Natural EN and RU language date/time parser with pluggable rules. - [xj2go](https://github.com/stackerzzq/xj2go) - Convert xml or json to go struct. @@ -2381,12 +2553,12 @@ See also [Natural Language Processing](#natural-language-processing) and [Text A - [gospider](https://github.com/zhshch2002/gospider) - A simple golang spider/scraping framework,build a spider in 3 lines. migrated from [goribot](https://github.com/zhshch2002/goribot) - [pagser](https://github.com/foolin/pagser) - Pagser is a simple, extensible, configurable parse and deserialize html page to struct based on goquery and struct tags for golang crawler. - [Tagify](https://github.com/zoomio/tagify) - Produces a set of tags from given source. +- [walker](https://github.com/cyucelen/walker) - Seamlessly fetch paginated data from any source. Simple and high performance API scraping included. - [xurls](https://github.com/mvdan/xurls) - Extract urls from text. ### RSS - [podcast](https://github.com/eduncan911/podcast) - iTunes Compliant and RSS 2.0 Podcast Generator in Golang -- [syndfeed](https://github.com/zhengchun/syndfeed) - A syndication feed for Atom 1.0 and RSS 2.0. ### Utility/Miscellaneous @@ -2396,6 +2568,7 @@ See also [Natural Language Processing](#natural-language-processing) and [Text A - [petrovich](https://github.com/striker2000/petrovich) - Petrovich is the library which inflects Russian names to given grammatical case. - [radix](https://github.com/yourbasic/radix) - Fast string sorting algorithm. - [TySug](https://github.com/Dynom/TySug) - Alternative suggestions with respect to keyboard layouts. +- [w2vgrep](https://github.com/arunsupe/semantic-grep) - A semantic grep tool using word embeddings to find semantically similar matches. For example, searching for "death" will find "dead", "killing", "murder". **[⬆ back to top](#contents)** @@ -2407,7 +2580,7 @@ _Libraries for accessing third party APIs._ - [amazon-product-advertising-api](https://github.com/ngs/go-amazon-product-advertising-api) - Go Client Library for [Amazon Product Advertising API](https://affiliate-program.amazon.com/gp/advertising/api/detail/main.html). - [anaconda](https://github.com/ChimeraCoder/anaconda) - Go client library for the Twitter 1.1 API. - [appstore-sdk-go](https://github.com/Kachit/appstore-sdk-go) - Unofficial Golang SDK for AppStore Connect API. -- [aws-sdk-go](https://github.com/aws/aws-sdk-go) - The official AWS SDK for the Go programming language. +- [aws-sdk-go](https://github.com/aws/aws-sdk-go-v2) - The official AWS SDK for the Go programming language. - [bqwriter](https://github.com/OTA-Insight/bqwriter) - High Level Go Library to write data into [Google BigQuery](https://cloud.google.com/bigquery) at a high throughout. - [brewerydb](https://github.com/naegelejd/brewerydb) - Go library for accessing the BreweryDB API. - [cachet](https://github.com/andygrunwald/cachet) - Go client library for [Cachet (open source status page system)](https://cachethq.io/). @@ -2417,6 +2590,7 @@ _Libraries for accessing third party APIs._ - [coinpaprika-go](https://github.com/coinpaprika/coinpaprika-api-go-client) - Go client library for interacting with Coinpaprika's API. - [device-check-go](https://github.com/rinchsan/device-check-go) - Go client library for interacting with [iOS DeviceCheck API](https://developer.apple.com/documentation/devicecheck) v1. - [discordgo](https://github.com/bwmarrin/discordgo) - Go bindings for the Discord Chat API. +- [disgo](https://github.com/switchupcb/disgo) - Go API Wrapper for the Discord API. - [dusupay-sdk-go](https://github.com/Kachit/dusupay-sdk-go) - Unofficial Dusupay payment gateway API Client for Go - [ethrpc](https://github.com/onrik/ethrpc) - Go bindings for Ethereum JSON RPC API. - [facebook](https://github.com/huandu/facebook) - Go Library that supports the Facebook Graph API. @@ -2425,7 +2599,7 @@ _Libraries for accessing third party APIs._ - [gads](https://github.com/emiddleton/gads) - Google Adwords Unofficial API. - [gami](https://github.com/bit4bit/gami) - Go library for Asterisk Manager Interface. - [gcm](https://github.com/Aorioli/gcm) - Go library for Google Cloud Messaging. -- [geo-golang](https://github.com/codingsince1985/geo-golang) - Go Library to access [Google Maps](https://developers.google.com/maps/documentation/geocoding/intro), [MapQuest](https://open.mapquestapi.com/geocoding/), [Nominatim](https://developer.mapquest.com/documentation/open/nominatim-search), [OpenCage](https://opencagedata.com/api), [Bing](https://msdn.microsoft.com/en-us/library/ff701715.aspx), [Mapbox](https://www.mapbox.com/developers/api/geocoding/), and [OpenStreetMap](https://wiki.openstreetmap.org/wiki/Nominatim) geocoding / reverse geocoding APIs. +- [geo-golang](https://github.com/codingsince1985/geo-golang) - Go Library to access [Google Maps](https://developers.google.com/maps/documentation/geocoding/intro), [MapQuest](https://developer.mapquest.com/documentation/geocoding-api/), [Nominatim](https://developer.mapquest.com/documentation/open/nominatim-search), [OpenCage](https://opencagedata.com/api), [Bing](https://msdn.microsoft.com/en-us/library/ff701715.aspx), [Mapbox](https://www.mapbox.com/developers/api/geocoding/), and [OpenStreetMap](https://wiki.openstreetmap.org/wiki/Nominatim) geocoding / reverse geocoding APIs. - [github](https://github.com/google/go-github) - Go library for accessing the GitHub REST API v3. - [githubql](https://github.com/shurcooL/githubql) - Go library for accessing the GitHub GraphQL API v4. - [go-atlassian](https://github.com/ctreminiom/go-atlassian) - Go library for accessing the [Atlassian Cloud](https://www.atlassian.com/enterprise/cloud) services (Jira, Jira Service Management, Jira Agile, Confluence, Admin Cloud) @@ -2439,21 +2613,23 @@ _Libraries for accessing third party APIs._ - [go-lark](https://github.com/go-lark/lark) - An easy-to-use unofficial SDK for [Feishu](https://open.feishu.cn/) and [Lark](https://open.larksuite.com/) Open Platform. - [go-marathon](https://github.com/gambol99/go-marathon) - Go library for interacting with Mesosphere's Marathon PAAS. - [go-myanimelist](https://github.com/nstratos/go-myanimelist) - Go client library for accessing the [MyAnimeList API](https://myanimelist.net/apiconfig/references/api/v2). +- [go-openai](https://github.com/sashabaranov/go-openai) - OpenAI ChatGPT, DALL·E, Whisper API library for Go. - [go-openproject](https://github.com/manuelbcd/go-openproject) - Go client library for interacting with [OpenProject](https://docs.openproject.org/api/) API. - [go-postman-collection](https://github.com/rbretecher/go-postman-collection) - Go module to work with [Postman Collections](https://learning.getpostman.com/docs/postman/collections/creating-collections/) (compatible with Insomnia). +- [go-redoc](https://github.com/mvrilo/go-redoc) - Embedded OpenAPI/Swagger documentation ui for Go using [ReDoc](https://redocly.com/). - [go-restcountries](https://github.com/chriscross0/go-restcountries) - Go library for the [REST Countries API](https://countrylayer.com/). +- [go-salesforce](https://github.com/k-capehart/go-salesforce) - Go client library for interacting with the [Salesforce REST API](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_list.htm). - [go-sophos](https://github.com/esurdam/go-sophos) - Go client library for the [Sophos UTM REST API](https://www.sophos.com/en-us/medialibrary/PDFs/documentation/UTMonAWS/Sophos-UTM-RESTful-API.pdf?la=en) with zero dependencies. -- [go-sptrans](https://github.com/sergioaugrod/go-sptrans) - Go client library for the SPTrans Olho Vivo API. - [go-swagger-ui](https://github.com/esurdam/go-swagger-ui) - Go library containing precompiled [Swagger UI](https://swagger.io/tools/swagger-ui/) for serving swagger json. - [go-telegraph](https://gitlab.com/toby3d/telegraph) - Telegraph publishing platform API client. - [go-trending](https://github.com/andygrunwald/go-trending) - Go library for accessing [trending repositories](https://github.com/trending) and [developers](https://github.com/trending/developers) at Github. -- [go-twitch](https://github.com/knspriggs/go-twitch) - Go client for interacting with the Twitch v3 API. - [go-twitter](https://github.com/dghubble/go-twitter) - Go client library for the Twitter v1.1 APIs. - [go-unsplash](https://github.com/hbagdi/go-unsplash) - Go client library for the [Unsplash.com](https://unsplash.com) API. - [go-xkcd](https://github.com/nishanths/go-xkcd) - Go client for the xkcd API. - [go-yapla](https://git.iglou.eu/Production/go-yapla) - Go client library for the Yapla v2.0 API. - [goagi](https://github.com/staskobzar/goagi) - Go library to build Asterisk PBX agi/fastagi applications. - [goami2](https://github.com/staskobzar/goami2) - AMI v2 library for Asterisk PBX. +- [GoFreeDB](https://github.com/FreeLeh/GoFreeDB) - Golang library providing common and simple database abstractions on top of Google Sheets. - [gogtrends](https://github.com/groovili/gogtrends) - Google Trends Unofficial API. - [golang-tmdb](https://github.com/cyruzin/golang-tmdb) - Golang wrapper for The Movie Database API v3. - [golyrics](https://github.com/mamal72/golyrics) - Golyrics is a Go library to fetch music lyrics data from the Wikia website. @@ -2465,11 +2641,13 @@ _Libraries for accessing third party APIs._ - [google-email-audit-api](https://github.com/ngs/go-google-email-audit-api) - Go client library for [Google G Suite Email Audit API](https://developers.google.com/admin-sdk/email-audit/). - [google-play-scraper](https://github.com/n0madic/google-play-scraper) - Get data from Google Play Store. - [gopaapi5](https://github.com/utekaravinash/gopaapi5) - Go Client Library for [Amazon Product Advertising API 5.0](https://webservices.amazon.com/paapi5/documentation/). -- [gosip](https://github.com/koltyakov/gosip) - Go client library SharePoint API. +- [gopensky](https://github.com/navidys/gopensky) - Go client implementation for [OpenSKY Network](https://opensky-network.org/) live's API (airspace ADS-B and Mode S data). +- [gosip](https://github.com/koltyakov/gosip) - Client library for SharePoint. - [gostorm](https://github.com/jsgilmore/gostorm) - GoStorm is a Go library that implements the communications protocol required to write Storm spouts and Bolts in Go that communicate with the Storm shells. - [hipchat](https://github.com/andybons/hipchat) - This project implements a golang client library for the Hipchat API. - [hipchat (xmpp)](https://github.com/daneharrigan/hipchat) - A golang package to communicate with HipChat over XMPP. - [igdb](https://github.com/Henry-Sarabia/igdb) - Go client for the [Internet Game Database API](https://api.igdb.com/). +- [ip2location-io-go](https://github.com/ip2location/ip2location-io-go) - Go wrapper for the IP2Location.io API [IP2Location.io](https://www.ip2location.io/). - [jokeapi-go](https://github.com/icelain/jokeapi) - Go client for [JokeAPI](https://sv443.net/jokeapi/v2/). - [lark](https://github.com/chyroc/lark) - [Feishu](https://open.feishu.cn/)/[Lark](https://open.larksuite.com/) Open API Go SDK, Support ALL Open API and Event Callback. - [lastpass-go](https://github.com/ansd/lastpass-go) - Go client library for the [LastPass](https://www.lastpass.com/) API. @@ -2479,6 +2657,7 @@ _Libraries for accessing third party APIs._ - [minio-go](https://github.com/minio/minio-go) - Minio Go Library for Amazon S3 compatible cloud storage. - [mixpanel](https://github.com/dukex/mixpanel) - Mixpanel is a library for tracking events and sending Mixpanel profile updates to Mixpanel from your go applications. - [newsapi-go](https://github.com/jellydator/newsapi-go) - Go client for [NewsAPI](https://newsapi.org/). +- [openaigo](https://github.com/otiai10/openaigo) - OpenAI GPT3/GPT3.5 ChatGPT API client library for Go. - [patreon-go](https://github.com/mxpv/patreon-go) - Go library for Patreon API. - [paypal](https://github.com/logpacker/PayPal-Go-SDK) - Wrapper for PayPal payment API. - [playlyfe](https://github.com/playlyfe/playlyfe-go-sdk) - The Playlyfe Rest API Go SDK. @@ -2492,6 +2671,7 @@ _Libraries for accessing third party APIs._ - [spotify](https://github.com/rapito/go-spotify) - Go Library to access Spotify WEB API. - [steam](https://github.com/sostronk/go-steam) - Go Library to interact with Steam game servers. - [stripe](https://github.com/stripe/stripe-go) - Go client for the Stripe API. +- [swag](https://github.com/zc2638/swag) - No comments, simple go wrapper to create swagger 2.0 compatible APIs. Support most routing frameworks, such as built-in, gin, chi, mux, echo, httprouter, fasthttp and more. - [textbelt](https://github.com/dietsche/textbelt) - Go client for the textbelt.com txt messaging API. - [translate](https://github.com/poorny/translate) - Go online translation package. - [Trello](https://github.com/adlio/trello) - Go wrapper for the Trello API. @@ -2513,7 +2693,6 @@ _General utilities and tools to make your life easier._ - [apm](https://github.com/topfreegames/apm) - Process manager for Golang applications with an HTTP API. - [backscanner](https://github.com/icza/backscanner) - A scanner similar to bufio.Scanner, but it reads and returns lines in reverse order, starting at a given position and going backward. -- [beyond](https://github.com/wesovilabs/beyond) - The Go tool that will drive you to the AOP world! - [blank](https://github.com/Henry-Sarabia/blank) - Verify or remove blanks and whitespace from strings. - [bleep](https://github.com/sinhashubham95/bleep) - Perform any number of actions on any set of OS signals in Go. - [boilr](https://github.com/tmrts/boilr) - Blazingly fast CLI tool for creating projects from boilerplate templates. @@ -2525,6 +2704,9 @@ _General utilities and tools to make your life easier._ - [clockwork](https://github.com/jonboulle/clockwork) - A simple fake clock for golang. - [cmd](https://github.com/SimonBaeumer/cmd) - Library for executing shell commands on osx, windows and linux. - [command](https://github.com/txgruppi/command) - Command pattern for Go with thread safe serial and parallel dispatcher. +- [config-file-validator](https://github.com/Boeing/config-file-validator) - Cross Platform tool to validate configuration files. +- [contextplus](https://github.com/contextplus/contextplus) - Package contextplus provide more easy to use functions for contexts. +- [cookie](https://github.com/syntaqx/cookie) - Cookie struct parsing and helper package. - [copy](https://github.com/gotidy/copy) - Package for fast copying structs of different types. - [copy-pasta](https://github.com/jutkko/copy-pasta) - Universal multi-workstation clipboard that uses S3 like backend for the storage. - [countries](https://github.com/biter777/countries) - Full implementation of ISO-3166-1, ISO-4217, ITU-T E.164, Unicode CLDR and IANA ccTLD standards. @@ -2538,11 +2720,13 @@ _General utilities and tools to make your life easier._ - [Death](https://github.com/vrecan/death) - Managing go application shutdown with signals. - [Deepcopier](https://github.com/ulule/deepcopier) - Simple struct copying for Go. - [delve](https://github.com/derekparker/delve) - Go debugger. +- [dive](https://github.com/wagoodman/dive) - A tool for exploring each layer in a Docker image. - [dlog](https://github.com/kirillDanshin/dlog) - Compile-time controlled logger to make your release smaller without removing debug calls. - [EaseProbe](https://github.com/megaease/easeprobe) - A simple, standalone, and lightWeight tool that can do health/status checking daemon, support HTTP/TCP/SSH/Shell/Client/... probes, and Slack/Discord/Telegram/SMS... notification. - [equalizer](https://github.com/reugn/equalizer) - Quota manager and rate limiter collection for Go. - [ergo](https://github.com/cristianoliveira/ergo) - The management of multiple local services running over different ports made easy. - [evaluator](https://github.com/nullne/evaluator) - Evaluate an expression dynamically based on s-expression. It's simple and easy to extend. +- [Failsafe-go](https://github.com/failsafe-go/failsafe-go) - Fault tolerance and resilience patterns for Go. - [filetype](https://github.com/h2non/filetype) - Small package to infer the file type checking the magic numbers signature. - [filler](https://github.com/yaronsumel/filler) - small utility to fill structs using "fill" tag. - [filter](https://github.com/gookit/filter) - provide filtering, sanitizing, and conversion of Go data. @@ -2551,6 +2735,7 @@ _General utilities and tools to make your life easier._ - [ghokin](https://github.com/antham/ghokin) - Parallelized formatter with no external dependencies for gherkin (cucumber, behat...). - [git-time-metric](https://github.com/git-time-metric/gtm) - Simple, seamless, lightweight time tracking for Git. - [gitbatch](https://github.com/isacikgoz/gitbatch) - manage your git repositories in one place. +- [gitcs](https://github.com/knbr13/gitcs/) - Git Commits Visualizer, CLI tool to visualize your Git commits on your local machine. - [go-actuator](https://github.com/sinhashubham95/go-actuator) - Production ready features for Go based web frameworks. - [go-astitodo](https://github.com/asticode/go-astitodo) - Parse TODOs in your GO code. - [go-bind-plugin](https://github.com/wendigo/go-bind-plugin) - go:generate tool for wrapping symbols exported by golang plugins (1.8 only). @@ -2562,11 +2747,13 @@ _General utilities and tools to make your life easier._ - [go-funk](https://github.com/thoas/go-funk) - Modern Go utility library which provides helpers (map, find, contains, filter, chunk, reverse, ...). - [go-health](https://github.com/Talento90/go-health) - Health package simplifies the way you add health check to your services. - [go-httpheader](https://github.com/mozillazg/go-httpheader) - Go library for encoding structs into Header fields. +- [go-lambda-cleanup](https://github.com/karl-cardenas-coding/go-lambda-cleanup) - A CLI for removing unused or previous versions of AWS Lambdas. - [go-lock](https://github.com/viney-shih/go-lock) - go-lock is a lock library implementing read-write mutex and read-write trylock without starvation. +- [go-pattern-match](https://github.com/PhakornKiong/go-pattern-match) - A Pattern matching library inspired by ts-pattern. - [go-pkg](https://github.com/chenquan/go-pkg) - A go toolkit. - [go-problemdetails](https://github.com/mvmaasakkers/go-problemdetails) - Go package for working with Problem Details. +- [go-qr](https://github.com/piglig/go-qr) - A native, high-quality and minimalistic QR code generator. - [go-rate](https://github.com/beefsack/go-rate) - Timed rate limiter for Go. -- [go-safe](https://github.com/kenkyu392/go-safe) - Panic-safe sandbox. - [go-sitemap-generator](https://github.com/ikeikeikeike/go-sitemap-generator) - XML Sitemap generator written in Go. - [go-trigger](https://github.com/sadlil/go-trigger) - Go-lang global event triggerer, Register Events with an id and trigger the event from anywhere from your project. - [go-type](https://github.com/mikekonan/go-types) - Library providing Go types for store/validation and transfer of ISO-4217, ISO-3166, and other types. @@ -2574,6 +2761,7 @@ _General utilities and tools to make your life easier._ - [goctx](https://github.com/zerosnake0/goctx) - Get your context value with high performance. - [godaemon](https://github.com/VividCortex/godaemon) - Utility to write daemons. - [godropbox](https://github.com/dropbox/godropbox) - Common libraries for writing Go services/applications from Dropbox. +- [gofn](https://github.com/tiendc/gofn) - High performance utility functions written using Generics for Go 1.18+. - [gohper](https://github.com/cosiner/gohper) - Various tools/modules help for development. - [golarm](https://github.com/msempere/golarm) - Fire alarms with system events. - [golog](https://github.com/mlimaloureiro/golog) - Easy and lightweight CLI tool to time track your tasks. @@ -2599,6 +2787,7 @@ _General utilities and tools to make your life easier._ - [intrinsic](https://github.com/mengzhuo/intrinsic) - Use x86 SIMD without writing any assembly code. - [jsend](https://github.com/clevergo/jsend) - JSend's implementation written in Go. - [jump](https://github.com/gsamokovarov/jump) - Jump helps you navigate faster by learning your habits. +- [just](https://github.com/kazhuravlev/just) - Just a collection of useful functions for working with generic data structures. - [koazee](https://github.com/wesovilabs/koazee) - Library inspired in Lazy evaluation and functional programming that takes the hassle out of working with arrays. - [lancet](https://github.com/duke-git/lancet) - A comprehensive, efficient, and reusable util function library of go. - [lets-go](https://github.com/aplescia-chwy/lets-go) - Go module that provides common utilities for Cloud Native REST API development. Also contains AWS Specific utilities. @@ -2616,7 +2805,7 @@ _General utilities and tools to make your life easier._ - [minquery](https://github.com/icza/minquery) - MongoDB / mgo.v2 query that supports efficient pagination (cursors to continue listing documents where we left off). - [moldova](https://github.com/StabbyCutyou/moldova) - Utility for generating random data based on an input template. - [mole](https://github.com/davrodpin/mole) - cli app to easily create ssh tunnels. -- [mongo-go-pagination](https://github.com/gobeam/mongo-go-pagination) - Mongodb Pagination for official mongodb/mongo-go-driver package which supports both normal queries and Aggregation pipelines. +- [mongo-go-pagination](https://github.com/gobeam/mongo-go-pagination) - Mongodb Pagination for official mongodb/mongo-go-driver package which supports both normal queries and Aggregation pipelines. - [mssqlx](https://github.com/linxGnu/mssqlx) - Database client library, proxy for any master slave, master master structures. Lightweight and auto balancing in mind. - [multitick](https://github.com/VividCortex/multitick) - Multiplexor for aligned tickers. - [myhttp](https://github.com/inancgumus/myhttp) - Simple API to make HTTP GET requests with timeout support. @@ -2628,7 +2817,7 @@ _General utilities and tools to make your life easier._ - [olaf](https://github.com/btnguyen2k/olaf) - Twitter Snowflake implemented in Go. - [onecache](https://github.com/adelowo/onecache) - Caching library with support for multiple backend stores (Redis, Memcached, filesystem etc). - [panicparse](https://github.com/maruel/panicparse) - Groups similar goroutines and colorizes stack dump. -- [pattern-match](https://github.com/alexpantyukhin/go-pattern-match) - Pattern matching libray. +- [pattern-match](https://github.com/alexpantyukhin/go-pattern-match) - Pattern matching library. - [peco](https://github.com/peco/peco) - Simplistic interactive filtering tool. - [pgo](https://github.com/arthurkushman/pgo) - Convenient functions for PHP community. - [pm](https://github.com/VividCortex/pm) - Process (i.e. goroutine) manager with an HTTP API. @@ -2645,6 +2834,7 @@ _General utilities and tools to make your life easier._ - [retry](https://github.com/percolate/retry) - A simple but highly configurable retry package for Go. - [retry](https://github.com/thedevsaddam/retry) - Simple and easy retry mechanism package for Go. - [retry](https://github.com/shafreeck/retry) - A pretty simple library to ensure your work to be done. +- [retry-go](https://github.com/avast/retry-go) - Simple library for retry mechanism. - [retry-go](https://github.com/rafaeljesus/retry-go) - Retrying made simple and easy for golang. - [robustly](https://github.com/VividCortex/robustly) - Runs functions resiliently, catching and restarting panics. - [rospo](https://github.com/ferama/rospo) - Simple and reliable ssh tunnels with embedded ssh server in Golang. @@ -2670,11 +2860,14 @@ _General utilities and tools to make your life easier._ - [toolbox](https://github.com/viant/toolbox) - Slice, map, multimap, struct, function, data conversion utilities. Service router, macro evaluator, tokenizer. - [ugo](https://github.com/alxrm/ugo) - ugo is slice toolbox with concise syntax for Go. - [UNIS](https://github.com/esemplastic/unis) - Common Architecture™ for String Utilities in Go. +- [upterm](https://github.com/owenthereal/upterm) - A tool for developers to share terminal/tmux sessions securely over the web. It’s perfect for remote pair programming, accessing computers behind NATs/firewalls, remote debugging, and more. - [usql](https://github.com/knq/usql) - usql is a universal command-line interface for SQL databases. - [util](https://github.com/shomali11/util) - Collection of useful utility functions. (strings, concurrency, manipulations, ...). +- [watchhttp](https://github.com/nikolaydubina/watchhttp) - Run command periodically and expose latest STDOUT or its rich delta as HTTP endpoint. - [wifiqr](https://github.com/reugn/wifiqr) - Wi-Fi QR Code Generator. - [wuzz](https://github.com/asciimoo/wuzz) - Interactive cli tool for HTTP inspection. - [xferspdy](https://github.com/monmohan/xferspdy) - Xferspdy provides binary diff and patch library in golang. +- [yogo](https://github.com/antham/yogo) - Check yopmail mails from command line. **[⬆ back to top](#contents)** @@ -2682,6 +2875,7 @@ _General utilities and tools to make your life easier._ _Libraries for working with UUIDs._ +- [fastuuid](https://github.com/rekby/fastuuid) - Fast generate UUIDv4 as string or bytes. - [goid](https://github.com/jakehl/goid) - Generate and Parse RFC4122 compliant V4 UUIDs. - [gouid](https://github.com/twharmon/gouid) - Generate cryptographically secure random string IDs with just one allocation. - [nanoid](https://github.com/aidarkhanov/nanoid) - A tiny and efficient Go unique string ID generator. @@ -2691,7 +2885,7 @@ _Libraries for working with UUIDs._ - [uuid](https://github.com/agext/uuid) - Generate, encode, and decode UUIDs v1 with fast or cryptographic-quality random node identifier. - [uuid](https://github.com/gofrs/uuid) - Implementation of Universally Unique Identifier (UUID). Supports both creation and parsing of UUIDs. Actively maintained fork of satori uuid. - [uuid](https://github.com/google/uuid) - Go package for UUIDs based on RFC 4122 and DCE 1.1: Authentication and Security Services. -- [wuid](https://github.com/edwingeng/wuid) - An extremely fast unique number generator, 10-135 times faster than UUID. +- [wuid](https://github.com/edwingeng/wuid) - An extremely fast globally unique number generator. - [xid](https://github.com/rs/xid) - Xid is a globally unique id generator library, ready to be safely used directly in your server code. **[⬆ back to top](#contents)** @@ -2701,17 +2895,19 @@ _Libraries for working with UUIDs._ _Libraries for validation._ - [checkdigit](https://github.com/osamingo/checkdigit) - Provide check digit algorithms (Luhn, Verhoeff, Damm) and calculators (ISBN, EAN, JAN, UPC, etc.). +- [go-validator](https://github.com/tiendc/go-validator) - Validation library using Generics. - [gody](https://github.com/guiferpa/gody) - :balloon: A lightweight struct validator for Go. - [govalid](https://github.com/twharmon/govalid) - Fast, tag-based validation for structs. - [govalidator](https://github.com/asaskevich/govalidator) - Validators and sanitizers for strings, numerics, slices and structs. - [govalidator](https://github.com/thedevsaddam/govalidator) - Validate Golang request data with simple rules. Highly inspired by Laravel's request validation. +- [hvalid](https://github.com/lyonnee/hvalid) hvalid is a lightweight validation library written in Go language. It provides a custom validator interface and a series of common validation functions to help developers quickly implement data validation. - [jio](https://github.com/faceair/jio) - jio is a json schema validator similar to [joi](https://github.com/hapijs/joi). - [ozzo-validation](https://github.com/go-ozzo/ozzo-validation) - Supports validation of various data types (structs, strings, maps, slices, etc.) with configurable and extensible validation rules specified in usual code constructs instead of struct tags. -- [terraform-validator](https://github.com/thazelart/terraform-validator) - A norms and conventions validator for Terraform. - [validate](https://github.com/gookit/validate) - Go package for data validation and filtering. support validate Map, Struct, Request(Form, JSON, url.Values, Uploaded Files) data and more features. - [validate](https://github.com/gobuffalo/validate) - This package provides a framework for writing validations for Go applications. - [validator](https://github.com/go-playground/validator) - Go Struct and Field validation, including Cross Field, Cross Struct, Map, Slice and Array diving. - [Validator](https://github.com/go-the-way/validator) - A lightweight model validator written in Go.Contains VFs:Min, Max, MinLength, MaxLength, Length, Enum, Regex. +- [valix](https://github.com/marrow16/valix) Go package for validating requests **[⬆ back to top](#contents)** @@ -2736,9 +2932,10 @@ _Libraries for version control._ _Libraries for manipulating video._ - [gmf](https://github.com/3d0c/gmf) - Go bindings for FFmpeg av\* libraries. +- [go-astiav](https://github.com/asticode/go-astiav) - Better C bindings for ffmpeg in GO. - [go-astisub](https://github.com/asticode/go-astisub) - Manipulate subtitles in GO (.srt, .stl, .ttml, .webvtt, .ssa/.ass, teletext, .smi, etc.). - [go-astits](https://github.com/asticode/go-astits) - Parse and demux MPEG Transport Streams (.ts) natively in GO. -- [go-m3u8](https://github.com/quangngotan95/go-m3u8) - Parser and generator library for Apple m3u8 playlists. +- [go-m3u8](https://github.com/etherlabsio/go-m3u8) - Parser and generator library for Apple m3u8 playlists. Actively maintained version of quangngotan95/go-m3u8 with improvements and latest HLS playlist parsing compatibility. - [go-mpd](https://github.com/unki2aut/go-mpd) - Parser and generator library for MPEG-DASH manifest files. - [goav](https://github.com/giorgisio/goav) - Comprehensive Go bindings for FFmpeg. - [gortsplib](https://github.com/aler9/gortsplib) - Pure Go RTSP server and client library. @@ -2759,15 +2956,19 @@ _Full stack web frameworks._ - [Air](https://github.com/aofei/air) - An ideally refined web framework for Go. - [anoweb](https://github.com/go-the-way/anoweb) - The lightweight and powerful web framework using the new way for Go.Another go the way. - [appy](https://github.com/appist/appy) - An opinionated productive web framework that helps scaling business easier. +- [Atreugo](https://github.com/savsgio/atreugo) - High performance and extensible micro web framework with zero memory allocations in hot paths. - [Banjo](https://github.com/nsheremet/banjo) - Very simple and fast web framework for Go. - [Beego](https://github.com/beego/beego) - beego is an open-source, high-performance web framework for the Go programming language. - [Buffalo](https://gobuffalo.io) - Bringing the productivity of Rails to Go! - [Confetti Framework](https://confetti-framework.github.io/docs/) - Confetti is a Go web application framework with an expressive, elegant syntax. Confetti combines the elegance of Laravel and the simplicity of Go. +- [Don](https://github.com/abemedia/go-don) - A highly performant and simple to use API framework. - [Echo](https://github.com/labstack/echo) - High performance, minimalist Go web framework. +- [Fastschema](https://github.com/fastschema/fastschema) - A flexible Go web framework and Headless CMS. - [Fiber](https://github.com/gofiber/fiber) - An Express.js inspired web framework build on Fasthttp. - [Fireball](https://github.com/zpatrick/fireball) - More "natural" feeling web framework. - [Flamingo](https://github.com/i-love-flamingo/flamingo) - Framework for pluggable web projects. Including a concept for modules and offering features for DI, Configareas, i18n, template engines, graphql, observability, security, events, routing & reverse routing etc. - [Flamingo Commerce](https://github.com/i-love-flamingo/flamingo-commerce) - Providing e-commerce features using clean architecture like DDD and ports and adapters, that you can use to build flexible e-commerce applications. +- [Fuego](https://github.com/go-fuego/fuego) - The framework for busy Go developers! Web framework generating OpenAPI 3 spec from source code. - [Gearbox](https://github.com/abahmed/gearbox) - A web framework written in Go with a focus on high performance and memory optimization. - [Gin](https://github.com/gin-gonic/gin) - Gin is a web framework written in Go! It features a martini-like API with much better performance, up to 40 times faster. If you need performance and good productivity. - [Ginrpc](https://github.com/xxjwxc/ginrpc) - Gin parameter automatic binding tool,gin rpc tools. @@ -2776,23 +2977,30 @@ _Full stack web frameworks._ - [go-rest](https://github.com/ungerik/go-rest) - Small and evil REST framework for Go. - [Goa](https://github.com/goadesign/goa) - Goa provides a holistic approach for developing remote APIs and microservices in Go. - [goa](https://github.com/goa-go/goa) - goa is just like koajs for golang, it is a flexible, light, high-performance and extensible web framework based on middleware. +- [GoFr](https://github.com/gofr-dev/gofr) - Gofr is an opinionated microservice development framework. +- [GoFrame](https://github.com/gogf/gf) - GoFrame is a modular, powerful, high-performance and enterprise-class application development framework of Golang. - [golamb](https://github.com/twharmon/golamb) - Golamb makes it easier to write API endpoints for use with AWS Lambda and API Gateway. - [Golax](https://github.com/fulldump/golax) - A non Sinatra fast HTTP framework with support for Google custom methods, deep interceptors, recursion and more. - [Golf](https://github.com/dinever/golf) - Golf is a fast, simple and lightweight micro-web framework for Go. It comes with powerful features and has no dependencies other than the Go Standard Library. - [Gondola](https://github.com/rainycape/gondola) - The web framework for writing faster sites, faster. +- [Gone](https://github.com/gone-io/gone) - A lightweight dependency injection and web framework inspired by Spring. - [gongular](https://github.com/mustafaakin/gongular) - Fast Go web framework with input mapping/validation and (DI) Dependency Injection. - [GoTuna](https://github.com/gotuna/gotuna) - Minimalistic web framework for Go with mux router, middlewares, sessions, templates, embedded views and static files. - [goweb](https://github.com/twharmon/goweb) - Web framework with routing, websockets, logging, middleware, static file server (optional gzip), and automatic TLS. - [Goyave](https://github.com/go-goyave/goyave) - Feature-complete REST API framework aimed at clean code and fast development, with powerful built-in functionalities. +- [Hertz](https://github.com/cloudwego/hertz) - A high-performance and strong-extensibility Go HTTP framework that helps developers build microservices. - [hiboot](https://github.com/hidevopsio/hiboot) - hiboot is a high performance web application framework with auto configuration and dependency injection support. - [Huma](https://github.com/danielgtaylor/huma/) - Framework for modern REST/GraphQL APIs with built-in OpenAPI 3, generated documentation, and a CLI. +- [Lit](https://github.com/jvcoutinho/lit) - Highly performant declarative web framework for Golang, aiming for simplicity and quality of life. - [Macaron](https://github.com/go-macaron/macaron) - Macaron is a high productive and modular design web framework in Go. - [mango](https://github.com/paulbellamy/mango) - Mango is a modular web-application framework for Go, inspired by Rack, and PEP333. - [Microservice](https://github.com/claygod/microservice) - The framework for the creation of microservices, written in Golang. - [neo](https://github.com/ivpusic/neo) - Neo is minimal and fast Go Web Framework with extremely simple API. - [patron](https://github.com/beatlabs/patron) - Patron is a microservice framework following best cloud practices with a focus on productivity. +- [Pnutmux](https://gitlab.com/fruitygo/pnutmux) - Pnutmux is a powerful Go web framework that uses regex for matching and handling HTTP requests. It offers features such as CORS handling, structured logging, URL parameters extraction, middlewares, and concurrency limiting. +- [Pulse](https://github.com/gopulse/pulse) - Pulse is an HTTP web framework written in Go (Golang) - [Resoursea](https://github.com/resoursea/api) - REST framework for quickly writing resource based services. -- [REST Layer](https://rest-layer.io) - Framework to build REST/GraphQL API on top of databases with mostly configuration over code. +- [REST Layer](https://github.com/rs/rest-layer) - Framework to build REST/GraphQL API on top of databases with mostly configuration over code. - [Revel](https://github.com/revel/revel) - High-productivity web framework for the Go language. - [rex](https://github.com/goanywhere/rex) - Rex is a library for modular development built upon gorilla/mux, fully compatible with `net/http`. - [rk-boot](https://github.com/rookie-ninja/rk-boot) - A bootstrapper library for building enterprise go microservice with Gin and gRPC quickly and easily. @@ -2804,6 +3012,7 @@ _Full stack web frameworks._ - [vox](https://github.com/aisk/vox) - A golang web framework for humans, inspired by Koa heavily. - [WebGo](https://github.com/bnkamalesh/webgo) - A micro-framework to build web apps; with handler chaining, middleware and context injection. With standard library compliant HTTP handlers(i.e. http.HandlerFunc). - [YARF](https://github.com/yarf-framework/yarf) - Fast micro-framework designed to build REST APIs and web services in a fast and simple way. +- [Yokai](https://github.com/ankorstore/yokai) - Simple, modular, and observable Go framework for backend applications. **[⬆ back to top](#contents)** @@ -2825,13 +3034,11 @@ _Full stack web frameworks._ - [Tollbooth](https://github.com/didip/tollbooth) - Rate limit HTTP request handler. - [XFF](https://github.com/sebest/xff) - Handle `X-Forwarded-For` header and friends. - #### Libraries for creating HTTP middlewares - [alice](https://github.com/justinas/alice) - Painless middleware chaining for Go. - [catena](https://github.com/codemodus/catena) - http.Handler wrapper catenation (same API as "chain"). - [chain](https://github.com/codemodus/chain) - Handler wrapper chaining with scoped data (net/context-based "middleware"). -- [go-wrap](https://github.com/go-on/wrap) - Small middlewares package for net/http. - [gores](https://github.com/alioygur/gores) - Go package that handles HTML, JSON, XML and etc. responses. Useful for RESTful APIs. - [interpose](https://github.com/carbocation/interpose) - Minimalist net/http middleware for golang. - [mediary](https://github.com/HereMobilityDevelopers/mediary) - add interceptors to `http.Client` to allow dumping/shaping/tracing/... of requests/responses. @@ -2879,6 +3086,7 @@ _Full stack web frameworks._ ## WebAssembly - [dom](https://github.com/dennwc/dom) - DOM library. +- [Extism Go SDK](https://github.com/extism/go-sdk) - Universal, cross-language WebAssembly framework for building plug-in systems and polyglot apps. - [go-canvas](https://github.com/markfarnan/go-canvas) - Library to use HTML5 Canvas, with all drawing within go code. - [tinygo](https://github.com/tinygo-org/tinygo) - Go compiler for small places. Microcontrollers, WebAssembly, and command-line tools. Based on LLVM. - [vert](https://github.com/norunners/vert) - Interop between Go and JS values. @@ -2921,7 +3129,9 @@ _Source code analysis tools, also known as Static Application Security Testing ( - [apicompat](https://github.com/bradleyfalzon/apicompat) - Checks recent changes to a Go project for backwards incompatible changes. - [asty](https://github.com/asty-org/asty) - Converts golang AST to JSON and JSON to AST. +- [blanket](https://gitlab.com/verygoodsoftwarenotvirus/blanket) - blanket is a tool that helps you catch functions which don't have direct unit tests in your Go packages. - [ChainJacking](https://github.com/Checkmarx/chainjacking) - Find which of your Go lang direct GitHub dependencies is susceptible to ChainJacking attack. +- [Chronos](https://github.com/amit-davidson/Chronos) - Detects race conditions statically - [dupl](https://github.com/mibk/dupl) - Tool for code clone detection. - [errcheck](https://github.com/kisielk/errcheck) - Errcheck is a program for checking for unchecked errors in Go programs. - [gcvis](https://github.com/davecheney/gcvis) - Visualise Go program GC trace data in real time. @@ -2931,24 +3141,23 @@ _Source code analysis tools, also known as Static Application Security Testing ( - [go-mod-outdated](https://github.com/psampaz/go-mod-outdated) - An easy way to find outdated dependencies of your Go projects. - [go-outdated](https://github.com/firstrow/go-outdated) - Console application that displays outdated packages. - [goast-viewer](https://github.com/yuroyoro/goast-viewer) - Web based Golang AST visualizer. -- [GoCover.io](https://gocover.io/) - GoCover.io offers the code coverage of any golang package as a service. -- [goimports](https://godoc.org/golang.org/x/tools/cmd/goimports) - Tool to fix (add, remove) your Go imports automatically. +- [goimports](https://pkg.go.dev/golang.org/x/tools/cmd/goimports) - Tool to fix (add, remove) your Go imports automatically. - [golang-ifood-sdk](https://github.com/arxdsilva/golang-ifood-sdk) - iFood API SDK. +- [golangci-lint](https://github.com/golangci/golangci-lint) – A fast Go linters runner. It runs linters in parallel, uses caching, supports `yaml` config, has integrations with all major IDE and has dozens of linters included. - [golines](https://github.com/segmentio/golines) - Formatter that automatically shortens long lines in Go code. -- [GoLint](https://github.com/golang/lint) - Golint is a linter for Go source code. - [GoPlantUML](https://github.com/jfeliu007/goplantuml) - Library and CLI that generates text plantump class diagram containing information about structures and interfaces with the relationship among them. - [goreturns](https://sourcegraph.com/github.com/sqs/goreturns) - Adds zero-value return statements to match the func return types. -- [gosimple](https://github.com/dominikh/go-tools/tree/master/cmd/gosimple) - gosimple is a linter for Go source code that specialises on simplifying code. - [gostatus](https://github.com/shurcooL/gostatus) - Command line tool, shows the status of repositories that contain Go packages. - [lint](https://github.com/surullabs/lint) - Run linters as part of go test. - [php-parser](https://github.com/z7zmey/php-parser) - A Parser for PHP written in Go. +- [revive](https://github.com/mgechev/revive) – ~6x faster, stricter, configurable, extensible, and beautiful drop-in replacement for `golint`. - [staticcheck](https://github.com/dominikh/go-tools/tree/master/cmd/staticcheck) - staticcheck is `go vet` on steroids, applying a ton of static analysis checks you might be used to from tools like ReSharper for C#. -- [tarp](https://github.com/verygoodsoftwarenotvirus/tarp) - tarp finds functions and methods without direct unit tests in Go source code. +- [testifylint](https://github.com/Antonboom/testifylint) – A linter that checks usage of [github.com/stretchr/testify](https://github.com/stretchr/testify). - [tickgit](https://github.com/augmentable-dev/tickgit) - CLI and go package for surfacing code comment TODOs (in any language) and applying a `git blame`to identify the author. - [todocheck](https://github.com/preslavmihaylov/todocheck) - Static code analyser which links TODO comments in code with issues in your issue tracker. - [unconvert](https://github.com/mdempsky/unconvert) - Remove unnecessary type conversions from Go source. -- [unused](https://github.com/dominikh/go-tools/tree/master/cmd/unused) - unused checks Go code for unused constants, variables, functions and types. - [usestdlibvars](https://github.com/sashamelentyev/usestdlibvars) - A linter that detect the possibility to use variables/constants from the Go standard library. +- [vacuum](https://github.com/daveshanley/vacuum) - An ultra-super-fast, lightweight OpenAPI linter and quality checking tool. - [validate](https://github.com/mccoyst/validate) - Automatically validates struct fields with tags. **[⬆ back to top](#contents)** @@ -2978,6 +3187,7 @@ _Plugin for text editors and IDEs._ ## Go Generate Tools +- [envdoc](https://github.com/g4s8/envdoc) - generate documentation for environment variables from Go source files. - [generic](https://github.com/usk81/generic) - flexible data type for Go. - [genny](https://github.com/cheekybits/genny) - Elegant generics for Go. - [gocontracts](https://github.com/Parquery/gocontracts) - brings design-by-contract to Go by synchronizing the code with the documentation. @@ -2986,7 +3196,9 @@ _Plugin for text editors and IDEs._ - [gotests](https://github.com/cweill/gotests) - Generate Go tests from your source code. - [gounit](https://github.com/hexdigest/gounit) - Generate Go tests using your own templates. - [hasgo](https://github.com/DylanMeeus/hasgo) - Generate Haskell inspired functions for your slices. -- [re2dfa](https://github.com/opennota/re2dfa) - Transform regular expressions into finite state machines and output Go source code. +- [options-gen](https://github.com/kazhuravlev/options-gen) - Functional options described by Dave Cheney's post "Functional options for friendly APIs". +- [re2dfa](https://gitlab.com/opennota/re2dfa) - Transform regular expressions into finite state machines and output Go source code. +- [sqlgen](https://github.com/anqiansong/sqlgen) - Generate gorm, xorm, sqlx, bun, sql code from SQL file or DSN. - [TOML-to-Go](https://xuri.me/toml-to-go) - Translates TOML into a Go type in the browser instantly. - [xgen](https://github.com/xuri/xgen) - XSD (XML Schema Definition) parser and Go/C/Java/Rust/TypeScript code generator. @@ -2995,12 +3207,11 @@ _Plugin for text editors and IDEs._ ## Go Tools - [colorgo](https://github.com/songgao/colorgo) - Wrapper around `go` command for colorized `go build` output. +- [decouple](https://github.com/bobg/decouple) - Find “overspecified” function parameters that could be generalized with interface types. - [depth](https://github.com/KyleBanks/depth) - Visualize dependency trees of any package by analyzing imports. - [docs](https://github.com/go-oas/docs) - Automatically generate RESTful API documentation for GO projects - aligned with Open API Specification standard. -- [generator-go-lang](https://github.com/axelspringer/generator-go-lang) - A [Yeoman](https://yeoman.io) generator to get new Go projects started. - [go-callvis](https://github.com/TrueFurby/go-callvis) - Visualize call graph of your Go program using dot format. -- [go-james](https://github.com/pieterclaerhout/go-james) - Go project skeleton creator, builds and tests your projects without the manual setup. -- [go-pkg-complete](https://github.com/skelterjohn/go-pkg-complete) - Bash completion for go and wgo. +- [go-size-analyzer](https://github.com/Zxilly/go-size-analyzer) - Analyze and visualize the size of dependencies in compiled Golang binaries, providing insight into their impact on the final build. - [go-swagger](https://github.com/go-swagger/go-swagger) - Swagger 2.0 implementation for go. Swagger is a simple yet powerful representation of your RESTful API. - [godbg](https://github.com/tylerwince/godbg) - Implementation of Rusts `dbg!` macro for quick and easy debugging during development. - [gomodrun](https://github.com/dustinblackman/gomodrun/) - Go tool that executes and caches binaries included in go.mod files. @@ -3013,8 +3224,10 @@ _Plugin for text editors and IDEs._ - [richgo](https://github.com/kyoh86/richgo) - Enrich `go test` outputs with text decorations. - [roumon](https://github.com/becheran/roumon) - Monitor current state of all active goroutines via a command line interface. - [rts](https://github.com/galeone/rts) - RTS: response to struct. Generates Go structs from server responses. +- [textra](https://github.com/ravsii/textra) - Extract Go struct field names, types and tags for filtering and exporting. - [typex](https://github.com/dtgorski/typex) - Examine Go types and their transitive dependencies, alternatively export results as TypeScript value objects (or types) declaration. + **[⬆ back to top](#contents)** ## Software Packages @@ -3035,7 +3248,9 @@ _Software written in Go._ - [bosun](https://github.com/bosun-monitor/bosun) - Time Series Alerting Framework. - [cassowary](https://github.com/rogerwelin/cassowary) - Modern cross-platform HTTP load-testing tool written in Go. - [Ddosify](https://github.com/ddosify/ddosify) - High-performance load testing tool, written in Golang. +- [decompose](https://github.com/s0rg/decompose) - tool to generate and process Docker containers connections graphs. - [DepCharge](https://github.com/centerorbit/depcharge) - Helps orchestrating the execution of commands across the many dependencies in larger projects. +- [Docker](https://www.docker.com/) - Open platform for distributed applications for developers and sysadmins. - [docker-go-mingw](https://github.com/x1unix/docker-go-mingw) - Docker image for building Go binaries for Windows with MinGW toolchain. - [Dockerfile-Generator](https://github.com/ozankasikci/dockerfile-generator) - A go library and an executable that produces valid Dockerfiles using various input channels. - [dogo](https://github.com/liudng/dogo) - Monitoring changes in the source file and automatically compile and run (restart). @@ -3044,6 +3259,7 @@ _Software written in Go._ - [Dropship](https://github.com/chrismckenzie/dropship) - Tool for deploying code via cdn. - [easyssh-proxy](https://github.com/appleboy/easyssh-proxy) - Golang package for easy remote execution through SSH and SCP downloading via `ProxyCommand`. - [fac](https://github.com/mkchoi212/fac) - Command-line user interface to fix git merge conflicts. +- [Flannel](https://github.com/flannel-io/flannel) - Flannel is a network fabric for containers, designed for Kubernetes. - [Fleet device management](https://github.com/fleetdm/fleet) - Lightweight, programmable telemetry for servers and workstations. - [gaia](https://github.com/gaia-pipeline/gaia) - Build powerful pipelines in any programming language. - [ghorg](https://github.com/gabrie30/ghorg) - Quickly clone an entire org/users repositories into one directory - Supports GitHub, GitLab, Gitea, and Bitbucket. @@ -3053,6 +3269,7 @@ _Software written in Go._ - [go-rocket-update](https://github.com/mouuff/go-rocket-update) - A simple way to make self updating Go applications - Supports Github and Gitlab. - [go-selfupdate](https://github.com/sanbornm/go-selfupdate) - Enable your Go applications to self update. - [gobrew](https://github.com/cryptojuice/gobrew) - gobrew lets you easily switch between multiple versions of go. +- [gobrew](https://github.com/kevincobain2000/gobrew) - Go version manager. Super simple tool to install and manage Go versions. Install go without root. Gobrew doesn't require shell rehash. - [godbg](https://github.com/sirnewton01/godbg) - Web-based gdb front-end application. - [Gogs](https://gogs.io/) - A Self Hosted Git Service in the Go Programming Language. - [gonative](https://github.com/inconshreveable/gonative) - Tool which creates a build of Go that can cross compile to all platforms while still using the Cgo-enabled versions of the stdlib packages. @@ -3064,22 +3281,33 @@ _Software written in Go._ - [Hey](https://github.com/rakyll/hey) - Hey is a tiny program that sends some load to a web application. - [httpref](https://github.com/dnnrly/httpref) - httpref is a handy CLI reference for HTTP methods, status codes, headers, and TCP and UDP ports. - [jcli](https://github.com/jenkins-zh/jenkins-cli) - Jenkins CLI allows you manage your Jenkins as an easy way. +- [k3d](https://github.com/k3d-io/k3d) - Little helper to run CNCF's k3s in Docker. +- [k3s](https://github.com/k3s-io/k3s) - Lightweight Kubernetes. +- [k6](https://github.com/grafana/k6) - A modern load testing tool, using Go and JavaScript. - [kala](https://github.com/ajvb/kala) - Simplistic, modern, and performant job scheduler. - [kcli](https://github.com/cswank/kcli) - Command line tool for inspecting kafka topics/partitions/messages. +- [kind](https://github.com/kubernetes-sigs/kind) - Kubernetes IN Docker - local clusters for testing Kubernetes. - [ko](https://github.com/google/ko) - Command line tool for building and deploying Go applications on Kubernetes - [kool](https://github.com/kool-dev/kool) - Command line tool for managing Docker environments as an easy way. +- [kubeblocks](https://github.com/apecloud/kubeblocks) - KubeBlocks is an open-source control plane that runs and manages databases, message queues and other data infrastructure on K8s. - [kubernetes](https://github.com/kubernetes/kubernetes) - Container Cluster Manager from Google. +- [kubeshark](https://github.com/kubeshark/kubeshark) - API traffic analyzer for Kubernetes, inspired by Wireshark, purposely built for Kubernetes. +- [KubeVela](https://github.com/kubevela/kubevela) - Cloud native application delivery. +- [KubeVPN](https://github.com/kubenetworks/kubevpn) - KubeVPN offers a Cloud-Native Dev Environment that seamlessly connects to your Kubernetes cluster network. +- [KusionStack](https://github.com/KusionStack/kusion) - A unified programmable configuration techstack to deliver modern app in 'platform as code' and 'infra as code' approach. - [kwatch](https://github.com/abahmed/kwatch) - Monitor & detect crashes in your Kubernetes(K8s) cluster instantly. - [lstags](https://github.com/ivanilves/lstags) - Tool and API to sync Docker images across different registries. - [lwc](https://github.com/timdp/lwc) - A live-updating version of the UNIX wc command. - [manssh](https://github.com/xwjdsh/manssh) - manssh is a command line tool for managing your ssh alias config easily. - [Mantil](https://github.com/mantil-io/mantil) - Go specific framework for building serverless applications on AWS that enables you to focus on pure Go code while Mantil takes care of the infrastructure. -- [Mizu](https://github.com/up9inc/mizu) - API traffic viewer for Kubernetes enabling you to view all API communication between microservices, multiprotocol support: HTTP1.1, HTTP/2, AMQP, Kafka, Redis. +- [minikube](https://github.com/kubernetes/minikube) - Run Kubernetes locally. - [Moby](https://github.com/moby/moby) - Collaborative project for the container ecosystem to assemble container-based systems. - [Mora](https://github.com/emicklei/mora) - REST server for accessing MongoDB documents and meta data. - [ostent](https://github.com/ostrost/ostent) - collects and displays system metrics and optionally relays to Graphite and/or InfluxDB. - [Packer](https://github.com/mitchellh/packer) - Packer is a tool for creating identical machine images for multiple platforms from a single source configuration. - [Pewpew](https://github.com/bengadbois/pewpew) - Flexible HTTP command line stress tester. +- [PipeCD](https://github.com/pipe-cd/pipecd) - A GitOps-style continuous delivery platform that provides consistent deployment and operations experience for any applications. +- [podinfo](https://github.com/stefanprodan/podinfo) - Podinfo is a tiny web application made with Go that showcases best practices of running microservices in Kubernetes. Podinfo is used by CNCF projects like Flux and Flagger for end-to-end testing and workshops. - [Pomerium](https://github.com/pomerium/pomerium) - Pomerium is an identity-aware access proxy. - [Rodent](https://github.com/alouche/rodent) - Rodent helps you manage Go versions, projects and track dependencies. - [s3-proxy](https://github.com/oxyno-zeta/s3-proxy) - S3 Proxy with GET, PUT and DELETE methods and authentication (OpenID Connect and Basic Auth). @@ -3090,7 +3318,10 @@ _Software written in Go._ - [sg](https://github.com/ChristopherRabotin/sg) - Benchmarks a set of HTTP endpoints (like ab), with possibility to use the response code and data between each call for specific server stress based on its previous response. - [skm](https://github.com/TimothyYe/skm) - SKM is a simple and powerful SSH Keys Manager, it helps you to manage your multiple SSH keys easily! - [StatusOK](https://github.com/sanathp/statusok) - Monitor your Website and REST APIs.Get Notified through Slack, E-mail when your server is down or response time is more than expected. +- [tau](https://github.com/taubyte/tau) - Easily build Cloud Computing Platforms with features like Serverless WebAssembly Functions, Frontend Hosting, CI/CD, Object Storage, K/V Database, and Pub-Sub Messaging. - [terraform-provider-openapi](https://github.com/dikhan/terraform-provider-openapi) - Terraform provider plugin that dynamically configures itself at runtime based on an OpenAPI document (formerly known as swagger file) containing the definitions of the APIs exposed. +- [tf-profile](https://github.com/datarootsio/tf-profile) - Profiler for Terraform runs. Generate global stats, resource-level stats or visualizations. +- [tlm](https://github.com/yusufcanb/tlm) - Local cli copilot, powered by CodeLLaMa - [traefik](https://github.com/containous/traefik) - Reverse proxy and load balancer with support for multiple backends. - [trubka](https://github.com/xitonix/trubka) - A CLI tool to manage and troubleshoot Apache Kafka clusters with the ability of generically publishing/consuming protocol buffer and plain text events to/from Kafka. - [uTask](https://github.com/ovh/utask) - Automation engine that models and executes business processes declared in yaml. @@ -3114,11 +3345,11 @@ _Software written in Go._ - [confd](https://github.com/kelseyhightower/confd) - Manage local application configuration files using templates and data from etcd or consul. - [crawley](https://github.com/s0rg/crawley) - Web scraper/crawler for cli. - [croc](https://github.com/schollz/croc) - Easily and securely send files or folders from one computer to another. -- [Docker](https://www.docker.com/) - Open platform for distributed applications for developers and sysadmins. - [Documize](https://github.com/documize/community) - Modern wiki software that integrates data from SaaS tools. - [dp](https://github.com/scryinfo/dp) - Through SDK for data exchange with blockchain, developers can get easy access to DAPP development. - [drive](https://github.com/odeke-em/drive) - Google Drive client for the commandline. - [Duplicacy](https://github.com/gilbertchen/duplicacy) - A cross-platform network and cloud backup tool based on the idea of lock-free deduplication. +- [fjira](https://github.com/mk-5/fjira) - A fuzzy-search based terminal UI application for Attlasian Jira - [Gebug](https://github.com/moshebe/gebug) - A tool that makes debugging of Dockerized Go applications super easy by enabling Debugger and Hot-Reload features, seamlessly. - [gfile](https://github.com/Antonito/gfile) - Securely transfer files between two computers, without any third party, over WebRTC. - [Go Package Store](https://github.com/shurcooL/Go-Package-Store) - App that displays updates for the Go packages in your GOPATH. @@ -3129,9 +3360,11 @@ _Software written in Go._ - [GoDocTooltip](https://github.com/diankong/GoDocTooltip) - Chrome extension for Go Doc sites, which shows function description as tooltip at function list. - [Gokapi](https://github.com/Forceu/gokapi) - Lightweight server to share files, which expire after a set amount of downloads or days. Similar to Firefox Send, but without public upload. - [GoLand](https://jetbrains.com/go) - Full featured cross-platform Go IDE. +- [GoNB](https://github.com/janpfeifer/gonb) - Interactive Go programming with Jupyter Notebooks (also works in VSCode, Binder and Google's Colab). - [Gor](https://github.com/buger/gor) - Http traffic replication tool, for replaying traffic from production to stage/dev environments in real-time. - [Guora](https://github.com/meloalright/guora) - A self-hosted Quora like web application written in Go. - [hoofli](https://github.com/dnnrly/hoofli) - Generate PlantUML diagrams from Chrome or Firefox network inspections. +- [hotswap](https://github.com/edwingeng/hotswap) - A complete solution to reload your go code without restarting your server, interrupting or blocking any ongoing procedure. - [hugo](https://gohugo.io/) - Fast and Modern Static Website Engine. - [ide](https://github.com/thestrukture/ide) - Browser accessible IDE. Designed for Go with Go. - [ipe](https://github.com/dimiro1/ipe) - Open source Pusher server implementation compatible with Pusher client libraries written in GO. @@ -3149,13 +3382,13 @@ _Software written in Go._ - [Orbit](https://github.com/gulien/orbit) - A simple tool for running commands and generating files from templates. - [peg](https://github.com/pointlander/peg) - Peg, Parsing Expression Grammar, is an implementation of a Packrat parser generator. - [Plik](https://github.com/root-gg/plik) - Plik is a temporary file upload system (Wetransfer like) in Go. +- [portal](https://github.com/SpatiumPortae/portal) - Portal is a quick and easy command-line file transfer utility from any computer to another. - [protoncheck](https://github.com/servusdei2018/protoncheck) - ProtonMail module for waybar/polybar/yabar/i3blocks. - [restic](https://github.com/restic/restic) - De-duplicating backup program. - [sake](https://github.com/alajmo/sake) - sake is a command runner for local and remote hosts. - [scc](https://github.com/boyter/scc) - Sloc Cloc and Code, a very fast accurate code counter with complexity calculations and COCOMO estimates. - [Seaweed File System](https://github.com/chrislusf/seaweedfs) - Fast, Simple and Scalable Distributed File System with O(1) disk seek. - [shell2http](https://github.com/msoap/shell2http) - Executing shell commands via http server (for prototyping or remote control). -- [snap](https://github.com/intelsdi-x/snap) - Powerful telemetry framework. - [Snitch](https://github.com/lucasgomide/snitch) - Simple way to notify your team and many tools when someone has deployed any application via Tsuru. - [Stack Up](https://github.com/pressly/sup) - Stack Up, a super simple deployment tool - just Unix - think of it like 'make' for a network of servers. - [stew](https://github.com/marwanhawari/stew) - An independent package manager for compiled binaries. @@ -3167,8 +3400,11 @@ _Software written in Go._ - [tsuru](https://tsuru.io/) - Extensible and open source Platform as a Service software. - [vaku](https://github.com/lingrino/vaku) - CLI & API for folder-based functions in Vault like copy, move, and search. - [vFlow](https://github.com/VerizonDigital/vflow) - High-performance, scalable and reliable IPFIX, sFlow and Netflow collector. +- [Wave Terminal](https://waveterm.dev) - Wave is an open-source, AI-native terminal built for seamless developer workflows with inline rendering, a modern UI, and persistent sessions. - [wellington](https://github.com/wellington/wellington) - Sass project management tool, extends the language with sprite functions (like Compass). - [woke](https://github.com/get-woke/woke) - Detect non-inclusive language in your source code. +- [yai](https://github.com/ekkinox/yai) - AI powered terminal assistant. +- [zs](https://git.mills.io/prologic/zs) - an extremely minimal static site generator. **[⬆ back to top](#contents)** @@ -3189,6 +3425,7 @@ _Where to discover new Go libraries._ - [go-web-framework-benchmark](https://github.com/smallnest/go-web-framework-benchmark) - Go web framework benchmark. - [go_serialization_benchmarks](https://github.com/alecthomas/go_serialization_benchmarks) - Benchmarks of Go serialization methods. - [gocostmodel](https://github.com/PuerkitoBio/gocostmodel) - Benchmarks of common basic operations for the Go language. +- [golang-benchmarks](https://github.com/SimonWaldherr/golang-benchmarks) - a collection of golang benchmarks. - [golang-sql-benchmark](https://github.com/tyler-smith/golang-sql-benchmark) - Collection of benchmarks for popular Go database/SQL utilities. - [gospeed](https://github.com/feyeleanor/GoSpeed) - Go micro-benchmarks for calculating the speed of language constructs. - [kvbench](https://github.com/jimrobinson/kvbench) - Key/Value database benchmark. @@ -3199,8 +3436,6 @@ _Where to discover new Go libraries._ ## Conferences -- [Capital Go](http://www.capitalgolang.com) - Washington, D.C., USA. -- [dotGo](https://www.dotgo.eu) - Paris, France. - [GoCon](https://gocon.connpass.com/) - Tokyo, Japan. - [GoDays](https://www.godays.io/) - Berlin, Germany. - [GoLab](https://golab.io/) - Florence, Italy. @@ -3209,7 +3444,7 @@ _Where to discover new Go libraries._ - [GopherCon Australia](https://gophercon.com.au/) - Sydney, Australia. - [GopherCon Brazil](https://gopherconbr.org) - Florianópolis, Brazil. - [GopherCon Europe](https://gophercon.eu/) - Berlin, Germany. -- [GopherCon India](https://www.gophercon.in/) - Pune, India. +- [GopherCon India](https://gopherconindia.org/) - Pune, India. - [GopherCon Israel](https://www.gophercon.org.il/) - Tel Aviv, Israel. - [GopherCon Russia](https://www.gophercon-russia.ru) - Moscow, Russia. - [GopherCon Singapore](https://gophercon.sg) - Mapletree Business City, Singapore. @@ -3224,10 +3459,16 @@ _Where to discover new Go libraries._ ### E-books for purchase - [100 Go Mistakes: How to Avoid Them](https://www.manning.com/books/100-go-mistakes-how-to-avoid-them) +- [Black Hat Go](https://nostarch.com/blackhatgo) - Go programming for hackers and pentesters. - [Build an Orchestrator in Go](https://www.manning.com/books/build-an-orchestrator-in-go) - [Continuous Delivery in Go](https://www.manning.com/books/continuous-delivery-in-go) - This practical guide to continuous delivery shows you how to rapidly establish an automated pipeline that will improve your testing, code quality, and final product. +- [Creative DIY Microcontroller Project With TinyGo and WebAssembly](https://www.packtpub.com/product/creative-diy-microcontroller-projects-with-tinygo-and-webassembly/9781800560208) - An introduction into the TinyGo compiler with projects involving Arduino and WebAssembly. +- [Effective Go: Elegant, efficient, and testable code](https://www.manning.com/books/effective-go) - Unlock Go’s unique perspective on program design, and start writing simple, maintainable, and testable Go code. - [For the Love of Go](https://bitfieldconsulting.com/books/love) - An introductory book for Go beginners. +- [Go in Practice, Second Edition](https://www.manning.com/books/go-in-practice-second-edition) - Your practical guide on the ins-and-outs of Go development, covering the standard library and the most important tools from Go’s powerful ecosystem. - [Know Go: Generics](https://bitfieldconsulting.com/books/generics) - A guide to understanding and using generics in Go. +- [Lets-Go](https://lets-go.alexedwards.net) - A step-by-step guide to creating fast, secure and maintanable web applications with Go. +- [Lets-Go-Further](https://lets-go-further.alexedwards.net) - Advanced patterns for building APIs and web applications in Go. - [The Power of Go: Tests](https://bitfieldconsulting.com/books/tests) - A guide to testing in Go. - [The Power of Go: Tools](https://bitfieldconsulting.com/books/tools) - A guide to writing command-line tools in Go. - [Writing A Compiler In Go](https://compilerbook.com) @@ -3240,8 +3481,10 @@ _Where to discover new Go libraries._ - [Build Web Application with Golang](https://astaxie.gitbooks.io/build-web-application-with-golang/content/en/) - [Building Web Apps With Go](https://codegangsta.gitbooks.io/building-web-apps-with-go/content/) - [Go 101](https://go101.org) - A book focusing on Go syntax/semantics and all kinds of details. -- [Go Bootcamp](http://golangbootcamp.com) +- [Go AST Book (Chinese)](https://github.com/chai2010/go-ast-book) - A book focusing on Go `go/*` packages. +- [Go Faster](https://leanpub.com/gofaster) - This book seeks to shorten your learning curve and help you become a proficient Go programmer, faster. - [Go Succinctly](https://github.com/thedevsir/gosuccinctly) - in Persian. +- [Go with the domain](https://threedots.tech/go-with-the-domain/) - A book showing how to apply DDD, Clean Architecture, and CQRS by practical refactoring. - [GoBooks](https://github.com/dariubs/GoBooks) - A curated list of Go books. - [How To Code in Go eBook](https://www.digitalocean.com/community/books/how-to-code-in-go-ebook) - A 600 page introduction to Go aimed at first time developers. - [Learning Go](https://www.miek.nl/downloads/Go/Learning-Go-latest.pdf) @@ -3277,6 +3520,7 @@ _Where to discover new Go libraries._ - [Belgrade Golang Meetup](https://www.meetup.com/golang-serbia/) - [Berlin Golang](https://www.meetup.com/golang-users-berlin/) - [Brisbane Gophers](https://www.meetup.com/Brisbane-Golang-Meetup/) +- [Bärner Go Meetup - Berne, Switzerland](https://www.meetup.com/berner-go-meetup/) - [Canberra Gophers](https://www.meetup.com/Canberra-Gophers/) - [Go Language NYC](https://www.meetup.com/golanguagenewyork/) - [Go London User Group](https://www.meetup.com/Go-London-User-Group/) @@ -3310,11 +3554,11 @@ _Where to discover new Go libraries._ - [Golang Lyon](https://www.meetup.com/Golang-Lyon/) - [Golang Marseille](https://www.meetup.com/fr-FR/Golang-Marseille/) - [Golang Melbourne](https://www.meetup.com/golang-mel/) -- [Golang Mountain View](https://www.meetup.com/Golang-Mountain-View/) - [Golang North East](https://www.meetup.com/en-AU/Golang-North-East/) - [Golang Paris](https://www.meetup.com/Golang-Paris/) - [Golang Poland](https://www.meetup.com/Golang-Poland/) - [Golang Pune](https://www.meetup.com/Golang-Pune/) +- [Golang Rotterdam](https://www.meetup.com/golang-rotterdam/) - [Golang Singapore](https://www.meetup.com/golangsg/) - [Golang Stockholm](https://www.meetup.com/Go-Stockholm/) - [Golang Sydney, AU](https://www.meetup.com/golang-syd/) @@ -3324,17 +3568,17 @@ _Where to discover new Go libraries._ - [Golang Turkey](https://kommunity.com/goturkiye) - [Golang Vancouver, BC](https://www.meetup.com/golangvan/) - [Golang Vienna, Austria](https://www.meetup.com/viennago/) -- [Golang Казань](https://www.meetup.com/GolangKazan/) - [Golang Москва](https://www.meetup.com/Golang-Moscow/) -- [Golang Питер](https://www.meetup.com/Golang-Peter/) - [GoSF - San Francisco, CA](https://www.meetup.com/golangsf) - [Istanbul Golang](https://www.meetup.com/Istanbul-Golang/) +- [Lagos Gophers](https://www.meetup.com/GolangNigeria/) - [Seattle Go Programmers](https://www.meetup.com/golang/) - [Ukrainian Golang User Groups](https://www.meetup.com/uagolang/) - [Utah Go User Group](https://www.meetup.com/utahgophers/) - [Women Who Go - San Francisco, CA](https://www.meetup.com/Women-Who-Go/) +- [Zürich Gophers - Zurich, Switzerland](https://www.meetup.com/zurich-gophers/) -*Add the group of your city/country here (send **PR**)* +_Add the group of your city/country here (send **PR**)_ **[⬆ back to top](#contents)** @@ -3343,9 +3587,10 @@ _Where to discover new Go libraries._ - [bahlo/go-styleguide](https://github.com/bahlo/go-styleguide) - [CockroachDB](https://github.com/cockroachdb/cockroach/blob/master/docs/style.md) - [GitLab](https://docs.gitlab.com/ee/development/go_guide/) +- [Google](https://google.github.io/styleguide/go/) - [Hyperledger](https://github.com/hyperledger/fabric/blob/release-1.4/docs/source/style-guides/go-style.rst) - [Magnetico](https://github.com/boramalper/magnetico/wiki/magnetico-Design-Specification) -- [Sourcegraph](https://about.sourcegraph.com/handbook/engineering/go_style_guide) +- [Sourcegraph](https://docs.sourcegraph.com/dev/background-information/languages/go) - [Thanos](https://thanos.io/tip/contributing/coding-style-guide.md/) - [Trybe](https://github.com/betrybe/playbook-go/blob/main/README_EN.md) - [Uber](https://github.com/uber-go/guide/blob/master/style.md) @@ -3356,6 +3601,7 @@ _Where to discover new Go libraries._ ### Twitter +- [@GoDiscussions](https://twitter.com/GoDiscussions) - [@golang](https://twitter.com/golang) - [@golang_news](https://twitter.com/golang_news) - [@golangch](https://twitter.com/golangch) @@ -3380,6 +3626,7 @@ _Where to discover new Go libraries._ - [Code with Mukesh](https://codewithmukesh.com/blog/category/golang) - Software Engineer and Blogs @ codewithmukesh.com. - [Coding Mystery](https://codingmystery.com) - Solve exciting escape-room-inspired programming challenges using Go. - [CodinGame](https://www.codingame.com/) - Learn Go by solving interactive tasks using small games as practical examples. +- [Explore Go Libraries & Projects](https://kandi.openweaver.com/explore/go) - Discover & find a curated list of popular & new Go libraries, top authors, trending project kits, discussions, tutorials & learning resources on kandi. - [Go Blog](https://blog.golang.org) - The official Go blog. - [Go Code Club](https://www.youtube.com/watch?v=nvoIPQYdx9g&list=PLEcwzBXTPUE_YQR7R0BRtHBYJ0LN3Y0i3) - A group of Gophers read and discuss a different Go project every week. - [Go Community on Hashnode](https://hashnode.com/n/go) - Community of Gophers on Hashnode. @@ -3389,21 +3636,21 @@ _Where to discover new Go libraries._ - [Go Report Card](https://goreportcard.com) - A report card for your Go package. - [go.dev](https://go.dev/) - A hub for Go developers. - [gocryforhelp](https://github.com/ninedraft/gocryforhelp) - Collection of Go projects that needs help. Good place to start your open-source way in Go. -- [godoc.org](https://godoc.org/) - Documentation for open source Go packages. - [Golang Developer Jobs](https://golangjob.xyz) - Developer Jobs exclusively for Golang related Roles. - [Golang Flow](https://golangflow.io) - Post Updates, News, Packages and more. - [Golang News](https://golangnews.com) - Links and news about Go programming. - [Golang Resources](https://golangresources.com) - A curation of the best articles, exercises, talks and videos to learn Go. +- [Golang Weekly](https://discu.eu/weekly/golang/) - Each monday projects, tutorials and articles about Go. - [golang-graphics](https://github.com/mholt/golang-graphics) - Collection of Go images, graphics, and art. - [golang-nuts](https://groups.google.com/forum/#!forum/golang-nuts) - Go mailing list. - [Google Plus Community](https://plus.google.com/communities/114112804251407510571) - The Google+ community for #golang enthusiasts. - [Gopher Community Chat](https://invite.slack.golangbridge.org) - Join Our New Slack Community For Gophers ([Understand how it came](https://blog.gopheracademy.com/gophers-slack-community/)). - [Gophercises](https://gophercises.com/) - Free coding exercises for budding gophers. -- [gowalker.org](https://gowalker.org) - Go Project API documentation. - [json2go](https://m-zajac.github.io/json2go) - Advanced JSON to Go struct conversion - online tool. -- [justforfunc](https://www.youtube.com/c/justforfunc) - Youtube channel dedicated to Go programming language tips and tricks, hosted by Francesc Campoy [@francesc](https://twitter.com/francesc). +- [justforfunc](https://www.youtube.com/c/justforfunc) - Youtube channel dedicated to Go programming language tips and tricks, hosted by Francesc Campoy [@francesc](https://twitter.com/francesc). - [Learn Go Programming](https://blog.learngoprogramming.com) - Learn Go concepts with illustrations. - [Made with Golang](https://madewithgolang.com/?ref=awesome-go) +- [pkg.go.dev](https://pkg.go.dev/) - Documentation for open source Go packages. - [r/Golang](https://www.reddit.com/r/golang) - News about Go. - [studygolang](https://studygolang.com) - The community of studygolang in China. - [Trending Go repositories on GitHub today](https://github.com/trending?l=go) - Good place to find new Go libraries. @@ -3414,14 +3661,16 @@ _Where to discover new Go libraries._ ### Tutorials - [50 Shades of Go](https://devs.cloudimmunity.com/gotchas-and-common-mistakes-in-go-golang/) - Traps, Gotchas, and Common Mistakes for New Golang Devs. +- [A Comprehensive Guide to Structured Logging in Go](https://betterstack.com/community/guides/logging/logging-in-go/) - Delve deep into the world of structured logging in Go with a specific focus on recently accepted slog proposal which aims to bring high performance structured logging with levels to the standard library. - [A Guide to Golang E-Commerce](https://snipcart.com/blog/golang-ecommerce-ponzu-cms-demo?utm_term=golang-ecommerce-ponzu-cms-demo) - Building a Golang site for e-commerce (demo included). - [A Tour of Go](https://tour.golang.org/) - Interactive tour of Go. +- [Build a Database in 1000 lines of code]( https://link.medium.com/O9YQlx89Htb) - Build a NoSQL Database From Zero in 1000 Lines of Code. - [Build web application with Golang](https://github.com/astaxie/build-web-application-with-golang) - Golang ebook intro how to build a web app with golang. - [Building and Testing a REST API in Go with Gorilla Mux and PostgreSQL](https://semaphoreci.com/community/tutorials/building-and-testing-a-rest-api-in-go-with-gorilla-mux-and-postgresql) - We’ll write an API with the help of the powerful Gorilla Mux. - [Building Go Web Applications and Microservices Using Gin](https://semaphoreci.com/community/tutorials/building-go-web-applications-and-microservices-using-gin) - Get familiar with Gin and find out how it can help you reduce boilerplate code and build a request handling pipeline. - [Caching Slow Database Queries](https://medium.com/@rocketlaunchr.cloud/caching-slow-database-queries-1085d308a0c9) - How to cache slow database queries. - [Canceling MySQL](https://medium.com/@rocketlaunchr.cloud/canceling-mysql-in-go-827ed8f83b30) - How to cancel MySQL queries. -- [CodeCrafters Golang Track](https://app.codecrafters.io/tracks/go) — Achieve mastery in advanced Go by building your own Redis, Docker, Git, and SQLite. Featuring goroutines, systems programming, file I/O, and more. +- [CodeCrafters Golang Track](https://app.codecrafters.io/tracks/go) - Achieve mastery in advanced Go by building your own Redis, Docker, Git, and SQLite. Featuring goroutines, systems programming, file I/O, and more. - [Debugged.it Go patterns](https://github.com/haveyoudebuggedit/go-patterns) - Advanced Go patterns with ready-to-run examples. - [Design Patterns in Go](https://github.com/shubhamzanwar/design-patterns) - Collection of programming design patterns implemented in Go. - [Ethereum Development with Go](https://github.com/miguelmota/ethereum-development-with-go-book) - A little e-book on Ethereum Development with Go. @@ -3429,6 +3678,7 @@ _Where to discover new Go libraries._ - [Go By Example](https://gobyexample.com/) - Hands-on introduction to Go using annotated example programs. - [Go Cheat Sheet](https://github.com/a8m/go-lang-cheat-sheet) - Go's reference card. - [Go database/sql tutorial](http://go-database-sql.org/) - Introduction to database/sql. +- [Go in 7 days](https://github.com/harrytran103/7_days_of_go) - Learn everything about Go in 7 days (from a Nodejs developer). - [Go Language Tutorial](https://www.javatpoint.com/go-tutorial) - Learn Go language Tutorial. - [Go Tutorial](https://www.tutorialspoint.com/go/index.htm) - Learn Go programming. - [Go WebAssembly Tutorial - Building a Simple Calculator](https://tutorialedge.net/golang/go-webassembly-tutorial/) @@ -3442,17 +3692,29 @@ _Where to discover new Go libraries._ - [GopherSnippets](https://gophersnippets.com/) - Code snippets with tests and testable examples for the Go programming language. - [Gosamples](https://gosamples.dev/) - Collection of code snippets that let you solve everyday code problems. - [Hackr.io](https://hackr.io/tutorials/learn-golang) - Learn Go from the best online golang tutorials submitted & voted by the golang programming community. +- [Hex Monscape](https://github.com/Haraj-backend/hex-monscape) - Getting started guidelines in writing maintainable code using Hexagonal Architecture. - [How to Benchmark: dbq vs sqlx vs GORM](https://medium.com/@rocketlaunchr.cloud/how-to-benchmark-dbq-vs-sqlx-vs-gorm-e814caacecb5) - Learn how to benchmark in Go. As a case-study, we will benchmark dbq, sqlx and GORM. - [How To Deploy a Go Web Application with Docker](https://semaphoreci.com/community/tutorials/how-to-deploy-a-go-web-application-with-docker) - Learn how to use Docker for Go development and how to build production Docker images. - [How to Use Godog for Behavior-driven Development in Go](https://semaphoreci.com/community/tutorials/how-to-use-godog-for-behavior-driven-development-in-go) - Get started with Godog — a Behavior-driven development framework for building and testing Go applications. - [Learn Go with 1000+ Exercises](https://github.com/inancgumus/learngo) - Learn Go with thousands of examples, exercises, and quizzes. - [Learn Go with TDD](https://github.com/quii/learn-go-with-tests) - Learn Go with test-driven development. -- [Learning Go by examples](https://dev.to/aurelievache/learning-go-by-examples-introduction-448n) - Serie of article in order to learn Golang language by concrete applications as example. +- [Learning Go by examples](https://dev.to/aurelievache/learning-go-by-examples-introduction-448n) - Series of articles in order to learn Golang language by concrete applications as example. +- [Microservices with Go](https://www.youtube.com/playlist?list=PLmD8u-IFdreyh6EUfevBcbiuCKzFk0EW_) - Dive deep into building microservices using Go, including gRPC. - [package main](https://www.youtube.com/packagemain) - YouTube channel about Programming in Go. - [Programming with Google Go](https://www.coursera.org/specializations/google-golang) - Coursera Specialization to learn about Go from scratch. - [Saving a Third of Our Memory by Re-ordering Go Struct Fields](https://qvault.io/golang/struct-field-ordering-memory/) - How inefficient field ordering in Go structs. +- [Scaling Go Applications](https://betterstack.com/community/guides/scaling-go/) - Everything about building, deploying and scaling Go applications in production. - [The world’s easiest introduction to WebAssembly with Golang](https://medium.com/@martinolsansky/webassembly-with-golang-is-fun-b243c0e34f02) +- [Understanding Go in a visual way](https://dev.to/aurelievache/series/26234) - Learn Go visually +- [W3basic Go Tutorials](https://www.w3basic.com/golang/) - W3Basic provides an in-depth tutorial and well-organized content to learn Golang programming. - [Working with Go](https://github.com/mkaz/working-with-go) - Intro to go for experienced programmers. - [Your basic Go](https://yourbasic.org/golang) - Huge collection of tutorials and how to's. **[⬆ back to top](#contents)** + +### Guided Learning + +- [The Go Developer Roadmap](https://roadmap.sh/golang) - A visual roadmap that new Go developers can follow through to help them learn Go. +- [The Go Learning Path](https://tutorialedge.net/paths/golang/) - A guided learning path containing a mix of free and premium resources. + +**[⬆ back to top](#contents)** diff --git a/go.mod b/go.mod index 6dbeadfc..9c0a0c9a 100644 --- a/go.mod +++ b/go.mod @@ -1,19 +1,22 @@ module github.com/avelino/awesome-go -go 1.17 +go 1.21 require ( - github.com/PuerkitoBio/goquery v1.8.0 + github.com/PuerkitoBio/goquery v1.8.1 github.com/avelino/slugify v0.0.0-20180501145920-855f152bd774 - github.com/yuin/goldmark v1.4.13 - golang.org/x/oauth2 v0.0.0-20211104180415-d3ed0bb246c8 + github.com/otiai10/copy v1.14.0 + github.com/yuin/goldmark v1.6.0 + golang.org/x/oauth2 v0.15.0 ) require ( github.com/andybalholm/cascadia v1.3.1 // indirect - github.com/golang/protobuf v1.4.2 // indirect - golang.org/x/net v0.0.0-20210916014120-12bc252f5db8 // indirect - golang.org/x/text v0.3.6 // indirect - google.golang.org/appengine v1.6.6 // indirect - google.golang.org/protobuf v1.25.0 // indirect + github.com/golang/protobuf v1.5.3 // indirect + golang.org/x/net v0.23.0 // indirect + golang.org/x/sync v0.3.0 // indirect + golang.org/x/sys v0.18.0 // indirect + golang.org/x/text v0.14.0 // indirect + google.golang.org/appengine v1.6.7 // indirect + google.golang.org/protobuf v1.33.0 // indirect ) diff --git a/go.sum b/go.sum index df7d0ed4..95538c17 100644 --- a/go.sum +++ b/go.sum @@ -1,376 +1,68 @@ -cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= -cloud.google.com/go v0.34.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= -cloud.google.com/go v0.38.0/go.mod h1:990N+gfupTy94rShfmMCWGDn0LpTmnzTp2qbd1dvSRU= -cloud.google.com/go v0.44.1/go.mod h1:iSa0KzasP4Uvy3f1mN/7PiObzGgflwredwwASm/v6AU= -cloud.google.com/go v0.44.2/go.mod h1:60680Gw3Yr4ikxnPRS/oxxkBccT6SA1yMk63TGekxKY= -cloud.google.com/go v0.45.1/go.mod h1:RpBamKRgapWJb87xiFSdk4g1CME7QZg3uwTez+TSTjc= -cloud.google.com/go v0.46.3/go.mod h1:a6bKKbmY7er1mI7TEI4lsAkts/mkhTSZK8w33B4RAg0= -cloud.google.com/go v0.50.0/go.mod h1:r9sluTvynVuxRIOHXQEHMFffphuXHOMZMycpNR5e6To= -cloud.google.com/go v0.52.0/go.mod h1:pXajvRH/6o3+F9jDHZWQ5PbGhn+o8w9qiu/CffaVdO4= -cloud.google.com/go v0.53.0/go.mod h1:fp/UouUEsRkN6ryDKNW/Upv/JBKnv6WDthjR6+vze6M= -cloud.google.com/go v0.54.0/go.mod h1:1rq2OEkV3YMf6n/9ZvGWI3GWw0VoqH/1x2nd8Is/bPc= -cloud.google.com/go v0.56.0/go.mod h1:jr7tqZxxKOVYizybht9+26Z/gUq7tiRzu+ACVAMbKVk= -cloud.google.com/go v0.57.0/go.mod h1:oXiQ6Rzq3RAkkY7N6t3TcE6jE+CIBBbA36lwQ1JyzZs= -cloud.google.com/go v0.62.0/go.mod h1:jmCYTdRCQuc1PHIIJ/maLInMho30T/Y0M4hTdTShOYc= -cloud.google.com/go v0.65.0/go.mod h1:O5N8zS7uWy9vkA9vayVHs65eM1ubvY4h553ofrNHObY= -cloud.google.com/go/bigquery v1.0.1/go.mod h1:i/xbL2UlR5RvWAURpBYZTtm/cXjCha9lbfbpx4poX+o= -cloud.google.com/go/bigquery v1.3.0/go.mod h1:PjpwJnslEMmckchkHFfq+HTD2DmtT67aNFKH1/VBDHE= -cloud.google.com/go/bigquery v1.4.0/go.mod h1:S8dzgnTigyfTmLBfrtrhyYhwRxG72rYxvftPBK2Dvzc= -cloud.google.com/go/bigquery v1.5.0/go.mod h1:snEHRnqQbz117VIFhE8bmtwIDY80NLUZUMb4Nv6dBIg= -cloud.google.com/go/bigquery v1.7.0/go.mod h1://okPTzCYNXSlb24MZs83e2Do+h+VXtc4gLoIoXIAPc= -cloud.google.com/go/bigquery v1.8.0/go.mod h1:J5hqkt3O0uAFnINi6JXValWIb1v0goeZM77hZzJN/fQ= -cloud.google.com/go/datastore v1.0.0/go.mod h1:LXYbyblFSglQ5pkeyhO+Qmw7ukd3C+pD7TKLgZqpHYE= -cloud.google.com/go/datastore v1.1.0/go.mod h1:umbIZjpQpHh4hmRpGhH4tLFup+FVzqBi1b3c64qFpCk= -cloud.google.com/go/pubsub v1.0.1/go.mod h1:R0Gpsv3s54REJCy4fxDixWD93lHJMoZTyQ2kNxGRt3I= -cloud.google.com/go/pubsub v1.1.0/go.mod h1:EwwdRX2sKPjnvnqCa270oGRyludottCI76h+R3AArQw= -cloud.google.com/go/pubsub v1.2.0/go.mod h1:jhfEVHT8odbXTkndysNHCcx0awwzvfOlguIAii9o8iA= -cloud.google.com/go/pubsub v1.3.1/go.mod h1:i+ucay31+CNRpDW4Lu78I4xXG+O1r/MAHgjpRVR+TSU= -cloud.google.com/go/storage v1.0.0/go.mod h1:IhtSnM/ZTZV8YYJWCY8RULGVqBDmpoyjwiyrjsg+URw= -cloud.google.com/go/storage v1.5.0/go.mod h1:tpKbwo567HUNpVclU5sGELwQWBDZ8gh0ZeosJ0Rtdos= -cloud.google.com/go/storage v1.6.0/go.mod h1:N7U0C8pVQ/+NIKOBQyamJIeKQKkZ+mxpohlUTyfDhBk= -cloud.google.com/go/storage v1.8.0/go.mod h1:Wv1Oy7z6Yz3DshWRJFhqM/UCfaWIRTdp0RXyy7KQOVs= -cloud.google.com/go/storage v1.10.0/go.mod h1:FLPqc6j+Ki4BU591ie1oL6qBQGu2Bl/tZ9ullr3+Kg0= -dmitri.shuralyov.com/gpu/mtl v0.0.0-20190408044501-666a987793e9/go.mod h1:H6x//7gZCb22OMCxBHrMx7a5I7Hp++hsVxbQ4BYO7hU= -github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= -github.com/BurntSushi/xgb v0.0.0-20160522181843-27f122750802/go.mod h1:IVnqGOEym/WlBOVXweHU+Q+/VP0lqqI8lqeDx9IjBqo= -github.com/PuerkitoBio/goquery v1.8.0 h1:PJTF7AmFCFKk1N6V6jmKfrNH9tV5pNE6lZMkG0gta/U= -github.com/PuerkitoBio/goquery v1.8.0/go.mod h1:ypIiRMtY7COPGk+I/YbZLbxsxn9g5ejnI2HSMtkjZvI= +github.com/PuerkitoBio/goquery v1.8.1 h1:uQxhNlArOIdbrH1tr0UXwdVFgDcZDrZVdcpygAcwmWM= +github.com/PuerkitoBio/goquery v1.8.1/go.mod h1:Q8ICL1kNUJ2sXGoAhPGUdYDJvgQgHzJsnnd3H7Ho5jQ= github.com/andybalholm/cascadia v1.3.1 h1:nhxRkql1kdYCc8Snf7D5/D3spOX+dBgjA6u8x004T2c= github.com/andybalholm/cascadia v1.3.1/go.mod h1:R4bJ1UQfqADjvDa4P6HZHLh/3OxWWEqc0Sk8XGwHqvA= github.com/avelino/slugify v0.0.0-20180501145920-855f152bd774 h1:HrMVYtly2IVqg9EBooHsakQ256ueojP7QuG32K71X/U= github.com/avelino/slugify v0.0.0-20180501145920-855f152bd774/go.mod h1:5wi5YYOpfuAKwL5XLFYopbgIl/v7NZxaJpa/4X6yFKE= -github.com/census-instrumentation/opencensus-proto v0.2.1/go.mod h1:f6KPmirojxKA12rnyqOA5BBL4O983OfeGPqjHWSTneU= -github.com/chzyer/logex v1.1.10/go.mod h1:+Ywpsq7O8HXn0nuIou7OrIPyXbp3wmkHB+jjWRnGsAI= -github.com/chzyer/readline v0.0.0-20180603132655-2972be24d48e/go.mod h1:nSuG5e5PlCu98SY8svDHJxuZscDgtXS6KTTbou5AhLI= -github.com/chzyer/test v0.0.0-20180213035817-a1ea475d72b1/go.mod h1:Q3SI9o4m/ZMnBNeIyt5eFwwo7qiLfzFZmjNmxjkiQlU= -github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw= -github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f/go.mod h1:M8M6+tZqaGXZJjfX53e64911xZQV5JYwmTeXPW+k8Sc= -github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= -github.com/envoyproxy/go-control-plane v0.9.0/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4= -github.com/envoyproxy/go-control-plane v0.9.1-0.20191026205805-5f8ba28d4473/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4= -github.com/envoyproxy/go-control-plane v0.9.4/go.mod h1:6rpuAdCZL397s3pYoYcLgu1mIlRU8Am5FuJP05cCM98= -github.com/envoyproxy/protoc-gen-validate v0.1.0/go.mod h1:iSmxcyjqTsJpI2R4NaDN7+kN2VEUnK/pcBlmesArF7c= -github.com/go-gl/glfw v0.0.0-20190409004039-e6da0acd62b1/go.mod h1:vR7hzQXu2zJy9AVAgeJqvqgH9Q5CA+iKCZ2gyEVpxRU= -github.com/go-gl/glfw/v3.3/glfw v0.0.0-20191125211704-12ad95a8df72/go.mod h1:tQ2UAYgL5IevRw8kRxooKSPJfGvJ9fJQFa0TUsXzTg8= -github.com/go-gl/glfw/v3.3/glfw v0.0.0-20200222043503-6f7a984d4dc4/go.mod h1:tQ2UAYgL5IevRw8kRxooKSPJfGvJ9fJQFa0TUsXzTg8= -github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b/go.mod h1:SBH7ygxi8pfUlaOkMMuAQtPIUF8ecWP5IEl/CR7VP2Q= -github.com/golang/groupcache v0.0.0-20190702054246-869f871628b6/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= -github.com/golang/groupcache v0.0.0-20191227052852-215e87163ea7/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= -github.com/golang/groupcache v0.0.0-20200121045136-8c9f03a8e57e/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= -github.com/golang/mock v1.1.1/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A= -github.com/golang/mock v1.2.0/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A= -github.com/golang/mock v1.3.1/go.mod h1:sBzyDLLjw3U8JLTeZvSv8jJB+tU5PVekmnlKIyFUx0Y= -github.com/golang/mock v1.4.0/go.mod h1:UOMv5ysSaYNkG+OFQykRIcU/QvvxJf3p21QfJ2Bt3cw= -github.com/golang/mock v1.4.1/go.mod h1:UOMv5ysSaYNkG+OFQykRIcU/QvvxJf3p21QfJ2Bt3cw= -github.com/golang/mock v1.4.3/go.mod h1:UOMv5ysSaYNkG+OFQykRIcU/QvvxJf3p21QfJ2Bt3cw= -github.com/golang/mock v1.4.4/go.mod h1:l3mdAwkq5BuhzHwde/uurv3sEJeZMXNpwsxVWU71h+4= -github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= -github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= -github.com/golang/protobuf v1.3.3/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw= -github.com/golang/protobuf v1.3.4/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw= -github.com/golang/protobuf v1.3.5/go.mod h1:6O5/vntMXwX2lRkT1hjjk0nAC1IDOTvTlVgjlRvqsdk= -github.com/golang/protobuf v1.4.0-rc.1/go.mod h1:ceaxUfeHdC40wWswd/P6IGgMaK3YpKi5j83Wpe3EHw8= -github.com/golang/protobuf v1.4.0-rc.1.0.20200221234624-67d41d38c208/go.mod h1:xKAWHe0F5eneWXFV3EuXVDTCmh+JuBKY0li0aMyXATA= -github.com/golang/protobuf v1.4.0-rc.2/go.mod h1:LlEzMj4AhA7rCAGe4KMBDvJI+AwstrUpVNzEA03Pprs= -github.com/golang/protobuf v1.4.0-rc.4.0.20200313231945-b860323f09d0/go.mod h1:WU3c8KckQ9AFe+yFwt9sWVRKCVIyN9cPHBJSNnbL67w= -github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvqG2KuDX0= -github.com/golang/protobuf v1.4.1/go.mod h1:U8fpvMrcmy5pZrNK1lt4xCsGvpyWQ/VVv6QDs8UjoX8= -github.com/golang/protobuf v1.4.2 h1:+Z5KGCizgyZCbGh1KZqA0fcLLkwbsjIzS4aV2v7wJX0= -github.com/golang/protobuf v1.4.2/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI= -github.com/google/btree v0.0.0-20180813153112-4030bb1f1f0c/go.mod h1:lNA+9X1NB3Zf8V7Ke586lFgjr2dZNuvo3lPJSGZ5JPQ= -github.com/google/btree v1.0.0/go.mod h1:lNA+9X1NB3Zf8V7Ke586lFgjr2dZNuvo3lPJSGZ5JPQ= -github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M= -github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= -github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= -github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= -github.com/google/go-cmp v0.4.1/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= -github.com/google/go-cmp v0.5.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= -github.com/google/go-cmp v0.5.1 h1:JFrFEBb2xKufg6XkJsJr+WbKb4FQlURi5RUcBveYu9k= -github.com/google/go-cmp v0.5.1/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= -github.com/google/martian v2.1.0+incompatible/go.mod h1:9I4somxYTbIHy5NJKHRl3wXiIaQGbYVAs8BPL6v8lEs= -github.com/google/martian/v3 v3.0.0/go.mod h1:y5Zk1BBys9G+gd6Jrk0W3cC1+ELVxBWuIGO+w/tUAp0= -github.com/google/pprof v0.0.0-20181206194817-3ea8567a2e57/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc= -github.com/google/pprof v0.0.0-20190515194954-54271f7e092f/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc= -github.com/google/pprof v0.0.0-20191218002539-d4f498aebedc/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM= -github.com/google/pprof v0.0.0-20200212024743-f11f1df84d12/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM= -github.com/google/pprof v0.0.0-20200229191704-1ebb73c60ed3/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM= -github.com/google/pprof v0.0.0-20200430221834-fc25d7d30c6d/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM= -github.com/google/pprof v0.0.0-20200708004538-1a94d8640e99/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM= -github.com/google/renameio v0.1.0/go.mod h1:KWCgfxg9yswjAJkECMjeO8J8rahYeXnNhOm40UhjYkI= -github.com/googleapis/gax-go/v2 v2.0.4/go.mod h1:0Wqv26UfaUD9n4G6kQubkQ+KchISgw+vpHVxEJEs9eg= -github.com/googleapis/gax-go/v2 v2.0.5/go.mod h1:DWXyrwAJ9X0FpwwEdw+IPEYBICEFu5mhpdKc/us6bOk= -github.com/hashicorp/golang-lru v0.5.0/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8= -github.com/hashicorp/golang-lru v0.5.1/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8= -github.com/ianlancetaylor/demangle v0.0.0-20181102032728-5e5cf60278f6/go.mod h1:aSSvb/t6k1mPoxDqO4vJh6VOCGPwU4O0C2/Eqndh1Sc= -github.com/jstemmer/go-junit-report v0.0.0-20190106144839-af01ea7f8024/go.mod h1:6v2b51hI/fHJwM22ozAgKL4VKDeJcHhJFhtBdhmNjmU= -github.com/jstemmer/go-junit-report v0.9.1/go.mod h1:Brl9GWCQeLvo8nXZwPNNblvFj/XSXhF0NWZEnDohbsk= -github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck= -github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo= -github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= -github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI= -github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= -github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA= -github.com/rogpeppe/go-internal v1.3.0/go.mod h1:M8bDsm7K2OlrFYOpmOWEs/qY81heoFRclV5y23lUDJ4= -github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= -github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4= -github.com/yuin/goldmark v1.1.25/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= -github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= -github.com/yuin/goldmark v1.1.32/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= -github.com/yuin/goldmark v1.4.13 h1:fVcFKWvrslecOb/tg+Cc05dkeYx540o0FuFt3nUVDoE= +github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk= +github.com/golang/protobuf v1.5.3 h1:KhyjKVUg7Usr/dYsdSqoFveMYd5ko72D+zANwlG1mmg= +github.com/golang/protobuf v1.5.3/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY= +github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/go-cmp v0.5.9 h1:O2Tfq5qg4qc4AmwVlvv0oLiVAGB7enBSJ2x2DqQFi38= +github.com/google/go-cmp v0.5.9/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= +github.com/otiai10/copy v1.14.0 h1:dCI/t1iTdYGtkvCuBG2BgR6KZa83PTclw4U5n2wAllU= +github.com/otiai10/copy v1.14.0/go.mod h1:ECfuL02W+/FkTWZWgQqXPWZgW9oeKCSQ5qVfSc4qc4w= +github.com/otiai10/mint v1.5.1 h1:XaPLeE+9vGbuyEHem1JNk3bYc7KKqyI/na0/mLd/Kks= +github.com/otiai10/mint v1.5.1/go.mod h1:MJm72SBthJjz8qhefc4z1PYEieWmy8Bku7CjcAqyUSM= github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= -go.opencensus.io v0.21.0/go.mod h1:mSImk1erAIZhrmZN+AvHh14ztQfjbGwt4TtuofqLduU= -go.opencensus.io v0.22.0/go.mod h1:+kGneAE2xo2IficOXnaByMWTGM9T73dGwxeWcUqIpI8= -go.opencensus.io v0.22.2/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw= -go.opencensus.io v0.22.3/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw= -go.opencensus.io v0.22.4/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw= +github.com/yuin/goldmark v1.6.0 h1:boZcn2GTjpsynOsC0iJHnBWa4Bi0qzfJjthwauItG68= +github.com/yuin/goldmark v1.6.0/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= -golang.org/x/crypto v0.0.0-20190510104115-cbcb75029529/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= -golang.org/x/crypto v0.0.0-20190605123033-f99c8df09eb5/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= -golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= -golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= -golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= -golang.org/x/exp v0.0.0-20190306152737-a1d7652674e8/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= -golang.org/x/exp v0.0.0-20190510132918-efd6b22b2522/go.mod h1:ZjyILWgesfNpC6sMxTJOJm9Kp84zZh5NQWvqDGG3Qr8= -golang.org/x/exp v0.0.0-20190829153037-c13cbed26979/go.mod h1:86+5VVa7VpoJ4kLfm080zCjGlMRFzhUhsZKEZO7MGek= -golang.org/x/exp v0.0.0-20191030013958-a1ab85dbe136/go.mod h1:JXzH8nQsPlswgeRAPE3MuO9GYsAcnJvJ4vnMwN/5qkY= -golang.org/x/exp v0.0.0-20191129062945-2f5052295587/go.mod h1:2RIsYlXP63K8oxa1u096TMicItID8zy7Y6sNkU49FU4= -golang.org/x/exp v0.0.0-20191227195350-da58074b4299/go.mod h1:2RIsYlXP63K8oxa1u096TMicItID8zy7Y6sNkU49FU4= -golang.org/x/exp v0.0.0-20200119233911-0405dc783f0a/go.mod h1:2RIsYlXP63K8oxa1u096TMicItID8zy7Y6sNkU49FU4= -golang.org/x/exp v0.0.0-20200207192155-f17229e696bd/go.mod h1:J/WKrq2StrnmMY6+EHIKF9dgMWnmCNThgcyBT1FY9mM= -golang.org/x/exp v0.0.0-20200224162631-6cc2880d07d6/go.mod h1:3jZMyOhIsHpP37uCMkUooju7aAi5cS1Q23tOzKc+0MU= -golang.org/x/image v0.0.0-20190227222117-0694c2d4d067/go.mod h1:kZ7UVZpmo3dzQBMxlp+ypCbDeSB+sBbTgSJuh5dn5js= -golang.org/x/image v0.0.0-20190802002840-cff245a6509b/go.mod h1:FeLwcggjj3mMvU+oOTbSwawSJRM1uh48EjtB4UJZlP0= -golang.org/x/lint v0.0.0-20181026193005-c67002cb31c3/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE= -golang.org/x/lint v0.0.0-20190227174305-5b3e6a55c961/go.mod h1:wehouNa3lNwaWXcvxsM5YxQ5yQlVC4a0KAMCusXpPoU= -golang.org/x/lint v0.0.0-20190301231843-5614ed5bae6f/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE= -golang.org/x/lint v0.0.0-20190313153728-d0100b6bd8b3/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= -golang.org/x/lint v0.0.0-20190409202823-959b441ac422/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= -golang.org/x/lint v0.0.0-20190909230951-414d861bb4ac/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= -golang.org/x/lint v0.0.0-20190930215403-16217165b5de/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= -golang.org/x/lint v0.0.0-20191125180803-fdd1cda4f05f/go.mod h1:5qLYkcX4OjUUV8bRuDixDT3tpyyb+LUpUlRWLxfhWrs= -golang.org/x/lint v0.0.0-20200130185559-910be7a94367/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY= -golang.org/x/lint v0.0.0-20200302205851-738671d3881b/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY= -golang.org/x/mobile v0.0.0-20190312151609-d3739f865fa6/go.mod h1:z+o9i4GpDbdi3rU15maQ/Ox0txvL9dWGYEHz965HBQE= -golang.org/x/mobile v0.0.0-20190719004257-d2bd2a29d028/go.mod h1:E/iHnbuqvinMTCcRqshq8CkpyQDoeVncDDYHnLhea+o= -golang.org/x/mod v0.0.0-20190513183733-4bf6d317e70e/go.mod h1:mXi4GBBbnImb6dmsKGUJ2LatrhH/nqhxcFungHvyanc= -golang.org/x/mod v0.1.0/go.mod h1:0QHyrYULN0/3qlju5TqG8bIK38QM8yzMo5ekMj3DlcY= -golang.org/x/mod v0.1.1-0.20191105210325-c90efee705ee/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg= -golang.org/x/mod v0.1.1-0.20191107180719-034126e5016b/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg= -golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= -golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= -golang.org/x/net v0.0.0-20180724234803-3673e40ba225/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= -golang.org/x/net v0.0.0-20180826012351-8a410e7b638d/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= -golang.org/x/net v0.0.0-20190108225652-1e06a53dbb7e/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= -golang.org/x/net v0.0.0-20190213061140-3a22650c66bd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= -golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= -golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= -golang.org/x/net v0.0.0-20190501004415-9ce7a6920f09/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= -golang.org/x/net v0.0.0-20190503192946-f4e77d36d62c/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= +golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4= golang.org/x/net v0.0.0-20190603091049-60506f45cf65/go.mod h1:HSz+uSET+XFnRR8LxR5pz3Of3rY3CfYBVs4xY44aLks= golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= -golang.org/x/net v0.0.0-20190628185345-da137c7871d7/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= -golang.org/x/net v0.0.0-20190724013045-ca1201d0de80/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= -golang.org/x/net v0.0.0-20191209160850-c0dbc17a3553/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= -golang.org/x/net v0.0.0-20200114155413-6afb5195e5aa/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= -golang.org/x/net v0.0.0-20200202094626-16171245cfb2/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= -golang.org/x/net v0.0.0-20200222125558-5a598a2470a0/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= -golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= -golang.org/x/net v0.0.0-20200301022130-244492dfa37a/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= -golang.org/x/net v0.0.0-20200324143707-d3edc9973b7e/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= -golang.org/x/net v0.0.0-20200501053045-e0ff5e5a1de5/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= -golang.org/x/net v0.0.0-20200506145744-7e3656a0809f/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= -golang.org/x/net v0.0.0-20200513185701-a91f0712d120/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= -golang.org/x/net v0.0.0-20200520182314-0ba52f642ac2/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= -golang.org/x/net v0.0.0-20200625001655-4c5254603344/go.mod h1:/O7V0waA8r7cgGh81Ro3o1hOxt32SMVPicZroKQ2sZA= -golang.org/x/net v0.0.0-20200707034311-ab3426394381/go.mod h1:/O7V0waA8r7cgGh81Ro3o1hOxt32SMVPicZroKQ2sZA= -golang.org/x/net v0.0.0-20200822124328-c89045814202/go.mod h1:/O7V0waA8r7cgGh81Ro3o1hOxt32SMVPicZroKQ2sZA= -golang.org/x/net v0.0.0-20210916014120-12bc252f5db8 h1:/6y1LfuqNuQdHAm0jjtPtgRcxIxjVZgm5OTu8/QhZvk= +golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg= golang.org/x/net v0.0.0-20210916014120-12bc252f5db8/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y= -golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= -golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= -golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= -golang.org/x/oauth2 v0.0.0-20191202225959-858c2ad4c8b6/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= -golang.org/x/oauth2 v0.0.0-20200107190931-bf48bf16ab8d/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= -golang.org/x/oauth2 v0.0.0-20211104180415-d3ed0bb246c8 h1:RerP+noqYHUQ8CMRcPlC2nvTa4dcBIjegkuWdcUDuqg= -golang.org/x/oauth2 v0.0.0-20211104180415-d3ed0bb246c8/go.mod h1:KelEdhl1UZF7XfJ4dDtk6s++YSgaE7mD/BuKKDLBl4A= -golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= -golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= -golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= -golang.org/x/sync v0.0.0-20190227155943-e225da77a7e6/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c= +golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= +golang.org/x/net v0.23.0 h1:7EYJ93RZ9vYSZAIb2x3lnuvqO5zneoD6IvWjuhfxjTs= +golang.org/x/net v0.23.0/go.mod h1:JKghWKKOSdJwpW2GEx0Ja7fmaKnMsbu+MWVZTokSYmg= +golang.org/x/oauth2 v0.15.0 h1:s8pnnxNVzjWyrvYdFUQq5llS1PX2zhPXmccZv99h7uQ= +golang.org/x/oauth2 v0.15.0/go.mod h1:q48ptWNTY5XWf+JNten23lcvHpLJ0ZSxF5ttTHKVCAM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= -golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= -golang.org/x/sync v0.0.0-20200317015054-43a5402ce75a/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= -golang.org/x/sync v0.0.0-20200625203802-6e8e738ad208/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= -golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.3.0 h1:ftCYgMx6zT/asHUrPw8BLLscYtGznsLAnjq5RH9P66E= +golang.org/x/sync v0.3.0/go.mod h1:FU7BRWz2tNW+3quACPkgCx/L+uEAv1htQ0V83Z9Rj+Y= golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= -golang.org/x/sys v0.0.0-20190312061237-fead79001313/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20190502145724-3ef323f4f1fd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20190507160741-ecd444e8653b/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20190606165138-5da285871e9c/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20190624142023-c5567b49c5d0/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20190726091711-fc99dfbffb4e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20191001151750-bb3f8db39f24/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20191204072324-ce4227a45e2e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20191228213918-04cbcbbfeed8/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200113162924-86b910548bc1/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200122134326-e047566fdf82/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200202164722-d101bd2416d5/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200212091648-12a6c2dcc1e4/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200223170610-d5e6a3e2c0ae/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200302150141-5c8b2ff67527/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200323222414-85ca7c5b95cd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200331124033-c3d80250170d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200501052902-10377860bb8e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200511232937-7e40ca221e25/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200515095857-1151b9dac4a9/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200523222454-059865788121/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.0.0-20200803210538-64077c9b5642/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.18.0 h1:DBdB3niSjOA/O0blCZBqDefyWNYveAYMNF1Wum0DYQ4= +golang.org/x/sys v0.18.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= -golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= +golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= -golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= -golang.org/x/text v0.3.6 h1:aRYxNxv6iGQlyVaZmk6ZgYEDa+Jg18DxebPSrd6bg1M= golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= -golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= -golang.org/x/time v0.0.0-20190308202827-9d24e82272b4/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= -golang.org/x/time v0.0.0-20191024005414-555d28b269f0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= +golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ= +golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= +golang.org/x/text v0.14.0 h1:ScX5w1eTa3QqT8oi6+ziP7dTV1S2+ALU0bI+0zXKWiQ= +golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= -golang.org/x/tools v0.0.0-20190114222345-bf090417da8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= -golang.org/x/tools v0.0.0-20190226205152-f727befe758c/go.mod h1:9Yl7xja0Znq3iFh3HoIrodX9oNMXvdceNzlUR8zjMvY= -golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= -golang.org/x/tools v0.0.0-20190312151545-0bb0c0a6e846/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= -golang.org/x/tools v0.0.0-20190312170243-e65039ee4138/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= -golang.org/x/tools v0.0.0-20190425150028-36563e24a262/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= -golang.org/x/tools v0.0.0-20190506145303-2d16b83fe98c/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= -golang.org/x/tools v0.0.0-20190524140312-2c0ae7006135/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= -golang.org/x/tools v0.0.0-20190606124116-d0a3d012864b/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= -golang.org/x/tools v0.0.0-20190621195816-6e04913cbbac/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= -golang.org/x/tools v0.0.0-20190628153133-6cdbf07be9d0/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= -golang.org/x/tools v0.0.0-20190816200558-6889da9d5479/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= -golang.org/x/tools v0.0.0-20190911174233-4f2ddba30aff/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= -golang.org/x/tools v0.0.0-20191012152004-8de300cfc20a/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= -golang.org/x/tools v0.0.0-20191113191852-77e3bb0ad9e7/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= -golang.org/x/tools v0.0.0-20191115202509-3a792d9c32b2/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= -golang.org/x/tools v0.0.0-20191125144606-a911d9008d1f/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= -golang.org/x/tools v0.0.0-20191130070609-6e064ea0cf2d/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= -golang.org/x/tools v0.0.0-20191216173652-a0e659d51361/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20191227053925-7b8e75db28f4/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20200117161641-43d50277825c/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20200122220014-bf1340f18c4a/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20200130002326-2f3ba24bd6e7/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20200204074204-1cc6d1ef6c74/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20200207183749-b753a1ba74fa/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20200212150539-ea181f53ac56/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20200224181240-023911ca70b2/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20200227222343-706bc42d1f0d/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= -golang.org/x/tools v0.0.0-20200304193943-95d2e580d8eb/go.mod h1:o4KQGtdN14AW+yjsvvwRTJJuXz8XRtIHtEnmAXLyFUw= -golang.org/x/tools v0.0.0-20200312045724-11d5b4c81c7d/go.mod h1:o4KQGtdN14AW+yjsvvwRTJJuXz8XRtIHtEnmAXLyFUw= -golang.org/x/tools v0.0.0-20200331025713-a30bf2db82d4/go.mod h1:Sl4aGygMT6LrqrWclx+PTx3U+LnKx/seiNR+3G19Ar8= -golang.org/x/tools v0.0.0-20200501065659-ab2804fb9c9d/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE= -golang.org/x/tools v0.0.0-20200512131952-2bc93b1c0c88/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE= -golang.org/x/tools v0.0.0-20200515010526-7d3b6ebf133d/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE= -golang.org/x/tools v0.0.0-20200618134242-20370b0cb4b2/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE= -golang.org/x/tools v0.0.0-20200729194436-6467de6f59a7/go.mod h1:njjCfa9FT2d7l9Bc6FUM5FLjQPp3cFF28FI3qnDFljA= -golang.org/x/tools v0.0.0-20200804011535-6c149bb5ef0d/go.mod h1:njjCfa9FT2d7l9Bc6FUM5FLjQPp3cFF28FI3qnDFljA= -golang.org/x/tools v0.0.0-20200825202427-b303f430e36d/go.mod h1:njjCfa9FT2d7l9Bc6FUM5FLjQPp3cFF28FI3qnDFljA= +golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc= golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= -golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= -golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 h1:go1bK/D/BFZV2I8cIQd1NKEZ+0owSTG1fDTci4IqFcE= -golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= -google.golang.org/api v0.4.0/go.mod h1:8k5glujaEP+g9n7WNsDg8QP6cUVNI86fCNMcbazEtwE= -google.golang.org/api v0.7.0/go.mod h1:WtwebWUNSVBH/HAw79HIFXZNqEvBhG+Ra+ax0hx3E3M= -google.golang.org/api v0.8.0/go.mod h1:o4eAsZoiT+ibD93RtjEohWalFOjRDx6CVaqeizhEnKg= -google.golang.org/api v0.9.0/go.mod h1:o4eAsZoiT+ibD93RtjEohWalFOjRDx6CVaqeizhEnKg= -google.golang.org/api v0.13.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI= -google.golang.org/api v0.14.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI= -google.golang.org/api v0.15.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI= -google.golang.org/api v0.17.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE= -google.golang.org/api v0.18.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE= -google.golang.org/api v0.19.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE= -google.golang.org/api v0.20.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE= -google.golang.org/api v0.22.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE= -google.golang.org/api v0.24.0/go.mod h1:lIXQywCXRcnZPGlsd8NbLnOjtAoL6em04bJ9+z0MncE= -google.golang.org/api v0.28.0/go.mod h1:lIXQywCXRcnZPGlsd8NbLnOjtAoL6em04bJ9+z0MncE= -google.golang.org/api v0.29.0/go.mod h1:Lcubydp8VUV7KeIHD9z2Bys/sm/vGKnG1UHuDBSrHWM= -google.golang.org/api v0.30.0/go.mod h1:QGmEvQ87FHZNiUVJkT14jQNYJ4ZJjdRF23ZXz5138Fc= -google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM= -google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= -google.golang.org/appengine v1.5.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= -google.golang.org/appengine v1.6.1/go.mod h1:i06prIuMbXzDqacNJfV5OdTW448YApPu5ww/cMBSeb0= -google.golang.org/appengine v1.6.5/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc= -google.golang.org/appengine v1.6.6 h1:lMO5rYAqUxkmaj76jAkRUvt5JZgFymx/+Q5Mzfivuhc= -google.golang.org/appengine v1.6.6/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc= -google.golang.org/genproto v0.0.0-20180817151627-c66870c02cf8/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc= -google.golang.org/genproto v0.0.0-20190307195333-5fe7a883aa19/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= -google.golang.org/genproto v0.0.0-20190418145605-e7d98fc518a7/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= -google.golang.org/genproto v0.0.0-20190425155659-357c62f0e4bb/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= -google.golang.org/genproto v0.0.0-20190502173448-54afdca5d873/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= -google.golang.org/genproto v0.0.0-20190801165951-fa694d86fc64/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc= -google.golang.org/genproto v0.0.0-20190819201941-24fa4b261c55/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc= -google.golang.org/genproto v0.0.0-20190911173649-1774047e7e51/go.mod h1:IbNlFCBrqXvoKpeg0TB2l7cyZUmoaFKYIwrEpbDKLA8= -google.golang.org/genproto v0.0.0-20191108220845-16a3f7862a1a/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= -google.golang.org/genproto v0.0.0-20191115194625-c23dd37a84c9/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= -google.golang.org/genproto v0.0.0-20191216164720-4f79533eabd1/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= -google.golang.org/genproto v0.0.0-20191230161307-f3c370f40bfb/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= -google.golang.org/genproto v0.0.0-20200115191322-ca5a22157cba/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= -google.golang.org/genproto v0.0.0-20200122232147-0452cf42e150/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc= -google.golang.org/genproto v0.0.0-20200204135345-fa8e72b47b90/go.mod h1:GmwEX6Z4W5gMy59cAlVYjN9JhxgbQH6Gn+gFDQe2lzA= -google.golang.org/genproto v0.0.0-20200212174721-66ed5ce911ce/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= -google.golang.org/genproto v0.0.0-20200224152610-e50cd9704f63/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= -google.golang.org/genproto v0.0.0-20200228133532-8c2c7df3a383/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= -google.golang.org/genproto v0.0.0-20200305110556-506484158171/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= -google.golang.org/genproto v0.0.0-20200312145019-da6875a35672/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= -google.golang.org/genproto v0.0.0-20200331122359-1ee6d9798940/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= -google.golang.org/genproto v0.0.0-20200430143042-b979b6f78d84/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= -google.golang.org/genproto v0.0.0-20200511104702-f5ebc3bea380/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c= -google.golang.org/genproto v0.0.0-20200515170657-fc4c6c6a6587/go.mod h1:YsZOwe1myG/8QRHRsmBRE1LrgQY60beZKjly0O1fX9U= -google.golang.org/genproto v0.0.0-20200526211855-cb27e3aa2013/go.mod h1:NbSheEEYHJ7i3ixzK3sjbqSGDJWnxyFXZblF3eUsNvo= -google.golang.org/genproto v0.0.0-20200618031413-b414f8b61790/go.mod h1:jDfRM7FcilCzHH/e9qn6dsT145K34l5v+OpcnNgKAAA= -google.golang.org/genproto v0.0.0-20200729003335-053ba62fc06f/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no= -google.golang.org/genproto v0.0.0-20200804131852-c06518451d9c/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no= -google.golang.org/genproto v0.0.0-20200825200019-8632dd797987/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no= -google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= -google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38= -google.golang.org/grpc v1.21.1/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM= -google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg= -google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY= -google.golang.org/grpc v1.26.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= -google.golang.org/grpc v1.27.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= -google.golang.org/grpc v1.27.1/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= -google.golang.org/grpc v1.28.0/go.mod h1:rpkK4SK4GF4Ach/+MFLZUBavHOvF2JJB5uozKKal+60= -google.golang.org/grpc v1.29.1/go.mod h1:itym6AZVZYACWQqET3MqgPpjcuV5QH3BxFS3IjizoKk= -google.golang.org/grpc v1.30.0/go.mod h1:N36X2cJ7JwdamYAgDz+s+rVMFjt3numwzf/HckM8pak= -google.golang.org/grpc v1.31.0/go.mod h1:N36X2cJ7JwdamYAgDz+s+rVMFjt3numwzf/HckM8pak= -google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8= -google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0= -google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM= -google.golang.org/protobuf v1.20.1-0.20200309200217-e05f789c0967/go.mod h1:A+miEFZTKqfCUM6K7xSMQL9OKL/b6hQv+e19PK+JZNE= -google.golang.org/protobuf v1.21.0/go.mod h1:47Nbq4nVaFHyn7ilMalzfO3qCViNmqZ2kzikPIcrTAo= -google.golang.org/protobuf v1.22.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= -google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= -google.golang.org/protobuf v1.23.1-0.20200526195155-81db48ad09cc/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= -google.golang.org/protobuf v1.24.0/go.mod h1:r/3tXBNzIEhYS9I1OUVjXDlt8tc493IdKGjtUeSXeh4= -google.golang.org/protobuf v1.25.0 h1:Ejskq+SyPohKW+1uil0JJMtmHCgJPJ/qWTxr8qp+R4c= -google.golang.org/protobuf v1.25.0/go.mod h1:9JNX74DMeImyA3h4bdi1ymwjUzf21/xIlbajtzgsN7c= -gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= -gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= -gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI= -gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= -honnef.co/go/tools v0.0.0-20190102054323-c2f93a96b099/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= -honnef.co/go/tools v0.0.0-20190106161140-3f1c8253044a/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= -honnef.co/go/tools v0.0.0-20190418001031-e561f6794a2a/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= -honnef.co/go/tools v0.0.0-20190523083050-ea95bdfd59fc/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= -honnef.co/go/tools v0.0.1-2019.2.3/go.mod h1:a3bituU0lyd329TUQxRnasdCoJDkEUEAqEt0JzvZhAg= -honnef.co/go/tools v0.0.1-2020.1.3/go.mod h1:X/FiERA/W4tHapMX5mGpAtMSVEeEUOyHaw9vFzvIQ3k= -honnef.co/go/tools v0.0.1-2020.1.4/go.mod h1:X/FiERA/W4tHapMX5mGpAtMSVEeEUOyHaw9vFzvIQ3k= -rsc.io/binaryregexp v0.2.0/go.mod h1:qTv7/COck+e2FymRvadv62gMdZztPaShugOCi3I+8D8= -rsc.io/quote/v3 v3.1.0/go.mod h1:yEA65RcK8LyAZtP9Kv3t0HmxON59tX3rD+tICJqUlj0= -rsc.io/sampler v1.3.0/go.mod h1:T1hPZKmBbMNahiBKFy5HrXp6adAjACjK9JXDnKaTXpA= +google.golang.org/appengine v1.6.7 h1:FZR1q0exgwxzPzp/aF+VccGrSfxfPpkBqjIIEq3ru6c= +google.golang.org/appengine v1.6.7/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc= +google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw= +google.golang.org/protobuf v1.26.0/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc= +google.golang.org/protobuf v1.33.0 h1:uNO2rsAINq/JlFpSdYEKIZ0uKD/R9cpdv0T+yoGwGmI= +google.golang.org/protobuf v1.33.0/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos= diff --git a/main.go b/main.go new file mode 100644 index 00000000..5d65e75c --- /dev/null +++ b/main.go @@ -0,0 +1,365 @@ +// Package main contains code for generate static site. +package main + +import ( + "bytes" + "embed" + "errors" + "fmt" + template2 "html/template" + "net/url" + "os" + "path/filepath" + "text/template" + + "github.com/avelino/awesome-go/pkg/markdown" + cp "github.com/otiai10/copy" + + "github.com/PuerkitoBio/goquery" + "github.com/avelino/awesome-go/pkg/slug" +) + +// Link contains info about awesome url +type Link struct { + Title string + URL string + Description string +} + +// Category describe link category +type Category struct { + Title string + Slug string + Description string + Links []Link +} + +// Source files +const readmePath = "README.md" + +// This files should be copied 'as is' to outDir directory +var staticFiles = []string{ + "tmpl/assets", + "tmpl/robots.txt", +} + +// Templates +//go:embed tmpl/*.tmpl.html tmpl/*.tmpl.xml +var tplFs embed.FS + +var tpl = template.Must(template.ParseFS(tplFs, "tmpl/*.tmpl.html", "tmpl/*.tmpl.xml")) + +// Output files +const outDir = "out/" // NOTE: trailing slash is required + +var outIndexFile = filepath.Join(outDir, "index.html") +var outSitemapFile = filepath.Join(outDir, "sitemap.xml") + +func main() { + if err := buildStaticSite(); err != nil { + panic(err) + } +} + +func buildStaticSite() error { + if err := dropCreateDir(outDir); err != nil { + return fmt.Errorf("drop-create out dir: %w", err) + } + + if err := renderIndex(readmePath, outIndexFile); err != nil { + return fmt.Errorf("convert markdown to html: %w", err) + } + + input, err := os.ReadFile(outIndexFile) + if err != nil { + return fmt.Errorf("read converted html: %w", err) + } + + doc, err := goquery.NewDocumentFromReader(bytes.NewReader(input)) + if err != nil { + return fmt.Errorf("create goquery instance: %w", err) + } + + categories, err := extractCategories(doc) + if err != nil { + return fmt.Errorf("extract categories: %w", err) + } + + if err := renderCategories(categories); err != nil { + return fmt.Errorf("render categories: %w", err) + } + + if err := rewriteLinksInIndex(doc, categories); err != nil { + return fmt.Errorf("rewrite links in index: %w", err) + } + + if err := renderSitemap(categories); err != nil { + return fmt.Errorf("render sitemap: %w", err) + } + + for _, srcFilename := range staticFiles { + dstFilename := filepath.Join(outDir, filepath.Base(srcFilename)) + fmt.Printf("Copy static file: %s -> %s\n", srcFilename, dstFilename) + if err := cp.Copy(srcFilename, dstFilename); err != nil { + return fmt.Errorf("copy static file `%s` to `%s`: %w", srcFilename, dstFilename, err) + } + } + + return nil +} + +// dropCreateDir drop and create output directory +func dropCreateDir(dir string) error { + if err := os.RemoveAll(dir); err != nil { + return fmt.Errorf("remove dir: %w", err) + } + + if err := mkdirAll(dir); err != nil { + return fmt.Errorf("create dir: %w", err) + } + + return nil +} + +func mkdirAll(path string) error { + _, err := os.Stat(path) + // directory is exists + if err == nil { + return nil + } + + // unexpected error + if !os.IsNotExist(err) { + return fmt.Errorf("unexpected result of dir stat: %w", err) + } + + // directory is not exists + if err := os.MkdirAll(path, 0755); err != nil { + return fmt.Errorf("midirAll: %w", err) + } + + return nil +} + +func renderCategories(categories map[string]Category) error { + for _, category := range categories { + categoryDir := filepath.Join(outDir, category.Slug) + if err := mkdirAll(categoryDir); err != nil { + return fmt.Errorf("create category dir `%s`: %w", categoryDir, err) + } + + // FIXME: embed templates + categoryIndexFilename := filepath.Join(categoryDir, "index.html") + fmt.Printf("Write category Index file: %s\n", categoryIndexFilename) + + buf := bytes.NewBuffer(nil) + if err := tpl.Lookup("category-index.tmpl.html").Execute(buf, category); err != nil { + return fmt.Errorf("render category `%s`: %w", categoryDir, err) + } + + // Sanitize HTML. This is not necessary, but allows to have content + // of all html files in same style. + { + doc, err := goquery.NewDocumentFromReader(buf) + if err != nil { + return fmt.Errorf("create goquery instance for `%s`: %w", categoryDir, err) + } + + html, err := doc.Html() + if err != nil { + return fmt.Errorf("render goquery html for `%s`: %w", categoryDir, err) + } + + if err := os.WriteFile(categoryIndexFilename, []byte(html), 0644); err != nil { + return fmt.Errorf("write category file `%s`: %w", categoryDir, err) + } + } + } + + return nil +} + +func renderSitemap(categories map[string]Category) error { + f, err := os.Create(outSitemapFile) + if err != nil { + return fmt.Errorf("create sitemap file `%s`: %w", outSitemapFile, err) + } + + fmt.Printf("Render Sitemap to: %s\n", outSitemapFile) + + if err := tpl.Lookup("sitemap.tmpl.xml").Execute(f, categories); err != nil { + return fmt.Errorf("render sitemap: %w", err) + } + + return nil +} + +func extractCategories(doc *goquery.Document) (map[string]Category, error) { + categories := make(map[string]Category) + var rootErr error + + doc. + Find("body #contents"). + NextFiltered("ul"). + Find("ul"). + EachWithBreak(func(_ int, selUl *goquery.Selection) bool { + if rootErr != nil { + return false + } + + selUl. + Find("li a"). + EachWithBreak(func(_ int, s *goquery.Selection) bool { + selector, exists := s.Attr("href") + if !exists { + return true + } + + category, err := extractCategory(doc, selector) + if err != nil { + rootErr = fmt.Errorf("extract category: %w", err) + return false + } + + categories[selector] = *category + + return true + }) + + return true + }) + + if rootErr != nil { + return nil, fmt.Errorf("extract categories: %w", rootErr) + } + + return categories, nil +} + +func extractCategory(doc *goquery.Document, selector string) (*Category, error) { + var category Category + var err error + + doc.Find(selector).EachWithBreak(func(_ int, selCatHeader *goquery.Selection) bool { + selDescr := selCatHeader.NextFiltered("p") + // FIXME: bug. this would select links from all neighboring + // sub-categories until the next category. To prevent this we should + // find only first ul + ul := selCatHeader.NextFilteredUntil("ul", "h2") + + var links []Link + ul.Find("li").Each(func(_ int, selLi *goquery.Selection) { + selLink := selLi.Find("a") + url, _ := selLink.Attr("href") + link := Link{ + Title: selLink.Text(), + // FIXME(kazhuravlev): Title contains only title but + // description contains Title + description + Description: selLi.Text(), + URL: url, + } + links = append(links, link) + }) + + // FIXME: In this case we would have an empty category in main index.html with link to 404 page. + if len(links) == 0 { + err = errors.New("category does not contain links") + return false + } + + category = Category{ + Slug: slug.Generate(selCatHeader.Text()), + Title: selCatHeader.Text(), + Description: selDescr.Text(), + Links: links, + } + + return true + }) + + if err != nil { + return nil, fmt.Errorf("build a category: %w", err) + } + + return &category, nil +} + +func rewriteLinksInIndex(doc *goquery.Document, categories map[string]Category) error { + var iterErr error + doc. + Find("body #content ul li ul li a"). + EachWithBreak(func(_ int, s *goquery.Selection) bool { + href, hrefExists := s.Attr("href") + if !hrefExists { + // FIXME: looks like is an error. Tag `a` in our case always + // should have `href` attr. + return true + } + + // do not replace links if no page has been created for it + _, catExists := categories[href] + if !catExists { + return true + } + + linkURL, err := url.Parse(href) + if err != nil { + iterErr = err + return false + } + + if linkURL.Fragment != "" && linkURL.Fragment != "contents" { + s.SetAttr("href", linkURL.Fragment) + } + + return true + }) + + if iterErr != nil { + return iterErr + } + + fmt.Printf("Rewrite links in Index file: %s\n", outIndexFile) + resultHTML, err := doc.Html() + if err != nil { + return fmt.Errorf("render html: %w", err) + } + + if err := os.WriteFile(outIndexFile, []byte(resultHTML), 0644); err != nil { + return fmt.Errorf("rewrite index file: %w", err) + } + + return nil +} + +// renderIndex generate site html (index.html) from markdown file +func renderIndex(srcFilename, outFilename string) error { + input, err := os.ReadFile(srcFilename) + if err != nil { + return err + } + + body, err := markdown.ToHTML(input) + if err != nil { + return err + } + + f, err := os.Create(outFilename) + if err != nil { + return err + } + + fmt.Printf("Write Index file: %s\n", outIndexFile) + data := map[string]interface{}{ + "Body": template2.HTML(body), + } + if err := tpl.Lookup("index.tmpl.html").Execute(f, data); err != nil { + return err + } + + if err := f.Close(); err != nil { + return fmt.Errorf("close index file: %w", err) + } + + return nil +} diff --git a/repo_test.go b/main_test.go similarity index 65% rename from repo_test.go rename to main_test.go index 39717369..3d59d22a 100644 --- a/repo_test.go +++ b/main_test.go @@ -1,7 +1,9 @@ package main import ( - "io/ioutil" + "bytes" + "github.com/avelino/awesome-go/pkg/markdown" + "os" "regexp" "sort" "strings" @@ -16,9 +18,38 @@ var ( reLinkWithDescription = regexp.MustCompile(`\* \[.*\]\(.*\) - \S.*[\.\!]`) ) +func requireNoErr(t *testing.T, err error, msg string) { + // FIXME: replace to github.com/stretchr/testify + t.Helper() + + if msg == "" { + msg = "unknown error" + } + + if err != nil { + t.Fatalf("Received unexpected error [%s]: %+v", msg, err) + } +} + +func goqueryFromReadme(t *testing.T) *goquery.Document { + t.Helper() + + input, err := os.ReadFile(readmePath) + requireNoErr(t, err, "readme file should be exists") + + html, err := markdown.ToHTML(input) + requireNoErr(t, err, "markdown should be rendered to html") + + buf := bytes.NewBuffer(html) + doc, err := goquery.NewDocumentFromReader(buf) + requireNoErr(t, err, "html must be valid for goquery") + + return doc +} + func TestAlpha(t *testing.T) { - query := startQuery() - query.Find("body > ul").Each(func(i int, s *goquery.Selection) { + doc := goqueryFromReadme(t) + doc.Find("body > ul").Each(func(i int, s *goquery.Selection) { if i != 0 { // skip content menu // TODO: the sub items (with 3 hash marks `###`) are staying in @@ -30,9 +61,9 @@ func TestAlpha(t *testing.T) { } func TestDuplicatedLinks(t *testing.T) { - query := startQuery() + doc := goqueryFromReadme(t) links := make(map[string]bool, 0) - query.Find("body li > a:first-child").Each(func(_ int, s *goquery.Selection) { + doc.Find("body li > a:first-child").Each(func(_ int, s *goquery.Selection) { t.Run(s.Text(), func(t *testing.T) { href, ok := s.Attr("href") if !ok { @@ -49,10 +80,9 @@ func TestDuplicatedLinks(t *testing.T) { // Test if an entry has description, it must be separated from link with ` - ` func TestSeparator(t *testing.T) { var matched, containsLink, noDescription bool - input, err := ioutil.ReadFile("./README.md") - if err != nil { - panic(err) - } + input, err := os.ReadFile(readmePath) + requireNoErr(t, err, "readme should be exists") + lines := strings.Split(string(input), "\n") for _, line := range lines { line = strings.Trim(line, " ") @@ -69,11 +99,12 @@ func TestSeparator(t *testing.T) { } } } -func TestGenerateHTML(t *testing.T) { - err := GenerateHTML() - if err != nil { - t.Errorf("html generate error '%s'", err.Error()) - } + +func TestRenderIndex(t *testing.T) { + requireNoErr(t, mkdirAll(outDir), "output dir should exists") + + err := renderIndex(readmePath, outIndexFile) + requireNoErr(t, err, "html should be rendered") } func testList(t *testing.T, list *goquery.Selection) { diff --git a/make_site.go b/make_site.go deleted file mode 100644 index e1a35448..00000000 --- a/make_site.go +++ /dev/null @@ -1,115 +0,0 @@ -package main - -import ( - "bytes" - "fmt" - "io/ioutil" - "log" - "os" - "strings" - "text/template" - - "github.com/PuerkitoBio/goquery" - "github.com/avelino/awesome-go/pkg/slug" -) - -type Link struct { - Title string - Url string - Description string -} - -type Object struct { - Title string - Slug string - Description string - Items []Link -} - -func main() { - GenerateHTML() - input, err := ioutil.ReadFile("./tmpl/index.html") - if err != nil { - panic(err) - } - buf := bytes.NewBuffer(input) - query, err := goquery.NewDocumentFromReader(buf) - if err != nil { - panic(err) - } - - objs := []Object{} - query.Find("body #content ul ul").First().Each(func(_ int, s *goquery.Selection) { - - s.Find("li a").Each(func(_ int, s *goquery.Selection) { - selector, _ := s.Attr("href") - obj := makeObjById(selector, query.Find("body")) - objs = append(objs, obj) - }) - }) - - makeSiteStruct(objs) - makeSitemap(objs) - changeLinksInIndex(string(input), query) -} - -func makeSiteStruct(objs []Object) { - for _, obj := range objs { - folder := fmt.Sprintf("tmpl/%s", obj.Slug) - err := os.Mkdir(folder, 0755) - if err != nil { - log.Println(err) - } - - t := template.Must(template.ParseFiles("tmpl/cat-tmpl.html")) - f, _ := os.Create(fmt.Sprintf("%s/index.html", folder)) - t.Execute(f, obj) - } -} - -func makeSitemap(objs []Object) { - t := template.Must(template.ParseFiles("tmpl/sitemap-tmpl.xml")) - f, _ := os.Create("tmpl/sitemap.xml") - t.Execute(f, objs) -} - -func makeObjById(selector string, s *goquery.Selection) (obj Object) { - s.Find(selector).Each(func(_ int, s *goquery.Selection) { - desc := s.NextFiltered("p") - ul := desc.NextFiltered("ul") - - links := []Link{} - ul.Find("li").Each(func(_ int, s *goquery.Selection) { - url, _ := s.Find("a").Attr("href") - link := Link{ - Title: s.Find("a").Text(), - Description: s.Text(), - Url: url, - } - links = append(links, link) - }) - obj = Object{ - Slug: slug.Generate(s.Text()), - Title: s.Text(), - Description: desc.Text(), - Items: links, - } - }) - return -} - -func changeLinksInIndex(html string, query *goquery.Document) { - query.Find("body #content ul li ul li a").Each(func(_ int, s *goquery.Selection) { - - href, exists := s.Attr("href") - if exists { - uri := strings.SplitAfter(href, "#") - if len(uri) >= 2 && uri[1] != "contents" { - html = strings.ReplaceAll( - html, fmt.Sprintf(`href="%s"`, href), fmt.Sprintf(`href="%s"`, uri[1])) - } - } - }) - - os.WriteFile("./tmpl/index.html", []byte(html), 0644) -} diff --git a/netlify.toml b/netlify.toml new file mode 100644 index 00000000..8a87f954 --- /dev/null +++ b/netlify.toml @@ -0,0 +1,47 @@ +# Settings in the [build] context are global and are applied to +# all contexts unless otherwise overridden by more specific contexts. +[build] +# Directory to change to before starting a build. +# This is where we will look for package.json/.nvmrc/etc. +# If not set, defaults to the root directory. +base = "./" + +# Directory that contains the deploy-ready HTML files and +# assets generated by the build. This is relative to the base +# directory if one has been set, or the root directory if +# a base has not been set. This sample publishes the directory +# located at the absolute path "root/project/build-output" + +publish = "out/" + +# Default build command. +command = "echo 'default context'" + +[[plugins]] +# Installs the Lighthouse Build Plugin for all deploy contexts +package = "@netlify/plugin-lighthouse" + +# Production context: all deploys from the Production branch +# set in your site’s Branches settings in the UI will inherit +# these settings. You can define environment variables +# here but we recommend using the Netlify UI for sensitive +# values to keep them out of your source repository. +[context.production] +publish = "out/" + +# Redirects and headers are GLOBAL for all builds – they do not +# get scoped to contexts no matter where you define them in the file. +# For context-specific rules, use _headers or _redirects files, +# which are PER-DEPLOY. + +[[redirects]] +from = "/awesome-cloud-native" +to = "/" +status = 302 +force = true + +[[redirects]] +from = "/awesome-go-fork" +to = "/" +status = 302 +force = true diff --git a/pkg/markdown/convert.go b/pkg/markdown/convert.go index 0a14f00d..31a77e5e 100644 --- a/pkg/markdown/convert.go +++ b/pkg/markdown/convert.go @@ -12,8 +12,8 @@ import ( "github.com/yuin/goldmark/util" ) -// ConvertMarkdownToHTML converts markdown byte slice to a HTML byte slice -func ConvertMarkdownToHTML(markdown []byte) ([]byte, error) { +// ToHTML converts markdown byte slice to a HTML byte slice +func ToHTML(markdown []byte) ([]byte, error) { md := goldmark.New( goldmark.WithExtensions(extension.GFM), goldmark.WithParserOptions( diff --git a/pkg/markdown/convert_test.go b/pkg/markdown/convert_test.go index 0efdf84e..9f2c58c2 100644 --- a/pkg/markdown/convert_test.go +++ b/pkg/markdown/convert_test.go @@ -5,7 +5,7 @@ import ( "testing" ) -func TestConvertMarkdownToHTML(t *testing.T) { +func TestToHTML(t *testing.T) { input := []byte( `## some headline followed by some paragraph with [a link](https://example.local) @@ -46,12 +46,12 @@ and some list:

embedded HTML is allowed

`, ) - got, err := ConvertMarkdownToHTML(input) + got, err := ToHTML(input) if err != nil { - t.Errorf("ConvertMarkdownToHTML() error = %v", err) + t.Errorf("ToHTML() error = %v", err) return } if strings.TrimSpace(string(got)) != strings.TrimSpace(string(expected)) { - t.Errorf("ConvertMarkdownToHTML() got = %v, want %v", string(got), string(expected)) + t.Errorf("ToHTML() got = %v, want %v", string(got), string(expected)) } } diff --git a/pkg/slug/generator.go b/pkg/slug/generator.go index 8bafcf2f..d2f79403 100644 --- a/pkg/slug/generator.go +++ b/pkg/slug/generator.go @@ -8,6 +8,7 @@ import ( // Generate slugs similar to GitHub's slugs on markdown parsing func Generate(text string) string { + // FIXME: this is should be like regexp.Replace(`[^-a-zA-Z\d]+`, ``) s := strings.ReplaceAll(text, "/", "") return slugify.Slugify(strings.TrimSpace(s)) } diff --git a/scripts.go b/scripts.go deleted file mode 100644 index b89c5a0f..00000000 --- a/scripts.go +++ /dev/null @@ -1,51 +0,0 @@ -package main - -import ( - "bytes" - "html/template" - "io/ioutil" - "os" - - "github.com/PuerkitoBio/goquery" - "github.com/avelino/awesome-go/pkg/markdown" -) - -func readme() []byte { - input, err := os.ReadFile("./README.md") - if err != nil { - panic(err) - } - html, err := markdown.ConvertMarkdownToHTML(input) - if err != nil { - panic(err) - } - return html -} - -func startQuery() *goquery.Document { - buf := bytes.NewBuffer(readme()) - query, err := goquery.NewDocumentFromReader(buf) - if err != nil { - panic(err) - } - return query -} - -type content struct { - Body template.HTML -} - -// GenerateHTML generate site html (index.html) from markdown file -func GenerateHTML() (err error) { - // options - readmePath := "./README.md" - tplPath := "tmpl/tmpl.html" - idxPath := "tmpl/index.html" - input, _ := ioutil.ReadFile(readmePath) - body, _ := markdown.ConvertMarkdownToHTML(input) - c := &content{Body: template.HTML(body)} - t := template.Must(template.ParseFiles(tplPath)) - f, err := os.Create(idxPath) - t.Execute(f, c) - return -} diff --git a/stale_repositories_test.go b/stale_repositories_test.go index 8a992e4c..20b013ff 100644 --- a/stale_repositories_test.go +++ b/stale_repositories_test.go @@ -18,211 +18,250 @@ import ( "golang.org/x/oauth2" ) -const issueTemplate = ` +const issueTemplateContent = ` {{range .}} - [ ] {{.}} {{end}} ` +var issueTemplate = template.Must(template.New("issue").Parse(issueTemplateContent)) + +// FIXME: use official github client var reGithubRepo = regexp.MustCompile("https://github.com/[a-zA-Z0-9-._]+/[a-zA-Z0-9-._]+$") var githubGETREPO = "https://api.github.com/repos%s" var githubGETCOMMITS = "https://api.github.com/repos%s/commits" var githubPOSTISSUES = "https://api.github.com/repos/avelino/awesome-go/issues" + +// FIXME: use https var awesomeGoGETISSUES = "http://api.github.com/repos/avelino/awesome-go/issues" //only returns open issues +// FIXME: variable has type Duration, but contains a number. we should use +// +// time.Hour * ... or change type of variable var numberOfYears time.Duration = 1 var timeNow = time.Now() -var issueTitle = fmt.Sprintf("Investigate repositories with more than 1 year without update - %s", timeNow.Format("2006-01-02")) +var issueTitle = fmt.Sprintf("Investigate repositories with more than 1 year without update - %s", timeNow.Format(time.DateOnly)) const deadLinkMessage = " this repository might no longer exist! (status code >= 400 returned)" const movedPermanently = " status code 301 received" const status302 = " status code 302 received" const archived = " repository has been archived" -//LIMIT specifies the max number of repositories that are added in a single run of the script +// LIMIT specifies the max number of repositories that are added in a single run of the script var LIMIT = 10 var ctr = 0 type tokenSource struct { AccessToken string } + type issue struct { Title string `json:"title"` Body string `json:"body"` } -type repo struct { - Archived bool `json:"archived"` -} func (t *tokenSource) Token() (*oauth2.Token, error) { - token := &oauth2.Token{ + return &oauth2.Token{ AccessToken: t.AccessToken, - } - return token, nil + }, nil } + func getRepositoriesFromBody(body string) []string { links := strings.Split(body, "- ") - for idx, link := range links { - str := strings.ReplaceAll(link, "\r", "") - str = strings.ReplaceAll(str, "[ ]", "") - str = strings.ReplaceAll(str, "[x]", "") - str = strings.ReplaceAll(str, " ", "") - str = strings.ReplaceAll(str, "\n", "") - str = strings.ReplaceAll(str, deadLinkMessage, "") - str = strings.ReplaceAll(str, movedPermanently, "") - str = strings.ReplaceAll(str, status302, "") - str = strings.ReplaceAll(str, archived, "") - links[idx] = str + for i, link := range links { + link = strings.ReplaceAll(link, "\r", "") + link = strings.ReplaceAll(link, "[ ]", "") + link = strings.ReplaceAll(link, "[x]", "") + link = strings.ReplaceAll(link, " ", "") + link = strings.ReplaceAll(link, "\n", "") + link = strings.ReplaceAll(link, deadLinkMessage, "") + link = strings.ReplaceAll(link, movedPermanently, "") + link = strings.ReplaceAll(link, status302, "") + link = strings.ReplaceAll(link, archived, "") + links[i] = link } + return links } -func generateIssueBody(repositories []string) (string, error) { - var writer bytes.Buffer - t := template.New("issue") - temp, err := t.Parse(issueTemplate) - if err != nil { - log.Print("Failed to generate template") - return "", err - } - err = temp.Execute(&writer, repositories) - if err != nil { - log.Print("Failed to generate template") - return "", err - } - issueBody := writer.String() - return issueBody, nil + +func generateIssueBody(t *testing.T, repositories []string) (string, error) { + t.Helper() + + buf := bytes.NewBuffer(nil) + err := issueTemplate.Execute(buf, repositories) + requireNoErr(t, err, "Failed to generate template") + + return buf.String(), nil } -func createIssue(staleRepos []string, client *http.Client) { + +func createIssue(t *testing.T, staleRepos []string, client *http.Client) { + t.Helper() + if len(staleRepos) == 0 { log.Print("NO STALE REPOSITORIES") return } - body, err := generateIssueBody(staleRepos) - if err != nil { - log.Print("Failed at CreateIssue") - return - } + + body, err := generateIssueBody(t, staleRepos) + requireNoErr(t, err, "failed to generate issue body") + newIssue := &issue{ Title: issueTitle, Body: body, } - buf := new(bytes.Buffer) - json.NewEncoder(buf).Encode(newIssue) - req, err := http.NewRequest("POST", githubPOSTISSUES, buf) - if err != nil { - log.Print("Failed at CreateIssue") - return - } - client.Do(req) + buf := bytes.NewBuffer(nil) + requireNoErr(t, json.NewEncoder(buf).Encode(newIssue), "failed to encode json req") + + req, err := http.NewRequest(http.MethodPost, githubPOSTISSUES, buf) + requireNoErr(t, err, "failed to create request") + + _, roundTripErr := client.Do(req) + requireNoErr(t, roundTripErr, "failed to send request") } -func getAllFlaggedRepositories(client *http.Client, flaggedRepositories *map[string]bool) error { - req, err := http.NewRequest("GET", awesomeGoGETISSUES, nil) - if err != nil { - log.Print("Failed to get all issues") - return err - } + +func getAllFlaggedRepositories(t *testing.T, client *http.Client) map[string]bool { + t.Helper() + + req, err := http.NewRequest(http.MethodGet, awesomeGoGETISSUES, nil) + requireNoErr(t, err, "failed to create request") + res, err := client.Do(req) - if err != nil { - log.Print("Failed to get all issues") - return err - } - target := []issue{} + requireNoErr(t, err, "failed to send request") + defer res.Body.Close() - json.NewDecoder(res.Body).Decode(&target) - for _, i := range target { - if i.Title == issueTitle { - repos := getRepositoriesFromBody(i.Body) - for _, repo := range repos { - (*flaggedRepositories)[repo] = true - } - } - } - return nil -} -func containsOpenIssue(link string, openIssues map[string]bool) bool { - _, ok := openIssues[link] - return ok -} -func testRepoState(toRun bool, href string, client *http.Client, staleRepos *[]string) bool { - if toRun { - ownerRepo := strings.ReplaceAll(href, "https://github.com", "") - apiCall := fmt.Sprintf(githubGETREPO, ownerRepo) - req, err := http.NewRequest("GET", apiCall, nil) - var repoResp repo - isRepoAdded := false - if err != nil { - log.Printf("Failed at repository %s\n", href) - return false - } - resp, err := client.Do(req) - if err != nil { - log.Printf("Failed at repository %s\n", href) - return false - } - defer resp.Body.Close() - json.NewDecoder(resp.Body).Decode(&repoResp) - if resp.StatusCode == 301 { - *staleRepos = append(*staleRepos, href+movedPermanently) - log.Printf("%s returned 301", href) - isRepoAdded = true - } - if resp.StatusCode == 302 && !isRepoAdded { - *staleRepos = append(*staleRepos, href+status302) - log.Printf("%s returned 302", href) - isRepoAdded = true - } - if resp.StatusCode >= 400 && !isRepoAdded { - *staleRepos = append(*staleRepos, href+deadLinkMessage) - log.Printf("%s might not exist!", href) - isRepoAdded = true - } - if repoResp.Archived && !isRepoAdded { - *staleRepos = append(*staleRepos, href+archived) - log.Printf("%s is archived!", href) - isRepoAdded = true - } - return isRepoAdded - } - return false -} -func testCommitAge(toRun bool, href string, client *http.Client, staleRepos *[]string) bool { - if toRun { - var respObj []map[string]interface{} - since := timeNow.Add(-1 * 365 * 24 * numberOfYears * time.Hour) - sinceQuery := since.Format(time.RFC3339) - ownerRepo := strings.ReplaceAll(href, "https://github.com", "") - apiCall := fmt.Sprintf(githubGETCOMMITS, ownerRepo) - req, err := http.NewRequest("GET", apiCall, nil) - isRepoAdded := false - if err != nil { - log.Printf("Failed at repository %s\n", href) - return false - } - q := req.URL.Query() - q.Add("since", sinceQuery) - req.URL.RawQuery = q.Encode() - resp, err := client.Do(req) - if err != nil { - log.Printf("Failed at repository %s\n", href) - return false - } - defer resp.Body.Close() - json.NewDecoder(resp.Body).Decode(&respObj) - isAged := len(respObj) == 0 - if isAged { - log.Printf("%s has not had a commit in a while", href) - *staleRepos = append(*staleRepos, href) - isRepoAdded = true - } - return isRepoAdded - } - return false -} -func testStaleRepository() { - query := startQuery() - var staleRepos []string + + var issues []issue + requireNoErr(t, json.NewDecoder(res.Body).Decode(&issues), "failed to unmarshal response") + addressedRepositories := make(map[string]bool) + for _, issue := range issues { + if issue.Title != issueTitle { + continue + } + + repos := getRepositoriesFromBody(issue.Body) + for _, repo := range repos { + addressedRepositories[repo] = true + } + } + + return addressedRepositories +} + +func checkRepoAvailability(toRun bool, href string, client *http.Client) ([]string, bool) { + if !toRun { + return nil, false + } + + ownerRepo := strings.ReplaceAll(href, "https://github.com", "") + apiCall := fmt.Sprintf(githubGETREPO, ownerRepo) + req, err := http.NewRequest(http.MethodGet, apiCall, nil) + if err != nil { + log.Printf("Failed at repository %s\n", href) + return nil, false + } + + resp, err := client.Do(req) + if err != nil { + log.Printf("Failed at repository %s\n", href) + return nil, false + } + + defer resp.Body.Close() + + var repoResp struct { + Archived bool `json:"archived"` + } + + if err := json.NewDecoder(resp.Body).Decode(&repoResp); err != nil { + return nil, false + } + + var isRepoAdded bool + + var warnings []string + if resp.StatusCode == http.StatusMovedPermanently { + warnings = append(warnings, href+movedPermanently) + log.Printf("%s returned %d", href, resp.StatusCode) + isRepoAdded = true + } + + if resp.StatusCode == http.StatusFound && !isRepoAdded { + warnings = append(warnings, href+status302) + log.Printf("%s returned %d", href, resp.StatusCode) + isRepoAdded = true + } + + if resp.StatusCode >= http.StatusBadRequest && !isRepoAdded { + warnings = append(warnings, href+deadLinkMessage) + log.Printf("%s might not exist!", href) + isRepoAdded = true + } + + if repoResp.Archived && !isRepoAdded { + warnings = append(warnings, href+archived) + log.Printf("%s is archived!", href) + isRepoAdded = true + } + + // FIXME: expression `(len(warnings) > 0) == isRepoAdded` is always true. + return warnings, isRepoAdded +} + +func checkRepoCommitActivity(toRun bool, href string, client *http.Client) ([]string, bool) { + if !toRun { + return nil, false + } + + ownerRepo := strings.ReplaceAll(href, "https://github.com", "") + apiCall := fmt.Sprintf(githubGETCOMMITS, ownerRepo) + req, err := http.NewRequest(http.MethodGet, apiCall, nil) + if err != nil { + log.Printf("Failed at repository %s\n", href) + return nil, false + } + + since := timeNow.Add(-1 * 365 * 24 * numberOfYears * time.Hour) + sinceQuery := since.Format(time.RFC3339) + + q := req.URL.Query() + q.Add("since", sinceQuery) + req.URL.RawQuery = q.Encode() + + resp, err := client.Do(req) + if err != nil { + log.Printf("Failed at repository %s\n", href) + return nil, false + } + + defer resp.Body.Close() + + var respObj []map[string]interface{} + // FIXME: handle error in all that cases + if err := json.NewDecoder(resp.Body).Decode(&respObj); err != nil { + return nil, false + } + + var warnings []string + var isRepoAdded bool + isAged := len(respObj) == 0 + if isAged { + log.Printf("%s has not had a commit in a while", href) + warnings = append(warnings, href) + isRepoAdded = true + } + + // FIXME: expression `(len(warnings) > 0) == isRepoAdded` is always true. + return warnings, isRepoAdded +} + +func TestStaleRepository(t *testing.T) { + doc := goqueryFromReadme(t) + oauth := os.Getenv("OAUTH_TOKEN") - client := &http.Client{} + client := &http.Client{ + Transport: &http.Transport{}, + } + if oauth == "" { log.Print("No oauth token found. Using unauthenticated client ...") } else { @@ -231,42 +270,47 @@ func testStaleRepository() { } client = oauth2.NewClient(context.Background(), tokenSource) } - err := getAllFlaggedRepositories(client, &addressedRepositories) - if err != nil { - log.Println("Failed to get existing issues. Exiting...") - return - } - query.Find("body li > a:first-child").EachWithBreak(func(_ int, s *goquery.Selection) bool { - href, ok := s.Attr("href") - if !ok { - log.Println("expected to have href") - return true - } - if ctr >= LIMIT && LIMIT != -1 { - log.Print("Max number of issues created") - return false - } - issueExists := containsOpenIssue(href, addressedRepositories) - if issueExists { - log.Printf("issue already exists for %s\n", href) - } else { - isGithubRepo := reGithubRepo.MatchString(href) - if isGithubRepo { - isRepoAdded := testRepoState(true, href, client, &staleRepos) - isRepoAdded = testCommitAge(!isRepoAdded, href, client, &staleRepos) - if isRepoAdded { - ctr++ - } - } else { + // FIXME: return addressedRepositories, no need to pass + addressedRepositories := getAllFlaggedRepositories(t, client) + + var staleRepos []string + doc. + Find("body li > a:first-child"). + EachWithBreak(func(_ int, s *goquery.Selection) bool { + href, ok := s.Attr("href") + if !ok { + log.Println("expected to have href") + return true + } + + if ctr >= LIMIT && LIMIT != -1 { + log.Print("Max number of issues created") + return false + } + + if _, issueExists := addressedRepositories[href]; issueExists { + log.Printf("issue already exists for %s\n", href) + return true + } + + if !reGithubRepo.MatchString(href) { log.Printf("%s non-github repo not currently handled", href) } - } - return true - }) - createIssue(staleRepos, client) -} -func TestStaleRepository(t *testing.T) { - testStaleRepository() + // FIXME: this is `or` expres24sion. Probably we need `and`? + warnings, isRepoAdded := checkRepoAvailability(true, href, client) + staleRepos = append(staleRepos, warnings...) + + warnings, isRepoAdded = checkRepoCommitActivity(!isRepoAdded, href, client) + staleRepos = append(staleRepos, warnings...) + + if isRepoAdded { + ctr++ + } + + return true + }) + + createIssue(t, staleRepos, client) } diff --git a/tmpl/_redirects b/tmpl/_redirects deleted file mode 100644 index d1c859a5..00000000 --- a/tmpl/_redirects +++ /dev/null @@ -1,2 +0,0 @@ -/awesome-cloud-native/ / -/awesome-go-fork/ / diff --git a/tmpl/assets/awesome-go.css b/tmpl/assets/awesome-go.css index eae76812..e0e5011b 100644 --- a/tmpl/assets/awesome-go.css +++ b/tmpl/assets/awesome-go.css @@ -114,3 +114,7 @@ h1 > a img { font-size: 9px; line-height: 1; } + +td { + padding: 6px; +} diff --git a/tmpl/assets/favicon/android-chrome-192x192.png b/tmpl/assets/favicon/android-chrome-192x192.png new file mode 100644 index 00000000..9596cfcb Binary files /dev/null and b/tmpl/assets/favicon/android-chrome-192x192.png differ diff --git a/tmpl/assets/favicon/android-chrome-512x512.png b/tmpl/assets/favicon/android-chrome-512x512.png new file mode 100644 index 00000000..84fe314b Binary files /dev/null and b/tmpl/assets/favicon/android-chrome-512x512.png differ diff --git a/tmpl/assets/favicon/apple-touch-icon.png b/tmpl/assets/favicon/apple-touch-icon.png new file mode 100644 index 00000000..18c182f4 Binary files /dev/null and b/tmpl/assets/favicon/apple-touch-icon.png differ diff --git a/tmpl/assets/favicon/favicon.ico b/tmpl/assets/favicon/favicon.ico new file mode 100644 index 00000000..1eba1ab9 Binary files /dev/null and b/tmpl/assets/favicon/favicon.ico differ diff --git a/tmpl/assets/favicon/manifest.json b/tmpl/assets/favicon/manifest.json new file mode 100644 index 00000000..2d423ac6 --- /dev/null +++ b/tmpl/assets/favicon/manifest.json @@ -0,0 +1,19 @@ +{ + "name": "Awesome Go", + "short_name": "Awesome-Go", + "icons": [ + { + "src": "./android-chrome-192x192.png", + "sizes": "192x192", + "type": "image/png" + }, + { + "src": "./android-chrome-512x512.png", + "sizes": "512x512", + "type": "image/png" + } + ], + "theme_color": "#ffffff", + "background_color": "#ffffff", + "display": "standalone" +} diff --git a/tmpl/cat-tmpl.html b/tmpl/cat-tmpl.html deleted file mode 100644 index aede5c61..00000000 --- a/tmpl/cat-tmpl.html +++ /dev/null @@ -1,109 +0,0 @@ - - - - - - - - - {{.Title}} - Awesome Go / Golang - - - - - - - - - - - - - - - - - -
-
-

- - awesome-go - - {{.Title}} - Awesome Go -

- -

{{.Description}}

- -

- Build Status - Awesome - Slack Widget - Netlify Status - Track Awesome List -

- -

- -

- -
-
-

Sponsorships

-

-

- -

-

- - Doppler -
- Quit struggling with scattered API keys and access controls. - -

-

- - x-team -
- Work from anywhere in the world with top tech companies like Riot Games, Coinbase, and Google. - -

-

- Digital Ocean -

-
- - 🗺️ back to content menu - - - - - Deploys by Netlify - -
- - - - - - - \ No newline at end of file diff --git a/tmpl/category-index.tmpl.html b/tmpl/category-index.tmpl.html new file mode 100644 index 00000000..808f2b60 --- /dev/null +++ b/tmpl/category-index.tmpl.html @@ -0,0 +1,113 @@ + + + + + + + {{.Title}} - Awesome Go / Golang + + + + + + + + + + + + + + + + + +
+
+

awesome-go {{.Title}} - + Awesome Go

+

{{.Description}}

+

Build Status Awesome Slack Widget Netlify Status +

+

+
🗺️ back to content + menu + Deploys by Netlify +
+ + + + + diff --git a/tmpl/tmpl.html b/tmpl/index.tmpl.html similarity index 78% rename from tmpl/tmpl.html rename to tmpl/index.tmpl.html index dcc35c8c..3142c956 100644 --- a/tmpl/tmpl.html +++ b/tmpl/index.tmpl.html @@ -1,34 +1,39 @@ - + - - - - + + + A curated list of awesome Go frameworks, libraries and software - Awesome Go / Golang - - - + + + - + - - - + + + + + + + + +
-

+

-

+
{{.Body}} diff --git a/tmpl/robots.txt b/tmpl/robots.txt index 72158267..f6e6d1d4 100644 --- a/tmpl/robots.txt +++ b/tmpl/robots.txt @@ -1 +1,2 @@ User-Agent: * +Allow: / diff --git a/tmpl/sitemap-tmpl.xml b/tmpl/sitemap.tmpl.xml similarity index 100% rename from tmpl/sitemap-tmpl.xml rename to tmpl/sitemap.tmpl.xml