https://github.com/wichmann/bbss

A management software for students of german vocational colleges.
https://github.com/wichmann/bbss

Last synced: about 1 year ago
JSON representation

A management software for students of german vocational colleges.

• Host: GitHub
• URL: https://github.com/wichmann/bbss
• Owner: wichmann
• License: gpl-2.0
• Created: 2014-04-03T06:08:44.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2025-01-31T08:38:16.000Z (over 1 year ago)
• Last Synced: 2025-01-31T09:29:00.526Z (over 1 year ago)
• Language: Python
• Size: 211 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
bbss - BBS Student Management

=============================

DESCRIPTION

-----------

bbss is a management software for students of german vocational colleges.

USAGE

-----

bbss can be used either with a graphical user interface or a command line

interface. To start the GUI, execute

    bbss_gui.py

Usage of bbss command line interface:

    bbss_cli clear

    bbss_cli import  [--import-format (csv | excel)] [-c CONFIG_FILE] [--dsdb]

    bbss_cli export  [--export-format (logodidact | ad)] [--drc] [--dric]

    bbss_cli search 

    Options:

    -h, --help             Show this help message and exit.

    --version              Show version information.

    --import-format        Import file format for student data. [default: csv]

    --export-format        Export file format for student data. [default: logodidact]

    -c CONFIG_FILE --config CONFIG_FILE

                           Config file in local directory.

    --drc                  Do not replace class names.

    --dric                 Do not replace illegal characters in student names.

    --dsdb                 Do not store imported student data in database.

For easy distribution it is possible to build a single zip or exe file

containing all necessary files with either cx_freeze or pyinstaller. Both

tools can be installed by using pip:

    pip install pyinstaller

    pip install cx_freeze

After the installation both tools can create in single directory or single

file distribution:

    pyinstaller bbss_gui.py

    pyinstaller --onefile bbss_gui.py

    python setup.py build

KNOWN PROBLEMS AND BUGS

-----------------------

bbss was written for use under Linux and Windows Vista and higher. Under older

systems like Windows XP where the default encoding is not UTF-8 problems can

occur.

The encoding of data files has to match the default OS encoding (mostly UTF-8).

LICENSE

-------

bbss is released under the GNU General Public License v2 or newer.

REQUIREMENTS

------------

bbss requires at least Python 3.2. The following Python packages are necessary:

* xlrd for importing Microsoft Excel files

* PyQt5 for graphical user interface (including pyqt5-dev-tools for pyuic5 tool)

* win32com for using Microsoft Active Directory under Windows

* docopt for handling command line arguments

* reportlab for creating PDF files as pasword lists for WebUntis user data

PROBLEMS

--------