Editing Admin Scripts

[[Category:Administration]]
[[Category:Management]]

The administration scripts are a collection of tools deemed useful in the regular administration process of the department. These tools are primary written in Python.

While the latest tools and instructions can be found at the [https://github.com/UCT-EE-OCW/EE_Admin_Scripts EE Admin Script GitHub page], this wiki entry should provide enough of an overview to at least get acquainted with the tool-set.

Currently the tools are still in the development process and require a minor set of development knowledge in order to correctly use.

= Installation = 
The tools use Python for processing. This section will guide you through installation of the tools and its requirements.

<ol>
<li>Download and install Python
<ul>
<li>On Windows, you can head to [https://www.python.org/downloads/windows/ the Python website] to get the latest version of Python 3. Seselct "Latest Python 3 release". Scroll to the bottom of the page, and select "Windows x86-64 executable installer". <br> When installing, <b>ensure you select the "Add Python to environment variables" option</b></Li>
<li>If you're using any other operating system, just use the relevant package manager.</li>
</ul>
</li>

<li>Download and install Git</li>
<ul>
<li>On Windows, visit the [https://git-scm.com/download/win Git for Windows] download site. You can just run through the default installation options if you're not developing anything.</li>
<li>If you're using any other operating system, just use the relevant package manager.</li>
</ul>

<li>Download and install PDFTk (the free version)</li>
<ul>
<li>On Windows, visit the [https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/ PDFTk site]</li>
<li>On other operating system, just use the relevant package manager.</li>
</ul>

<li>Create a Folder where you'd like to keep the tools</li>
<ul>
<li>This could be something like "Admin Scripts" under "My Documents" or your home folder.
</ul>

<li>Fetch the latest code</li>
<ol>
<li>Enter into the folder you created</li>
<li>Open a terminal/PowerShell window</li>
<ul>
<li> On Windows, hold down shift and right click, then select "Open PowerShell window here".
</ul>
<li> Type <pre>git clone https://github.com/UCT-EE-OCW/EE_Admin_Scripts . --depth=1</pre> and press enter.</li>
</ol>

<li>Install the required Python packages</li>
<ol>
<li> Still within the terminal/PowerShell window, type the following:
<pre>pip install -r requirements.txt</pre>
</li>
</ol>

<li>Check to see if it is working</li>

</ol>

== Updating the scripts ==
Occasionally you may get notice that the scripts have updated, though the scripts as they are exist in workable form. The easiest way to do this is to visit [https://github.com/UCT-EE-OCW/EE_Admin_Scripts The GitHub Page] and look under the commits column for the latest commit (update).

In order to update the scripts, enter into the folder you created, open a new PowerShell window or terminal, and enter in <pre>git pull</pre>. You may also need to update packages, in which case running <pre>pip install -r requirements.txt</pre> will do this for you.