Yarn: 도우미 대 Util 대 Utils

저는 단수 Util 가 가장 좋습니다. 👍 유틸. 👎 도우미용, 😕 Utils용

tbh 나는 어떤 식으로든 갈 수 있습니다. 다만 일관성을 갖자.

또한 동사가 있는 경우 -ing(동명사), 예: Chatting NetworkThreading 또는 복수 명사, 예: Projectiles Screenshots over Helper Util 등

MathHelper -> Maths ?? 또는 Util -> s ??

나는 Mathematics 에 대한 유효한 약어임을 감안할 때 오래 전에 Maths 에 대해 주장했습니다. https://github.com/FabricMC/yarn/issues/249#issuecomment -446102638

Yarn은 미국식 영어 이름을 사용합니다. 여기서 Maths 는 Mathematics 에 대한 유효한 약어가 아닙니다.

동명사 또는 복수형이 모두 적용되지 않는 경우 Helper 접미사로 대체하는 것이 좋습니다. 그렇지 않으면 Texts 와 같이 $ ing 또는 s 를 선호합니다.

또한 DrawableHelper 는 유틸리티 클래스가 아니라 편리한 인스턴스 메소드가 많은 기능적 인터페이스 또는 추상 클래스입니다.

-ing 및 -s에 대한 liach의 제안에 대한 내 문제는 일관성을 유지하기가 매우 어려워 문제의 목적을 완전히 무효화한다는 것입니다. count 명사 유틸리티 클래스가 -s 로 끝나도록 만들 수 있지만 Nbts , RailPlacements , Maps 와 같은 예외가 발생합니다. 일관성을 유지하는 것은 불가능합니다.

우리는 표준을 채택하고 그것에 충실해야 합니다. 투표를 보면 Helper 또는 Util 이어야 하지만 Utils 는 안됩니다.

Util over Helper 에 대한 한 가지 주장은 $# Util 클래스 자체가 Helper 라고 불리는 것이 이치에 맞지 않는다는 것입니다. MathHelper 가 MathUtil 라고 불리는 것은 나쁘지 않을 거라고 생각합니다. 단지 모든 사람들이 MathHelper 로 불리는 것에 익숙하기 때문입니다. 나는 수학 유틸리티 클래스가 MathUtil 라고 불리는 프로젝트에서 일해 왔으며, 전혀 문제가 되지 않고 아무런 차이가 없습니다. MathUtil 라는 이름은 MathHelper 이름 변경 문제에서 논의조차 되지 않았습니다.

현재 $ Helper Util 클래스가 더 많지만 실제로 해당 클래스를 사용하는 빈도에 따라 가중치를 부여해야 하므로 지금부터 살펴보고 결과를 보고하겠습니다. .

대부분의 사람들이 Helper 접미사를 사용하는 것 같습니다. 따라서 Util 또는 Utils (클래스 Util 자체 제외)로 끝나는 모든 현재 클래스의 이름을 $# Helper 4$#$ 로 바꾸는 것을 제안합니다. Helper 로 끝나는 다른 클래스의 이름을 바꾸는 것은 별도의 문제에서 논의할 수 있습니다.

대부분의 사람들이 Helper 접미사를 사용하는 것 같습니다.

아니요?

오, 이런, 나는 장님이 되어야 합니다. 그런 다음 Helper 로 끝나는 모든 클래스의 이름을 Util 로 끝낼 것을 제안합니다.

나는 접미사가 악마의 일이며 *elperer 및 *til 로 끝나는 모든 클래스의 이름을 그 접미사가 없도록 이름을 바꿀 것을 제안합니다.

MathHelper -> Maths .

PiglinHelper -> Piglins

Yarn은 미국식 영어 이름을 사용합니다. 여기서 Maths 는 Mathematics 에 대한 유효한 약어가 아닙니다.

Maths 가 미국식 용어인 줄 알았습니다.

MathHelper -> Mathinator

Maps ? 나

또한 Guava는 Maps , Sets , Collections , Streams 와 같은 복수형 패턴을 사용합니다.

이것은 복수형을 사용할 때의 문제였습니다. 이름이 좋아 보이지만 예외가 너무 많습니다. 단어가 대량 명사(예: "수학")이므로 복수형이 없거나 복수형이 이미 다른 라이브러리(예: "지도")에서 사용되기 때문입니다. 일관성을 유지하기가 너무 어려워 처음부터 변경하는 요점을 무산시킬 것입니다.

복수형으로 괜찮을 이름:

• 버퍼
• 데이터스트림
• 드로어블
• 기본 스킨
• 밉맵
• Nbts
• 레일 플레이스먼트
• 스폰
• 입력
• 모델
• 텍스처
• 파일 이름
• 발사체
• 룩타겟
• 구조 테스트
• 테스트
• 스크린샷
• Gl할당

질량 명사이거나 명사가 아니기 때문에 괜찮지 않은 이름:

• 제이슨
• 수학
• 알
• Glfws
• 스무딩
• Damages(복수는 다른 의미를 가짐)
• 네트워크(여기에는 하나의 네트워크만 있음)
• NetworkThreads(네트워크 스레드는 하나만 있음)
• 네트워크 암호화

이미 사용 중이어서 사용할 수 없는 이름:

• 마법
• 지도
• 상태효과
• 물약

기타 이유로 허용되지 않는 이름:

• Rotation3(이 이름은 더 많은 생각이 필요함)
• 채팅(기술적으로 채팅의 복수형이지만 "채팅"에 대한 유틸리티 클래스에는 적합하지 않습니다. 그것이 그 목적이라고 가정합니다. 텍스트 구성 요소를 위한 것이라면 "텍스트"는 괜찮은 이름일 것입니다)
• Utils("s"로 이름을 바꿀 수는 없습니다. lol, "Util"로 유지하는 것이 좋습니다)

전체적으로 18/34 이름은 복수형으로 괜찮을 것입니다. 즉, 다른 16개에 대해 더 나은 이름을 찾아야 한다는 의미입니다. 일관성을 위해 너무 많습니다.

의미가 있는 곳에서는 복수형을 사용하고 의미가 없는 곳에서는 Util 접미사를 사용하는 것이 좋습니다. 그러면 최소한 "Helper"와 "Util" 중에서 무작위로 선택하는 것보다 따라야 할 규칙이 있습니다. 이것이 현재 우리가 하는 일입니다.

@Earthcomputer NetworkThreads 는 잘 작동합니다. 네트워크 스레드 작업을 위한 유틸리티입니다. 하나만 있어도 상관없습니다.

당신은 그 중 하나 또는 두 가지 점에서 나와 동의하지 않을 수 있지만 그것이 요점이 아니며 18/34의 전체 비율을 많이 변경하지 않습니다.

나는 Util 또는 Helper 에 대해 주장하고, 그것들을 완전히 제거하는 것은 나에게 너무 많은 의미가 없습니다.

그런데 일부는 Util 이라는 이름을 지정할 수 없습니다. 예를 들어 DataStreamHelper 는 util 클래스가 아니라 데이터 스트림을 래핑하는 개체입니다.