From 8b8c7f8fd9a794da842e2e36d2d86f259a694f7b Mon Sep 17 00:00:00 2001 From: Jermiah Joseph Date: Sun, 11 Feb 2024 19:58:25 -0500 Subject: [PATCH] docs: Update CI/CD workflow and documentation --- .github/workflows/main.yml | 3 +- docs/InitializeClient.rst | 115 ++------------------------------- docs/markdowns/Installation.md | 2 +- 3 files changed, 9 insertions(+), 111 deletions(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 0e10226..7b9a8ff 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -4,7 +4,7 @@ name: CI-CD on: push: # push to any branch - branches: [ main ] + branches: [ main , docs] pull_request: branches: [ main , development] @@ -46,6 +46,7 @@ jobs: Codecov: needs: Unit-Tests runs-on: ubuntu-latest + if: github.ref == 'refs/heads/docs' steps: - name: Checkout code uses: actions/checkout@v3 diff --git a/docs/InitializeClient.rst b/docs/InitializeClient.rst index a1ebba8..9bab999 100644 --- a/docs/InitializeClient.rst +++ b/docs/InitializeClient.rst @@ -32,7 +32,8 @@ initialize the client when performing a query. .. tab:: Command Line - To get a list of available public collections that start with "TCGA", run the following command: + All of the shell commands made available by nbiatoolkit have the option to use your credentials instead of the guest account. + To do so, simply add the -u `USERNAME` and -pw `PASSWORD` flags to the command. For example: .. tabs:: @@ -46,13 +47,16 @@ initialize the client when performing a query. .. code-block:: bash - getCollections -u -p --prefix TCGA + getCollections -u -pw --prefix TCGA Logging ^^^^^^^ +The client can be initialized with a log level to control the verbosity of the logs. This is primarily intended for debugging and development purposes. +The default log level is 'INFO' and the available log levels are 'DEBUG', 'INFO', 'WARNING', 'ERROR'. + .. tabs:: .. tab:: Python @@ -63,110 +67,3 @@ Logging client = NBIAClient(log_level='DEBUG) client.getCollections(prefix='TCGA') - - .. tab:: Command Line - - .. code-block:: bash - - getCollections --prefix TCGA # TODO:: implement logging for cli - -.. tabs:: - - .. group-tab:: Linux - - Linux tab content - tab set 1 - - .. group-tab:: Mac OSX - - Mac OSX tab content - tab set 1 - - .. group-tab:: Windows - - Windows tab content - tab set 1 - -.. tabs:: - - .. group-tab:: Linux - - Linux tab content - tab set 2 - - .. group-tab:: Mac OSX - - Mac OSX tab content - tab set 2 - - .. group-tab:: Windows - - Windows tab content - tab set 2 - - -.. tabs:: - - .. code-tab:: c - - C Main Function - - .. code-tab:: c++ - - C++ Main Function - - .. code-tab:: py - - Python Main Function - - .. code-tab:: java - - Java Main Function - - .. code-tab:: julia - - Julia Main Function - - .. code-tab:: fortran - - Fortran Main Function - - .. code-tab:: r R - - R Main Function - -.. tabs:: - - .. code-tab:: c - - int main(const int argc, const char **argv) { - return 0; - } - - .. code-tab:: c++ - - int main(const int argc, const char **argv) { - return 0; - } - - .. code-tab:: py - - def main(): - return - - .. code-tab:: java - - class Main { - public static void main(String[] args) { - } - } - - .. code-tab:: julia - - function main() - end - - .. code-tab:: fortran - - PROGRAM main - END PROGRAM main - - .. code-tab:: r R - - main <- function() { - return(0) - } diff --git a/docs/markdowns/Installation.md b/docs/markdowns/Installation.md index d1142a9..e842f4f 100644 --- a/docs/markdowns/Installation.md +++ b/docs/markdowns/Installation.md @@ -1,4 +1,4 @@ -# INSTALLATION +# Installation > [!WARNING] > `nbiatoolkit` is currently under development and is not guaranteed to be stable.