Skip to content

tlikonen/koas

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kouluarvosanatietokanta

Esittely

Kouluarvosanatietokanta (Koas) on tietokantaohjelma koulun tai oppilaitoksen opettajalle. Tietokantaan voi syöttää oppilaita, koulusuorituksia sekä arvosanoja ja mahdollisia lisätietoja. Tietokannasta voi hakea tietoja esimerkiksi seuraavilla tavoilla:

  • tietyn oppilaan kaikki suoritukset ja arvosanat
  • tietyn suorituksen arvosanat koko opetusryhmältä
  • opetusryhmän kaikki arvosanat koottuna
  • jakaumia ja paremmuusjärjestyksiä.

Ohjelma myös laskee suoritusten keskiarvot automaattisesti ja hyödyntää laskemisessa käyttäjän määrittämiä painokertoimia. Ohjelmassa on tekstipohjainen käyttöliittymä ja myös tulosteet ovat tekstimuotoisia taulukoita.

Tiedot tallennetaan joko SQLite-tietokantatiedostoon tai erilliselle PostgreSQL-tietokantapalvelimelle.

Asentaminen

Kouluarvosanatietokanta toimii ainakin GNU/Linux-käyttöjärjestelmissä. Ohjelman kääntäminen ja suorittaminen vaatii SBCL-nimisen Common Lisp -toteutuksen. Lisäksi asennettuna täytyy olla kehittäjäversio Readline- ja SQLite3-kirjastosta. Esimerkiksi Debian GNU/Linux -käyttöjärjestelmässä edellä mainitut ovat asennuspaketeissa nimeltä sbcl, libreadline6-dev ja libsqlite3-dev.

Ensimmäisellä kerralla kääntämisen yhteydessä käytetään wget-ohjelmaa, jolla haetaan internetistä Quicklisp. Quicklispin avulla ladataan internetistä automaattisesti eräitä Common Lisp -kirjastoja.

Ohjelma käännetään komennolla make ja asennetaan komennolla make install. Oletuksena ohjelma asennetaan hakemistoon /usr/local/bin. Asennushakemiston voi määrittää makefile-muuttujalla bindir. Käytettävän SBCL:n polun voi määrittää muuttujalla sbcl. Esimerkki: make sbcl=... bindir=.... Käytetyt muuttujat tallentuvat tiedostoon config.mk.

Käyttö

Koas käynnistetään yleensä komennolla koas. Se käynnistää ohjelman vuorovaikutteiseen tilaan, jossa kehote Koas> ilmaisee, että komentoja voi syöttää. Komennolla ? tulostuu ohjeet kaikista ohjelman komennoista.

Ensimmäisellä käynnistyskerralla luodaan automaattisesti SQLite-tietokantatiedosto, johon ohjelman asetukset ja tietokanta oletuksena tallentuvat.

Ohjelmassa on myös toimintoja ja asetuksia, joita käytetään vain komentoriviargumenttien kautta. Niistä saa lisätietoa, kun ohjelman käynnistää antamalla argumentin -h tai --ohje.

Tekijä ja tekijänoikeus

Ohjelman tekijä on Teemu Likonen <tlikonen@iki.fi> (OpenPGP-avain: 6965F03973F0D4CA22B9410F0F2CAE0E07608462), ja ohjelmaa levitetään The GNU General Public License -nimisellä lisenssillä. Lisenssin teksti on linkin takana englanninkielisenä. Lisenssin ajatuksena on, että ohjelmaa saa käyttää ja levittää vapaasti. Ohjelmaan saa myös vapaasti tehdä omia muutoksia, mutta jos levittää omaa muunneltua versiota, täytyy ohjelman muunneltu lähdekoodi antaa muiden käyttöön. Muunnellut versiot täytyy jakaa tällä samalla ohjelmistolisenssillä (tai sen uudemmalla versiolla).

Ohjelmaa levitetään siinä toivossa, että siitä on hyötyä muille. Ohjelman tekijä ei kuitenkaan anna mitään takuita ohjelmalle, ei edes lupausta, että se sopii johonkin tiettyyn käyttötarkoitukseen.

Copyright and Licence

Copyright (C) 2013-2022 Teemu Likonen <tlikonen@iki.fi>

OpenPGP key: 6965F03973F0D4CA22B9410F0F2CAE0E07608462

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The license text: http://www.gnu.org/licenses/gpl-3.0.html