re-simple-python-project

This simple project structure template repository is adapted from the Good Enough Project Cookiecutter template by Barbara Vreede (2019).

This template was cloned for the RepCo workshop on 26th & 27th October.

I'm going to commit this as a demo for Git & GitHub.

Hello this is a third line!

Usage

Click "Use this template" at the top of this page to create a new repository with the same folder structure.

Project Structure

The project structure distinguishes three kinds of folders:

  • read-only (RO): not edited by either code or researcher
  • human-writeable (HW): edited by the researcher only.
  • project-generated (PG): folders generated when running the code; these folders can be deleted or emptied and will be completely reconstituted as the project is run.
.
├── .gitignore
├── LICENSE
├── README.md
├── requirements.txt
├── data               <- All project data, ignored by git
│   ├── processed      <- The final, canonical data sets for modeling. (PG)
│   ├── raw            <- The original, immutable data dump. (RO)
│   └── temp           <- Intermediate data that has been transformed. (PG)
├── docs               <- Documentation notebook for users (HW)
│   ├── manuscript     <- Manuscript source, e.g., LaTeX, Markdown, etc. (HW)
│   └── reports        <- Other project reports and notebooks (e.g. Jupyter, .Rmd) (HW)
├── results
│   ├── figures        <- Figures for the manuscript or reports (PG)
│   └── output         <- Other output for the manuscript or reports (PG)
└── src                <- Source code for this project (HW)

Add a citation file

Create a citation file for your repository using cffinit

License

This project is licensed under the terms of the MIT License.