npm view 는 설치하지 않고 레지스트리에서 패키지 정보를 읽는다. versions 필드는 게시된 모든 버전 목록이고, time 필드는 버전마다 게시된 시각이다.

-- 설치하지 않고 레지스트리 메타데이터를 읽는다
npmView :: Package -> Field -> IO Json
npmView "cowsay" "versions"   -- 게시된 모든 버전
npmView "cowsay" "time"       -- 버전마다 게시된 시각
#210

npm 은 지금 실행 중인 스크립트 이름을 npm_lifecycle_event 환경 변수로 넘긴다. dev:hello 스크립트에서 ${npm_lifecycle_event#dev:} 로 접두사를 떼면 hello 가 남는다. 스크립트는 sh 로 돌기 때문에 bash 전용 ${var//a/b} 대신 POSIX ${var#prefix} 를 쓴다. 다만 이렇게 하기보다 스크립트를 따로 쓰는 편이 낫다.

-- npm 은 실행 중인 스크립트 이름을 npm_lifecycle_event 로 넘긴다
stage :: String -> Maybe String
stage = stripPrefix "dev:"       -- ${npm_lifecycle_event#dev:} — sh 로 돌아서 POSIX # 만 (bash 의 // 는 안 된다)

stage "dev:hello" == Just "hello"
-- 이렇게 하기보다 스크립트를 따로 쓰는 게 낫다
#213

CRA 는 .env 의 ${VAR} 를 이미 있는 환경 변수 값으로 채운다(dotenv-expand). turbo 는 태스크를 돌릴 때마다 그 태스크의 해시를 TURBO_HASH 로 넣어 주므로, REACT_APP_VERSION=0.0.0-${TURBO_HASH} 로 두면 버전이 자동으로 채워진다.

-- CRA: .env 의 ${VAR} 를 이미 있는 환경 변수로 채운다 (dotenv-expand)
expand :: Env -> String -> String
expand env = replaceVars (\v -> fromMaybe "" (lookup v env))

-- turbo 가 태스크마다 TURBO_HASH 를 넣어 준다 — REACT_APP_VERSION 을 자동으로 채울 방법을 찾다가 해시를 붙였다
expand [("TURBO_HASH", "ab12")] "0.0.0-${TURBO_HASH}" == "0.0.0-ab12"   -- REACT_APP_VERSION
#229

리눅스는 사용자당 만들 수 있는 inotify 감시 개수에 상한(max_user_watches)이 있다. 파일이 많아 상한을 넘으면 System limit for number of file watchers reached 가 나고 webpack 의 파일 감시가 변경을 알아채지 못한다. /etc/sysctl.conf 에 fs.inotify.max_user_watches=524288 을 넣고 sysctl -p 로 적용한다.

-- inotify: 사용자당 감시 개수에 상한이 있다
watched :: [File] -> Bool
watched files = length files <= maxUserWatches   -- 넘으면 webpack 이 변경을 못 알아챈다
                                                 -- "System limit for number of file watchers reached"
-- echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
#234

빌드할 때 버전에 꼬리표를 붙이려면 date +%s 로 1970-01-01 UTC 이후 초를 쓸 수 있다. 실제로는 .env 에서 REACT_APP_VERSION=1.0.0-${TURBO_HASH} 처럼 turbo 가 태스크마다 넣어 주는 해시를 dotenv-expand 로 펼쳐 쓴다 — 내용이 같으면 해시도 같다.

-- 빌드 버전에 꼬리표
version :: Either Timestamp TurboHash -> String
version (Left t)  = "1.0.0-" ++ show t   -- $(date +%s): 1970-01-01 UTC 이후 초, 빌드마다 다르다
version (Right h) = "1.0.0-" ++ h        -- .env 의 ${TURBO_HASH} — 실제로는 이쪽 (dotenv-expand)
#235

로컬에서만 실행 해야하는 프로젝트가 있길래 아무래도 사전설정 같은 귀찮은 문제가 있으니 pkg를 사용하면 좋을 것 같아서 들어가봤는데 개발이 중단 되었다.

노드 21버젼에서 해당 기능이 지원되는데 재미있는 시도들이 많이 나왔으면 좋겠다.


#300

Windows 에서는 ActiveXObject(“Excel.Application”) 로 실행 중인 Excel 을 COM 객체로 잡는다. Node 에서는 node-activex 가 같은 일을 한다. 그다음은 Excel 객체 모델을 따라 내려간다 — Application 에서 Workbook, Worksheet, Range 순. Excel View 는 이렇게 활성 셀의 행 전체를 읽어 별도 창에 띄운다.

-- Node 에서 Excel: COM(ActiveX) 으로 실행 중인 앱을 잡고 객체 모델을 따라 내려간다
activeX :: ProgId -> IO Application         -- new ActiveXObject('Excel.Application') · node-activex

-- Application → Workbooks → Worksheets → Range
activeRow :: IO Range
activeRow = entireRow . activeCell <$> activeX "Excel.Application"   -- Excel View: 활성 셀의 행을 별도 창에

-- 아직 안 해본 것: 객체 모델 · view 기능을 스프레드시트로
#312

imagemin을 사용하려고 하는데 module로 라이브러리가 업데이트 되어서 찾아본 내용. 혼란스러운 부분도 있지만 성숙해지는 과정이라고 본다.


Footnotes

  1. esm 배경과 tsup, unbuild 라는 두개의 해결방법을 소개해주고 있다. ↩

#58

URL 을 fetch 해 응답을 arrayBuffer 로 받아 Buffer 로 바꾸고, 폴더가 없으면 만든 뒤 URL 경로의 파일 이름으로 저장한다.

-- 이미지 다운로드: 응답을 Buffer 로 받아 파일로
download :: Url -> IO ()
download url = do
  buf <- fromArrayBuffer <$> (fetch url >>= arrayBuffer)
  createDirectoryIfMissing folder                       -- 없으면 mkdir
  writeFile (folder </> takeFileName (pathname url)) buf
#59

enqueue 는 has → add → queue.add 를 await 없이 한 턴에 끝내 락이 필요 없다. 큐는 무제한 대기열과 동시성 상한이 걸린 실행 중으로 나뉜다. visit 은 GET 으로 본문을 받아 링크를 뽑고 태스크가 끝나기 전에 enqueue 로 돌려보낸다. onIdle 은 대기열과 실행 중이 둘 다 0 일 때 resolve 된다. 자식을 .then·setTimeout 으로 태스크 밖에서 넣으면 부모가 먼저 끝나 onIdle 이 일이 남았는데 resolve 된다.

-- start 에서 링크로 닿는 URL 전부 — 처리 결과가 다시 입력이 되어 언제 끝날지 모를 때
crawl :: (Url -> [Url]) -> Url -> Set Url
crawl links start = go Set.empty [start]
  where
    go seen []      = seen                                   -- onIdle: 대기열·실행 중 둘 다 0
    go seen (u : q)
      | u `member` seen = go seen q                          -- seen.has
      | otherwise       = go (insert u seen) (q ++ links u)  -- seen.add 와 자식 추가가 한 걸음: 끼어들 틈이 없다
    -- 끼어들 틈이 없는 건 단일 스레드라서다: 함수는 도중에 선점되지 않는다. has 와 add 사이에 await 가 없으니 락이 필요 없다
    -- 요청보다 먼저 표시한다. 요청 뒤에 표시하면 그 사이 같은 URL 이 또 들어온다

-- 서로 가리키는 페이지가 있어도 끝나고, 결과 크기가 고유 URL 수와 같으면 된 것이다
#597

PNG 마다 sharp 의 trim 으로 가장자리 여백을 잘라 낸 뒤, 잘린 이미지의 크기를 다시 읽어 가로·세로를 절반으로 resize 하고 .half.png 로 저장한다. 특정 영역만 잘라 내려면 extract 에 left·top 오프셋과 width·height 를 준다.

-- PNG 마다: 여백을 자르고 절반으로
half :: Image -> Image
half img = resize (round (w / 2), round (h / 2)) t
  where t      = trim img            -- 가장자리 여백 제거
        (w, h) = size t              -- 잘린 뒤 크기를 다시 읽는다

-- for entry in fg('./**/*.png'): half entry → entry.replace(.png, .half.png)
-- crop: extract { left = 50, top = 50, width = 200, height = 400 }
#60

ID3 is a metadata container most often used in conjunction with the MP3 audio file format.

MP3 파일은 ID3v2 태그, 오디오 프레임들, ID3v1 태그 순으로 놓인다. 오디오 프레임은 각각 11비트 sync(FF Ex)로 시작하고, 디코더는 이 패턴을 찾아 재생하며 그 밖의 바이트는 건너뛴다. 그래서 태그는 오디오를 건드리지 않고 앞뒤에 붙인 바이트 덩어리다. ID3v2 는 맨 앞에 붙는 가변 길이 컨테이너다: 10바이트 헤더(“ID3”, 버전 2, 플래그 1, 크기 4 syncsafe) 뒤에 프레임이 반복된다. 프레임은 ID 4(TIT2 제목, TPE1 아티스트, TALB 앨범, APIC 커버), 크기 4, 플래그 2, 본문이고, 텍스트 본문의 첫 바이트가 인코딩이다(00 ISO-8859-1, 01 UTF-16 BOM, 02 UTF-16BE, 03 UTF-8). 마지막 프레임 뒤에 00 으로 채운 패딩을 둘 수 있다. ID3v1 은 맨 끝 128바이트 고정 칸이다: TAG 3, 제목 30, 아티스트 30, 앨범 30, 연도 4, 코멘트 30, 장르 번호 1. v1.1 은 코멘트를 28 로 줄이고 00 다음 1바이트에 트랙 번호를 넣는다. 인코딩을 적을 칸은 없다. 장치 셋: 크기는 바이트마다 최상위 비트를 0 으로 둔 syncsafe 정수라(7비트 × 4 = 28비트, 최대 256MB) 크기 값이 sync 로 읽히지 않는다. 본문에 거짓 sync FF Ex 가 생기면 FF 00 Ex 로 바꾼다(unsynchronisation). 태그가 패딩 안에서 커지면 태그만 고쳐 쓰고, 넘치면 오디오를 밀어 파일 전체를 다시 쓴다.



Footnotes

  1. MP3, MP4, OGG, FLAC 등 다양한 음악 형식을 지원. 제목, 아티스트, 앨범 등과 같은 음악 파일의 메타데이터에 액세스하기 위한 간단하고 사용하기 쉬운 API를 제공합니다. ↩

  2. TagLib 바인딩 ↩

  3. 다양한 ID3 태그 버전을 지원하며 간단하고 사용하기 쉬운 API를 제공합니다. ↩

#61

Footnotes

  1. 이 명령은 업그레이드를 수행하기 전에 오래된 패키지를 표시하여 사용자가 업그레이드할 패키지를 선택할 수 있도록 합니다. ↩

  2. npm-check-updates는 지정된 버전을 무시하고 package.json 종속성을 최신 버전으로 업그레이드합니다 . ↩

#62

xlsx 로 시트를 header: 1 로 읽으면 행이 객체가 아니라 배열로 나와 열을 인덱스로 자를 수 있다. 머리글 행을 빼고 2~4번째 열(키·영어·한국어)만 잘라, 빈 행은 [] 로 남으므로 걸러 내고, 키를 소문자·밑줄로 바꿔 en.json 과 ko.json 두 파일로 나눠 쓴다. CSV 와는 다르다.

-- 엑셀 → 언어별 JSON. header: 1 이면 행이 배열 — 열을 인덱스로 자른다
locales :: [[Cell]] -> (Map Key String, Map Key String)
locales rows = (fromList [(k, en) | (k, en, _) <- rs], fromList [(k, ko) | (k, _, ko) <- rs])
  where rs = [ (normalize key, en, ko)
             | row <- drop 1 rows                       -- 머리글 행
             , let [key, en, ko] = take 3 (drop 1 row)  -- 2~4번째 열
             , any nonEmpty row ]                       -- 빈 행도 [] 로 나온다
        normalize = map toLower . replace "-" "_"
-- → en.json · ko.json
#64

npm install –save ../foo/bar 처럼 로컬 디렉터리를 설치하면 package.json 에 상대 경로로 정규화되어 “bar”: “file:../foo/bar” 로 저장된다. 레지스트리를 거치지 않고 파일 시스템의 패키지를 의존성으로 건다.

-- 로컬 디렉터리를 의존성으로 — 상대 경로로 정규화되어 저장된다
dep :: Path -> (Name, Spec)
dep path = (packageName path, "file:" ++ relative path)

dep "../foo/bar" == ("bar", "file:../foo/bar")   -- npm install --save ../foo/bar
#65

모노레포에서 yarn workspace <이름> <명령> 은 아무 Yarn 명령이나 그 워크스페이스 안에서 실행한다. add 면 루트가 아니라 그 패키지의 package.json 에 의존성이 들어간다.

-- 아무 Yarn 명령이나 그 워크스페이스 안에서
workspace :: Name -> Command -> IO ()
workspace name cmd = inDir (packageDir name) (yarn cmd)

workspace "awesome-package" (Add ["react", "react-dom"] Dev)   -- 그 패키지의 package.json devDependencies 에
#66