From bcc968e7a8d3e309f7a8bf64a1b8c02bd92c9cc9 Mon Sep 17 00:00:00 2001 From: David Oduneye Date: Sun, 28 Apr 2024 19:17:26 -0400 Subject: [PATCH] doc: added documentation for cli --- cli/README.md | 63 +++++++++++++++++++++++++++++ frontend/dashboard/src/app/page.tsx | 2 +- go.work.sum | 1 + 3 files changed, 65 insertions(+), 1 deletion(-) create mode 100644 cli/README.md diff --git a/cli/README.md b/cli/README.md new file mode 100644 index 000000000..3539602e7 --- /dev/null +++ b/cli/README.md @@ -0,0 +1,63 @@ +# SAC (Student Activity Calendar) CLI + +[![CLI](https://github.com/GenerateNU/sac/actions/workflows/cli.yml/badge.svg)](https://github.com/GenerateNU/sac/actions/workflows/cli.yml) +[![Go Report Card](https://goreportcard.com/badge/github.com/GenerateNU/sac/cli)](https://goreportcard.com/report/github.com/GenerateNU/sac/cli) +[![License](https://img.shields.io/github/license/GenerateNU/sac)](https://github.com/GenerateNU/sac/blob/main/LICENSE) + + + +## Introduction +The SAC CLI is a tool designed to help manage and automate tasks for the GenerateNU Student Activity Calendar platform. It provides a comprehensive suite of commands for formatting, testing, linting, running, and managing databases and other configurations essential for the SAC platform. + +## Table of Contents + +1. [Installation](#installation) +2. [Usage](#usage) +3. [Available Commands](#available-commands) +4. [Command Aliases](#command-aliases) +5. [Dependencies](#dependencies) +6. [License](#license) + +## Installation + +To install the SAC CLI, clone the repository and run the following script from the root of the application: + +```bash +./install_cli.sh +``` + +## Usage + +To use the SAC CLI, you can run it with various flags or commands: + +``` +sac [flags] +sac [command] +``` + +## Available Commands + +- **completion**: Generate the autocompletion script for the specified shell. +- **database**: Database management commands. +- **format**: Formatting commands. +- **help**: Help about any command. +- **lint**: Linting commands. +- **run**: Run commands for backend and frontend. +- **setup**: Installs and sets up the project. (WIP) +- **swagger**: Run swagger initialization for backend openapi spec. +- **test**: Testing commands. + +For more detailed information about a command, use: + +```bash +sac [command] --help +``` + +## Command Aliases + +Several commands in the SAC CLI are equipped with short aliases to make them quicker and easier to use. For example, a command like `sac format frontend dashboard` which is pretty lengthy can be shortened to `sac f fe d`. + +## Dependencies + +- `golangci-lint`: A linter aggregator for Go, ensuring code quality. +- `gofumpt`: A stricter formatter for Go code, ensuring consistency. diff --git a/frontend/dashboard/src/app/page.tsx b/frontend/dashboard/src/app/page.tsx index 06e3a13ed..3763448a3 100644 --- a/frontend/dashboard/src/app/page.tsx +++ b/frontend/dashboard/src/app/page.tsx @@ -1,4 +1,4 @@ -import Image from 'next/image'; +import Image from "next/image"; export default function Home() { return ( diff --git a/go.work.sum b/go.work.sum index d11da3f9e..5a2b8473b 100644 --- a/go.work.sum +++ b/go.work.sum @@ -287,6 +287,7 @@ github.com/prometheus/procfs v0.6.0/go.mod h1:cz+aTbrPOrUb4q7XlbU9ygM+/jj0fzG6c1 github.com/remyoudompheng/bigfft v0.0.0-20200410134404-eec4a21b6bb0/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo= github.com/rogpeppe/go-internal v1.9.0/go.mod h1:WtVeX8xhTBvf0smdhujwtBcq4Qrzq/fJaraNFVN+nFs= github.com/rqlite/gorqlite v0.0.0-20230708021416-2acd02b70b79/go.mod h1:xF/KoXmrRyahPfo5L7Szb5cAAUl53dMWBh9cMruGEZg= +github.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk= github.com/sagikazarmark/crypt v0.17.0/go.mod h1:SMtHTvdmsZMuY/bpZoqokSoChIrcJ/epOxZN58PbZDg= github.com/shopspring/decimal v1.2.0/go.mod h1:DKyhrW/HYNuLGql+MJL6WCR6knT2jwCFRcu2hWCYk4o= github.com/shurcooL/sanitized_anchor_name v1.0.0/go.mod h1:1NzhyTcUVG4SuEtjjoZeVRXNmyL/1OwPU0+IJeTBvfc=