GNU bug report logs - #28452
[PATCH 0/6] On-line doc and search for services

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: ludo <at> gnu.org (Ludovic Courtès)
Cc: tracker <at> debbugs.gnu.org
Subject: bug#28452: closed ([PATCH 0/6] On-line doc and search for services)
Date: Sat, 16 Sep 2017 16:14:01 +0000

[Message part 1 (text/plain, inline)]

Your message dated Sat, 16 Sep 2017 18:13:07 +0200
with message-id <87efr6k4fg.fsf <at> gnu.org>
and subject line Re: [bug#28452] [PATCH 0/6] On-line doc and search for services
has caused the debbugs.gnu.org bug report #28452,
regarding [PATCH 0/6] On-line doc and search for services
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
28452: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=28452
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Ludovic Courtès <ludo <at> gnu.org>
To: guix-patches <at> gnu.org
Cc: Ludovic Courtès <ludo <at> gnu.org>
Subject: [PATCH 0/6] On-line doc and search for services
Date: Wed, 13 Sep 2017 23:17:56 +0200

Hello!

This patch series adds a new ‘guix system search’ command to search
through the available services types:

--8<---------------cut here---------------start------------->8---
$ ./pre-inst-env guix system search anony network
name: tor
location: gnu/services/networking.scm:670:2
extends: shepherd-root account activate
description: Run the Tor (https://torproject.org) anonymous networking daemon.
relevance: 9

name: static-networking
location: gnu/services/networking.scm:248:2
extends: shepherd-root etc
description: Turn up the specified network interfaces upon startup, with the given IP
+ address, gateway, netmask, and so on.  The value for services of this type is a list of
+ `static-networking' objects, one per network interface.
relevance: 6

name: network-manager
location: gnu/services/networking.scm:947:4
extends: shepherd-root dbus polkit activate profile
description: Run NetworkManager (https://wiki.gnome.org/Projects/NetworkManager), a
+ network management daemon that aims to simplify wired and wireless networking.
relevance: 6

[...]
--8<---------------cut here---------------end--------------->8---

I think this can be pretty useful.  It also works with service types
that have #f as their ‘description’ field, which is the vast majority of
them (help welcome!).

Possible improvements and related things:

  • Display each field and value of the default value of services.

  • Add ‘guix system edit’ or ‘guix edit --service’?

  • Add a web UI to browse services.

Comments welcome!

Ludo’.

Ludovic Courtès (6):
  ui: Generalize relevance computation.
  services: Add a description and location for each service type.
  services: Add 'fold-service-types'.
  guix system: Add 'search' command.
  services: base: Add descriptions.
  services: networking: Add descriptions.

 Makefile.am                    |   1 +
 doc/guix.texi                  |  42 ++++++++++++
 gnu/services.scm               |  37 ++++++++++-
 gnu/services/base.scm          |  85 ++++++++++++++++++++----
 gnu/services/networking.scm    |  55 +++++++++++++---
 guix/scripts/package.scm       |  21 +-----
 guix/scripts/system.scm        |  13 +++-
 guix/scripts/system/search.scm | 144 +++++++++++++++++++++++++++++++++++++++++
 guix/ui.scm                    |  44 +++++++++++++
 po/guix/POTFILES.in            |   1 +
 po/packages/POTFILES.in        |   2 +
 tests/guix-system.sh           |   6 +-
 12 files changed, 403 insertions(+), 48 deletions(-)
 create mode 100644 guix/scripts/system/search.scm

-- 
2.14.1

[Message part 3 (message/rfc822, inline)]

From: ludo <at> gnu.org (Ludovic Courtès)
To: Christopher Baines <mail <at> cbaines.net>
Cc: 28452-done <at> debbugs.gnu.org
Subject: Re: [bug#28452] [PATCH 0/6] On-line doc and search for services
Date: Sat, 16 Sep 2017 18:13:07 +0200

Hi Chris,

Christopher Baines <mail <at> cbaines.net> skribis:

> On Wed, 13 Sep 2017 23:17:56 +0200
> Ludovic Courtès <ludo <at> gnu.org> wrote:
>
>> Hello!
>> 
>> This patch series adds a new ‘guix system search’ command to search
>> through the available services types:

[...]

> This looks awesome Ludo :) I've tried it out locally, and it works
> well. Obviously it will work a lot better when more services have
> descriptions, but this is a great start.
>
> I've also had a look through the patches, and they all look good to me.

Thanks for your feedback!  I’ve pushed it now.

Note that this changes the ABI, so you’ll need at least:

  rm gnu/*.go gnu/services/*.go gnu/system/*.go && make

Ludo’.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.