Popper is a convention for organizing an academic article's artifacts following a DevOps approach, with the goal of making it easy for others (and yourself!) to repeat an experiment or analysis pipeline.
We first need to install the CLI tool by following these instructions. Show the available commands:
Show which version you installed:
Create a project repository (if you are not familiar with git, look here):
mkdir mypaper cd mypaper git init echo '# mypaper' > README.md git add . git commit -m 'first commit'
Initialize the popper repository and add the
.popper.yml file to
popper init git add . git commit -m 'adds .popper.yml file'
Initialize pipeline using
popper init myexp
Show what this did:
ls -l pipelines/myexp
Commit the "empty" pipeline:
git add pipelines/myexp git commit -m 'adding myexp scaffold'
Run popper run:
Once a pipeline is executed, one can show the logs:
ls -l pipelines/myexp/popper_logs
Adding Project to GitHub
Create a repository on github, register the remote repository to your local git and push all your commits:
git remote add origin firstname.lastname@example.org:<user>/<repo> git push -u origin master
<user> is your username and
<repo> is the name of the
repository you have created.
Adding Project to Travis
popper ci --service travis
And commit the file:
git add .travis.yml git commit -m 'Adds TravisCI config file'
Trigger an execution by pushing to github:
Go to TravisCI website to see your experiments being executed.