Metadata-Version: 2.1
Name: randomizer-package
Version: 0.6.0
Summary: A randomizer GUI application for generating random outputs.
Home-page: https://github.com/NBlancs/randomizer_nblancs
Author: Nblancs
Author-email: noeljhumel.blanco@1.ustp.edu.ph
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# Randomizer Application Documentation

## How to install and run the Randomizer Package
  #### 1. Go to [Randomizer Package Link](https://pypi.org/project/randomizer-package/0.4.0/#description)
  ***
  #### 2. Go to terminal and run this command.
    pip install randomizer-package==0.4.0
  ***
  #### 3. Check if the randomizer-package is in the pip list by using this command.
    pip list
  ***
  #### 4. If a warning shows up that looks like this
  ![warning](doc_imgs/warning_script.jpg)
  ***
  #### 4.1. Copy the directory showed in the warning and paste it into the PATH in the environment variables.
  ![environmental_variable](doc_imgs/environmental_variable.gif)
  ***
  #### 5. To run the package go to the terminal and run this command.
    run_randomizer

---

## UI Layout and Button Function Explanations
  #### Button Function Explanation
The **INPUT USER** field is designed for user input. 
***

When the **SHUFFLE BUTTON** is clicked, it will display a dropdown menu with several options. 

  * The Single Output option randomizes the order of the input. 

  * The Single Picker option picks one random output based on the input. 

  * The Multiple Output option displays multiple random outputs. 

  * The By Group Output option displays the output by groups, which the user will select according to the preferred number of outputs.
    
 ***
 **SETTING ICON**: Is for allowing duplicates in the
 variables or not
 ***
 
 **ENTER BUTTON**: will enter the variable inputted by
 the user and start the program
 
 ***
 **RESULT FIELD**: this is where the result will display
 ***
 
 **CLEAR BUTTON**: to clear the displayed output in the result
 field to be use again in the next task

  ***
  #### Main Frame
  ![default](doc_imgs/default.png)
  ***

  #### Single Output
  ![single_output](doc_imgs/single_output.png)
  ***

  #### Single Picker
  ![single_picker](doc_imgs/single_picker.png)
  ***

  #### Multiple Output
  ![single_picker](doc_imgs/multiple_output.png)
  ***

  #### Group Output - Groups Windows
  ![single_picker](doc_imgs/group_output_group_window.png)
  ***

  #### Group Output
  ![single_picker](doc_imgs/group_output.png)
  ***

  #### Settings Window
  ![single_picker](doc_imgs/settings.png)
  ***

  
