On this page:
client-property-list
client-property-ref
client-revision-property-list
client-revision-property-ref
Version: 4.2.1

3.8 Accessing Properties

(client-property-list client 
  path 
  [#:peg-revision peg-revision 
  #:revision revision 
  #:recurse recurse?]) 
  (listof (cons/c string? (listof (cons/c symbol? bytes?))))
  client : client?
  path : path-string?
  peg-revision : _opt-revision = 'unspecified
  revision : _opt-revision = 'head
  recurse? : any/c = #f
Retrieves all properties set on the given working copy or repository path or on resources within it, if recurse? is not #f.

The properties are returned as a nested association list: The keys of the first level are repository paths, the keys of the second level are the property names.

(client-property-ref client 
  path 
  key 
  [#:peg-revision peg-revision 
  #:revision revision 
  #:recurse recurse?]) 
  (listof (cons/c string? bytes?))
  client : client?
  path : path-string?
  key : symbol?
  peg-revision : _opt-revision = 'unspecified
  revision : _opt-revision = 'head
  recurse? : any/c = #f
Retrieves all instances of the property identified by key, set on the given working or repository path or on resources within it, if recurse? is not #f.

The property values are returned as an association list with repository paths as keys.

(client-revision-property-list client 
  url 
  [#:revision revision]) 
  (cons/c integer? (listof (cons/c symbol? bytes?)))
  client : client?
  url : string?
  revision : _opt-revision = 'head
Retrieves all properties set on a specific revision of the repository path at url.

The procedure returns a pair consisting of the properties’ actual revision number and an association list with property names as keys.

(client-revision-property-ref client 
  url 
  key 
  [#:revision revision]) 
  (or/c (cons/c integer? bytes?) #f)
  client : client?
  url : string?
  key : symbol?
  revision : _opt-revision = 'head
Retrieves the property identified by key, set on a specific revision of the repository path at url.

The procedure returns a pair consisting of the property’s actual revision number and its value or #f if the requested property is not set on the revision.