-; TODO optional text wrap
-; TODO write
-; TODO caching (use cache by default, unless explicitly asked for update)
-; - [x] value --> cache
-; - [ ] value <-- cache
-; requires: commands
-; TODO timeline limits
-; TODO feed set operations (perhaps better done externally?)
-; TODO timeline as a result of a query (feed set op + filter expressions)
-; TODO named timelines
-; TODO CLI params
-; TODO config files
-; TODO parse "following" from feed
-; - following = <nick> <uri>
-; TODO parse mentions:
-; - @<source.nick source.url> | @<source.url>
-; TODO highlight mentions
-; TODO filter on mentions
-; TODO highlight hashtags
-; TODO filter on hashtags
-; TODO hashtags as channels? initial hashtag special?
-; TODO query language
-; TODO console logger colors by level ('error)
-; TODO file logger ('debug)
-; TODO commands:
-; - r | read
-; - see timeline ops above
-; - w | write
-; - arg or stdin
-; - nick expand to URI
-; - q | query
-; - see timeline ops above
-; - see hashtag and channels above
-; - d | download
-; - u | upload
-; - calls user-configured command to upload user's own feed file to their server
-;
-; Looks like a better CLI parser than "racket/cmdline":
-; https://docs.racket-lang.org/natural-cli/
-
-#lang racket
+#lang typed/racket/no-check
(require openssl/sha1)
(require racket/date)
+(require
+ net/head
+ net/uri-codec
+ net/url)
-(require http-client)
-(require rfc3339-old)
+(require (prefix-in info: "info.rkt"))
(module+ test
- (require rackunit))
+ (require rackunit))
+
+(define-type Url
+ net/url-structs:url)
+
+(define-type Out-Format
+ (U 'single-line
+ 'multi-line))
+
+(define-type Timeline-Order
+ (U 'old->new
+ 'new->old))
-(struct msg (ts_epoch ts_rfc3339 nick uri text))
-(struct feed (nick uri))
+(define-type Result
+ (∀ (α β) (U (cons 'ok α)
+ (cons 'error β))))
-(define (concurrent-filter-map num_workers f xs)
+(struct Msg
+ ([ts-epoch : Integer]
+ [ts-orig : String]
+ [nick : (Option String)]
+ [uri : Url]
+ [text : String]
+ [mentions : (Listof Peer)]))
+
+(struct Peer
+ ([nick : (Option String)]
+ [uri : Url]
+ [uri-str : String]
+ [comment : (Option String)])
+ #:transparent)
+
+(struct Resp
+ ([status-line : String]
+ [headers : (Listof Bytes)]
+ [body-input : Input-Port])
+ #:transparent)
+
+(define-custom-set-types peers
+ #:elem? Peer?
+ (λ (p1 p2)
+ (equal? (Peer-uri-str p1)
+ (Peer-uri-str p2)))
+ (λ (p)
+ (equal-hash-code (Peer-uri-str p))))
+; XXX Without supplying above explicit hash procedure, we INTERMITTENTLY get
+; the following contract violations:
+;
+; custom-elem-contents: contract violation
+; expected: custom-elem?
+; given: #f
+; context...:
+; /usr/share/racket/collects/racket/private/set-types.rkt:104:0: custom-set->list
+; /home/siraaj/proj/pub/tt/tt.rkt:716:0: crawl
+; /usr/share/racket/collects/racket/cmdline.rkt:191:51
+; body of (submod "/home/siraaj/proj/pub/tt/tt.rkt" main)
+;
+; TODO Investigate why and make a minimal reproducible test case.
+
+(: tt-home-dir Path-String)
+(define tt-home-dir (build-path (expand-user-path "~") ".tt"))
+
+(: concurrent-filter-map (∀ (α β) (-> Natural (-> α β) (Listof α) (Listof β))))
+(define (concurrent-filter-map num-workers f xs)
; TODO preserve order of elements OR communicate that reorder is expected
; TODO switch from mailboxes to channels
(define (make-worker id f)
(define parent (current-thread))
(λ ()
- (define self (current-thread))
+ (define self : Thread (current-thread))
+ (: work (∀ (α) (-> α)))
(define (work)
(thread-send parent (cons 'next self))
(match (thread-receive)
- ['done (thread-send parent (cons 'exit id))]
- [(cons 'unit x) (begin
- (define y (f x))
- (when y (thread-send parent (cons 'result y)))
- (work))]))
+ ['done (thread-send parent (cons 'exit id))]
+ [(cons 'unit x) (begin
+ (define y (f x))
+ (when y (thread-send parent (cons 'result y)))
+ (work))]))
(work)))
+ (: dispatch (∀ (α β) (-> (Listof Nonnegative-Integer) (Listof α) (Listof β))))
(define (dispatch ws xs ys)
(if (empty? ws)
ys
(match (thread-receive)
- [(cons 'exit w) (dispatch (remove w ws =) xs ys)]
- [(cons 'result y) (dispatch ws xs (cons y ys))]
- [(cons 'next thd) (match xs
- ['() (begin
- (thread-send thd 'done)
- (dispatch ws xs ys))]
- [(cons x xs) (begin
- (thread-send thd (cons 'unit x))
- (dispatch ws xs ys))])])))
- (define workers (range num_workers))
+ [(cons 'exit w) (dispatch (remove w ws =) xs ys)]
+ [(cons 'result y) (dispatch ws xs (cons y ys))]
+ [(cons 'next thd) (match xs
+ ['() (begin
+ (thread-send thd 'done)
+ (dispatch ws xs ys))]
+ [(cons x xs) (begin
+ (thread-send thd (cons 'unit x))
+ (dispatch ws xs ys))])])))
+ (define workers (range num-workers))
(define threads (map (λ (id) (thread (make-worker id f))) workers))
(define results (dispatch workers xs '()))
(for-each thread-wait threads)
results)
(module+ test
- (define n-workers 10)
- (define given (list
- (λ (x) (if (even? x) x #f))
- (range 11)))
- (check-equal?
- (sort (apply concurrent-filter-map (cons n-workers given)) <)
- (sort (apply filter-map given ) <)))
-
-(define (msg-print out-format odd msg)
- (printf
- (match out-format
- ['single-line "~a \033[1;37m<~a ~a>\033[0m \033[0;~am~a\033[0m~n"]
- ['multi-line "~a~n\033[1;37m<~a ~a>\033[0m~n\033[0;~am~a\033[0m~n~n"]
- [_ (raise (format "Invalid output format: ~a" out-format))])
- (date->string (seconds->date [msg-ts_epoch msg]) #t)
- (msg-nick msg)
- (msg-uri msg)
- (if odd 36 33)
- (msg-text msg)))
-
-(define re-msg-begin
- ; TODO Zulu offset. Maybe in several formats. Which ones?
- (pregexp "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}"))
-
-(define (str->msg nick uri str)
- (if (not (regexp-match? re-msg-begin str))
- (begin
- (log-debug "Non-msg line from nick:~a, line:~a" nick str)
- #f)
- (let ([toks (string-split str (regexp "\t+"))])
- (if (not (= 2 (length toks)))
- (begin
- (log-warning "Invalid msg line from nick:~a, msg:~a" nick str)
- #f)
- (let*
- ([ts_rfc3339 (first toks)]
- [text (second toks)]
- [t (string->rfc3339-record ts_rfc3339)]
- ; TODO handle tz offset
- [ts_epoch (find-seconds [rfc3339-record:second t]
- [rfc3339-record:minute t]
- [rfc3339-record:hour t]
- [rfc3339-record:mday t]
- [rfc3339-record:month t]
- [rfc3339-record:year t])])
- (msg ts_epoch ts_rfc3339 nick uri text))))))
+ (let* ([f (λ (x) (if (even? x) x #f))]
+ [xs (range 11)]
+ [actual (sort (concurrent-filter-map 10 f xs) <)]
+ [expected (sort ( filter-map f xs) <)])
+ (check-equal? actual expected "concurrent-filter-map")))
+(: msg-print (-> Out-Format Integer Msg Void))
+(define msg-print
+ (let* ([colors (vector 36 33)]
+ [n (vector-length colors)])
+ (λ (out-format color-i msg)
+ (let ([color (vector-ref colors (modulo color-i n))]
+ [nick (Msg-nick msg)]
+ [uri (url->string (Msg-uri msg))]
+ [text (Msg-text msg)]
+ [mentions (Msg-mentions msg)])
+ (match out-format
+ ['single-line
+ (let ([nick (if nick nick uri)])
+ (printf "~a \033[1;37m<~a>\033[0m \033[0;~am~a\033[0m~n"
+ (parameterize
+ ([date-display-format 'iso-8601])
+ (date->string (seconds->date (Msg-ts-epoch msg)) #t))
+ nick color text))]
+ ['multi-line
+ (let ([nick (if nick (string-append nick " ") "")])
+ (printf "~a (~a)~n\033[1;37m<~a~a>\033[0m~n\033[0;~am~a\033[0m~n~n"
+ (parameterize
+ ([date-display-format 'rfc2822])
+ (date->string (seconds->date (Msg-ts-epoch msg)) #t))
+ (Msg-ts-orig msg)
+ nick uri color text))])))))
+
+(: rfc3339->epoch (-> String (Option Nonnegative-Integer)))
+(define rfc3339->epoch
+ (let ([re (pregexp "^([0-9]{4})-([0-9]{2})-([0-9]{2})T([0-9]{2}):([0-9]{2})(:([0-9]{2}))?(\\.[0-9]+)?(Z|([+-])([0-9]{1,2}):?([0-9]{2}))?$")])
+ (λ (ts)
+ (match (regexp-match re ts)
+ [(list _wholething yyyy mm dd HH MM _:SS SS _fractional tz-whole tz-sign tz-HH tz-MM)
+ (let*
+ ([tz-offset
+ (match* (tz-whole tz-sign tz-HH tz-MM)
+ [("Z" #f #f #f)
+ 0]
+ [(_ (or "-" "+") (? identity h) (? identity m))
+ (let ([h (string->number h)]
+ [m (string->number m)]
+ ; Reverse to get back to UTC:
+ [op (match tz-sign ["+" -] ["-" +])])
+ (op 0 (+ (* 60 m) (* 60 (* 60 h)))))]
+ [(a b c d)
+ (log-warning "Impossible TZ string: ~v, components: ~v ~v ~v ~v" tz-whole a b c d)
+ 0])]
+ [ts-orig ts]
+ [local-time? #f]
+ [ts-epoch (find-seconds (if SS (string->number SS) 0)
+ (string->number MM)
+ (string->number HH)
+ (string->number dd)
+ (string->number mm)
+ (string->number yyyy)
+ local-time?)])
+ (+ ts-epoch tz-offset))]
+ [_
+ (log-debug "Invalid timestamp: ~v" ts)
+ #f]))))
+
+(: str->msg (-> (Option String) Url String (Option Msg)))
+(define str->msg
+ (let ([re (pregexp "^([^\\s\t]+)[\\s\t]+(.*)$")])
+ (λ (nick uri str)
+ (define str-head (substring str 0 (min 100 (string-length str))))
+ (with-handlers*
+ ([exn:fail?
+ (λ (e)
+ (log-debug
+ "Failed to parse msg: ~v, from: ~v, at: ~v, because: ~v"
+ str-head nick (url->string uri) e)
+ #f)])
+ (match (regexp-match re str)
+ [(list _wholething ts-orig text)
+ (let ([ts-epoch (rfc3339->epoch ts-orig)])
+ (if ts-epoch
+ (let ([mentions
+ (filter-map
+ (λ (m) (match (regexp-match #px"@<([^>]+)>" m)
+ [(list _wholething nick-uri)
+ (str->peer nick-uri)]))
+ (regexp-match* #px"@<[^\\s]+([\\s]+)?[^>]+>" text))])
+ (Msg ts-epoch ts-orig nick uri text mentions))
+ (begin
+ (log-debug
+ "Msg rejected due to invalid timestamp: ~v, nick:~v, uri:~v"
+ str-head nick (url->string uri))
+ #f)))]
+ [_
+ (log-debug "Non-msg line from nick:~v, line:~a" nick str-head)
+ #f])))))
+
+(module+ test
+ ; TODO Test for when missing-nick case
+ (let* ([tzs (for*/list ([d '("-" "+")]
+ [h '("5" "05")]
+ [m '("00" ":00" "57" ":57")])
+ (string-append d h m))]
+ [tzs (list* "" "Z" tzs)])
+ (for* ([n '("fake-nick")]
+ [u '("fake-uri")]
+ [s '("" ":10")]
+ [f '("" ".1337")]
+ [z tzs]
+ [sep (list "\t" " ")]
+ [txt '("foo bar baz" "'jaz poop bear giraffe / tea" "@*\"``")])
+ (let* ([ts (string-append "2020-11-18T22:22"
+ (if (non-empty-string? s) s ":00")
+ z)]
+ [m (str->msg n u (string-append ts sep txt))])
+ (check-not-false m)
+ (check-equal? (Msg-nick m) n)
+ (check-equal? (Msg-uri m) u)
+ (check-equal? (Msg-text m) txt)
+ (check-equal? (Msg-ts-orig m) ts (format "Given: ~v" ts))
+ )))
+
+ (let* ([ts "2020-11-18T22:22:09-0500"]
+ [tab " "]
+ [text "Lorem ipsum"]
+ [nick "foo"]
+ [uri "bar"]
+ [actual (str->msg nick uri (string-append ts tab text))]
+ [expected (Msg 1605756129 ts nick uri text '())])
+ (check-equal?
+ (Msg-ts-epoch actual)
+ (Msg-ts-epoch expected)
+ "str->msg ts-epoch")
+ (check-equal?
+ (Msg-ts-orig actual)
+ (Msg-ts-orig expected)
+ "str->msg ts-orig")
+ (check-equal?
+ (Msg-nick actual)
+ (Msg-nick expected)
+ "str->msg nick")
+ (check-equal?
+ (Msg-uri actual)
+ (Msg-uri expected)
+ "str->msg uri")
+ (check-equal?
+ (Msg-text actual)
+ (Msg-text expected)
+ "str->msg text")))
+
+(: str->lines (-> String (Listof String)))
(define (str->lines str)
(string-split str (regexp "[\r\n]+")))
+(module+ test
+ (check-equal? (str->lines "abc\ndef\n\nghi") '("abc" "def" "ghi")))
+
+(: str->msgs (-> (Option String) Url String (Listof Msg)))
(define (str->msgs nick uri str)
- (filter-map (λ (line) (str->msg nick uri line)) (str->lines str)))
-
-(define (hash-sha1 str)
- (define in (open-input-string str))
- (define digest (sha1 in))
- (close-input-port in)
- digest)
-
-(define (uri-fetch uri)
- (log-info "GET ~a" uri)
- (define resp (http-get uri))
- (define status (http-response-code resp))
- (define body (http-response-body resp))
- (log-debug "finished GET ~a status:~a body length:~a"
- uri status (string-length body))
- ; TODO Handle redirects
- (if (= status 200)
- (let*
- ([url-digest
- (hash-sha1 uri)]
- [cache-file-path
- (expand-user-path (string-append "~/.tt/cache/" url-digest))])
- (display-to-file
- body cache-file-path
- #:exists 'replace)
- body)
- ; TODO A more-informative exception
- (raise status)))
+ (filter-map (λ (line) (str->msg nick uri line)) (filter-comments (str->lines str))))
-(define (timeline-print out-format timeline)
- (for ([msg timeline]
- [i (in-naturals)])
- (msg-print out-format (odd? i) msg)))
-
-(define (feed->msgs feed)
- (log-info "downloading feed nick:~a uri:~a"
- (feed-nick feed)
- (feed-uri feed))
- (with-handlers
- ([exn:fail:network?
- (λ (e)
- (log-error "network error nick:~a uri:~a exn:~a"
- (feed-nick feed)
- (feed-uri feed)
- e)
- #f)]
- [integer?
- (λ (status)
- (log-error "http error nick:~a uri:~a status:~a"
- (feed-nick feed)
- (feed-uri feed)
- status)
- #f)])
- (define uri (feed-uri feed))
- (str->msgs [feed-nick feed] uri [uri-fetch uri])))
-
-; TODO timeline contract : time-sorted list of messages
-(define (timeline num_workers feeds)
- (sort (append* (concurrent-filter-map num_workers feed->msgs feeds))
- (λ (a b) [< (msg-ts_epoch a) (msg-ts_epoch b)])))
-
-(define (str->feed str)
- ; TODO validation
- (define toks (string-split str))
- (apply feed toks))
-
-(define (str->feeds str)
- (map str->feed (str->lines str)))
-
-(define (file->feeds filename)
- (str->feeds (file->string filename)))
-
-(define (we-are-twtxt)
- (define uri
- "https://raw.githubusercontent.com/mdom/we-are-twtxt/master/we-are-twtxt.txt")
- (str->feeds (uri-fetch uri)))
-
-(define (user-agent prog-name prog-version)
+(: cache-dir Path-String)
+(define cache-dir (build-path tt-home-dir "cache"))
+
+(define cache-object-dir (build-path cache-dir "objects"))
+
+(: url->cache-file-path-v1 (-> Url Path-String))
+(define (url->cache-file-path-v1 uri)
+ (define (hash-sha1 str) : (-> String String)
+ (define in (open-input-string str))
+ (define digest (sha1 in))
+ (close-input-port in)
+ digest)
+ (build-path cache-object-dir (hash-sha1 (url->string uri))))
+
+(: url->cache-file-path-v2 (-> Url Path-String))
+(define (url->cache-file-path-v2 uri)
+ (build-path cache-object-dir (uri-encode (url->string uri))))
+
+(define url->cache-object-path url->cache-file-path-v2)
+
+(: cache-object-filename->url (-> Path-String Url))
+(define (cache-object-filename->url name)
+ (string->url (uri-decode (path->string name))))
+
+(define (url->cache-etag-path uri)
+ (build-path cache-dir "etags" (uri-encode (url->string uri))))
+
+(define (url->cache-lmod-path uri)
+ (build-path cache-dir "lmods" (uri-encode (url->string uri))))
+
+(: uri-read-cached (-> Url (Option String)))
+(define (uri-read-cached uri)
+ (define path-v1 (url->cache-file-path-v1 uri))
+ (define path-v2 (url->cache-file-path-v2 uri))
+ (when (file-exists? path-v1)
+ (rename-file-or-directory path-v1 path-v2 #t))
+ (if (file-exists? path-v2)
+ (file->string path-v2)
+ (begin
+ (log-debug "Cache file not found for URI: ~a" (url->string uri))
+ #f)))
+
+(: str->url (-> String (Option String)))
+(define (str->url s)
+ (with-handlers*
+ ([exn:fail? (λ (e) #f)])
+ (string->url s)))
+
+(: str->peer (String (Option Peer)))
+(define (str->peer str)
+ (log-debug "Parsing peer string: ~v" str)
+ (match
+ (regexp-match
+ #px"(([^\\s\t]+)[\\s\t]+)?([a-zA-Z]+://[^\\s\t]*)[\\s\t]*(#\\s*(.*))?"
+ str)
+ [(list _wholething
+ _nick-with-space
+ nick
+ url
+ _comment-with-hash
+ comment)
+ (match (str->url url)
+ [#f
+ (log-error "Invalid URI in peer string: ~v" str)
+ #f]
+ [url
+ (Peer nick url (url->string url) comment)])]
+ [_
+ (log-debug "Invalid peer string: ~v" str)
+ #f]))
+
+(module+ test
+ (check-equal?
+ (str->peer "foo http://bar/file.txt # some rando")
+ (Peer "foo" (str->url "http://bar/file.txt") "http://bar/file.txt" "some rando"))
+ (check-equal?
+ (str->peer "http://bar/file.txt # some rando")
+ (Peer #f (str->url "http://bar/file.txt") "http://bar/file.txt" "some rando"))
+ (check-equal?
+ (str->peer "http://bar/file.txt #")
+ (Peer #f (str->url "http://bar/file.txt") "http://bar/file.txt" ""))
+ (check-equal?
+ (str->peer "http://bar/file.txt#") ; XXX URLs can have #s
+ (Peer #f (str->url "http://bar/file.txt#") "http://bar/file.txt#" #f))
+ (check-equal?
+ (str->peer "http://bar/file.txt")
+ (Peer #f (str->url "http://bar/file.txt") "http://bar/file.txt" #f))
+ (check-equal?
+ (str->peer "foo http://bar/file.txt")
+ (Peer "foo" (str->url "http://bar/file.txt") "http://bar/file.txt" #f))
+ (check-equal?
+ (str->peer "foo bar # baz")
+ #f)
+ (check-equal?
+ (str->peer "foo bar://baz # quux")
+ (Peer "foo" (str->url "bar://baz") "bar://baz" "quux"))
+ (check-equal?
+ (str->peer "foo bar//baz # quux")
+ #f))
+
+(: filter-comments (-> (Listof String) (Listof String)))
+(define (filter-comments lines)
+ (filter-not (λ (line) (string-prefix? line "#")) lines))
+
+(: str->peers (-> String (Setof Peer)))
+(define (str->peers str)
+ (make-immutable-peers (filter-map str->peer (filter-comments (str->lines str)))))
+
+(: peers->file (-> (Setof Peers) Path-String Void))
+(define (peers->file peers path)
+ (display-lines-to-file
+ (map (match-lambda
+ [(Peer n _ u c)
+ (format "~a~a~a"
+ (if n (format "~a " n) "")
+ u
+ (if c (format " # ~a" c) ""))])
+ (sort (set->list peers)
+ (match-lambda**
+ [((Peer n1 _ _ _) (Peer n2 _ _ _))
+ (string<? (if n1 n1 "")
+ (if n2 n2 ""))])))
+ path
+ #:exists 'replace))
+
+(: file->peers (-> Path-String (Setof Peer)))
+(define (file->peers file-path)
+ (if (file-exists? file-path)
+ (str->peers (file->string file-path))
+ (begin
+ (log-warning "File does not exist: ~v" (path->string file-path))
+ (make-immutable-peers))))
+
+(define re-rfc2822
+ #px"^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), ([0-9]{2}) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) ([0-9]{4}) ([0-2][0-9]):([0-6][0-9]):([0-6][0-9]) GMT")
+
+(: b->n (-> Bytes (Option Number)))
+(define (b->n b)
+ (string->number (bytes->string/utf-8 b)))
+
+(: mon->num (-> Bytes Natural))
+(define/match (mon->num mon)
+ [(#"Jan") 1]
+ [(#"Feb") 2]
+ [(#"Mar") 3]
+ [(#"Apr") 4]
+ [(#"May") 5]
+ [(#"Jun") 6]
+ [(#"Jul") 7]
+ [(#"Aug") 8]
+ [(#"Sep") 9]
+ [(#"Oct") 10]
+ [(#"Nov") 11]
+ [(#"Dec") 12])
+
+(: rfc2822->epoch (-> Bytes (Option Nonnegative-Integer)))
+(define (rfc2822->epoch timestamp)
+ (match (regexp-match re-rfc2822 timestamp)
+ [(list _ _ dd mo yyyy HH MM SS)
+ #:when (and dd mo yyyy HH MM SS)
+ (find-seconds (b->n SS)
+ (b->n MM)
+ (b->n HH)
+ (b->n dd)
+ (mon->num mo)
+ (b->n yyyy)
+ #f)]
+ [_
+ #f]))
+
+(: user-agent String)
+(define user-agent
(let*
- ([prog-uri "https://github.com/xandkar/tt"]
- [user-feed-file (expand-user-path "~/twtxt-me.txt")]
+ ([prog-name "tt"]
+ [prog-version (info:#%info-lookup 'version)]
+ [prog-uri "https://github.com/xandkar/tt"]
+ [user-peer-file (build-path tt-home-dir "me")]
[user
- (if (file-exists? user-feed-file)
- (let ([user (first (file->feeds user-feed-file))])
- (format "+~a; @~a" (feed-uri user) (feed-nick user)))
- (format "+~a" prog-uri))]
- )
+ (if (file-exists? user-peer-file)
+ (match (set-first (file->peers user-peer-file))
+ [(Peer #f _ u _) (format "+~a" u )]
+ [(Peer n _ u _) (format "+~a; @~a" u n)])
+ (format "+~a" prog-uri))])
(format "~a/~a (~a)" prog-name prog-version user)))
+(: header-get (-> (Listof Bytes) Bytes (Option Bytes)))
+(define (header-get headers name)
+ (match (filter-map (curry extract-field name) headers)
+ [(list val) val]
+ [_ #f]))
+
+(: uri-download-from-port
+ (-> Url (Listof (U Bytes String)) Input-Port
+ (U 'skipped-cached 'downloaded-new))) ; TODO 'ok|'error ?
+(define (uri-download-from-port u headers body-input)
+ (define u-str (url->string u))
+ (log-debug "uri-download-from-port ~v into ~v" u-str cached-object-path)
+ (define cached-object-path (url->cache-object-path u))
+ (define cached-etag-path (url->cache-etag-path u))
+ (define cached-lmod-path (url->cache-lmod-path u))
+ (define etag (header-get headers #"ETag"))
+ (define lmod (header-get headers #"Last-Modified"))
+ (define lmod-curr (if lmod (rfc2822->epoch lmod) #f))
+ (define lmod-prev (if (file-exists? cached-lmod-path)
+ (rfc2822->epoch (file->bytes cached-lmod-path))
+ #f))
+ (log-debug "lmod-curr:~v lmod-prev:~v" lmod-curr lmod-prev)
+ (define cached?
+ (or (and etag
+ (file-exists? cached-etag-path)
+ (bytes=? etag (file->bytes cached-etag-path))
+ (begin
+ (log-debug "ETags match, skipping the rest of ~v" u-str)
+ #t))
+ (and lmod-curr
+ lmod-prev
+ (<= lmod-curr lmod-prev)
+ (begin
+ (log-debug "Last-Modified <= current skipping the rest of ~v" u-str)
+ #t))))
+ (if (not cached?)
+ (begin
+ (log-debug
+ "Downloading the rest of ~v. ETag: ~a, Last-Modified: ~v"
+ u-str etag lmod)
+ (make-parent-directory* cached-object-path)
+ (make-parent-directory* cached-etag-path)
+ (make-parent-directory* cached-lmod-path)
+ (call-with-output-file cached-object-path
+ (curry copy-port body-input)
+ #:exists 'replace)
+ (when etag
+ (display-to-file etag cached-etag-path #:exists 'replace))
+ (when lmod
+ (display-to-file lmod cached-lmod-path #:exists 'replace))
+ 'downloaded-new)
+ 'skipped-cached))
+
+(: uri-download
+ (-> Positive-Float Url
+ (Result (U 'skipped-cached 'downloaded-new)
+ Any))) ; TODO Maybe more-precise error type?
+(define (uri-download timeout u)
+ (define u-str (url->string u))
+ (define timeout-chan (make-channel))
+ (define result-chan (make-channel))
+ (define timeout-thread
+ (thread (λ ()
+ ; Doing this instead of sync/timeout to distinguish error values,
+ ; rather than just have #f to work with.
+ (sleep timeout)
+ (channel-put timeout-chan '(error . timeout)))))
+ (define result-thread
+ (thread (λ ()
+ ; XXX We timeout getting a response, but body download could
+ ; also take a long time and we might want to time that out as
+ ; well, but then we may end-up with partially downloaded
+ ; objects. But that could happen anyway if the server drops the
+ ; connection for whatever reason.
+ ;
+ ; Maybe that is OK once we start treating the
+ ; downloaded object as an addition to the stored set of
+ ; messages, rather than the final set of messages.
+
+ ; TODO message db
+ ; - 1st try can just be an in-memory set that gets written-to
+ ; and read-from disk as a whole.
+ (define result
+ (with-handlers
+ ; TODO Maybe name each known errno? (exn:fail:network:errno-errno e)
+ ([exn:fail:network?
+ (λ (e) `(error . (net-error . ,e)))]
+ [exn?
+ (λ (e) `(error . (other . ,e)))])
+ (define-values (status-line headers body-input)
+ (http-sendrecv/url
+ u
+ #:headers (list (format "User-Agent: ~a" user-agent))))
+ `(ok . ,(Resp status-line headers body-input))))
+ (channel-put result-chan result))))
+ (define result
+ (sync timeout-chan
+ result-chan))
+ (kill-thread result-thread)
+ (kill-thread timeout-thread)
+ (match result
+ [(cons 'error _)
+ result]
+ [(cons 'ok (Resp status-line headers body-input))
+ (log-debug "headers: ~v" headers)
+ (log-debug "status-line: ~v" status-line)
+ (define status
+ (string->number (second (string-split (bytes->string/utf-8 status-line)))))
+ (log-debug "status: ~v" status)
+ ; TODO Handle redirects. Should be within same timeout as req and body.
+ (let ([result
+ (match status
+ [200
+ `(ok . ,(uri-download-from-port u headers body-input))]
+ [_
+ `(error . (http . ,status))])])
+ (close-input-port body-input)
+ result)]))
+
+(: timeline-print (-> Out-Format (Listof Msg) Void))
+(define (timeline-print out-format timeline)
+ (void (foldl (match-lambda**
+ [((and m (Msg _ _ nick _ _ _)) (cons prev-nick i))
+ (let ([i (if (equal? prev-nick nick) i (+ 1 i))])
+ (msg-print out-format i m)
+ (cons nick i))])
+ (cons "" 0)
+ timeline)))
+
+(: peer->msgs (-> Peer (Listof Msg)))
+(define (peer->msgs peer)
+ (match-define (Peer nick uri uri-str _) peer)
+ (log-debug "Reading peer nick:~v uri:~v" nick uri-str)
+ (define msgs-data (uri-read-cached uri))
+ ; TODO Expire cache
+ (if msgs-data
+ (str->msgs nick uri msgs-data)
+ '()))
+
+(: peer-download
+ (-> Positive-Float Peer
+ (Result (U 'skipped-cached 'downloaded-new)
+ Any)))
+(define (peer-download timeout peer)
+ (match-define (Peer nick uri u _) peer)
+ (log-info "Download BEGIN URL:~a" u)
+ (define-values (results _tm-cpu-ms tm-real-ms _tm-gc-ms)
+ (time-apply uri-download (list timeout uri)))
+ (define result (car results))
+ (log-info "Download END in ~a seconds, URL:~a, result:~s"
+ (/ tm-real-ms 1000.0)
+ u
+ result)
+ result)
+
+(: timeline-download (-> Integer Positive-Float (Setof Peer) Void))
+(define (timeline-download num-workers timeout peers)
+ (define results
+ (concurrent-filter-map num-workers
+ (λ (p) (cons p (peer-download timeout p)))
+ (set->list peers)))
+ (define peers-ok
+ (filter-map (match-lambda
+ [(cons p (cons 'ok _)) p]
+ [(cons _ (cons 'error e)) #f])
+ results))
+ (define peers-err
+ (filter-map (match-lambda
+ [(cons _ (cons 'ok _))
+ #f]
+ [(cons p (cons 'error e))
+ (struct-copy Peer p [comment (format "~s" e)])])
+ results))
+ (peers->file peers-ok (build-path tt-home-dir "peers-last-downloaded-ok"))
+ (peers->file peers-err (build-path tt-home-dir "peers-last-downloaded-err")))
+
+(: peers->timeline (-> (Listof Peer) (Listof Msg)))
+(define (peers->timeline peers)
+ (append* (filter-map peer->msgs (set->list peers))))
+
+(: timeline-sort (-> (Listof Msg) timeline-order (Listof Msgs)))
+(define (timeline-sort msgs order)
+ (define cmp (match order
+ ['old->new <]
+ ['new->old >]))
+ (sort msgs (λ (a b) (cmp (Msg-ts-epoch a)
+ (Msg-ts-epoch b)))))
+
+(: paths->peers (-> (Listof String) (Setof Peer)))
+(define (paths->peers paths)
+ (let* ([paths (match paths
+ ['()
+ (let ([peer-refs-file (build-path tt-home-dir "peers")])
+ (log-debug
+ "No peer ref file paths provided, defaulting to ~v"
+ (path->string peer-refs-file))
+ (list peer-refs-file))]
+ [paths
+ (log-debug "Peer ref file paths provided: ~v" paths)
+ (map string->path paths)])]
+ [peers (apply set-union (map file->peers paths))])
+ (log-info "Read-in ~a peers." (set-count peers))
+ peers))
+
+(: mentioned-peers-in-cache (-> (Setof Peer)))
+(define (mentioned-peers-in-cache)
+ ; TODO Expire cache
+ (define msgs
+ (append* (map (λ (filename)
+ (define path (build-path cache-object-dir filename))
+ (define size (/ (file-size path) 1000000.0))
+ (log-debug "BEGIN parsing ~a MB from file: ~v"
+ size
+ (path->string path))
+ (define t0 (current-inexact-milliseconds))
+ (define m (filter-map
+ (λ (line)
+ (str->msg #f (cache-object-filename->url filename) line))
+ (filter-comments
+ (file->lines path))))
+ (define t1 (current-inexact-milliseconds))
+ (log-debug "END parsing ~a MB in ~a seconds from file: ~v."
+ size
+ (* 0.001 (- t1 t0))
+ (path->string path))
+ (when (empty? m)
+ (log-debug "No messages found in ~a" (path->string path)))
+ m)
+ (directory-list cache-object-dir))))
+ (make-immutable-peers (append* (map Msg-mentions msgs))))
+
+(: log-writer-stop (-> Thread Void))
+(define (log-writer-stop log-writer)
+ (log-message (current-logger) 'fatal 'stop "Exiting." #f)
+ (thread-wait log-writer))
+
+(: log-writer-start (-> Log-Level Thread))
+(define (log-writer-start level)
+ (let* ([logger
+ (make-logger #f #f level #f)]
+ [log-receiver
+ (make-log-receiver logger level)]
+ [log-writer
+ (thread
+ (λ ()
+ (parameterize
+ ([date-display-format 'iso-8601])
+ (let loop ()
+ (match-define (vector level msg _ topic) (sync log-receiver))
+ (unless (equal? topic 'stop)
+ (eprintf "~a [~a] ~a~n" (date->string (current-date) #t) level msg)
+ (loop))))))])
+ (current-logger logger)
+ log-writer))
+
+(: crawl (-> Void))
+(define (crawl)
+ (let* ([peers-all-file
+ (build-path tt-home-dir "peers-all")]
+ [peers-mentioned-file
+ (build-path tt-home-dir "peers-mentioned")]
+ [peers-parsed-file
+ (build-path tt-home-dir "peers-parsed")]
+ [peers-mentioned-curr
+ (mentioned-peers-in-cache)]
+ [peers-mentioned-prev
+ (file->peers peers-mentioned-file)]
+ [peers-mentioned
+ (set-union peers-mentioned-prev
+ peers-mentioned-curr)]
+ [peers-all-prev
+ (file->peers peers-all-file)]
+ [peers-all
+ (set-union peers-mentioned
+ peers-all-prev)]
+ [peers-discovered
+ (set-subtract peers-all
+ peers-all-prev)]
+ [peers-parsed
+ (for/set ([p peers-all] #:when (> (length (peer->msgs p)) 0)) p)])
+ ; TODO Deeper de-duping
+ (log-info "Known peers mentioned: ~a" (set-count peers-mentioned))
+ (log-info "Known peers parsed ~a" (set-count peers-parsed))
+ (log-info "Known peers total: ~a" (set-count peers-all))
+ (log-info "Discovered ~a new peers:~n~a"
+ (set-count peers-discovered)
+ (pretty-format (map
+ (match-lambda
+ [(Peer n _ u c) (list n u c)])
+ (set->list peers-discovered))))
+ (peers->file peers-mentioned
+ peers-mentioned-file)
+ (peers->file peers-parsed
+ peers-parsed-file)
+ (peers->file peers-all
+ peers-all-file)))
+
+(: read (-> (Listof String) Number Number Timeline-Order Out-Format Void))
+(define (read file-paths ts-min ts-max order out-format)
+ (let* ([peers
+ (paths->peers file-paths)]
+ [msgs
+ (timeline-sort (peers->timeline peers) order)]
+ [include?
+ (λ (m)
+ (and (or (not ts-min) (>= (Msg-ts-epoch m) ts-min))
+ (or (not ts-max) (<= (Msg-ts-epoch m) ts-max))))])
+ (timeline-print out-format (filter include? msgs))))
+
+(: upload (-> Void))
+(define (upload)
+ ; FIXME Should not exit from here, but only after cleanup/logger-stoppage.
+ (if (system (path->string (build-path tt-home-dir "hooks" "upload")))
+ (exit 0)
+ (exit 1)))
+
+(: download (-> (Listof String) Positive-Integer Positive-Float Void))
+(define (download file-paths num-workers timeout)
+ (let ([peers (paths->peers file-paths)])
+ (define-values (_res _cpu real-ms _gc)
+ (time-apply timeline-download (list num-workers timeout peers)))
+ (log-info "Downloaded timelines from ~a peers in ~a seconds."
+ (set-count peers)
+ (/ real-ms 1000.0))))
+
+(: dispatch (-> String Void))
+(define (dispatch command)
+ (match command
+ [(or "d" "download")
+ ; Initially, 15 was fastest out of the tried: 1, 5, 10, 20. Then I
+ ; started noticing significant slowdowns. Reducing to 5 seems to help.
+ (let ([num-workers 5]
+ [timeout 10.0])
+ (command-line
+ #:program "tt download"
+ #:once-each
+ [("-j" "--jobs")
+ njobs "Number of concurrent jobs."
+ (set! num-workers (string->number njobs))]
+ [("-t" "--timeout")
+ seconds "Timeout seconds per request."
+ (set! timeout (string->number seconds))]
+ #:args file-paths
+ (download file-paths num-workers timeout)))]
+ [(or "u" "upload")
+ (command-line
+ #:program "tt upload" #:args () (upload))]
+ [(or "r" "read")
+ (let ([out-format 'multi-line]
+ [order 'old->new]
+ [ts-min #f]
+ [ts-max #f])
+ (command-line
+ #:program "tt read"
+ #:once-each
+ [("-r" "--rev")
+ "Reverse displayed timeline order."
+ (set! order 'new->old)]
+ [("-m" "--min")
+ m "Earliest time to display (ignore anything before it)."
+ (set! ts-min (rfc3339->epoch m))]
+ [("-x" "--max")
+ x "Latest time to display (ignore anything after it)."
+ (set! ts-max (rfc3339->epoch x))]
+ #:once-any
+ [("-s" "--short")
+ "Short output format"
+ (set! out-format 'single-line)]
+ [("-l" "--long")
+ "Long output format"
+ (set! out-format 'multi-line)]
+ #:args file-paths
+ (read file-paths ts-min ts-max order out-format)))]
+ [(or "c" "crawl")
+ (command-line
+ #:program "tt crawl" #:args () (crawl))]
+ [command
+ (eprintf "Error: invalid command: ~v\n" command)
+ (eprintf "Please use the \"--help\" option to see a list of available commands.\n")
+ (exit 1)]))
+
(module+ main
- (require setup/getinfo)
-
- (let* ([logger (make-logger #f #f 'debug #f)]
- [log-receiver (make-log-receiver logger 'debug)])
- (void (thread (λ ()
- [date-display-format 'iso-8601]
- [let loop ()
- (define data (sync log-receiver))
- (define level (vector-ref data 0))
- (define msg (vector-ref data 1))
- (define ts (date->string (current-date) #t))
- (eprintf "~a [~a] ~a~n" ts level msg)
- (loop)])))
- (current-logger logger))
- (current-http-response-auto #f)
- (let* ([prog-name "tt"]
- [prog-version ((get-info (list prog-name)) 'version)]
- [user-agent (user-agent prog-name prog-version)])
- (current-http-user-agent user-agent))
- (date-display-format 'rfc2822)
- (let ([feeds
- (let ([args (current-command-line-arguments)])
- (if (= 0 (vector-length args))
- (we-are-twtxt)
- (file->feeds (vector-ref args 0))))]
- [out-format
- 'multi-line]
- [num_workers
- 15]) ; 15 was fastest out of the tried 1, 5, 10, 15 and 20.
- (timeline-print out-format (timeline num_workers feeds))))
+ (let ([log-level 'info])
+ (command-line
+ #:program
+ "tt"
+ #:once-each
+ [("-d" "--debug")
+ "Enable debug log level."
+ (set! log-level 'debug)]
+ #:help-labels
+ ""
+ "and <command> is one of"
+ "r, read : Read the timeline (offline operation)."
+ "d, download : Download the timeline."
+ ; TODO Add path dynamically
+ "u, upload : Upload your twtxt file (alias to execute ~/.tt/hooks/upload)."
+ "c, crawl : Discover new peers mentioned by known peers (offline operation)."
+ ""
+ #:args (command . args)
+ (define log-writer (log-writer-start log-level))
+ (current-command-line-arguments (list->vector args))
+ ; TODO dispatch should return status with which we should exit after cleanups
+ (dispatch command)
+ (log-writer-stop log-writer))))