# service-naming

Source: https://api-genie.dev/docs/linter/protobuf/rules/service-naming

A rule of the Protobuf linter, which reads proto3 files; the reader rejects proto2 and editions files. Since 0.9.0. In the rulesets: Recommended at warning, Strict at error, All at error.

This rule checks whether the name of every service of a Protobuf file is in `PascalCase`.

## Rule details

The service name becomes the base of the names of the generated client and server classes, so it
should follow the type naming conventions of the target languages.

The `service-naming` rule checks every service, and reports `Service name '<name>' should be
PascalCase` for every name that is not in `PascalCase`. A name is in `PascalCase` when it starts
with an upper-case letter and contains only letters and digits, such as `PetOwner` (acronyms
such as `HTTPServer` are accepted).

When the name converted to `PascalCase` differs from the original and is itself valid, the
message ends with a suggestion, for example `, e.g. '<converted>'`. To convert a name, it is
split into words at underscores and other separators, at lower-to-upper case changes and before
the last capital of an acronym, and the words are capitalized and joined, so `pet_owner` becomes
`PetOwner`.

Turn the rule off if the names are part of an existing API that you cannot rename. To allow a single
service, add an `// apigenie-lint-disable service-naming` comment to it.

## Examples

**Good**.

```proto
syntax = "proto3";

package acme.pets.v1;

service PetService {
  rpc GetPet(GetPetRequest) returns (GetPetResponse);
}

message GetPetRequest {
  string name = 1;
}

message GetPetResponse {
  string name = 1;
}
```

**Bad**. The linter reports `Service name 'pet_service' should be PascalCase, e.g. 'PetService'`.

```proto
syntax = "proto3";

package acme.pets.v1;

service pet_service {
  rpc GetPet(GetPetRequest) returns (GetPetResponse);
}

message GetPetRequest {
  string name = 1;
}

message GetPetResponse {
  string name = 1;
}
```
