1
0
mirror of https://github.com/romkatv/powerlevel10k.git synced 2024-12-12 19:18:28 +02:00
powerlevel10k/TESTS.md
Christian Höltje df318488c9 test-in-docker: quickly test frameworks in docker
This adds `./test-in-docker` for quickly playing with various frameworks.

All the containers are based off Ubuntu 14.04 which has ZSH 5.0.2.

Thanks to @dritter for figuring out all the framework installation
methods.
2017-07-11 20:41:46 -04:00

1.2 KiB

Structure

The Unit-Tests do not follow exactly the file structure of Powerlevel9k itself.

Basic Tests

Basic Tests belong in test/powerlevel9k.spec if they test basic functionality of Powerlevel9k itself. Basic functions from the functions directory have their Tests in separate files under test/functions.

Segment Tests

These Tests tend to be more complex in setup than the basic tests. To avoid ending up in a huge single file, there is one file per segment in test/segments.

Manual Testing

If unit tests are not sufficient (e.g. you have an issue with your prompt that occurs only in a specific ZSH framework) then you can use either Docker or or our Vagrant.

Docker

This is the easiest to use if you have Docker already installed and running.

The command ./test-in-docker should make it fairly easy to get into a running container with the framework of your choice.

You can get Docker at https://www.docker.com/community-edition.

Vagrant

Currently there are two test VMs. test-vm is an Ubuntu machine with several pre-installed ZSH frameworks. And there is test-bsd-vm which is a FreeBSD! For how to run the machines see here.