{ "info": { "author": "Sarbjit Singh", "author_email": "srbcheema1@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3.5" ], "description": "# Exam_scheduler\n\n[![a srbcheema1 production](https://img.shields.io/badge/-a%20srbcheema1%20production-blue.svg)](https://github.com/srbcheema1)\n[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.ocm/srbcheema1/exam_scheduler/issues)\n[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.png?v=103)](https://github.com/srbcheema1/exam_scheduler)\n[![Build Status](https://travis-ci.org/srbcheema1/exam_scheduler.svg?branch=master)](https://travis-ci.org/srbcheema1/exam_scheduler)\n[![HitCount](http://hits.dwyl.io/srbcheema1/exam_scheduler.svg)](http://hits.dwyl.io/srbcheema1/exam_scheduler)\n\n**exam_scheduler** is a commandline tool to produce teacher-duty schedule in examination for a school/college. It also acts as library-cum-backbone for [ExamScheduler](https://srbcheema1.github.io/ExamScheduler/) a web-based tool.\n\n\n### Installation\n\n#### Install using pip (Recommended)\n\n- Use pip to install, user `--user` flag\n```\npython3 -m pip install --user exam_scheduler\n```\n\n\n##### linux and mac users\n```\npython3 -m pip install --user exam_scheduler\n```\nDon't forget `~/.local/bin` should be in your `PATH`. Add line `export PATH=$PATH:\"~/.local/bin\"` in your `.bashrc`\n\n##### windows users\nfor windows users you should have python3 installed in your system\n```\npython3 -m pip install --user exam_scheduler\n```\n\n#### Build from Source\n\n- Clone the repository and checkout to stable commit\n```\ngit clone https://github.com/srbcheema1/exam_scheduler\ncd exam_scheduler\ngit checkout \n```\n\n- install requirements\n```\npython3 -m pip install --user -r requirements.txt\n```\n- Install exam_scheduler\n```\npython3 setup.py install --user\n```\n- Building Source Distribution\n```\npython3 setup.py sdist\n```\n\n\n\n### Inputs Required\n\n\n- room_list - includes `room-name` and `teachers-required` as compulsory attributes. Other attributes may follow.\n - `Res` (Case-senstive) is special room name for reserved purposes.\n - Recommended to be used instead of dummy rooms.\n\n- teachers_list - includes `teacher-name` and `rank` as compulsory attributes. Other attributes may follow.\n\n- schedule_list - A 2D matrix includeing relation between a session and a room\n - value is 'Y' if room is required on particular session.\n - By default empty cell is treated as 'N'\n\n- work_ratio - Includes rank and work_ratio as compulsory attributes. Other optional attributes may follow.\n\nBy default it will automtically pick excel files from working-directory OR `input` folder containing `room_list`,`teachers_list`,`schedule_list` and `work_ratio` in their names.\n\nFor more instructions please visit our [help page](https://srbcheema1.github.io/ExamScheduler/#/Help).\n\n### Usage\n```\nsrb@srb-pc:$ exam_scheduler --help\nusage: exam_scheduler.py [-h] [-v] [-o OUTPUT] [-s SEED] [-r RESERVED]\n [-vr VR | -vs VS | -vt VT]\n\noptional arguments:\n -h, --help show this help message and exit\n -v, --version Display version number\n -o OUTPUT, --output OUTPUT\n Output file name, default output.xlsx\n -s SEED, --seed SEED seed value for randomness\n -r RESERVED, --reserved RESERVED\n reserved number of seats for each session\n -d, --debug print debug info\n -vr VR verify room_list file\n -vs VS verify schedule_list file\n -vt VT verify teachers_list file\n```\n\n```\nsrb@srb-pc:$ exam_scheduler -o result.xlsx\nUsing room_list : /home/srb/programs/exam_scheduler/input/room_list.csv\nUsing teachers_list : /home/srb/programs/exam_scheduler/input/teachers_list.csv\nUsing schedule_list : /home/srb/programs/exam_scheduler/input/schedule_list.csv\nUsing seed value : 5\nUsing reserved value : 0\nrank count : {\n \"0\": 33,\n \"1\": 7,\n \"2\": 23,\n \"3\": 77,\n \"4\": 59,\n \"5\": 91\n}\naverage duties : {\n \"0\": 0.0,\n \"1\": 2.0,\n \"2\": 2.347,\n \"3\": 3.0,\n \"4\": 3.0,\n \"5\": 3.0\n}\ntype of rooms : {\n \"[1, 3, 5]\": 1,\n \"[1, 4, 5]\": 13,\n \"[2, 3, 5]\": 1,\n \"[2, 4, 5]\": 53,\n \"[3, 4, 5]\": 85,\n \"[3, 4]\": 25,\n \"[3, 5]\": 119,\n \"[4, 5]\": 1\n}\nOutput written to : /home/srb/programs/exam_scheduler/result.xlsx\n```\n\n\n\n### Contact / Social Media\n\n[![Github](https://raw.githubusercontent.com/srbcheema1/CheemaFy/master/myPlugins/extra_things/png_images/social/github.png)](https://github.com/srbcheema1/)\n[![LinkedIn](https://raw.githubusercontent.com/srbcheema1/CheemaFy/master/myPlugins/extra_things/png_images/social/linkedin-48x48.png)](https://www.linkedin.com/in/srbcheema1/)\n[![Facebook](https://raw.githubusercontent.com/srbcheema1/CheemaFy/master/myPlugins/extra_things/png_images/social/fb.png)](https://www.facebook.com/srbcheema/)\n\n\n### Developed by\n\nDeveloper / Author: [Srb Cheema](https://github.com/srbcheema1/)\n\nCollaborator : [Rakesh Kumar](https://github.com/spider34/)", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/srbcheema1/exam_scheduler", "keywords": "", "license": "MIT License", "maintainer": "", "maintainer_email": "", "name": "exam-scheduler", "package_url": "https://pypi.org/project/exam-scheduler/", "platform": "", "project_url": "https://pypi.org/project/exam-scheduler/", "project_urls": { "Homepage": "http://github.com/srbcheema1/exam_scheduler" }, "release_url": "https://pypi.org/project/exam-scheduler/0.1.0/", "requires_dist": null, "requires_python": "", "summary": "A commandline tool to create examination schedules", "version": "0.1.0" }, "last_serial": 5805772, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "027760ab716acd55c118770b5c8bb82c", "sha256": "935c4e553a6068f6d12997eb52b22d93cccf595fc8f1c8baceac34565aeaaac6" }, "downloads": -1, "filename": "exam_scheduler-0.0.1-py3.6.egg", "has_sig": false, "md5_digest": "027760ab716acd55c118770b5c8bb82c", "packagetype": "bdist_egg", "python_version": "3.6", "requires_python": null, "size": 18766, "upload_time": "2019-01-08T22:25:45", "url": "https://files.pythonhosted.org/packages/e1/a1/cf5e7bbb1d49666c9f3d43321df118866e302e23fe15e0a9a44950ab0c10/exam_scheduler-0.0.1-py3.6.egg" }, { "comment_text": "", "digests": { "md5": "1c818aacdec182c1d7cf242c3aa3b897", "sha256": "ddbe2c4c47e1f37175927aa800a6c7a7f09376ee24a2d418e38a50d8700a1adb" }, "downloads": -1, "filename": "exam_scheduler-0.0.1.tar.gz", "has_sig": false, "md5_digest": "1c818aacdec182c1d7cf242c3aa3b897", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6571, "upload_time": "2019-01-08T22:25:47", "url": "https://files.pythonhosted.org/packages/97/ac/505fa51ae3c5da18ec09bf109d33c09f3bd7a88d9b55a2c1e83bd8bc3188/exam_scheduler-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "7c0b25a912ade9e5bc3cb987ca26eeed", "sha256": "db0d88505c744fdca858663351a7aa78d98c95e7fb036d60e606bef7d2c263b5" }, "downloads": -1, "filename": "exam_scheduler-0.0.2.tar.gz", "has_sig": false, "md5_digest": "7c0b25a912ade9e5bc3cb987ca26eeed", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8071, "upload_time": "2019-02-20T16:46:34", "url": "https://files.pythonhosted.org/packages/66/90/1039f3a6e7c9a1cc5a27142cc6123f47c9b17749a29a2de3ba65f1d44e2e/exam_scheduler-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "0c067af3b444efd7fdbc677a0812c197", "sha256": "6eaeab78d01c08617492496d8eaefd94c768aefc191e5e752a3accf44967b586" }, "downloads": -1, "filename": "exam_scheduler-0.0.3.tar.gz", "has_sig": false, "md5_digest": "0c067af3b444efd7fdbc677a0812c197", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10434, "upload_time": "2019-04-22T06:54:39", "url": "https://files.pythonhosted.org/packages/6d/ba/0c1efa6e105bc214b6c9ac59e2bdd4245a90734da4745124ff1351c0fbbe/exam_scheduler-0.0.3.tar.gz" } ], "0.0.4": [ { "comment_text": "", "digests": { "md5": "88a2512c160645b923570c8b89dc7510", "sha256": "0255408a746d44ad9e7f4fd44e628ca65e042526e33ee9edf168787e37903f26" }, "downloads": -1, "filename": "exam_scheduler-0.0.4.tar.gz", "has_sig": false, "md5_digest": "88a2512c160645b923570c8b89dc7510", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11802, "upload_time": "2019-04-28T17:16:39", "url": "https://files.pythonhosted.org/packages/21/63/d6f8da5cf25301e4322cc01540728cd7f085cd24e986dee3b11a9d2c91c1/exam_scheduler-0.0.4.tar.gz" } ], "0.0.5": [ { "comment_text": "", "digests": { "md5": "3a278fadfdc0eeefe0a47ef5e6a7984a", "sha256": "6c6bc358b186c564d1fb9ea5c678ef39c6be054febc0063499ee6ab87bbfa638" }, "downloads": -1, "filename": "exam_scheduler-0.0.5-py3.6.egg", "has_sig": false, "md5_digest": "3a278fadfdc0eeefe0a47ef5e6a7984a", "packagetype": "bdist_egg", "python_version": "3.6", "requires_python": null, "size": 34179, "upload_time": "2019-05-03T20:23:47", "url": "https://files.pythonhosted.org/packages/0e/fc/b6e976d2390d86dbc8b07e0b5bf11102a8cea1ce8c420f934712bb933aae/exam_scheduler-0.0.5-py3.6.egg" }, { "comment_text": "", "digests": { "md5": "70e0d217ecb6391552ae9c4f0fec63c5", "sha256": "3ee612da6613326f024cc58c0dc872676ecf67610c7daa0a00b0d172d4a236ff" }, "downloads": -1, "filename": "exam_scheduler-0.0.5.tar.gz", "has_sig": false, "md5_digest": "70e0d217ecb6391552ae9c4f0fec63c5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11911, "upload_time": "2019-05-03T20:23:49", "url": "https://files.pythonhosted.org/packages/da/4d/0d28c64abe1bd742cd8ebaa88d8a5222b78f25eb62090756fcd37ce2342c/exam_scheduler-0.0.5.tar.gz" } ], "0.0.6": [ { "comment_text": "", "digests": { "md5": "49487bfeaf592fb5265229c8e5580643", "sha256": "be7b676783a459c55942ed35b15e8ca1b89659c352ea435fd095cff87bdaf92b" }, "downloads": -1, "filename": "exam_scheduler-0.0.6.tar.gz", "has_sig": false, "md5_digest": "49487bfeaf592fb5265229c8e5580643", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11993, "upload_time": "2019-05-08T16:05:34", "url": "https://files.pythonhosted.org/packages/ec/e9/239010e8fabab705a75b5c39bae8fc74d5c3b118c0468e081123d8e3653d/exam_scheduler-0.0.6.tar.gz" } ], "0.0.7": [ { "comment_text": "", "digests": { "md5": "3609d38521664ec1a2e635a09af6acf0", "sha256": "e7f919ef51478c14038dc27a38a170bde7e82cbaf34c32c464cf3a8e7dc73f08" }, "downloads": -1, "filename": "exam_scheduler-0.0.7.tar.gz", "has_sig": false, "md5_digest": "3609d38521664ec1a2e635a09af6acf0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13520, "upload_time": "2019-05-16T13:16:44", "url": "https://files.pythonhosted.org/packages/91/0d/f6465c6f2fe560f24836331fd04740c8736f5c8d0f9e552fcdfbe62cc920/exam_scheduler-0.0.7.tar.gz" } ], "0.0.8": [ { "comment_text": "", "digests": { "md5": "dc46b585d6780034f7f0bd6a3dae1153", "sha256": "d673c1e1d9f8605cba002209d2b91aed710adfb9dd1f7f98ab8db38ae656ac8c" }, "downloads": -1, "filename": "exam_scheduler-0.0.8.tar.gz", "has_sig": false, "md5_digest": "dc46b585d6780034f7f0bd6a3dae1153", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13847, "upload_time": "2019-06-07T07:39:01", "url": "https://files.pythonhosted.org/packages/51/4c/8cdef4c149f368fdd8dd7f1ba64d8c26b94230c63bcfb9f7fd0aab43a249/exam_scheduler-0.0.8.tar.gz" } ], "0.0.9": [ { "comment_text": "", "digests": { "md5": "164c28d029d185f32fd5fe93536acabd", "sha256": "12c586e790bf681c8ecedcd9c06a287c9e448db5e642556b6282ba81bcb9d2ca" }, "downloads": -1, "filename": "exam_scheduler-0.0.9.tar.gz", "has_sig": false, "md5_digest": "164c28d029d185f32fd5fe93536acabd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14138, "upload_time": "2019-09-09T18:44:36", "url": "https://files.pythonhosted.org/packages/d4/a0/6ba69a3026b8a3c7769325edbf652bb466b10ab2d6f192d96c48c4ac7344/exam_scheduler-0.0.9.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "6306c94a50bdc697de43708e0a95b5e4", "sha256": "fa9b7e64c25a6e54b1f536ea79ee2448bac49d804d072666856c578c6076a740" }, "downloads": -1, "filename": "exam_scheduler-0.1.0.tar.gz", "has_sig": false, "md5_digest": "6306c94a50bdc697de43708e0a95b5e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14236, "upload_time": "2019-09-09T22:06:17", "url": "https://files.pythonhosted.org/packages/d4/16/a45caa4936225119d84a82dbffd8c10f52be711252152ac049248023cb25/exam_scheduler-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6306c94a50bdc697de43708e0a95b5e4", "sha256": "fa9b7e64c25a6e54b1f536ea79ee2448bac49d804d072666856c578c6076a740" }, "downloads": -1, "filename": "exam_scheduler-0.1.0.tar.gz", "has_sig": false, "md5_digest": "6306c94a50bdc697de43708e0a95b5e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14236, "upload_time": "2019-09-09T22:06:17", "url": "https://files.pythonhosted.org/packages/d4/16/a45caa4936225119d84a82dbffd8c10f52be711252152ac049248023cb25/exam_scheduler-0.1.0.tar.gz" } ] }