Metadata-Version: 2.1
Name: eatlocal
Version: 0.7.1
Summary: eatlocal helps the user solve PyBite code challenges on their local machine
Home-page: https://github.com/rhelmstedter/eatlocal
License: LICENSE
Keywords: cli,pybites
Author: Russell Helmstedter
Author-email: rhelmstedter@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: beautifulsoup4 (>=4.10.0,<5.0.0)
Requires-Dist: python-dotenv (>=0.19.2,<0.20.0)
Requires-Dist: rich (>=11.1.0,<12.0.0)
Requires-Dist: selenium (>=4.1.0,<5.0.0)
Requires-Dist: typer (>=0.4.0,<0.5.0)
Description-Content-Type: text/markdown

# eatlocal

Eatlocal helps the user solve [PyBites](https://codechallang.es) code challenges locally. This cli tool allows you to download, unzip, and organize bites according to the expected structure from the directions on the PyBites website. Once you have solved the bite you can use eatlocal to submit and it will open a bowser tab at the correct location.

## Table of Contents

+ [Usage](#Usage)
+ [Installation](#Installation)
	+ [macOS/Linux](#macoslinux)
	+ [Windows](#Windows)
+ [Setup](#Setup)
	+ [Install Chrome and Chromedriver](#Install-Chrome-and-Chromedriver)
		+ [macOS](#macOS)
		+ [Linux](#Linux)
		+ [Windows](#Windows-1)
	+ [PyBites Credentials](#PyBites-Credentials)
		+ [macOS/Linux](#macoslinux-1)
		+ [Windows](#Windows-2)


## Usage

Navigate to your local PyBites repo.

Download and extract bites:
```bash
eatlocal download <bite number>
```

Display bites in the terminal:
```bash
eatlocal display <bite number>
```

Submit bites:
```bash
eatlocal submit <bite number>
```

## Installation

### macOS/Linux

```bash
pip3 install eatlocal
```
### Windows

```bash
pip install eatlocal
```

## Setup

1. Go through the directions on the PyBites website to connect your GitHub account to your PyBites account.
2. Make sure you have Chrome and chromedriver installed and on `$PATH`.
3. Setup your PyBites login credentials as environment variables. If you signed up for PyBites by authenticating through GitHub or Google, you may need to set a password manually in order to use eatlocal.

### Install Chrome and Chromedriver

#### macOS

One option is to use homebrew [homebrew](https://brew.sh/). 

Install chrome:

```bash
brew install --cask google-chrome
```

Install chromedriver:

```bash
brew install chromedriver
```

Before you run chromedriver for the first time, you must explicitly give permission since the developer has not been verified. Running the following command in the terminal removes the warning put in place by Apple:

```bash
xattr -d com.apple.quarantine $(which chromedriver)
```

Homebrew automatically puts chromedriver on `$PATH` for you. And since homebrew handles both chrome and chromedriver installations for me, I can run `brew update && brew upgrade` to help ensure I have the same version number for both chrome and chromedriver. If you do not go the homebrew route, you must manually ensure that your version of chrome matches the version of chromedriver.


#### Linux

Unfortunately, I did not find some fancy package manager for Linux, but I was able to install chrome and chromedriver manually for Linux Mint.

Navigate to the download page for [google chrome](https://www.google.com/chrome/) and download the appropriate version for your system. Then, open up a terminal and navigate to where you downloaded the file. For me it was `~/Downloads`. I ran the following commands to install and check which version I have.

```bash
cd ~/Downloads
sudo dpkg -i google-chrome-stable_current_amd64.deb
google-chrome --version
```

Next, navigate to the [chromedriver download page](https://chromedriver.chromium.org/downloads) and choose the version that matches the output from `google-chrome --version`. Download that file that matches your system. Head back to your terminal.

1. Ensure that you have unzip installed:

```bash
sudo apt install unzip
```

2. Unzip the chromedriver file. For me it was located in the downloads folder: 

```bash
unzip ~/Downloads/chromedriver_linux64.zip -d ~/Downloads
```

3. Make it executable and move to `/usr/local/share`:

```bash
chmod +x ~/Downloads/chromedriver
sudo mv -f ~/Downloads/chromedriver /usr/local/share/chromedriver
```

4. Create symlinks:

```bash
sudo ln -s /usr/local/share/chromedriver /usr/local/bin/chromedriver
```
5. Confirm you have access:

```bash
which chromedriver
```

#### Windows

If working in windows powershell you can use [chocolately](https://chocolatey.org/) to install chromedriver.

I've found that in order to install packages I have to use an elevated administrative shell, with `choco install chromedriver`.

I attempted to use `eatlocal` from [WSL2](https://docs.microsoft.com/en-us/windows/wsl/about) but there seems to be an issue with `google-chrome` itself. I could not get it to work.

### PyBites Credentials

You must have your PyBites username and password stored in the environment variables `PYBITES_USERNAME` and `PYBITES_PASSWORD` respectively.

#### macOS/Linux

There are two methods to handle this in.

**Virtual Environment Method**

A note of warning: If you use this method make sure that your virtual environment is not being pushed to GitHub. If you accidentally push your virtual environment—clearly that has never happened to me—then you have exposed your password and should change it immediately.

1. Create a virtual environment for your PyBites repo:

```bash
python3 -m venv .venv
```

2. Add the line `.venv` to your `.gitignore` file.

```bash
echo ".venv" >> .gitignore
```

3. With the environment deactivated, use your favorite text editor (I use nvim, btw) to open the activate file, e.g., `nvim .venv/bin/activate` and add the following lines:

```bash
export PYBITES_USERNAME=<username>
export PYBITES_PASSWORD=<password>
```

4. Activate the environment `source .venv/bin/activate`.

**Shell RC Method**

If you are not using a virtual environment, you can add the variables directly to your shell config. 

1. I use zsh, so I would use my favorite text editor `nvim ~/.zshrc` and set the variables by adding the same two lines as above:

```bash
export PYBITES_USERNAME=<username>
export PYBITES_PASSWORD=<password>
```

2. Either exit your terminal completely and reopen, or source your config file with `source ~/.zshrc`.

#### Windows

I don't know of a way to do this other than graphically (Booo!). If you like pictures follow this [tutorial](https://windowsloop.com/add-environment-variable-in-windows-10).

1. Open the Start menu by pressing the “Windows Key”.
2. Type “Environment variables” and click on the “Edit the system environment variables” result.
3. Click on the "Advanced" tab.
4. Click "Environment Variables".
5. Under "User variables" click "New".
6. In the "Variable name" field enter: PYBITES_USERNAME
7. In the "Variable value" field enter: <username>
8. Repeat steps 5-7 for the password variable.
9. Click "Ok"
10. Click "Apply"
11. Restart your computer.

