Zen

Translation

English type: lisp
;; Return the package object define above at the end of the module.
guile
83/740 · 74

Sign in to save the translation.

English German Actions
guix build -f guix.scm -s aarch64-linux -s riscv64-linux
guix build -f guix.scm -s aarch64-linux -s riscv64-linux
@dots{} or cross-compile:
… oder Sie cross-kompilieren:
guix build -f guix.scm --target=x86_64-w64-mingw32
guix build -f guix.scm --target=x86_64-w64-mingw32
You can also use @dfn{package transformations} to test package variants (@pxref{Package Transformation Options,,, guix, GNU Guix Reference Manual}):
Möglich sind auch @dfn{Paketumwandlungsoptionen}, womit Sie Varianten Ihres Pakets testen können (siehe @ref{Paketumwandlungsoptionen,,, guix.de, Referenzhandbuch zu GNU Guix}):
# What if we built with Clang instead of GCC?
guix build -f guix.scm \
--with-c-toolchain=guile@@3.0.99-git=clang-toolchain
# Wie sieht es aus, wenn wir mit Clang statt GCC erstellen?
guix build -f guix.scm \
--with-c-toolchain=guile@@3.0.99-git=clang-toolchain
# What about that under-tested configure flag?
guix build -f guix.scm \
--with-configure-flag=guile@@3.0.99-git=--disable-networking
# Was ist mit wenig getesteten configure-Befehlszeilenoptionen?
guix build -f guix.scm \
--with-configure-flag=guile@@3.0.99-git=--disable-networking
Handy!
Praktisch!
Level 2: The Repository as a Channel
Stufe 2: Das Repository als Kanal
We now have a Git repository containing (among other things) a package definition (@pxref{Building with Guix}). Can't we turn it into a @dfn{channel} (@pxref{Channels,,, guix, GNU Guix Reference Manual})? After all, channels are designed to ship package definitions to users, and that's exactly what we're doing with our @file{guix.scm}.
Jetzt haben wir ein Git-Repository mit (unter anderem) einer Paketdefinition (siehe @ref{Building with Guix}). Wäre es nicht besser, wenn wir daraus einen @dfn{Kanal} machen würden (siehe @ref{Kanäle,,, guix.de, Referenzhandbuch zu GNU Guix})? Schließlich sind Kanäle entwickelt worden, um Nutzer mit Paketdefinitionen zu versorgen, und genau das tun wir mit @file{guix.scm}.
Turns out we can indeed turn it into a channel, but with one caveat: we must create a separate directory for the @code{.scm} file(s) of our channel so that @command{guix pull} doesn't load unrelated @code{.scm} files when someone pulls the channel---and in Guile, there are lots of them! So we'll start like this, keeping a top-level @file{guix.scm} symlink for the sake of @command{guix shell}:
Tatsächlich sollten wir es zu einem Kanal machen, aber aufgepasst: Die @code{.scm}-Datei(en) unseres Kanals gehören in ein gesondertes Verzeichnis, damit @command{guix pull} nicht versucht, die falschen @code{.scm}-Dateien zu laden, wenn jemand damit den Kanal herunterlädt@tie{}– und in Guile gibt es viele @code{.scm}-Dateien! Wir fangen mit der Trennung an, behalten aber auf oberster Ebene eine symbolische Verknüpfung @file{guix.scm} zur Nutzung mit @command{guix shell}:
mkdir -p .guix/modules
mv guix.scm .guix/modules/guile-package.scm
ln -s .guix/modules/guile-package.scm guix.scm
mkdir -p .guix/modules
mv guix.scm .guix/modules/guile-package.scm
ln -s .guix/modules/guile-package.scm guix.scm
To make it usable as part of a channel, we need to turn our @file{guix.scm} file into a @dfn{package module} (@pxref{Package Modules,,, guix, GNU Guix Reference Manual}): we do that by changing the @code{use-modules} form at the top to a @code{define-module} form. We also need to actually @emph{export} a package variable, with @code{define-public}, while still returning the package value at the end of the file so we can still use @command{guix shell} and @command{guix build -f guix.scm}. The end result looks like this (not repeating things that haven't changed):
Damit es als Kanal verwendet werden kann, erweitern wir unsere @file{guix.scm}-Datei zu einem @dfn{Paketmodul} (siehe @ref{Paketmodule,,, guix.de, Referenzhandbuch zu GNU Guix}). Das geschieht, indem wir die @code{use-modules}-Form am Anfang durch eine @code{define-module}-Form ersetzen. Auch müssen wir dann eine Paketvariable @emph{exportieren}, mit @code{define-public}, und dennoch am Ende der Datei den Paketwert zurückliefern, damit @command{guix shell} und @command{guix build -f guix.scm} weiterhin funktionieren. Das Endergebnis sieht so aus (ohne zu wiederholen, was wir nicht verändern):
(define-module (guile-package)
#:use-module (guix)
#:use-module (guix git-download) ;for ‘git-predicate’
@dots{})
(define-module (guile-package)
#:use-module (guix)
#:use-module (guix git-download) ;für ‚git-predicate‘
…)
(define vcs-file?
;; Return true if the given file is under version control.
(or (git-predicate (dirname (dirname (current-source-directory))))
(const #t))) ;not in a Git checkout
(define vcs-file?
;; Wahr zurückliefern, wenn die angegebene Datei unter
;; Versionskontrolle steht.
(or (git-predicate (dirname (dirname (current-source-directory))))
(const #t))) ;es ist kein Git-Checkout
(define-public guile
(package
(name "guile")
(version "3.0.99-git") ;funky version number
(source (local-file "../.." "guile-checkout"
#:recursive? #t
#:select? vcs-file?))
@dots{}))
(define-public guile
(package
(name "guile")
(version "3.0.99-git") ;komische Versionsnummer
(source (local-file "../.." "guile-checkout"
#:recursive? #t
#:select? vcs-file?))
…))
;; Return the package object define above at the end of the module.
guile
;; Das oben definierte Paketobjekt muss am Modulende zurückgeliefert werden.
guile
We need one last thing: a @uref{https://guix.gnu.org/manual/devel/en/html_node/Package-Modules-in-a-Sub_002ddirectory.html,@code{.guix-channel} file} so Guix knows where to look for package modules in our repository:
Zuletzt brauchen wir noch eine @uref{https://guix.gnu.org/manual/devel/de/html_node/Paketmodule-in-einem-Unterverzeichnis.html,@code{.guix-channel}-Datei}, um Guix zu erklären, woher es die Paketmodule in unserem Repository bekommt:
;; This file lets us present this repo as a Guix channel.
;; Mit dieser Datei kann man dieses Repo als Guix-Kanal eintragen.
(channel
(version 0)
(directory ".guix/modules")) ;look for package modules under .guix/modules/
(channel
(version 0)
(directory ".guix/modules")) ;Paketmodule finden sich unter .guix/modules/
To recap, we now have these files:
Zusammengefasst liegen diese Dateien jetzt im Repository:
.
├── .guix-channel
├── guix.scm → .guix/modules/guile-package.scm
└── .guix
    └── modules
       └── guile-package.scm
.
├── .guix-channel
├── guix.scm → .guix/modules/guile-package.scm
└── .guix
    └── modules
       └── guile-package.scm
And that's it: we have a channel! (We could do better and support @uref{https://guix.gnu.org/manual/devel/en/html_node/Specifying-Channel-Authorizations.html,@emph{channel authentication}} so users know they're pulling genuine code. We'll spare you the details here but it's worth considering!) Users can pull from this channel by @uref{https://guix.gnu.org/manual/devel/en/html_node/Specifying-Additional-Channels.html,adding it to @code{~/.config/guix/channels.scm}}, along these lines:
Und das war alles: Wir haben einen Kanal erschaffen! (Noch besser wäre es, auch @uref{https://guix.gnu.org/en/manual/devel/de/html_node/Kanalautorisierungen-angeben.html,@emph{Kanalautorisierungen}} zu unterstützen, damit Benutzer wissen, dass der heruntergeladene Code echt ist. Wir ersparen Ihnen die Feinheiten hier, aber ziehen Sie es in Betracht!) Nutzer können von diesem Kanal pullen, indem sie @uref{https://guix.gnu.org/manual/devel/de/html_node/Weitere-Kanale-angeben.html,ihn zu @code{~/.config/guix/channels.scm} hinzufügen}, etwa so:
(append (list (channel
(name 'guile)
(url "https://git.savannah.gnu.org/git/guile.git")
(branch "main")))
%default-channels)
(append (list (channel
(name 'guile)
(url "https://git.savannah.gnu.org/git/guile.git")
(branch "main")))
%default-channels)
After running @command{guix pull}, we can see the new package:
Nach einem Aufruf von @command{guix pull} sind die neuen Pakete zu sehen:
$ guix describe
Generation 264 May 26 2023 16:00:35 (current)
guile 36fd2b4
repository URL: https://git.savannah.gnu.org/git/guile.git
branch: main
commit: 36fd2b4920ae926c79b936c29e739e71a6dff2bc
guix c5bc698
repository URL: https://git.savannah.gnu.org/git/guix.git
commit: c5bc698e8922d78ed85989985cc2ceb034de2f23
$ guix package -A ^guile$
guile 3.0.99-git out,debug guile-package.scm:51:4
guile 3.0.9 out,debug gnu/packages/guile.scm:317:2
guile 2.2.7 out,debug gnu/packages/guile.scm:258:2
guile 2.2.4 out,debug gnu/packages/guile.scm:304:2
guile 2.0.14 out,debug gnu/packages/guile.scm:148:2
guile 1.8.8 out gnu/packages/guile.scm:77:2
$ guix build guile@@3.0.99-git
[@dots{}]
/gnu/store/axnzbl89yz7ld78bmx72vpqp802dwsar-guile-3.0.99-git-debug
/gnu/store/r34gsij7f0glg2fbakcmmk0zn4v62s5w-guile-3.0.99-git
$ guix describe
Generation 264 26. Mai 2023 16:00:35 (aktuell)
guile 36fd2b4
Repository-URL: https://git.savannah.gnu.org/git/guile.git
Branch: main
Commit: 36fd2b4920ae926c79b936c29e739e71a6dff2bc
guix c5bc698
Repository-URL: https://git.savannah.gnu.org/git/guix.git
Commit: c5bc698e8922d78ed85989985cc2ceb034de2f23
$ guix package -A ^guile$
guile 3.0.99-git out,debug guile-package.scm:51:4
guile 3.0.9 out,debug gnu/packages/guile.scm:317:2
guile 2.2.7 out,debug gnu/packages/guile.scm:258:2
guile 2.2.4 out,debug gnu/packages/guile.scm:304:2
guile 2.0.14 out,debug gnu/packages/guile.scm:148:2
guile 1.8.8 out gnu/packages/guile.scm:77:2
$ guix build guile@@3.0.99-git
[…]
/gnu/store/axnzbl89yz7ld78bmx72vpqp802dwsar-guile-3.0.99-git-debug
/gnu/store/r34gsij7f0glg2fbakcmmk0zn4v62s5w-guile-3.0.99-git
That's how, as a developer, you get your software delivered directly into the hands of users! No intermediaries, yet no loss of transparency and provenance tracking.
Auf diesem Weg liefern Sie, als Entwickler, Ihre Software direkt in die Hände der Nutzer! Es gibt keine Mittelsmänner, trotzdem bleiben Transparenz und Provenienzverfolgung erhalten.
With that in place, it also becomes trivial for anyone to create Docker images, Deb/RPM packages, or a plain tarball with @command{guix pack} (@pxref{Invoking guix pack,,, guix, GNU Guix Reference Manual}):
Auf dieser Grundlage kann außerdem jeder leicht Docker-Abbilder, Pakete als Deb/RPM oder einen einfachen Tarball mit @command{guix pack} anfertigen (siehe @ref{Aufruf von guix pack,,, guix.de, Referenzhandbuch zu GNU Guix}):
# How about a Docker image of our Guile snapshot?
guix pack -f docker -S /bin=bin guile@@3.0.99-git
# Sie wünschen ein Docker-Image mit unserem Guile-Snapshot?
guix pack -f docker -S /bin=bin guile@@3.0.99-git
# And a relocatable RPM?
guix pack -f rpm -R -S /bin=bin guile@@3.0.99-git
# Und ein verschiebliches RPM?
guix pack -f rpm -R -S /bin=bin guile@@3.0.99-git
Bonus: Package Variants
Bonus: Paketvarianten
We now have an actual channel, but it contains only one package (@pxref{The Repository as a Channel}). While we're at it, we can define @dfn{package variants} (@pxref{Defining Package Variants,,, guix, GNU Guix Reference Manual}) in our @file{guile-package.scm} file, variants that we want to be able to test as Guile developers---similar to what we did above with transformation options. We can add them like so:
Jetzt, wo wir es zu einem richtigen Kanal gebracht haben (siehe @ref{The Repository as a Channel}), drängt sich die Frage auf, warum er nur ein Paket enthält. Da geht mehr, denn wir können gleich mehrere @dfn{Paketvarianten} (siehe @ref{Paketvarianten definieren,,, guix.de, Referenzhandbuch zu GNU Guix}) in unserer Datei @file{guile-package.scm} festlegen, und zwar Varianten, die wir Entwickler von Guile gerne testen würden@tie{}– wofür wir oben noch Paketumwandlungsoptionen gebraucht haben. Wir können Sie auf diese Weise eintragen:

Loading…

User avatar pelzflorian

Translation uploaded

  1. guix
  2. documentation-cookbook
  3. German
;; Return the package object define above at the end of the module.
guile
;; Das oben definierte Paketobjekt muss am Modulende zurückgeliefert werden.
guile
7 months ago
User avatar None

String updated in the repository

  1. guix
  2. documentation-cookbook
  3. German
;; Return the package object define above at the end of the module.
guile
 
7 months ago
Browse all string changes

Things to check

Reused translation

Other source string: “;; Return the package object defined above at the end of the module. guile ”

Reset

Glossary

English German
module Modul guix Glossary
package guix Glossary

String information

Source string description
type: lisp
Flags
no-wrap
Source string location
guix-git/doc/guix-cookbook.texi:4645
String age
7 months ago
Last updated
7 months ago
Source string age
7 months ago
Translation file
po/doc/guix-cookbook.de.po, string 987