Skip to content

Commit

Permalink
docs: Update CI/CD workflow and documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
jjjermiah committed Feb 12, 2024
1 parent ad0ec3a commit 8b8c7f8
Show file tree
Hide file tree
Showing 3 changed files with 9 additions and 111 deletions.
3 changes: 2 additions & 1 deletion .github/workflows/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ name: CI-CD
on:
push:
# push to any branch
branches: [ main ]
branches: [ main , docs]
pull_request:
branches: [ main , development]

Expand Down Expand Up @@ -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
Expand Down
115 changes: 6 additions & 109 deletions docs/InitializeClient.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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::

Expand All @@ -46,13 +47,16 @@ initialize the client when performing a query.

.. code-block:: bash
getCollections -u <USERNAME> -p <PASSWORD> --prefix TCGA
getCollections -u <USERNAME> -pw <PASSWORD> --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
Expand All @@ -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)
}
2 changes: 1 addition & 1 deletion docs/markdowns/Installation.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# INSTALLATION
# Installation

> [!WARNING]
> `nbiatoolkit` is currently under development and is not guaranteed to be stable.
Expand Down

0 comments on commit 8b8c7f8

Please sign in to comment.