unofficial mirror of guix-patches@gnu.org 
 help / color / mirror / code / Atom feed
blob ab838b60352185ce209d02ca463f3ff07cc9df35 12251 bytes (raw)
name: guix/import/juliahub.scm 	 # note: path name is non-authoritative(*)

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
 
;;; GNU Guix --- Functional package management for GNU
;;; Copyright © 2023 Nicolas Graves <ngraves@ngraves.fr>
;;;
;;; This file is part of GNU Guix.
;;;
;;; GNU Guix is free software; you can redistribute it and/or modify it
;;; under the terms of the GNU General Public License as published by
;;; the Free Software Foundation; either version 3 of the License, or (at
;;; your option) any later version.
;;;
;;; GNU Guix is distributed in the hope that it will be useful, but
;;; WITHOUT ANY WARRANTY; without even the implied warranty of
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;; GNU General Public License for more details.
;;;
;;; You should have received a copy of the GNU General Public License
;;; along with GNU Guix.  If not, see <http://www.gnu.org/licenses/>.

(define-module (guix import juliahub)
  #:use-module (ice-9 textual-ports)
  #:use-module (ice-9 regex)
  #:use-module (ice-9 match)
  #:use-module (srfi srfi-1)
  #:use-module (srfi srfi-9)
  #:use-module (srfi srfi-71)
  #:use-module (guix http-client)
  #:use-module (guix git)
  #:use-module (guix import utils)
  #:use-module (guix import json)
  #:use-module (guix base32)
  #:use-module (guix packages)
  #:use-module (guix upstream)
  #:use-module (json)
  #:use-module ((guix licenses) #:prefix license:)

  #:export (juliahub->guix-package
            %juliahub-updater
            juliahub-recursive-import))


;; JuliaHub API.
(define (juliahub-redirect-uri name)
  (let* ((url (string-append "https://docs.juliahub.com/" name "/"))
         (port (http-fetch url #:text? #t))
         (_ (get-line port))
         (meta (get-line port))
         (regex "url=[a-zA-Z0-9]{5}\\/[0-9\\.]*")
         (redirect (match:substring (string-match regex meta))))
    (close-port port)
    (string-drop redirect 4)))

(define (juliahub-url name)
  (let* ((url (string-append "https://docs.juliahub.com/" name "/"))
         (uri (juliahub-redirect-uri name)))
    (string-append url uri "/")))

;; General package repository.
(define %general-base-url
  "https://raw.githubusercontent.com/JuliaRegistries/General/master/")

(define (general-url package-name file)
  (let ((folder (string-capitalize (string-take package-name 1))))
    (string-append
     %general-base-url folder "/" package-name "/" file)))

(define (ini-line->alist line)
  (let* ((l (string-split line #\=))
         (attribute (string->symbol (string-drop-right (car l) 1)))
         (value (string-drop (string-drop-right (cadr l) 1) 2)))
    `(,attribute . ,value)))

(define (ini-fetch url)
  (let* ((port (http-fetch url #:text? #t))
         (raw (get-string-all port))
         (lines (drop-right (string-split raw #\newline) 1)))
    (close-port port)
    (map ini-line->alist lines)))

;; Filtering out julia-stdlibs.
;; To update them, see file sysimg.jl.
(define %julia-stdlibs
  (list "julia"
        "ArgTools"
        "Artifacts"
        "Base64"
        "CRC32c"
        "FileWatching"
        "Libdl"
        "Logging"
        "Mmap"
        "NetworkOptions"
        "SHA"
        "Serialization"
        "Sockets"
        "Unicode"
        "DelimitedFiles"
        "LinearAlgebra"
        "Markdown"
        "Printf"
        "Random"
        "Tar"
        "Dates"
        "Distributed"
        "Future"
        "InteractiveUtils"
        "LibGit2"
        "Profile"
        "SparseArrays"
        "UUIDs"
        "REPL"
        "SharedArrays"
        "Statistics"
        "SuiteSparse"
        "TOML"
        "Test"
        "LibCURL"
        "Downloads"
        "Pkg"
        "LazyArtifacts"))

;; Julia package.
(define-json-mapping <juliahub-package> make-juliahub-package juliahub-package?
  json->juliahub-package
  (homepage juliahub-package-homepage) ;string
  (readme juliahub-package-readme) ;string
  (version juliahub-package-version) ;string
  (description juliahub-package-description) ;string
  (dependencies
   juliahub-package-dependencies "deps"
   json->juliahub-dependencies) ;list of <juliahub-dependency>
  (url juliahub-package-url) ;string
  (uuid juliahub-package-uuid) ;string
  (license juliahub-package-license)) ;string

(define-json-mapping <juliahub-dependency>
  make-juliahub-dependency juliahub-dependency?
  json->juliahub-dependency
  (direct? juliahub-dependency-direct? "direct") ;boolean
  (name juliahub-dependency-name) ;string
  (uuid juliahub-dependency-uuid) ;string
  (versions juliahub-dependency-versions "versions" vector->list)) ;list of strings

(define (julia-name->guix-name name)
  (string-append "julia-" (snake-case name)))

(define* (juliahub-fetch name #:key (version #f))
  "Return a <juliahub-package> record for package NAME, or #f on failure."
  (let* ((uri (juliahub-redirect-uri name))
         (slug (string-take uri 5))
         (url (if version
                  (string-append "https://docs.juliahub.com/" name "/"
                                 slug "/" version "/pkg.json")
                  (string-append (juliahub-url name) "pkg.json"))))
    (and=> (json-fetch url) json->juliahub-package)))

(define (make-julia-sexp name version source home-page synopsis description
                         direct-dependencies test-dependencies-names license)
  "Return the `package' s-expression for a Julia package with the given NAME,
VERSION, SOURCE, HOME-PAGE, DESCRIPTION, DIRECT-DEPENDENCIES,
TEST-DEPENDENCIES-NAMES and LICENSE."
  `(package
     (name ,(julia-name->guix-name name))
     (version ,version)
     (source ,source)
     (build-system julia-build-system)
     ,@(if (null? direct-dependencies)
           '()
           `((propagated-inputs
              (list ,@(map (compose string->symbol
                                    julia-name->guix-name
                                    juliahub-dependency-name)
                           direct-dependencies)))))
     ,@(if (null? test-dependencies-names)
           '()
           `((native-inputs
              (list ,@(map (compose string->symbol julia-name->guix-name)
                           test-dependencies-names)))))
     (synopsis ,synopsis)
     (description ,description)
     (home-page ,home-page)
     (license ,(if license (spdx-string->license license) #f))))

;; Dependencies helpers.
(define (json->juliahub-dependencies vector)
  (if (vector? vector)
      (filter-map
       (lambda (el)
         (let ((dep (json->juliahub-dependency el)))
           (if (and (juliahub-dependency-direct? dep)
                    (not (member (juliahub-dependency-name dep)
                                 %julia-stdlibs)))
               dep
               #f)))
       (vector->list vector))))

(define (parse-test-dependencies directory)
  (let* ((port (open-input-file (string-append directory "/Project.toml")))
         (project.toml (get-string-all port))
         (regex "\ntest = \\[.*\\]")
         (deps (match:substring (string-match regex project.toml)))
         (pure (string-delete (list->char-set (list #\" #\ )) deps)))
    (close-port port)
    (filter (lambda (x) (not (member x %julia-stdlibs)))
            (string-split (string-drop (string-drop-right pure 1) 7) #\,))))

;; Juliahub may be more up-to-date than the General registry or the actual git
;; tag (it seems around 6 hours pass between the time a commit is supplied to
;; JuliaRegistrator as a release, and the time Julia TagBot Github Action makes
;; the git tag). We have no simple way to get the commit of the latest-version.
;; Thus the best simple thing we can do is get the latest-git-tag, and import
;; this version instead. We do this by parsing Package.toml in the General
;; registry, and then getting the refs of the git repo supplied by this
;; file. Parsing this file is also necessary if the package is in a subdir of a
;; git repository, because the information isn't present in Juliahub.

;; There's a last case where some Julia packages are not based on a particular
;; git tag. In this case, the script fails, but it seems quite rare. We could
;; introduce the tree-commit which is available in the Versions.toml file in the
;; General repository. This can be used to identify the state of a repository,
;; since we have a unique hash of the listing of files and directories.

(define (latest-git-tag repo)
  (let* ((last-ref (last (remote-refs repo #:tags? #t)))
         (last-git-tag (last (string-split last-ref #\/))))
    (string-drop last-git-tag 1)))

(define* (juliahub->guix-package package-name
                                 #:key version #:allow-other-keys)
  "Fetch the metadata for PACKAGE-NAME from juliahub.org, and return the
`package' s-expression corresponding to that package, or #f on failure.
Optionally include a VERSION string to fetch a specific version juliahub."
  (let* ((package-toml (ini-fetch (general-url package-name "Package.toml")))
         (subdir (assoc-ref package-toml 'subdir))
         (tag (latest-git-tag (assoc-ref package-toml 'repo)))
         (package (if version
                      (juliahub-fetch package-name #:version version)
                      (if tag
                          (juliahub-fetch package-name #:version tag)
                          (juliahub-fetch package-name)))))
    (if package
        (let* ((source directory
                       (git->origin
                        (juliahub-package-url package)
                        `(tag-or-commit
                          . ,(string-append
                              "v" (juliahub-package-version package)))))
               (direct-dependencies
                (filter juliahub-dependency-direct?
                        (juliahub-package-dependencies package)))
               (dependencies-names (map juliahub-dependency-name
                                        direct-dependencies))
               (test-dependencies-names
                (if subdir
                    (parse-test-dependencies
                     (string-append subdir "/" directory))
                    (parse-test-dependencies directory)))
               (homepage (juliahub-package-homepage package)))
          (values (make-julia-sexp
                   package-name
                   (juliahub-package-version package)
                   source
                   (match homepage
                     ("" (juliahub-package-url package))
                     ((? string?) homepage)
                     (_ (juliahub-package-url package)))
                   (juliahub-package-description package)
                   (beautify-description
                    (juliahub-package-readme package))
                   direct-dependencies
                   test-dependencies-names
                   (juliahub-package-license package))
                  (append dependencies-names test-dependencies-names)))
    (values #f '()))))

;; We must use the url to get a name with the true case of juliahub/general.
(define (guix-package->juliahub-name package)
  (let* ((url (juliahub-package-url package))
         (git-name (last (string-split url #\/)))
         (ungitted-name (if (string-suffix? ".git" git-name)
                            (string-drop-right git-name 4)
                            git-name))
         (package-name (if (string-suffix? ".jl" ungitted-name)
                           (string-drop-right ungitted-name 4)
                           ungitted-name)))
    package-name))

(define* (import-release package #:key (version #f))
  "Return an <upstream-source> for the latest release of PACKAGE."
  (let* ((package-name (guix-package->juliahub-name package))
         (package      (juliahub-fetch package-name))
         (version  (or version (juliahub-package-version package))))
    (upstream-source
     (package (package-name package))
     (version version)
     (urls (list (juliahub-package-url package))))))

(define %juliahub-updater
  (upstream-updater
   (name 'juliahub)
   (description "Updater for Juliahub packages")
   (pred juliahub-package?)
   (import import-release)))

(define* (juliahub-recursive-import package-name #:optional version)
  (recursive-import package-name
                    #:repo '()
                    #:repo->guix-package juliahub->guix-package
                    #:guix-name julia-name->guix-name
                    #:version version))

debug log:

solving ab838b6035 ...
found ab838b6035 in https://yhetil.org/guix-patches/20231221140142.16523-2-ngraves@ngraves.fr/ ||
	https://yhetil.org/guix-patches/20240203230807.25751-2-ngraves@ngraves.fr/

applying [1/1] https://yhetil.org/guix-patches/20231221140142.16523-2-ngraves@ngraves.fr/
diff --git a/guix/import/juliahub.scm b/guix/import/juliahub.scm
new file mode 100644
index 0000000000..ab838b6035

Checking patch guix/import/juliahub.scm...
Applied patch guix/import/juliahub.scm cleanly.

skipping https://yhetil.org/guix-patches/20240203230807.25751-2-ngraves@ngraves.fr/ for ab838b6035
index at:
100644 ab838b60352185ce209d02ca463f3ff07cc9df35	guix/import/juliahub.scm

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).