You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Modified script to output to HTML files rather than to the screen or to .txt files.
- Eliminated parameter to define output file. This is no longer needed. An output folder is now created, and an HTML file is created for every scout.
- Eliminated parameter to allow progress report for individual scouts. This is no longer needed since individual HTML files are created for each scout.
- Added parameter to define CSS file. The script uses a default style by default but users can define their own CSS file to override this style.
- Minor bug fixes.
This repository constains a tool for for generating Scouts BSA progress reports
2
+
This repository constains a tool for for generating Scouts BSA progress reports.
3
3
4
4
The tool comes in the form of a windows executable or a python script. While I encourage all users to run the python version of the script so they can see what it is doing, I also realize many people may not have even heard of python. As a result, I have also generated a windows executable for those users.
5
5
@@ -15,34 +15,32 @@ Before running the script for the first time, ensure python 3.11 or later is ins
15
15
16
16
`pip install pandas`
17
17
`pip install psutil`
18
+
`pip install dominate`
18
19
19
20
# Usage
20
21
## Windows Executable
21
-
Drag the desired CSV file and drop it onto the progress.py icon. When the script executes, it will prompt the user for all optional arguments. See the definition of all arguements in the "Python Script" section below.
22
+
Drag the desired CSV file and drop it onto the progress.py icon. When the script executes, it will prompt the user for all optional arguments. See the definition of all arguements in the "Python Script" section below. The script will generate HTML files in an "output" folder where the .exe file is located.
22
23
23
24
## Python Script
24
-
The script can be launched from the command line or from Windows.
25
+
The script can be launched from the command line or from Windows. The script will generate HTML files in an "output" folder where the script file is located.
25
26
26
27
To lanuch from windows drag the desired CSV file and drop it onto the progress.py icon. When the script executes, it will prompt the user for all optional arguments.
27
28
28
29
To launch from the command line type the following, where {} denotes optional portions and [] denotes portions to be specified by the user.
This outlines the path to the CSV file exported from Scoutbook.
35
36
36
37
### Optional Arguments
37
-
#### {--out=[outfile.txt]}
38
-
Specifies the file name where all output will be written.
39
-
If omitted, output will be displayed to the screen.
40
38
#### --date=[MM/DD/YYYY]
41
39
Defines the date of of the last progress report. All progress made since this date will be considered new.
42
40
If omitted, a default date of 1/1/1980 wil be used.
43
-
### --id=[scoutid]
44
-
Tells the script to only generate a progress report for a specific scout.
45
-
If omitted, a progress report will be generated for all scouts listed in the CSV file.
41
+
####--css=[style.css]
42
+
Defines the CSS style sheet to customize the look of the progress reports.
43
+
If omitted, a default style will be applied.
46
44
#### --cubs
47
45
Indicates that the progress report is generated for Cub Scouts. When this flag is set, the script will not display progress towards eagle, and will indicate Cub Scout and Webelos specific advancement and awards.
48
46
If omitted, only Scouts BSA advancement and awards will be displayed.
0 commit comments