11 Commits

Author SHA1 Message Date
f0f3b410b2 release version 2.2.0a 2021-06-29 05:47:15 +02:00
35ee16479a set to v.2.1.0a 2021-06-08 00:53:28 +02:00
3da9195697 release version 2.1.0 2021-06-08 00:38:26 +02:00
e4d533b249 fix formatting 2021-06-04 21:19:33 +02:00
b774ec6e1e add readme.md 2021-06-04 21:15:47 +02:00
fc3f350e96 Aplha Release from Python TimeTrack 2021-06-04 11:28:22 +02:00
4801df4b5f cleanup master branch 2021-06-04 09:48:18 +02:00
21ce7ab426 cleanup master branch 2021-06-04 09:46:19 +02:00
33c99066a1 delete dev junk 2021-06-04 09:35:02 +02:00
3c6c4f731c add TimeTrack v1.5.1 (bash) to git 2021-06-04 09:23:51 +02:00
4a5aa37174 cleanup git repo 2021-06-04 09:18:28 +02:00
7 changed files with 138 additions and 577 deletions

4
.gitignore vendored
View File

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

Binary file not shown.

Binary file not shown.

Binary file not shown.

25
README.md Normal file
View File

@@ -0,0 +1,25 @@
# Timetrack
Simple time tracking
## Requirements
- Python 3.7 or higher
## Usage
*as of v.2.1.0a*
Start the script and follow the menu.
Currently no further usability.
## Agenda
- [ ] [Reports](https://git.4nima.net/anima/timetrack/issues/13)
- [x] by day
- [ ] by week
- [ ] by month
- [ ] by user
- [ ] [Manual time entries](https://git.4nima.net/anima/timetrack/issues/6)
- [ ] [Break in time entries](https://git.4nima.net/anima/timetrack/issues/5)
- [ ] [Short side tasks](https://git.4nima.net/anima/timetrack/issues/12)
- [x] User management
- [ ] [Categories](https://git.4nima.net/anima/timetrack/issues/7)
- [ ] [Clients](https://git.4nima.net/anima/timetrack/issues/8)
- [ ] [References](https://git.4nima.net/anima/timetrack/issues/9)
- [ ] [GUI](https://git.4nima.net/anima/timetrack/issues/10)

View File

@@ -3,7 +3,7 @@
#
# timeTrack.py
# by 4nima
# v.2.1.2
# v.2.2.0a
#
#########################
# simple time tracking with database
@@ -23,29 +23,32 @@ class TimeTrack:
self.USERID = 0
self.USERNAME = ''
self.OLDEVENT = 2
self.CLIENTS = False
self.CATEGORIES = False
self.REFERENCES = False
self.LOGFILE = 'timetrack.log'
self.DBCON = sqlite3.connect(self.DATABASE, detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES)
logging.basicConfig(
filename=self.LOGFILE,
level=logging.DEBUG,
format='%(asctime)s - %(process)d-%(levelname)s: %(message)s',
datefmt='%Y-%m-%d %H:%M:%S'
)
if os.name == 'posix':
logging.debug('Unix/Linux system detected')
self.LINUX = True
else:
logging.debug('Winwos System detected')
self.db_setup()
self.load_config()
def __del__(self):
self.DBCON.close()
## Prepartation
#==============
### Check OS and clear screen
def clear_screen(self):
if os.name == 'posix':
logging.debug('Unix/Linux system detected')
if self.LINUX:
_ = os.system('clear')
else:
logging.debug('Winwos System detected')
_ = os.system('cls')
### Loads or creates a config file
@@ -61,17 +64,23 @@ class TimeTrack:
quit()
else:
logging.info('Config file was loaded successfully')
self.USERID = data['user']
self.OLDEVENT = data['oldevent']
logging.debug('UserID {} was used'.format(data['user']))
self.USERID = data['userid']
self.OLDEVENT = data['oldevent']
self.CLIENTS = data['clients']
self.CATEGORIES = data['categories']
self.REFERENCES = data['references']
logging.debug('UserID {} was used'.format(data['userid']))
self.set_user()
else:
logging.warning('Config file not found')
config = {
'default' : 'interactive',
'user' : 1,
'oldevent' : 2
'userid' : 1,
'oldevent' : 2,
'clients' : False,
'categories' : False,
'references' : False
}
with open(self.CONFIG, "w") as outfile:
json.dump(config, outfile, indent=4, sort_keys=True)
@@ -137,7 +146,7 @@ class TimeTrack:
logging.debug('Create initial database tables')
try:
with self.DBCON as con:
with sqlite3.connect(self.DATABASE, detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES) as con:
for SQL in sql:
con.execute(SQL)
except sqlite3.Error as err:
@@ -281,8 +290,9 @@ class TimeTrack:
logging.debug('Accepted username: {}'.format(username))
sql = "INSERT INTO users ( name ) values ( ? )"
try:
with self.DBCON as con:
with sqlite3.connect(self.DATABASE, detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES) as con:
con.execute(sql, [username])
except sqlite3.Error as err:
logging.error('User could not be saved in database')
@@ -307,7 +317,7 @@ class TimeTrack:
sql = "SELECT * FROM users"
try:
with self.DBCON as con:
with sqlite3.connect(self.DATABASE, detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES) as con:
cur = con.cursor()
if data:
cur.execute(sql, [data])
@@ -339,6 +349,23 @@ class TimeTrack:
else:
self.USERNAME = data[0][1]
def delete_user(self, UID=False):
if not UID:
logging.error('no userid passed for deletion')
else:
logging.debug('Userid {} will be delete'.format(UID))
sql = "DELETE FROM users WHERE id = ?"
try:
with sqlite3.connect(self.DATABASE, detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES) as con:
con.execute(sql, [UID])
except sqlite3.Error as err:
logging.error('User could not be delete from database')
logging.debug(sql)
logging.error('SQLError: {}'.format(err))
else:
logging.info('User was delete successfully')
## Time handling
#===============
### Creates an active event if none exists for the user
@@ -348,7 +375,7 @@ class TimeTrack:
sql = "INSERT INTO active_events ( starttime, user_id ) VALUES ( ?, ? )"
try:
with self.DBCON as con:
with sqlite3.connect(self.DATABASE, detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES) as con:
con.execute(sql, [TIME, self.USERID])
except sqlite3.Error as err:
logging.error('Event could not be created')
@@ -381,7 +408,7 @@ class TimeTrack:
return 0
try:
with self.DBCON as con:
with sqlite3.connect(self.DATABASE, detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES) as con:
con.execute(sql, [data])
except sqlite3.Error as err:
logging.error('Event could not be deleted')
@@ -484,7 +511,7 @@ class TimeTrack:
sql = "INSERT INTO time_entries ( starttime, endtime, user_id, activity ) VALUES ( ?, ?, ?, ? )"
try:
with self.DBCON as con:
with sqlite3.connect(self.DATABASE, detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES) as con:
con.execute(sql, [data[1], endtime, self.USERID, action])
except sqlite3.Error as err:
logging.error('Time entry could not be created')
@@ -524,7 +551,8 @@ class TimeTrack:
'Was willst du tun?',
'[1] Zeiterfassung starten',
'[2] heutiger Report',
'[3] Benutzerverwaltung',
'[3] Reports',
'[4] Benutzerverwaltung',
'[0] Programm verlassen'
]
userinput = self.userchoise(printtext, 4)
@@ -537,14 +565,42 @@ class TimeTrack:
self.report_by_day(DETAIL=True)
input()
elif userinput == 3:
self.interactive_usermanagment()
self.interactive_reports()
elif userinput == 4:
print('commig soon ...')
input()
self.interactive_usermanagment()
else:
exit()
self.start_interactive_mode()
### Reports menu
def interactive_reports(self):
self.clear_screen()
printtext = [
'==> Reports für {}'.format(self.USERNAME),
'Welcher Report soll angezeigt werden?',
'[1] Tages Report von [Datum]',
'[0] abbrechen'
]
userinput = self.userchoise(printtext, 2)
if userinput == 1:
valid = False
while not valid:
self.clear_screen()
print('Report für welches Datum soll angezeigt werden?')
print('[0] für abbruch')
userdate = input("Datum: [yyyy-mm-dd]:")
if userdate == 0:
break
else:
try:
date = datetime.datetime.strptime(userdate, "%Y-%m-%d")
valid = True
except:
pass
self.report_by_day(date.date())
### Usermanagment menu
def interactive_usermanagment(self):
self.clear_screen()
printtext = [
@@ -560,9 +616,28 @@ class TimeTrack:
if userinput == 1:
self.create_user()
elif userinput == 2:
pass
users = self.get_users()
printtext = ['Wähle deinen User:']
count = 1
for user in users:
printtext.append('[{}] {}'.format(count, user[1]))
count += 1
printtext.append('[0] abbrechen')
userid = self.userchoise(printtext, count)
self.USERID = users[userid - 1][0]
self.set_user()
elif userinput == 3:
pass
users = self.get_users()
printtext = ['Welcher User soll gelöscht werden?:']
count = 1
for user in users:
printtext.append('[{}] {}'.format(count, user[1]))
count += 1
printtext.append('[0] abbrechen')
userid = self.userchoise(printtext, count)
self.delete_user(users[userid - 1][0])
## Reports
#=========
@@ -571,6 +646,11 @@ class TimeTrack:
if not USER:
USER = self.USERID
timedata = self.get_time_entry(DAY=DATE, USERID=USER)
if timedata == 0:
print("Es wurden keine Zeiteinträge für den angegeben Tag gefunden")
logging.debug('No time entries for date: '.format(DATE))
input()
return 1
STARTTIMES = []
ENDTIMES = []
@@ -590,12 +670,13 @@ class TimeTrack:
ENTRIECOUNT = len(timedata)
self.clear_screen()
print('{:40} {}'.format("Beginn des ersten Zeiteintrags:", FIRSTSTARTTIME.strftime('%d.%m.%Y %H:%M')))
print('{:40} {}'.format("Ende des letzen Zeiteintrags:", LASTENDTIME.strftime('%d.%m.%Y %H:%M')))
print('{:40} {}'.format("Maximal erfassbare Zeit:", self.timedela_to_string(TRACKEDTIMESPAN)))
print('{:40} {}'.format("Nicht erfasste Zeit:", self.timedela_to_string(NONTRACKEDTIME)))
print('{:40} {}'.format("Erfasste Zeit:", self.timedela_to_string(TRACKEDTIME)))
print('{:40} {}'.format("Zeiteinträge:", ENTRIECOUNT))
text = "{:40} {}"
print(text.format("Beginn des ersten Zeiteintrags:", FIRSTSTARTTIME.strftime('%d.%m.%Y %H:%M')))
print(text.format("Ende des letzen Zeiteintrags:", LASTENDTIME.strftime('%d.%m.%Y %H:%M')))
print(text.format("Maximal erfassbare Zeit:", self.timedela_to_string(TRACKEDTIMESPAN)))
print(text.format("Nicht erfasste Zeit:", self.timedela_to_string(NONTRACKEDTIME)))
print(text.format("Erfasste Zeit:", self.timedela_to_string(TRACKEDTIME)))
print(text.format("Zeiteinträge:", ENTRIECOUNT))
printtext = [
'Zeiteinträge anzeigen?',
@@ -653,5 +734,4 @@ class TimeTrack:
if __name__ == "__main__":
test = TimeTrack()
test.start_interactive_mode()
test.DBCON.close()
test.start_interactive_mode()

View File

@@ -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