vektah/gqlparser

0

/ 100

Documentation58
Engineering99
Health100
Go559MIT1d ago
Grade a repo

Polished and well engineered. Punching above its star count.

A port of the parser from graphql-js into golang

Documentation

58

Contributing guide5pt0

No CONTRIBUTING.md found (−47 pts base + up to −53 pts more for content).

→ Add a CONTRIBUTING.md telling newcomers how to get involved. Include setup, code style, test, and PR instructions.

Install and run instructions9pt45

No install instructions found in the README (−45 pts).

→ Add a section showing how to install dependencies.

README12pt70

README is present.

License6pt100

Licensed under MIT.

Engineering

99

Reproducibility6pt95

Lockfile present (go.sum). Installs are reproducible.

Tests18pt100

Test files detected (ast/argmap_test.go).

CI/CD14pt100

CI is configured (.github/workflows/lint.yml).

Linting and formatting5pt100

Formatting enforced (.github/.editorconfig).

Issue and PR templates6pt100

Issue or PR templates present.

Project health

100

Dependency manifest6pt100

Dependency manifest found (go.mod).

Repository metadata5pt100

Repository has a description.

Activity5pt100

Actively maintained (pushed within the last month).

Housekeeping3pt100

.gitignore present.

Repository health signals

Activity, community, and responsiveness at scan time

Activity

  • —
    Commits (30d / 90d)
  • 139
    Forks
  • 59
    Releaseslatest 6y ago

Community

  • —
    Community health
  • —
    authors own >50% of commits
  • 559
    Watchers

Responsiveness

  • 3h
    Median issue response
  • <1h
    Median PR merge time
  • 37
    Open issues
Repository files18 root entries
  • .circleci
  • .github
    Good: CI is configured (.github/workflows/lint.yml).
    Good: Formatting enforced (.github/.editorconfig).
    Good: Dependabot covers 3 ecosystems (github-actions, gomod, npm). Dependencies stay current.
    Good: Issue or PR templates present.
  • ast
    Good: Test files detected (ast/argmap_test.go).
  • bin
  • formatter
  • gqlerror
  • lexer
  • parser
  • validator
  • .gitignore
    Good: .gitignore present.
  • .go-version
  • .golangci.yaml
  • go.mod
    Good: Dependency manifest found (go.mod).
  • go.sum
    Good: Lockfile present (go.sum). Installs are reproducible.
  • gqlparser.go
  • LICENSE
    Good: Licensed under MIT.
  • readme.md
    Good: README is present.
    Issue: README has little structure (−15 pts). Add 2-3 headings for +8 pts; 4+ earns +15 pts.Fix: Break it into sections (Overview, Install, Usage, Contributing) using Markdown headings.
    Good: README includes screenshots or visuals. Great for first impressions.
    Issue: README has no code examples (−15 pts).Fix: Show a quick-start snippet so contributors can see what using your project looks like.
    Good: README links to a live demo or deployed app.
    Good: README includes status badges.
    Issue: No install instructions found in the README (−45 pts).Fix: Add a section showing how to install dependencies.
    Good: README documents how to run the project.
  • WIP.md