Skip to content
This repository has been archived by the owner on Jul 19, 2023. It is now read-only.

Commit

Permalink
Update settings, license, and contributing files
Browse files Browse the repository at this point in the history
  • Loading branch information
ncoop57 committed Dec 7, 2020
1 parent 54d0ba7 commit 2db53a0
Show file tree
Hide file tree
Showing 3 changed files with 17 additions and 4 deletions.
12 changes: 11 additions & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,19 @@

## How to get started

Before anything else, please install the git hooks that run automatic scripts during each commit and merge to strip the notebooks of superfluous metadata (and avoid merge conflicts). After cloning the repository, run the following command inside it:
To first get up and running you must first start the docker container that contains the necessary development environment. Run the following command to build the docker container and launch it. This will take a significant amount of time (>20min), but will be faster on future runs.
- <data_path>: the absolute path to where the data you want to mount into the container is located. This mount will be available at `/home/jovyan/data`
- <port>: The port you want to be able to access the jupyter lab interface from.
- --build: Optional flag that when present will build from scratch the docker container. On future runs, just omit the `--build` flag to not rebuild the docker container.
```
bash start.sh <data_path> <port> --build
```

Once the container has launched, log into the container through the jupyter lab interface by going to your browser and typing `localhost:<port>`. When prompted for a password input `asdf`. Another way to log into the docker container can be using `docker exec -it <container_name>`. After you are in the container, please install the git hooks that run automatic scripts during each commit, format all your nbs according to our style, and merge to strip the notebooks of superfluous metadata (and avoid merge conflicts) and install the library locally. Run the following commands from the root of the repository (`/home/jovyan/work`):
```
nbdev_install_git_hooks
pip install -e .
pre-commit install
```

## Did you find a bug?
Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright [yyyy] [name of copyright owner]
Copyright 2020 Semeru Lab

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand Down
7 changes: 5 additions & 2 deletions settings.ini
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,12 @@ license = apache2
status = 2

# Optional. Same format as setuptools requirements
# requirements =
requirements = fastcore==1.3.10
# Optional. Same format as setuptools console_scripts
# console_scripts =
console_scripts = mlproj_process_data=mlproj_template.cli:process_data
mlproj_train=mlproj_template.cli:train
mlproj_evaluate=mlproj_template.cli:evaluate
mlproj_reproduce=mlproj_template.cli:reproduce
# Optional. Same format as setuptools dependency-links
# dep_links =

Expand Down

0 comments on commit 2db53a0

Please sign in to comment.