{"id":21914305,"url":"https://github.com/luckykadam/kickup","last_synced_at":"2025-03-22T08:46:43.936Z","repository":{"id":72383577,"uuid":"222061050","full_name":"luckykadam/kickup","owner":"luckykadam","description":"Kickup: Template for Quick Projects (Machine Coding Interviews)","archived":false,"fork":false,"pushed_at":"2019-12-10T14:14:35.000Z","size":8,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-27T09:08:50.084Z","etag":null,"topics":["csv-parser","interview","python","quick-start-project","system-design","template"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/luckykadam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-16T07:06:46.000Z","updated_at":"2020-08-02T06:49:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"328278f1-d466-4040-8462-ddb0a6e1461e","html_url":"https://github.com/luckykadam/kickup","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luckykadam%2Fkickup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luckykadam%2Fkickup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luckykadam%2Fkickup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luckykadam%2Fkickup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luckykadam","download_url":"https://codeload.github.com/luckykadam/kickup/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244931587,"owners_count":20534010,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csv-parser","interview","python","quick-start-project","system-design","template"],"created_at":"2024-11-28T18:23:27.557Z","updated_at":"2025-03-22T08:46:43.918Z","avatar_url":"https://github.com/luckykadam.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kickup\nKickup: Template for Quick Projects (Machine Coding Interviews)\n\n## About\nThis repo serves as a great starting point for fast prototype projects.\n* Specially useful in Machine Coding interviews, when time is limited (~1 hour) and you can't afford to waste time on boiler plate code.\n* Implementation of Data Access Layer (csv) and Command Line Interface is provided, which are essential components of a demoable project.\n* Compelte code is under 200 line of code, which makes it easy to understand and extend.\n\n## Design\nThe code is designed as three modules.\n1. Command line interface: The module responsible for interaction with the end-user. It can be replaced with any kind of interface without affecting other module. For example: it can be replaced by REST API.\n2. Business Logic: This module contains the core logic of the application.\n3. Data Access Object: This module is responsible for interacting with the storage and provide the data to the application. Currently it reads from csv file, and keeps the data in memory. It can easily be replaced with another DAO which interacts with Database.\n\n\n## Implementation\nImplementation is done in python3.6. No external library is used.\n\u003cbr\u003e Although it implements Group Management System, this code can be used as a started code for any quick project.\n\n### Files\nAll the source code is inside `src` directory.\n\n* **command_line_interface.py**\nThis file represents Command Line Interface module. It interacts directly with `GroupManager`, but not with data access module.\n\u003cbr\u003e It extends [Cmd](https://docs.python.org/3/library/cmd.html#cmd.Cmd) class, and can be started by `cmdloop` function.\n\n* **group_manager.py**\nThis file represents Group Management module. It interacts directly with data access module.\nIt provides functions: `check_user_in_group`, `add_user_to_group` and `remove_user_from_group`.\n\n* **csv_dao.py**\nThis file represents CSV Data Access Object module. It interacts with storage(csv files) to provide data access to other modules.\n\n* **models.py**\nThis file contains the definition of entities.\n\n* **main.py**\nThis file stitch together all the module into an application.\n\n* **exceptions.py**\nThis file contains definition of commonly occurring exceptions.\n\n## Usage/Execution\nThe application can be started using command\n```\ncd src\npython src/main.py\n```\nThe program load the data from data directory and provides a command prompt for basic functionality.\n### Commands\n1. `help`: To know about available commands.\n2. `users`: To see all users.\n3. `groups`: To see all groups.\n4. `assign \u003cuser_id\u003e \u003cgroup_id\u003e`: To assign a user to a group.\n5. `remove \u003cuser_id\u003e \u003cgroup_id\u003e`: To remove a user from a group.\n6. `exit`: To exit from command prompt.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluckykadam%2Fkickup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluckykadam%2Fkickup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluckykadam%2Fkickup/lists"}