{"id":24609407,"url":"https://github.com/scorpi-on/courseos","last_synced_at":"2025-10-16T03:39:19.508Z","repository":{"id":250920920,"uuid":"835895035","full_name":"Scorpi-ON/CourseOS","owner":"Scorpi-ON","description":"Course project on operational systems (Dec 2023, 5th semester of university)","archived":false,"fork":false,"pushed_at":"2025-01-07T13:37:21.000Z","size":75,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-24T18:14:19.350Z","etag":null,"topics":["course-project","file-system","interprocess-communication","pyqt6","pytest","s5fs"],"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/Scorpi-ON.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":"2024-07-30T18:30:55.000Z","updated_at":"2025-01-07T13:39:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"0472bc6b-468f-4b91-98b5-b415a9410c81","html_url":"https://github.com/Scorpi-ON/CourseOS","commit_stats":null,"previous_names":["scorpi-on/pythos"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scorpi-ON%2FCourseOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scorpi-ON%2FCourseOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scorpi-ON%2FCourseOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scorpi-ON%2FCourseOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Scorpi-ON","download_url":"https://codeload.github.com/Scorpi-ON/CourseOS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244217950,"owners_count":20417677,"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":["course-project","file-system","interprocess-communication","pyqt6","pytest","s5fs"],"created_at":"2025-01-24T18:14:41.955Z","updated_at":"2025-10-16T03:39:19.488Z","avatar_url":"https://github.com/Scorpi-ON.png","language":"Python","readme":"# CourseOS\n\n[![license](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![release](https://img.shields.io/github/v/release/Scorpi-ON/CourseOS?include_prereleases)](https://github.com/Scorpi-ON/CourseOS/releases)\n[![downloads](https://img.shields.io/github/downloads/Scorpi-ON/CourseOS/total)](https://github.com/Scorpi-ON/CourseOS/releases)\n[![code size](https://img.shields.io/github/languages/code-size/Scorpi-ON/CourseOS.svg)](https://github.com/Scorpi-ON/CourseOS)\n\n[![Ruff and MyPy checks](https://github.com/Scorpi-ON/CourseOS/actions/workflows/linters.yaml/badge.svg)](https://github.com/Scorpi-ON/CourseOS/actions/workflows/linters.yaml)\n[![pytest tests](https://github.com/Scorpi-ON/CourseOS/actions/workflows/tests.yaml/badge.svg)](https://github.com/Scorpi-ON/CourseOS/actions/workflows/tests.yaml)\n[![PyQt UI compilation](https://github.com/Scorpi-ON/CourseOS/actions/workflows/ui-compile.yaml/badge.svg)](https://github.com/Scorpi-ON/CourseOS/actions/workflows/ui-compile.yaml)\n[![CodeQL (Python, C++, GH Actions)](https://github.com/Scorpi-ON/CourseOS/actions/workflows/codeql.yaml/badge.svg)](https://github.com/Scorpi-ON/CourseOS/actions/workflows/codeql.yaml)\n\nКурсовой проект по операционным системам, продуктом которого является эмулятор файловой системы S5FS, а\nтакже межпроцессного взаимодействия.\n\n\u003cdetails\u003e\u003csummary\u003e\u003ch2\u003eСкриншоты\u003c/h2\u003e\u003c/summary\u003e\n    \u003ch3\u003eЭмулятор ФС\u003c/h3\u003e\n    \u003cp\u003eАвторизация:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/0ef55d55-1c32-474d-ad17-be6081ca5197\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eСписки групп и пользователей:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/7fc6ad1c-c6c5-46d5-8380-dcad630a4655\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eСписок файлов:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/c4b393c2-7303-4730-8f71-89036be1bbca\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eСоздание новой группы:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/3a15fc15-cb29-4598-8a85-dcef9adbeb45\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eСоздание нового пользователя:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/f0723028-74fb-4cb1-a65f-327ad656fa7b\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eГруппа и пользователь успешно добавлены:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/f7e0489a-a7c5-419d-a5f4-dfe10ba0b5ee\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eПопытка открыть системный файл (запрещено):\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/2de5b047-a9f3-424c-b3dd-148669904e53\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eПодтверждение перед удалением не системного файла:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/d8c24545-6c41-41e9-9b72-9d1f46e4ee48\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eПоскольку файл был создан другим пользователем, а у других пользователей права на запись нет, удалить его нельзя:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/2c343b0f-d99c-4215-bd6f-bc8a11964c2e\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eСоздание нового файла:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/b9b25f5e-bd3d-4656-9c9c-fafdbaba5cf2\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eВыставление прав при создании нового файла:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/993b2eac-3e5d-4d61-a61b-6e9853d4fec6\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eОткрытие файла после создания (метаданные обновлены):\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/f9ef2961-3d36-4cf4-af0d-d4bc5460c4ea\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eОткрытие файла после снятия права на запись (поля заполнены данными, но не активны для изменения):\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/769736c8-6a63-447c-8629-186c5440240f\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eДата модификации файла после его редактирования обновлена:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/04f72c03-13fa-4dc9-bed6-e9e76a38aa84\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eКопирование файла:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/0b0547a6-fa1f-477d-8dee-c757e625a962\" width=\"50%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eУдаление исходного файла (будет произведено только после возвращения права на запись):\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/9e025cba-a86f-4126-93e0-b4bdc47e6f89\" width=\"50%\"\u003e\n    \u003ch3\u003eДемо межпроцессного взаимодействия\u003c/h3\u003e\n    \u003cp\u003eКаналы:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/1b261cc0-b4e2-4ca2-9439-0adfd433a221\" width=\"65%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eИменованные каналы:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/edf4465f-1b42-410c-89d7-0876f88fe447\" width=\"65%\"\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003cp\u003eРазделяемая память:\u003c/p\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/4fb2e732-fc55-44c9-bb80-667201999360\" width=\"65%\"\u003e\n\u003c/details\u003e\n\n## Основные требования\n\n- файловая система должна эмулировать структуру и принцип работы S5FS\n- файловая система должна «работать» в бинарном файле\n- файловая система должна быть одноуровневой и работать с битовой картой свободных/занятых кластеров\n- файловая система должна поддерживать:\n    - CRUD-операции с файлами и каталогами\n    - создание пользователей и групп, вход в систему от имени пользователей\n    - настройку прав доступа к файлам и каталогам\n    - дополнительные возможности на усмотрение разработчика\n- в прототипе межпроцессного взаимодействия должны быть реализованы следующие средства:\n    - каналы\n    - именованные каналы\n    - разделяемая память\n- эмулятор файловой системы должен быть выполнен в виде графического приложения\n- работу межпроцессного взаимодействия можно проиллюстрировать в отдельных консольных программах\n- язык написания эмулятора ФС — любой, межпроцессного взаимодействия — один из низкоуровневых (например, C/C++)\n\n## Особенности реализации\n\n- [x] все требования соблюдены\n- [x] эмулятор файловой системы кроссплатформенный, межпроцессное взаимодействие написано под Linux- [x] операции с бинарным файлом файловой системы покрыты тестами\n- [x] интегрированы инструменты управления зависимости и статического анализа кода\n- [x] проверка качества кода посредством CI/CD пайплайнов и Git-хуков\n\n## Стек\n\n- **Python** — основной язык программирования\n- **uv** — пакетный менеджер\n- **pytest** — фреймворк для тестирования\n- **Ruff** — инструмент для форматирования и анализа кода\n- **MyPy** — статический типизатор Python\n- **pre-commit** — фреймворк для настройки хуков Git\n- **GNU C++** — компилятор C++ для иллюстрации межпроцессного взаимодействия\n\n## Установка и запуск\n\n### Эмулятор ФС\n\n0. Клонируйте репозиторий и перейдите в папку эмулятора:\n\n```shell\ngit clone git@github.com:Scorpi-ON/CourseOS.git\ncd CourseOS/fs\n```\n\n1. Установите пакетный менеджер uv одним из способов. Например, для Windows:\n\n```shell\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n2. Установите зависимости:\n\n```shell\nuv sync --frozen --no-dev\n```\n\n3. Теперь запускать проект можно командой:\n\n```shell\nuv run -m CourseOS\n```\n\n### Демо межпроцессного взаимодействия\n\n0. Клонируйте репозиторий и перейдите в папку файлов межпроцессного взаимодействия:\n\n```shell\ngit clone git@github.com:Scorpi-ON/CourseOS.git\ncd CourseOS/processes\n```\n\n1. Запуск демонстрации работы **каналов**:\n\n```shell\ng++ pipes.cpp -o pipes.out \u0026\u0026 ./pipes.out\n```\n\n2. Запуск демонстрации работы **именованных каналов** (выполняется с двух терминалов, открытых параллельно):\n\nРидер:\n\n```shell\ng++ named_pipes_reader.cpp -o named_pipes_reader.out \u0026\u0026 ./named_pipes_reader.out\n```\n\nРайтер:\n\n```shell\ng++ named_pipes_writer.cpp -o named_pipes_writer.out \u0026\u0026 ./named_pipes_writer.out\n```\n\n3. Запуск демонстрации работы **разделяемой памяти** (выполняется с двух терминалов, открытых параллельно):\n\nРидер:\n\n```shell\ng++ shared_memory_reader.cpp -o shared_memory_reader.out \u0026\u0026 ./shared_memory_reader.out\n```\n\nРайтер:\n\n```shell\ng++ shared_memory_writer.cpp -o shared_memory_writer.out \u0026\u0026 ./shared_memory_writer.out\n```\n\n## Модификация\n\n### Эмулятор ФС\n\nЧтобы модифицировать проект, необходимо установить все зависимости, включая необходимые только для разработки:\n\n```shell\nuv sync\npre-commit install --hook-type pre-commit --hook-type pre-push```\n```\n\nЗапустить форматирование кода, его линтинг и статический анализ типов можно следующими командами соответственно:\n\n```shell\nruff format\nruff check --fix\nmypy .\n```\nЭта операция производятся автоматически при коммитах.\n\nДля запуска всех автотестов выполните команду:\n\n```shell\npytest CourseOS/tests\n```\n\nЭта операция производятся автоматически при отправке изменений.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscorpi-on%2Fcourseos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscorpi-on%2Fcourseos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscorpi-on%2Fcourseos/lists"}