History

Using the history command, it is possible to show the history of the current checked out ledger.

Usage:
  permguard history [flags]

Flags:
  -h, --help   help for history

Global Flags:
  -o, --output string            output format (default "terminal")
      --spiffe-enabled           enable native SPIFFE mTLS via Workload API
      --spiffe-endpoint string   SPIFFE Workload API socket path (defaults to SPIFFE_ENDPOINT_SOCKET env)
      --tls-ca-file string       path to CA certificate for server verification (PEM)
      --tls-cert-file string     path to client certificate for mTLS (PEM)
      --tls-key-file string      path to client private key for mTLS (PEM)
      --tls-skip-verify          skip server certificate verification (insecure, dev only)
  -v, --verbose                  true for verbose output
  -w, --workdir string           workdir (default ".")

caution

The output from your current version of Permguard may differ from the example provided on this page.

Show the History

The permguard history command allows you to show the history of the current checked out ledger.

permguard history

output:

Your workspace history head/273165098782/fd1ac44e4afa4fc4beec622494d3175a:

commit bafyreigicp6inahqx7bny4q3hayvfyldwgx34vlg55z6dt3mpgdc6xqtm4:
  - tree: bafyreigecbyyfwelaip4ynreku26h7pwu5qqg5fm3s23lcbzlejdrhpfwu
  - Committer date: 2024-12-24 16:51:57 +0100 CET
  - Author date: 2024-12-24 16:51:57 +0100 CET
commit bafyreidxucxtwamjuk6g4ziku2yon2qhtm7jnjbcsbrcwyecm7fj2vzety:
  - tree: bafyreigyugkg5ywg2fxgwmfbnz3b25tmi332255jbwzneurdssifdbazri
  - Committer date: 2024-12-24 16:50:04 +0100 CET
  - Author date: 2024-12-24 16:50:04 +0100 CET
commit bafyreiag4keidsdw5gyiyox3mqylddufxmsjdp2wpjaga66yuv5672bote:
  - tree: bafyreigecbyyfwelaip4ynreku26h7pwu5qqg5fm3s23lcbzlejdrhpfwu
  - Committer date: 2024-12-24 16:48:58 +0100 CET
  - Author date: 2024-12-24 16:48:58 +0100 CET

total 3

JSON Output

permguard history --output json

output:

{
  "commits": [
    {
      "author": "",
      "author_timestamp": "2024-12-24T16:51:57+01:00",
      "committer": "",
      "committer_timestamp": "2024-12-24T16:51:57+01:00",
      "message": "",
      "oid": "bafyreigicp6inahqx7bny4q3hayvfyldwgx34vlg55z6dt3mpgdc6xqtm4",
      "parent": "bafyreidxucxtwamjuk6g4ziku2yon2qhtm7jnjbcsbrcwyecm7fj2vzety",
      "tree": "bafyreigecbyyfwelaip4ynreku26h7pwu5qqg5fm3s23lcbzlejdrhpfwu"
    },
    {
      "author": "",
      "author_timestamp": "2024-12-24T16:50:04+01:00",
      "committer": "",
      "committer_timestamp": "2024-12-24T16:50:04+01:00",
      "message": "",
      "oid": "bafyreidxucxtwamjuk6g4ziku2yon2qhtm7jnjbcsbrcwyecm7fj2vzety",
      "parent": "bafyreiag4keidsdw5gyiyox3mqylddufxmsjdp2wpjaga66yuv5672bote",
      "tree": "bafyreigyugkg5ywg2fxgwmfbnz3b25tmi332255jbwzneurdssifdbazri"
    },
    {
      "author": "",
      "author_timestamp": "2024-12-24T16:48:58+01:00",
      "committer": "",
      "committer_timestamp": "2024-12-24T16:48:58+01:00",
      "message": "",
      "oid": "bafyreiag4keidsdw5gyiyox3mqylddufxmsjdp2wpjaga66yuv5672bote",
      "parent": "bafyreiaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "tree": "bafyreigecbyyfwelaip4ynreku26h7pwu5qqg5fm3s23lcbzlejdrhpfwu"
    }
  ]
}