{"id":15105324,"url":"https://github.com/mohamedhamed1s/cloud-system","last_synced_at":"2026-02-05T21:32:08.522Z","repository":{"id":256103121,"uuid":"854333918","full_name":"MOHAMEDHAMED1S/cloud-system","owner":"MOHAMEDHAMED1S","description":"This project provides an application built using Flask, enabling users to manage files through a web interface. Features include file uploads, organization into folders, sharing files with others, and setting access permissions to be either public or private.","archived":false,"fork":false,"pushed_at":"2024-09-09T16:30:18.000Z","size":13790,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-18T19:12:01.758Z","etag":null,"topics":["cloud","flask","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MOHAMEDHAMED1S.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-09-09T01:21:59.000Z","updated_at":"2024-09-09T16:30:22.000Z","dependencies_parsed_at":"2024-09-09T02:48:29.620Z","dependency_job_id":null,"html_url":"https://github.com/MOHAMEDHAMED1S/cloud-system","commit_stats":null,"previous_names":["mohamedhamed1s/cloud-system"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MOHAMEDHAMED1S%2Fcloud-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MOHAMEDHAMED1S%2Fcloud-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MOHAMEDHAMED1S%2Fcloud-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MOHAMEDHAMED1S%2Fcloud-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MOHAMEDHAMED1S","download_url":"https://codeload.github.com/MOHAMEDHAMED1S/cloud-system/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230326807,"owners_count":18209051,"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":["cloud","flask","python"],"created_at":"2024-09-25T20:23:25.945Z","updated_at":"2026-02-05T21:32:07.459Z","avatar_url":"https://github.com/MOHAMEDHAMED1S.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n# Cloud System Project\nWelcome to the File Sharing Project using Flask! This project allows you to upload and share files securely with others.\n\n![Project Image](images/1.png)\n\n## Table of Contents\n\n- [Description](#description)\n- [Features](#features)\n- [Installation](#installation)\n- [Running the Project](#running-the-project)\n- [Configuration](#configuration)\n- [Files and Folders](#files-and-folders)\n- [Version Control](#version-control)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Description\n\nThis project provides an application built using Flask, enabling users to manage files through a web interface. Features include file uploads, organization into folders, sharing files with others, and setting access permissions to be either public or private.\n\n## Features\n\n- **Login and Registration:** Allows users to create accounts and log in to access their files.\n- **File Uploads:** Upload multiple files simultaneously.\n- **File Management:** Ability to delete files, move them between folders, and create new folders.\n- **File Sharing:** Set files as public for others to access, or keep them private.\n- **User-Friendly Interface:** Simple interface for managing files and folders.\n\n## Installation\n\nTo install and run the project locally, follow these steps:\n\n1. **Clone the Repository:**\n\n    ```bash\n    git clone https://github.com/MOHAMEDHAMED1S/cloud-system.git\n    ```\n\n2. **Navigate to the Project Directory:**\n\n    ```bash\n    cd cloud-system\n    ```\n\n3. **Create and Activate a Virtual Environment:**\n\n    On **Unix-like Systems** (Linux/macOS):\n    ```bash\n    python -m venv venv\n    source venv/bin/activate\n    ```\n\n    On **Windows**:\n    ```bash\n    python -m venv venv\n    venv\\Scripts\\activate\n    ```\n\n4. **Install Dependencies:**\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n5. **Create the Database:**\n\n    Run the Flask command to create the database:\n    ```bash\n    flask create_db\n    ```\n\n## Running the Project\n\nTo start the application, use the following command:\n\n```bash\npython app.py\n```\n\nOpen your web browser and go to [http://localhost:4000](http://localhost:4000) to view the application.\n\n## Configuration\n\nYou can modify project settings through the `app.py` file. Important settings include:\n\n- **Secret Keys:** `app.secret_key` - Use a secret key to ensure session security.\n- **Database Path:** `app.config['SQLALCHEMY_DATABASE_URI']` - Specify the path to your database here.\n- **Upload Folder Path:** `app.config['UPLOAD_FOLDER']` - Specify the folder where files will be stored.\n\nEnsure these settings are configured to fit your working environment.\n\n## Files and Folders\n\nHere’s a breakdown of the project’s file and folder structure:\n\n- **`app.py`**: Contains Flask application definitions and all routes and main functions.\n- **`extensions.py`**: Contains initialization for extensions such as SQLAlchemy and Flask-Login.\n- **`manage.py`**: Tool for managing migrations and updating the database.\n- **`migrations/`**: Contains migration files for Flask-Migrate. Includes `alembic.ini`, `env.py`, and migration files in the `versions` folder.\n- **`models.py`**: Contains database model definitions representing database tables.\n- **`requirements.txt`**: Lists the packages required to run the project.\n- **`static/`**: Contains static CSS and JavaScript files. Includes `styles.css` in the example.\n- **`templates/`**: Contains HTML template files. Includes `index.html`, `login.html`, and `register.html`.\n- **`uploads/`**: Contains files uploaded by users.\n- **`venv/`**: Contains the project’s virtual environment. Do not add this folder to the repository, and it’s typically added to `.gitignore`.\n\n## Version Control\n\nThis project uses Git for version control. To review the change history, you can use:\n\n```bash\ngit log\n```\n\n## Contributing\n\nWe welcome your contributions! If you’d like to add new features or fix bugs, please follow these steps:\n\n1. **Create a New Branch:**\n\n    ```bash\n    git checkout -b feature-branch\n    ```\n\n2. **Make Your Changes.**\n\n3. **Commit Your Changes to GitHub:**\n\n    ```bash\n    git add .\n    git commit -m \"Description of the changes\"\n    git push origin feature-branch\n    ```\n\n4. **Open a Pull Request on GitHub.**\n\nThe pull request will be reviewed and merged by maintainers.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE). You can find the license details in the `LICENSE` file included with the project.\n\n---\n\nIf you have any questions or need assistance, feel free to open an issue in the GitHub repository.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedhamed1s%2Fcloud-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohamedhamed1s%2Fcloud-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedhamed1s%2Fcloud-system/lists"}