guardian/typerighter được TopGit xếp vào nhóm dự án mã nguồn mở, với 277 sao trên GitHub, viết chủ yếu bằng Scala. Even if you’re the right typer, couldn’t hurt to use Typerighter!
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Typerighter is the server-side part of a service to check a document against a set of user-defined rules. It's designed to work like a spelling or grammar checker. It contains two services, the checker and the rule manager – see architecture for more information.
We use it at the Guardian to check content against our style guide. Max Walker, the subeditor who inspired the creation of Typerighter, has written an introduction here.
To understand our goals for the tool, see the vision document.
For setup, see the docs directory.
For an example of a Typerighter client (the part that presents the spellcheck-style interface to the user), see prosemirror-typerighter.
How it works: an overview
The Typerighter Rule Manager produces a JSON artefact (stored in S3) which is ingested by the Checker service. This artefact represents all the rules in our system, currently including user-defined regex rules, user-defined Language Tool pattern rules (defined as XML) and Language Tool core rules (pre-defined rules from Language Tool). Historically, rules were derived from a Google Sheet, rather than the Rule Manager.
Each rule in the service corresponds to a Matcher that receives the document and passes back a list of RuleMatch. We have the following Matcher implementations:
RegexMatcher uses regular expressions
LanguageToolMatcher is powered by the LanguageTool project, and uses a combination of native LanguageTool rules and user-defined XML rules as its corpus
Matches contain the range that match applies to, a description of why the match has occurred, and any relevant suggestions – see the RuleMatch interface for the full description.
Architecture
Roles
Rule owner: a person responsible for maintaining the rules that Typerighter consumes.
Rule user: a person checking their copy with the checker service.
The system consists of two Scala services:
The rule-manager service, which is responsible for the lifecycle of Typerighter's corpus of rules, and publishes them as an artefact
The checker service, which consumes that artefact and responds to requests to check copy against the corpus of rules with matches.
Typerighter's built to manage document checks of every kind, include checks that we haven't yet thought of. To that end, a MatcherPool is instantiated for each running checker service, which is responsible for managing incoming checks, including parallelism, backpressure, and ensuring that our checks are given to the appropriate matchers.
A MatcherPool accepts any matcher instance that satisfies the Matcher trait. Two core Matcher implementations include RegexMatcher, that checks copy with regular expressions, and LanguageToolMatcher, that checks copy with an instance of a JLanguageTool. The MatcherPool is excited to accommodate new matchers in the future! Here's a diagram to illustrate:
Both the Checker and Rule Manager services are built in Scala with the Play framework. Data in the Rule Manager is stored in a Postgres database, queried via ScalikeJDBC.
Google credentials are fetched from SSM using AWS Credentials or Instance Role.
It's worth noting that, at the moment, there are a fair few assumptions built into this repository that are Guardian-specific:
We assume the use of AWS cloud services, and default to the eu-west-1 region. This is configurable on a per-project basis with the configuration parameter aws.region.
Building and deployment is handled by riff-raff, the Guardian's deployment platform.
Configuration is handled by simple-configuration.
We'd be delighted to participate in discussions, or consider PRs, that aimed to make Typerighter easier to use in a less institutionally specific context.
Integration
The prosemirror-typerighter plugin provides an integration for the Prosemirror rich text editor.
If you'd like to provide your own integration, this service will function as a standalone REST platform, but you'll need to use pan-domain-authentication to provide a valid auth cookie with your requests.
Upgrading LanguageTool
LanguageTool has core rules that we use, and as we upgrade LT, these could change underneath us.
There's a script to see if rules have changed as a result of an upgrade in ./script/js/compare-rule-xml.js.
Formatting
Prettier formatting
Prettier is installed in the client app using the Guardian's recommended config. To format files you can run npm run format:write. A formatting check will run as part of CI.
To configure the IntelliJ Prettier plugin to format on save see the guide here. To configure the VS Code Prettier plugin see here.
Scala formatting
Typerighter uses Scalafmt to ensure consistent linting across all Scala files.
To lint all files you can run sbt scalafmtAll
To confirm all files are linted correctly, you can run sbt scalafmtCheckAll
You can configure your IDE to format scala files on save according to the linting rules defined in .scalafmt.conf
For intellij there is a guide to set up automated linting on save here and here. For visual studio code with metals see here
Automatic formatting
The project contains a pre-commit hook which will automatically run the Scala formatter on all staged files. To enable this, run ./script/setup from the root of the project.
Developer how-tos
Connecting to the rule-manager database in CODE or PROD
Sometimes it's useful to connect to the databases running in AWS to inspect the data locally.
We can use ssm-scala to create an SSH tunnel that exposes the remote database on a local port. For example, to connect to the CODE database, we can run:
You'll need to use the username and password specified in AWS parameter store at /${STAGE}/flexible/typerighter-rule-manager/db.default.username and db.default.password. For example, you may run the following commands with AWS cli to get those values for CODE:
You should then be able to connect the database on localhost:5000. You may use psql as the frontend sql client. Typerighter DB uses the default database name postgres.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/guardian/typerighter là nguồn chính thức.
guardian/typerighter có bao nhiêu sao?
guardian/typerighter có 277 sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/guardian/typerighter. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
guardian/typerighter có phải mã nguồn mở không?
Có — guardian/typerighter phát hành theo license Apache-2.0, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/guardian/typerighter.
guardian/typerighter còn đang phát triển không?
Commit gần nhất trên guardian/typerighter là 20 ngày trước (theo timestamp GitHub). Repo có 10 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
guardian/typerighter dùng license gì?
guardian/typerighter phát hành theo license Apache-2.0. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
guardian/typerighter là gì?
guardian/typerighter (guardian/typerighter) là dự án Scala trên GitHub. Theo mô tả gốc: Even if you’re the right typer, couldn’t hurt to use Typerighter!
guardian/typerighter viết bằng ngôn ngữ gì?
guardian/typerighter chủ yếu viết bằng Scala. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Đọc đầy đủ README ở tab phía trên.
typerighter có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về typerighter.