randSuffix
문자열 하나, 또는 배열 안의 모든 문자열 뒤에 무작위 토큰을 붙입니다. MistyOwl은 MistyOwl_nVtRC가 됩니다. 두 사람이 같은 닉네임에 닿을 만한 확률을, 거의 닿지 않을 확률로 낮춰 줍니다. 이 라이브러리가 만든 문자열이 아니어도 받습니다.
import { randNickname, randSuffix } from 'randino';
randSuffix('MistyOwl'); // 'MistyOwl_nVtRC'
randSuffix('MistyOwl', { length: 8, separator: '-' }); // 'MistyOwl-k3Rm9dQx'
randSuffix(randNickname({ language: 'en', count: 2 }));
// ['RoundSeason_RVBnC', 'RowdyDusk_dwtu5']| 옵션 | 타입 | 기본값 | 설명 |
|---|---|---|---|
value | string | string[] | — | 뒤에 붙일 대상. 옵션이 아니라 첫 번째 인자. 생략하면 토큰만 |
length | number | 5 | 토큰의 글자 수. 1 … 32로 제한 |
separator | string | '_' | 값과 토큰 사이에 들어감. 빈 문자열이면 바로 이어 붙음 |
charset | string | 내장 | 토큰을 뽑아 쓸 문자들 |
random | () => number | — | 무작위성을 어디서 가져올지. 난수원 고르기를 보세요 |
string에는 string을, string[]에는 string[]을 반환합니다.
import 'package:randino/randino.dart';
randSuffix(value: 'MistyOwl'); // 'MistyOwl_nVtRC'
randSuffix(value: 'MistyOwl', length: 8, separator: '-'); // 'MistyOwl-k3Rm9dQx'
randSuffixAll(randNickname(language: WordLanguage.en, count: 2));
// ['RoundSeason_RVBnC', 'RowdyDusk_dwtu5']| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
value | String? | null | 뒤에 붙일 대상. 생략하면 토큰만 |
length | int | 5 | 토큰의 글자 수. 1 … 32로 제한 |
separator | String | '_' | 값과 토큰 사이에 들어감 |
charset | String? | null | 토큰을 뽑아 쓸 문자들 |
random | Random? | null | 무작위성을 어디서 가져올지. 난수원 고르기를 보세요 |
String을 반환합니다. value를 포함해 모든 파라미터가 이름 있는 파라미터입니다. Dart는 선택적 위치 파라미터와 이름 있는 파라미터를 함께 쓸 수 없고, 값을 선택 사항으로 만드는 쪽이 짧은 호출보다 가치가 있었습니다. 리스트 형태는 randSuffixAll입니다. List<String>을 받아 List<String>을 돌려주며, 이름 있는 파라미터는 동일합니다. Dart에는 오버로드도 유니온 타입도 없기 때문에, 하나가 두 형태를 받는 대신 두 함수로 나뉘어 있습니다.
from randino import rand_nickname, rand_suffix
rand_suffix("MistyOwl") # 'MistyOwl_nVtRC'
rand_suffix("MistyOwl", length=8, separator="-") # 'MistyOwl-k3Rm9dQx'
rand_suffix(rand_nickname(language="en", count=2))
# ['RoundSeason_RVBnC', 'RowdyDusk_dwtu5']| 인자 | 타입 | 기본값 | 설명 |
|---|---|---|---|
value | str | list[str] | None | None | 뒤에 붙일 대상. 위치 인자이며 나머지는 키워드 전용. 생략하면 토큰만 |
length | int | 5 | 토큰의 글자 수. 1 … 32로 제한 |
separator | str | "_" | 값과 토큰 사이에 들어감 |
charset | str | "" | 토큰을 뽑아 쓸 문자들. 비어 있으면 기본값 |
random | Callable[[], float] | None | None | 무작위성을 어디서 가져올지. 난수원 고르기를 보세요 |
str에는 str을, list[str]에는 list[str]을 반환합니다. @overload가 이 대응을 그대로 전달하므로 타입 검사기도 어느 쪽인지 압니다.
토큰만 얻기
장식 함수가 붙이는 것은 붙일 대상이 없어도 그 자체로 쓸모가 있으므로 값은 선택 사항입니다. 값을 주지 않으면 randSuffix는 토큰만 돌려주고, 사이에 둘 것이 없으므로 구분자는 붙지 않습니다.
randSuffix(); // 'nVtRC'
randSuffix({ length: 8 }); // 'k3Rm9dQx'첫 번째 인자는 값 또는 옵션이며, 문자열이 옵션 객체가 될 일은 없으므로 두 형태 모두 모호하지 않게 읽힙니다.
randSuffix(); // 'nVtRC'
randSuffix(length: 8); // 'k3Rm9dQx'rand_suffix() # 'nVtRC'
rand_suffix(length=8) # 'k3Rm9dQx'빈 문자열은 값이고, 값을 주지 않은 것은 값이 아닙니다. randSuffix('')randSuffix(value: '')rand_suffix("")는 구분자까지 포함해 '_nVtRC'를 돌려줍니다.
값마다 새로 뽑은 토큰
토큰은 호출마다 하나가 아니라 값마다 하나씩 뽑습니다. 닉네임 100개를 넘기면 서로 다른 토큰 100개가 붙으므로 결과끼리도 겹치지 않습니다. 리스트를 넘길 이유가 이것입니다.
randSuffix(['Owl', 'Owl', 'Owl']);
// ['Owl_nVtRC', 'Owl_AVcCV', 'Owl_gDe2C']randSuffixAll(const ['Owl', 'Owl', 'Owl']);
// ['Owl_nVtRC', 'Owl_AVcCV', 'Owl_gDe2C']rand_suffix(["Owl", "Owl", "Owl"])
# ['Owl_nVtRC', 'Owl_AVcCV', 'Owl_gDe2C']기본 문자 집합은 헷갈리는 글자를 뺍니다
0과 O, 1과 l과 I가 없습니다. 접미사는 한 화면에서 읽어 다른 화면에 입력하는 값이고, 문제가 생기는 지점이 정확히 그 다섯 글자입니다. 더 좁히고 싶다면 더 짧은 문자 집합을 넘기면 됩니다.
randSuffix('MistyOwl', { charset: '0123456789' }); // 'MistyOwl_40218'
randSuffix('MistyOwl', { charset: AFFIX_CHARSET.replace(/[A-Z]/g, '') }); // 'MistyOwl_kq3mv'randSuffix(value: 'MistyOwl', charset: '0123456789'); // 'MistyOwl_40218'
randSuffix(value: 'MistyOwl', charset: affixCharset.replaceAll(RegExp('[A-Z]'), '')); // 'MistyOwl_kq3mv'rand_suffix("MistyOwl", charset="0123456789") # 'MistyOwl_40218'
rand_suffix("MistyOwl", charset="".join(c for c in AFFIX_CHARSET if not c.isupper()))
# 'MistyOwl_kq3mv'토큰은 무작위일 뿐, 추측 불가능하지는 않습니다
토큰은 각 플랫폼의 일반 난수 생성기에서 나옵니다. Math.random, dart:math의 Random, Python의 random은 모두 암호학적으로 안전한 난수원이 아닙니다. 여기서 두 가지가 따라오고, 둘 다 보기보다 중요합니다.
- 토큰은 추측할 수 있습니다. 이런 생성기는 작은 내부 상태를 굴리는데, 그 상태는 출력 몇 개만으로 복원됩니다. 토큰 몇 개를 본 사람은 다음에 나올 토큰을 계산해 낼 수 있습니다.
- 토큰은 겹칠 수 있습니다. 기본값은 57자 알파벳에서 고른 다섯 글자, 즉 601,692,057가지입니다. 생일 문제로 3만 개 언저리부터 충돌이 잦아지고, 5만 개를 뽑은 실제 실행에서 한 번 겹쳤습니다.
length를 늘리면 그 지점이 멀어지지만(여덟 글자는 3.7 × 10¹⁴가지) 0이 되지는 않습니다.
그래서 접미 토큰은 닉네임 둘을 구분하는 데는 맞고, 추측 불가능해야 하는 값에는 맞지 않습니다. 세션 토큰, 초대 코드, 비밀번호 재설정 링크, 남이 훑어서는 안 되는 객체 키가 그렇습니다. 그런 값에는 random 옵션으로 보안 난수원(crypto.getRandomValues, Random.secure(), SystemRandom)을 넘기고, 반드시 유일해야 하는 값에는 토큰이 아니라 데이터베이스 제약을 쓰십시오.
닉네임 옵션이 아닌 이유
문자열에 토큰을 붙이는 일은 닉네임이 아니라 문자열에 관한 것이기 때문입니다. 별도 함수여서 이름에도, 주문 번호에도, 이미 만들어 둔 어떤 문자열에도 쓸 수 있습니다. 그리고 닉네임 생성기의 길이 옵션은 접미사를 뺀 앞부분이 아니라 닉네임 전체를 가리킵니다.
함께 보기
randPrefix— 같은 토큰을 뒤가 아니라 앞에.randModifier— 토큰 대신 단어를 붙이는 세 번째 장식 함수.randNickname— 이 함수를 가장 자주 붙이는 대상.- 상수 — 기본 문자 집합과 길이 상한.