Skip to content

WSU-4110/warrior-bot

Repository files navigation

warrior-bot

Terminal assistant for Wayne State University students.

Welcome!

warrior-bot is a CLI tool for Wayne State University staff and students. The idea is to make many of the things we need day to day easier to access and use through the terminal.

You can access the documentation here.

To install warrior bot, you can run:

pip install warrior-bot

For uv users:

uv install warrior-bot

For poetry users:

poetry install warrior-bot

For developers, you will find relevant info about how to setup, build and run this project below.

Requirements

If you're on MacOS, we recommend iTerm2

Setup (development)

Ensure you have a version of Python >= 3.10 installed on your machine.

Virtual Environment

It's best that you use a virtual environment to both develop and test warrior-bot.

python3 -m venv venv # create virtual environment named "venv"

source venv/bin/activate # activate the virtual environment

pip install -r requirements.txt # install all needed libraries to your virtual environment

deactivate # deactivate the environment

Install and run the CLI script

To install the warrior-bot console script, run from root:

pip install -e .

Then, you can begin testing/iterating and developing on warrior-bot:

warrior-bot where naresh mahabir

wb go degree works

wb book --b state hall

pre-commit hooks

As a developer, you can install hooks to automatically do things like run black, isort or flake8 on your files before they get committed.

To configure this, we already provide you with a .pre-commit-config.yaml file which will set this up for you. Simply run:

pip install -r requirements-dev.txt # install developer requirements

pre-commit install # install pre-commit cookes

Now, whenever you make some changes to your files, these hooks will automatically clean your code up for you or warn you when something looks out of place and allow you to adjust the files before pushing them upstream.

License

This project is licensed under your choice of either:

You may choose either license to govern your use of this software.

About

CLI for WSU campus info, and resource access.

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Contributors