worldbank / repkit

A Stata package with tools related to computational reproducibility
https://worldbank.github.io/repkit/
6 stars 0 forks source link

repkit

This Stata module is a package providing a utility toolkit for reproducibility best-practices. The motivation for this package is to make the World Bank's reproducibility best-practices more accessible to a wider Stata community. The best-practices promoted in this package appreciated identified and implemented as part of the World Bank's reproducibility effort.

Currently, this toolkit has the following commands:

Command Description
repado Command used to manage a project's dependencies of commands installed from external sources such as SSC. This command provides a way to make sure that all team members as well as future reproducers of the projects code use the exact same version of all command dependencies.
repadolog Outputs a report of the commands installed in the current PLUS folder.
repkit Command named the same as the package. Most important purpose is that this command makes the code which repkit work.
reproot This command allows teams to dynamically set root-paths with no manual user-specific set-up, in both single-rooted and multi-rooted projects.
reproot_setup This command helps setting up the environment setting file used in reproot
reprun This command is used to automate reproducibility checks by running a do-file or a set of do-files and compare all state values (RNG-value, datasignature etc.) between the two runs. This command is currently only release as a beta-version.
lint lint is an opinionated detector that attempts to improve the readability and organization of Stata do files. The command is written based on the good coding practices of the Development Impact Evaluation Unit at The World Bank.

Installation

While we allow multiple ways of installing the package, we recommend all users to install the package from SSC unless there is a very specific reason to not do so.

Install from SSC

To install from SSC, run this code in your Stata command line.

ssc install repkit

Install from GitHub repo

You can install older versions of repkit directly from the GitHub repository. To do so, start by finding the tag corresponding to the version you want to install here: https://github.com/worldbank/repkit/tags. Update the local "tag" in the code below with the value of the tag you picked, and then run the code.

local tag "v1.0"
net install repkit, ///
  from("https://raw.githubusercontent.com/worldbank/repkit/`tag'/src")

Contributions

This package is developed in this repo on GitHub using the adodown workflow.

We are happy to receive feedback and/or contributions. Please feel free to report bugs or request new features by opening up a new issue.

You are also welcome to fork this repo and submit a pull request with contribution to the code.

Authors

This package is written and published by DIME Analytics and the LSMS Team. Both teams are teams within the World Bank DIME Analytics is a research data methodology team part of the Development Impact department. The Living Standards Measurement Study (LSMS) is the World Bank's flagship household survey program and is part of the World Bank’s Development Data Group.

Contact: