set to v.2.1.0a

.gitignore

@@ -1,4 +0,0 @@
-*.log
-*.conf
-*.db
-.vscode

README.md

@@ -0,0 +1,24 @@
+# Timetrack
+Simple time tracking
+
+## Requirements 
+- Python 3.9 or higher
+
+## Usage
+*as of v.2.1.0a*  
+Start the script and follow the menu.  
+Currently no further usability. 
+
+## Agenda
+- [ ] Reports
+    - [x] by day  
+    - [ ] by week  
+    - [ ] by month  
+    - [ ] by user  
+- [ ] Manual time entries
+- [ ] Break in time entries
+- [ ] User management
+- [ ] Categories
+- [ ] Clients
+- [ ] References
+- [ ] GUI

timeTrack.py

@@ -38,7 +38,6 @@ class TimeTrack:
         self.DBCON.close()
     
     ## Prepartation
-    #==============
     ### Check OS and clear screen
     def clear_screen(self):
         if os.name == 'posix':
@@ -262,7 +261,6 @@ class TimeTrack:
             return timedata
 
     ## user handling
-    #===============
     ### Creates a user who does not yet exist
     def create_user(self, USER=''):
         if USER == '':
@@ -338,7 +336,6 @@ class TimeTrack:
             self.USERNAME = data[0][1]
 
     ## Time handling
-    #===============
     ### Creates an active event if none exists for the user
     def save_event(self, TIME=datetime.datetime.now()):
         if not self.get_active_event(USERID=self.USERID):
@@ -389,7 +386,7 @@ class TimeTrack:
         else:
             logging.debug('Event was successfully deleted')
 
-    ### Checks for existing time entries and creates a new one if none is available.
+    # Checks for existing time entries and creates a new one if none is available.
     def time_start(self, AUTOFORWARD=True):
         self.clear_screen()
         starttime = datetime.datetime.now()
@@ -448,7 +445,7 @@ class TimeTrack:
                 print('Event von {} Uhr geladen'.format(data[1].strftime("%H:%M")))
                 self.time_stop()
 
-    ### Stops existing time entries
+    # Stops existing time entries
     def time_stop(self):
         data = self.get_active_event(USERID=self.USERID)
         logging.debug('Event stop progess is started')
@@ -507,7 +504,6 @@ class TimeTrack:
                     logging.info('Time entry was created successfully')
                 
                 self.delete_event(data[0])
-                self.clear_screen()
                 self.print_time_entry(STARTTIME=data[1], ENDTIME=endtime, ACTIVITY=action)
                 print('Zeiteintrag wurde gespeichert.')
                 userinput = 0
@@ -535,41 +531,30 @@ class TimeTrack:
                 logging.debug('Terminated by the user')
                 exit()
 
-    ## Interactive mode
+    def timedela_to_string(self, TIME):
-    #==================
+        s = TIME.seconds
-    ### Main menu of the interactive menu
+        hours, remainder = divmod(s, 3600)
-    def start_interactive_mode(self):
+        minutes, seconds = divmod(remainder, 60)
+        output = '{:02}:{:02}:{:02}'.format(int(hours), int(minutes), int(seconds))
+        return output
+  
+    # Shows a time entry
+    def print_time_entry(self, STARTTIME='', ENDTIME='', ACTIVITY=''):
         self.clear_screen()
-        printtext = [
+        s = (ENDTIME - STARTTIME).seconds
-            'Was willst du tun?',
+        hours, remainder = divmod(s, 3600)
-            '[1] Zeiterfassung starten',
+        minutes, seconds = divmod(remainder, 60)
-            '[2] heutiger Report',
-            '[3] Report für Tag x',
-            '[0] Programm verlassen'
-        ]
-        userinput = self.userchoise(printtext, 4)
         
-        if userinput == 1:
+        print(50*"-")
-            logging.debug('Start TimeTrack')
+        print('Start: {} Uhr'.format(STARTTIME.strftime('%H:%M')))
-            self.time_start()
+        print('Ende: {} Uhr'.format(ENDTIME.strftime('%H:%M')))
-        elif userinput == 2:
+        print('Dauer: {:02}:{:02}:{:02}'.format(int(hours), int(minutes), int(seconds)))
-            logging.info('Print todays report')
+        if not ACTIVITY == '':
-            self.report_by_day(DETAIL=True)
+            print('Aktivität:')
-            input()
+            print(ACTIVITY)
-            self.start_interactive_mode()
+        print(50*"-")
-        elif userinput == 3:
-            print('commig soon ...')
-            input()
-            self.start_interactive_mode()
-        elif userinput == 4:
-            print('commig soon ...')
-            input()
-            self.start_interactive_mode()
 
-    ## Reports
+    def report_by_day(self, DATE=datetime.date.today(), USER=''):
-    #=========
-    ### One day report, optionally with time entries
-    def report_by_day(self, DATE=datetime.date.today(), USER='', DETAIL=''):
         if not USER: 
             USER = self.USERID
         timedata = self.get_time_entry(DAY=DATE, USERID=USER)
@@ -599,61 +584,41 @@ class TimeTrack:
             print('{:40} {}'.format("Erfasste Zeit:", self.timedela_to_string(TRACKEDTIME)))
             print('{:40} {}'.format("Zeiteinträge:", ENTRIECOUNT))
 
-            printtext = [
+    def start_interactive_mode(self):
-                'Zeiteinträge anzeigen?',
+        self.clear_screen()
-                '[1] Ja',
+        userinput = 0
-                '[0] Nein'
+        while not 0 < int(userinput) < 4:
-            ]
+            print('Was willst du tun?')
-            userinput = self.userchoise(printtext)
+            print('[1] für Zeiterfassung starten')
-            if userinput == 1:
+            print('[2] für heutiger Report')
-                for entry in timedata:
+            print('[3] für Report für Tag x')
-                    self.print_time_entry(entry[1], entry[2], entry[4])
+            print('[9] für Programm verlassen')
-            else:
-                self.start_interactive_mode()
-
-    ## Outputs
-    #=========
-    ### Shows a time entry
-    def print_time_entry(self, STARTTIME='', ENDTIME='', ACTIVITY=''):
-        s = (ENDTIME - STARTTIME).seconds
-        hours, remainder = divmod(s, 3600)
-        minutes, seconds = divmod(remainder, 60)
-        
-        print(50*"-")
-        print('Start: {} Uhr'.format(STARTTIME.strftime('%H:%M')))
-        print('Ende: {} Uhr'.format(ENDTIME.strftime('%H:%M')))
-        print('Dauer: {:02}:{:02}:{:02}'.format(int(hours), int(minutes), int(seconds)))
-        if not ACTIVITY == '':
-            print('Aktivität:')
-            print(ACTIVITY)
-        print(50*"-")
-
-    ## Miscellaneous
-    #===============
-    ### User selection
-    def userchoise(self, TEXT='', MAX=2):
-        userinput = -1
-        while not -1 < int(userinput) < MAX:
-            for text in TEXT:
-                print(text)
             userinput = input('Aktion: ')
             logging.debug('User input: {}'.format(userinput))
             try:
                 int(userinput)
             except ValueError:
-                userinput = -1
+                userinput = 0
             else:
-                self.clear_screen()
+                if int(userinput) == 9:
-        return int(userinput)
+                    logging.debug('Terminated by the user')
+                    exit()
+            self.clear_screen()
 
-    ### Conversion to string of Timedelta typ
+        if userinput == "1":
-    def timedela_to_string(self, TIME):
+            logging.debug('Start TimeTrack')
-        s = TIME.seconds
+            self.time_start()
-        hours, remainder = divmod(s, 3600)
+        elif userinput == "2":
-        minutes, seconds = divmod(remainder, 60)
+            logging.info('Print todays report')
-        output = '{:02}:{:02}:{:02}'.format(int(hours), int(minutes), int(seconds))
+            self.report_by_day()
-        return output
+            input()
+            self.start_interactive_mode()
+        elif userinput == "3":
+            print('commig soon ...')
+            input()
+            self.start_interactive_mode()
 
+        print(userinput)
 
 if __name__ == "__main__":
     test = TimeTrack()

timeTrack.sh

@@ -1,540 +0,0 @@
-#!/bin/bash
-#==========
-#
-# timeTrack.sh
-# by 4nima
-# v.1.5.0
-# 
-#==========
-# Einfaches Erfassen von Zeiten mit einer SQLDB (SQLite, kein Server) 
-#==========
-
-
-# Variablen Definieren
-#=====================
-# Pfad zur Datenbank (Vollständiger Pfad benutzen!) 
-DBDIR="/root/time/work/.timeTrack.db"
-DB="timeTrack"
-
-## Verfügbare Kategorien (0 = Default) 
-### ACHTUNG: in der DB werden die IDs gespeichert, verändern der Rheinfolge verfälscht Reports
-# Alternativ neben Kategorien noch Tags oder Projekte anbieten
-declare -a categories
-categories[0]="Junk"
-categories+=("Kunden")
-categories+=("Internes")
-categories+=("Meetings")
-categories+=("Schulung")
-categories+=("Pause")
-categories+=("Sonstiges")
-categories+=("Privates")
-
-# Funktionen
-#===========
-## DB
-### Erstellt eine Datenbank Datei
-function createDB {
-  sqlite3 $DBDIR "
-    CREATE TABLE IF NOT EXISTS $DB (
-      id INTEGER PRIMARY KEY,
-      date INTEGER,
-      day INTEGER,
-      kw INTEGER,
-      task TEXT,
-      category INTEGER,
-      worktime INTEGER
-    );
-  "
-}
-
-### Fügt einen Task in die DB ein
-function insertTask {
-  sqlite3 $DBDIR "
-    INSERT INTO $DB (
-      date,
-      day,
-      kw,
-      task,
-      category,
-      worktime
-    ) VALUES (
-      '$(date +%s)',
-      '$(date +%u)',
-      '$(date +%V)',
-      '$1',
-      '$2',
-      '$3'
-    );
-  "
-}
-
-### Eintrag aus der Datenbank löschen
-function eraseTask {
-  echo "<================================================>"
-  sqlite3 $DBDIR "
-    DELETE
-    FROM $DB
-    WHERE id = $DBID
-  "
-  echo "Task wurde gelöscht"
-  echo "<================================================>"
-}
-
-### Suche
-#### Anhand der ID
-function searchById {
-  echo "<================================================>"
-  sqlite3 $DBDIR -column -header "
-    SELECT *
-    FROM $DB
-    WHERE id = $DBID
-  "
-  echo "<================================================>"
-}
-
-#### Anhand eines Strings (in Tasks)
-function searchByString {
-  echo "<================================================>"
-  sqlite3 $DBDIR -column -header "
-    SELECT *
-    FROM $DB
-    WHERE task LIKE '%$SEARCH%' 
-  "
-  echo "<================================================>"
-}
-
-### Updates
-#### Datum
-function updateDate {
-  echo "<================================================>"
-  sqlite3 $DBDIR "
-    UPDATE $DB
-    SET date = '$UPDATEVALUE'
-    WHERE id = $DBID
-  "
-  echo "Datum geupdatet"
-  echo "<================================================>"
-}
-
-function updateTask {
-  echo "<================================================>"
-  sqlite3 $DBDIR "
-    UPDATE $DB
-    SET task = '$UPDATEVALUE'
-    WHERE id = $DBID
-  "
-  echo "Task geupdatet"
-  echo "<================================================>"
-}
-
-function updateCategory {
-  echo "<================================================>"
-  sqlite3 $DBDIR "
-    UPDATE $DB
-    SET category = '$UPDATEVALUE'
-    WHERE id = $DBID
-  "
-  echo "Kategorie geupdatet"
-  echo "<================================================>"
-}
-
-function updateWorktime {
-  echo "<================================================>"
-  sqlite3 $DBDIR "
-    UPDATE $DB
-    SET worktime = '$UPDATEVALUE'
-    WHERE id = $DBID
-  "
-  echo " Arbeitszeit geupdatet"
-  echo "<================================================>"
-}
-
-### Reports
-#### Auslesen aller Heutigen Tasks
-function dailyReport {
-  echo "<================================================>"
-  day=$(convertDay $(date +%u))
-  echo "Daly Report vom $day - KW $(date +%V)"
-  sqlite3 $DBDIR -column -header "
-    SELECT
-      count(id) AS 'Tasks',
-      time(sum(worktime), 'unixepoch') AS 'Arbeitszeit'
-    FROM $DB 
-    WHERE kw = '$(date +%V)'
-    AND day = '$(date +%u)' 
-  "
-  echo 
-}
-
-function weeklyReport {
-  echo "<================================================>"
-  echo "Weekly Report vom KW $(date +%V)"
-  sqlite3 $DBDIR -column -header "
-    SELECT 
-      count(id) AS 'Tasks',
-      time(sum(worktime), 'unixepoch') AS 'Arbeitszeit'
-    FROM $DB 
-    WHERE kw = '$(date +%V)'
-  "
-  echo
-}
-
-function dailyCategoryReport {
-  day=$(convertDay $(date +%u))
-  for i in ${!categories[@]}; do
-    echo "<================================================>"
-    echo "Report für Kategorie: ${categories[i]}"
-    echo "Für $day in KW: $(date +%V)"
-    sqlite3 $DBDIR -column -header "
-      SELECT  
-        count(id) AS 'Tasks',
-        time(sum(worktime), 'unixepoch') AS 'Arbeitszeit'
-      FROM $DB 
-      WHERE kw = '$(date +%V)'
-      AND day = '$(date +%u)'
-      AND category = '$i'
-    "
-    echo
-  done
-}
-
-function weeklyCategoryReport {
-  week=$(convertDay $(date +%u))
-  for i in ${!categories[@]}; do
-    echo "<================================================>"
-    echo "Report für Kategorie: ${categories[i]}"
-    echo "In KW: $(date +%V)"
-    sqlite3 $DBDIR -column -header "
-      SELECT  
-        count(id) AS 'Tasks',
-        time(sum(worktime), 'unixepoch') AS 'Arbeitszeit'
-      FROM $DB 
-      WHERE kw = '$(date +%V)'
-      AND category = '$i'
-    "
-    echo
-  done
-}
-
-## Abläufe
-### Prüft ob SQLite3 installiert ist und erstellt eine Datenbank wenn nicht schon vorhanden
-function checkRequirements {
-  dpkg -l sqlite3
-  if [ $? -ne 0 ]; then
-    echo "Bitte sqlite3 installieren!"
-    exit
-  fi
-  
-  if [ ! -d $DIR ];then
-    mkdir -r $DIR
-  fi
-  createDB
-}  
- 
-### Start des Trackings und Tätigkeits Abfrage
-function startTracking {
-  starttime=$(date +%s)
-  echo "<================================================>"
-  echo "Time Tracking gestartet um: $(date +%H:%M)"
-  IFS= read -a doingwords -p "Tätigkeit? `echo $'\n> '`" 
-  doing=${doingwords[0]}
-}
-
-### Beendet das Tacking und Kategorie Abfrage
-function endTracking {
-  for i in ${!categories[@]}; do
-    echo "$i. ${categories[i]}"
-  done
-  IFS= read -p "Kategorie? `echo $'\n> '`" category
-  endtime=$(date +%s)
-  worktime=$(($endtime - $starttime))
-}
-
-### Erstellt eine Zusammenfassung zu dem eben Bearbeiteten Task
-#### Verbesserung: Möglichkeit auch Tasks aus der DB erneut auszugeben
-function printTask {
-  echo "<================================================>"
-  echo "Time Tracking beendet um $(date +%H:%M) - $outputtime"
-  echo "<================================================>"
-  echo "Du hast $outputtime in ${categories[$category]} investiert"
-  echo "<================================================>"
-  echo "Task: $doing"
-  echo "<================================================>"
-}
-
-### Aufruf bei -D(atenbank)
-function showDB {
-  sqlite3 $DBDIR -column -header  "SELECT * from $DB"
-}
-
-### Aufruf bei -c(onfig) [/path/to/config.file]
-function config {
-  if [ -f $OPTARG ];then 
-    config=$OPTARG
-    echo $config
-    # Datei einlesen; Prüfung was angepasst wurde (DB / DB file / Kategorien); validieren; weiter oder exit.
-  else 
-    echo "Dieses Konfigfile existiert nicht"
-    exit
-  fi
-}
-
-### Aufruf bei -e(rase) [DB ID]
-function erase {
-  if [[ $OPTARG =~ ^[0-9]+$ ]]; then
-    DBID=$OPTARG
-    searchById
-    IFS= read -p "Diesen Eintrag löschen?(y/n) `echo $'\n> '`" DELIT
-    if [ $DELIT == "Y" ] || [ $DELIT == "y" ]; then
-      eraseTask
-    fi
-  else
-    echo "Gib die ID des zu löschenden Tasks ein"
-    echo "Mit '-s' kannst du eine Suche starten"
-    exit
-  fi
-}
-
-### Aufruf bei -h(elp)
-function printHelp {
-  echo '
-    Benutzung: ./timeTrack.sh [option [argument]]
-
-    Ohne Option wird das Skript für eine Zeitmessung ausgeführt und dann beendet. 
-
-    Optionen: 
-      -D              # Listet die Tabelle der Datenbank auf
-      -c [arg]        # Konfigurationsdatei
-      -e [DB ID]      # Eintrag aus Tabelle löschen (Siehe -s)
-      -h              # Zeigt diese Hilfe
-      -H [option]     # Zeigt Detail Hilfe zu der Option
-      -i              # Startet eine Aufgaben speicherung mit eigenen Zeiteingaben
-      -l              # Startet das Skript im Loop (abbrechen mit Strg + C)
-      -r [type]       # Zeigt Reports für [day / week / month / category / ...]
-      -s [string]     # Sucht in der Datenbank nach [string] (nur im Aufgaben Feld)
-      -u [DB ID]      # Update für bereits vorhandene Einträge in der Datenbank (Siehe -s)
-  '
-}
-
-### Aufrug bei -H(elp) [option]
-function helpTo {
-  case $1 in
-    c)
-      echo '
-        Benutzung: ./timeTrack.sh -c /path/to/my.conf
-
-        Mit der Option -c kann ein eine Konigurationsdatei angegeben werden. 
-        In der Konfigurationsdatei können individuelle Parameter übergeben werden: 
-          Pfad zur Datenbankdatei:
-            DBDIR="/path/to/file.db"      # Vollständigen Pfad angeben
-
-          In der Datenbankdatei die Tabelle festlegen: 
-            DB="myTable"                  # Keine Sonder- oder Leerzeichen 
-        
-          Eigene Kategorien: 
-            categories[0]="Default")      # Standard Kategorie
-            categories+=("newCategory")   # Hinzufügen einer Kategorie (wiederholbar)
-      '
-      ;;
-    *)
-      exit
-      ;;
-  esac
-}      
-
-### Aufruf bei -i(nsert)
-function insert {
-  IFS= read -p "Tätigkeit? `echo $'\n> '`" TASK
-  IFS= read -p "Dauer? `echo $'\n> '`" WORKTIME 
-  IFS= read -p "Endzeit? `echo $'\n> '`" ENDDATE
-  IFS= read -p "Kategorie? `echo $'\n> '`" CATEGORY
-}
-
-### Aufruf bei -r(eport) [Ansicht...]
-function report {
-  REPORT=$OPTARG
-  clear
-  case $REPORT in
-    day|daily)
-      dailyReport
-      dailyCategoryReport
-      ;;
-    week|weekly)
-      weeklyReport
-      weeklyCategoryReport
-      ;;
-    *)
-      dailyReport
-      ;;
-  esac
-}
-
-### Standard Aufruf
-function default {
-  checkRequirements
-  clear
-  startTracking
-  endTracking
-  calcWorktime $worktime
-  insertTask "$doing" "$category" "$worktime"
-  clear
-  printTask
-}
-
-### Aufruf bei -s(earch) [Suchstring]
-function search {
-  # Optionen ob damit was gemacht werden soll (Update / Löschen)
-  SEARCH=$OPTARG
-  searchByString 
-}
-
-### Aufruf bei -u(pdate) [DB ID]
-function update {
-  # Prüfung ob angaben stimmen, weitere eingaben ändern
-  DBID=$OPTARG
-  searchById
-  echo "
-    1. Datum
-    2. Task
-    3. Kategorie
-    4. Arbeitszeit
-  "
-  IFS= read -p "Was soll geupdatet werden? `echo $'\n> '`" UPDATETYPE
-  IFS= read -p "Was soll eingetragen werden? `echo $'\n> '`" UPDATEVALUE
-  case $UPDATETYPE in
-    1|Datum)
-      updateDate
-      ;;
-    2|Task)
-      updateTask
-      ;;
-    3|Kategorie)
-      updateCategory
-      ;;
-    4|Arbeitszeit)
-      updateWorktime
-      ;;
-    *)
-      echo "Falsche angabe"
-      exit
-      ;;
-    esac
-}
-
-## Umwandlung / Umrechnung
-### Rechnet die Sekunden in Stunden und Minuten um
-function calcWorktime {
-  if [ $1 -ge 3600 ]; then
-    hworktime=$((worktime / 3600))
-    mworktime=$(((worktime % 3600) / 60))
-    gmworktime=$((worktime / 60))
-    outputtime="$gmworktime min ($hworktime:$mworktime H)"
-  else 
-    gmworktime=$((worktime / 60))
-    outputtime="$gmworktime min"
-  fi
-}
-
-function convertDay {
-  case $1 in
-    1)
-      echo "Montag"
-      ;;
-    2)
-      echo "Dienstag"
-      ;;
-    3)
-      echo "Mittwoch"
-      ;;
-    4)
-      echo "Donnerstag"
-      ;;
-    5)
-      echo "Freitag"
-      ;;
-    6)
-      echo "Samstag"
-      ;;
-    7)
-      echo "Sonntag"
-      ;;
-  esac
-}
-
-# Argumente auslesen
-#===============================
-while getopts "Dc:e:hH:ilr:s:Tu:" opt; do
-  case $opt in
-    D)
-      showDB
-      exit
-      ;;
-    c)
-      config
-      exit
-      ;;
-    e)
-      erase
-      exit
-      ;;
-    h)
-      printHelp
-      exit
-      ;;
-    H)
-      helpTo $OPTARG
-      exit
-      ;;
-    i)
-      insert
-      exit
-      ;;
-    l)
-      while true; do
-        default
-      done
-      ;;
-    r)
-      report
-      exit
-      ;;
-    s)
-      search
-      exit
-      ;;
-    T)
-      # Testing
-      results=($(sqlite3 $DBDIR "
-        SELECT *
-        FROM $DB
-      "))
-      
-      #for i in ${!results[@]}; do
-      for i in "${!results[@]}"; do
-        echo "<================================================>"
-        echo "Test für: ${results[i]}"
-
-        echo "Record No. $i: ${results[$i]}"
-
-
-        fieldA=${results[0]};
-        fieldB=${results[1]};
-        fieldC=${results[2]};
-        fieldD=${results[3]};
-
-      done
-
-      echo $fieldA $fieldB $fieldC $fieldD
-      exit
-      ;;
-    u)
-      update  
-      exit
-      ;;
-    *)
-      exit
-      ;;
-  esac
-done
-
-default