This is a homegrown collection of opinionated scripts and utilities to make the charm dev's life a somewhat easier.
Clone the repo; symlink 'jhack.py' as 'jhack' to ~/bin or somewhere under PATH.
$ pip install -r requirements.txt
jhack [category] [command]
for example:
$ jhack utils tail
Happy hacking!
jhack utils sync ./src application-name/0
Will watch the ./src folder for changes and push any to application-name/0 under /charm/src/.
jhack utils unbork-juju
Does exactly what it says, and it does it pretty well.
jhack utils ffwd
Fast-forwards the firing of update-status hooks, and restores it to a 'slow' firing rate after the process is killed or after a given timeout.
Self-explanation:
jhack utils ffwd
--timeout 10 # exits after 10 seconds
--fast-interval 5 # update-status fires each 5 seconds
--slow-interval 50m # when done, set update-status firing rate to 50 minutes. Monitors the logs and gathers all logs concerning events being fired on the units. Will pprint the last N in a nice format. Keeps listening and updates in the background as new units are added.
┏━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ timestamp ┃ prometheus-k8s/0 ┃ traefik-k8s/0 ┃ prometheus-k8s/1 ┃
┡━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 13:37:15 │ │ │ ingress-relation-changed │
│ 13:37:14 │ │ │ ingress-relation-joined │
│ 13:37:14 │ │ │ ingress-relation-changed │
│ 13:37:13 │ │ │ prometheus-peers-relation-c… │
│ 13:37:12 │ │ │ prometheus-peers-relation-j… │
│ 13:37:12 │ │ │ prometheus-pebble-ready │
│ 13:37:11 │ │ │ start │
│ 13:37:10 │ │ │ config-changed │
│ 13:37:09 │ ingress-relation-changed │ │ │
│ 13:37:09 │ │ │ database-storage-attached │
│ 13:37:09 │ │ ingress-per-unit-relation-c… │ │
│ 13:37:08 │ │ │ leader-settings-changed │
│ 13:37:08 │ │ ingress-per-unit-relation-c… │ │
│ 13:37:08 │ prometheus-peers-relation-c… │ │ │
│ 13:37:08 │ │ │ ingress-relation-created │
│ 13:37:07 │ │ ingress-per-unit-relation-j… │ │
│ 13:37:07 │ prometheus-peers-relation-j… │ │ │
│ 13:37:07 │ │ │ prometheus-peers-relation-c… │
│ 13:37:06 │ │ │ install │
└───────────┴──────────────────────────────┴──────────────────────────────┴──────────────────────────────┘
jhack utils show-relation prometheus-k8s/0:ingress traefik-k8s/0:ingress-per-unit --watch
Will pprint:
relation data v0.1
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
┃ category ┃ keys ┃ prometheus-k8s/0 ┃ traefik-k8s/0 ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━┩
│ metadata │ endpoint │ 'ingress' │ 'ingress-per-unit' │
│ │ leader │ True │ True │
├──────────────────┼──────────┼──────────────────────────────────────────────────┼────────────────────┤
│ application data │ data │ ingress: │ │
│ │ │ prometheus-k8s/0: │ │
│ │ │ url: http://foo.bar:80/test-prometheus-k8s-0 │ │
│ unit data │ data │ host: 10.1.232.174 │ │
│ │ │ model: test │ │
│ │ │ name: prometheus-k8s/0 │ │
│ │ │ port: 9090 │ │
└──────────────────┴──────────┴──────────────────────────────────────────────────┴────────────────────┘jhack model clear
Will nuke all applications in the current model.
jhack model rm
Will nuke the current model.
Updates a packed .charm file by dumping into it any number of directories.
jhack charm update ./my_charm_file-amd64.charm --src ./src --dst src
This will take ./src and recursively copy it into the packed charm's /src dir (it will destroy any existing content).
Like update, but keeps watching for changes in the provided directories and pushes them into the packed charm whenever there's one.
jhack charm sync ./my_charm_file-amd64.charm --src ./src --dst src
Used to pack a charm and refresh it in a juju model. Useful when developing.
If used without arguments, it will assume the cwd is the charm's root, will run
charmcraft pack, and grab the application name from the charm's name.
jhack charm repack
Otherwise, you can specify a folder where the packing should be done, and an application name to target with the refresh.
jhack charm repack --root /where/my/charm/root/is --name juju-app-name
Used to play around with jinx (YAMLess Charms)
jhack jinx install
Downloads the jinx source.
jhack jinx init
Basically jinxcraft init.