sgt2ical

Attention:

This softare is free, but I ask something in return!!! To say it in spanish:
"Software Libre pero no gratuito" (which in English is the same term).
I'm not asking for any money but for your help. I need all the users to check
and update the profiles. If this is not done, more and more of the accuracy will
be lost. I get asked all the time when the financial calculation routines will be
published. And I will not release any new stuff, until somebody corrects the
data. So please, consider donating 15 minutes of your time, to check that all
profiles are correct. Thank you.

Description:

This program allows you to import your updated schedule from the SGT server directly into
your calendar on the Mac. It actually evolved from a quick'n'dirty hack to quickly import
my schedule. The code is still quite a mess, but I'm actually cleaning it up. Any contri-
butions are welcome. This is far from perfect though...I only update when I have a little
spare time.

Reporting Bugs

I kindly invite you to make use of the tracker on this site to report bugs. I really need
feedback to sort out all kinds of problems. Also feature requests are very welcome. You
know a trick about how to obtain certain data from sgt? Go ahead and tell me, I'll try to
incorporate it into the program.

Requirements:

• MacOSX Lion or later, but be aware I will only support Mavericks and later Versions
• A working iCloud or Google calendar to sync with mobile devices, a local calendar
  to view your calendar offline
• SVN command line client, this is mandatory now! Time has shown that there are too
  many problems arising with manual installation

Installation:

In first place you have to have a working installation of svn. Therefore you need to
install Apple's (free) developer tools. The easiest way for that is just typing svn in
a terminal, and you will be offered to install the dev-tools. For the rest of this tu-
torial I assume that you have svn installed!
Due to the vast amount of inquiries I have been receiving, I have decided to release an
INSTALL script. Please paste the following statement on the command line:
curl -f "https://sourceforge.net/p/sgt2ical/code/HEAD/tree/INSTALL?format=raw" | bash
and the install script will install the program for you.
Attention: When you execute the install script for the first time, the program will
require you to accept a server certificate. Choose 'P' for permanently and you will not
be asked again.
The GUI is able - by the way - to call this script as well, making it easy to run
the script with no need for console work.

Applescript:

You may want to install an Applescript to call this program, just if you are unfamiliar with
command line use.

Uninstall:

The install script is now able to remove the software from your system. It will remove
all symlinks and all directories that have been created during the installation. Please type:
bash ~/sgt2ical/INSTALL REMOVE
in the terminal window to run the removal script.

Usage:

sgt2ical [options]

-u --user
Username ( i.e. Número de Nómina ) *
-p --password
Password for SGT
-i --ini
Start date (format DD/MM/YYYY)
-e --end
End date (format DD/MM/YYYY) Remember: No error checking is done!

Troubleshooting:

Whenever a password is required on a console, there is no echo. In other words, you will not see what you are typing. Although it appears that the program doesn't react to your input, it is copying all characters. Just type your password blindly and hit enter.
Let me stress out onther big point where a lot of people have had trouble. If the installer asks for a password, it's the administrators password that has to be used to install the program, which most of the time is the same as the current user's password. This is not your SGT password!
If an error message "Unknown error. This is probably due to a misspelled parameter!" appears, it might be neccesary to check your parameters. For now ALL parameters are mandatory.

Misc Information:

This is an Emergeny Release!!!
Please read all the details in the Changelog.
Used libraries:
* PyICS and it's dependencies
* Beatifulsoup4 and it's dependencies

Changelog:

Please check out the changelog at https://sourceforge.net/p/sgt2ical/code/HEAD/tree/CHANGELOG

© 2013-2016 D.Sanchez