Async Aggregators

async-aggregators/.github/workflows/lint.yaml

@@ -0,0 +1,38 @@
+# GitHub Action Workflow enforcing our code style.
+
+name: Lint
+
+# Trigger the workflow on both push (to the main repository, on the main branch)
+# and pull requests (against the main repository, but from any repo, from any branch).
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+# Brand new concurrency setting! This ensures that not more than one run can be triggered for the same commit.
+# It is useful for pull requests coming from the main repository since both triggers will match.
+concurrency: lint-${{ github.sha }}
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    env:
+      # The Python version your project uses. Feel free to change this if required.
+      PYTHON_VERSION: "3.10"
+
+    steps:
+      # Checks out the repository in the current folder.
+      - name: Checks out repository
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
+
+      # Set up the right version of Python
+      - name: Set up Python ${{ env.PYTHON_VERSION }}
+        uses: actions/setup-python@v3
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Run pre-commit hooks
+        uses: pre-commit/action@v3.0.0

async-aggregators/.github/workflows/unittests.yaml

@@ -0,0 +1,41 @@
+# GitHub Action Workflow running unittests.
+
+name: Run Unittests
+
+# Specifies when the workflow should be run. In this case, it's triggered for every push and pull request.
+on: [push]
+
+jobs:
+  build:
+
+    # Specifies the type of runner the job will run on. "ubuntu-latest" refers to the latest available version of Ubuntu.
+    runs-on: ubuntu-latest
+
+    # A list of steps that will be run as part of the "build" job.
+    steps:
+      # Checks out the repository in the current folder.
+      - name: Checks out repository
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
+
+      # Set up the right version of Python
+      - name: Set up Python ${{ env.PYTHON_VERSION }}
+        uses: actions/setup-python@v3
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      # Installs Poetry - a tool for dependency management in Python.
+      - name: Install Poetry
+        run: |
+          curl -sSL https://install.python-poetry.org | python3 -
+
+      # Installs the dependencies for the project using Poetry.
+      # This will use the pyproject.toml and poetry.lock files from your repository.
+      - name: Install dependencies with Poetry
+        run: |
+          poetry install
+
+      # Runs the unittests using the virtual environment managed by Poetry.
+      - name: Run tests
+        run: poetry run python -m unittest discover  # Adjust the command if you have a specific way to run your tests.

async-aggregators/.gitignore

@@ -0,0 +1,31 @@
+# Files generated by the interpreter
+__pycache__/
+*.py[cod]
+
+# Environment specific
+.venv
+venv
+.env
+env
+
+# Unittest reports
+.coverage*
+
+# Logs
+*.log
+
+# PyEnv version selector
+.python-version
+
+# Built objects
+*.so
+dist/
+build/
+
+# IDEs
+# PyCharm
+.idea/
+# VSCode
+.vscode/
+# MacOS
+.DS_Store

async-aggregators/.pre-commit-config.yaml

@@ -0,0 +1,35 @@
+## Pre-commit setup
+# See https://github.com/python-discord/code-jam-template/tree/main#pre-commit-run-linting-before-committing
+
+# Make sure to edit the `additional_dependencies` list if you want to add plugins
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+      - id: check-toml
+      - id: check-yaml
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+
+  - repo: https://github.com/pre-commit/pygrep-hooks
+    rev: v1.5.1
+    hooks:
+      - id: python-check-blanket-noqa
+
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/pycqa/flake8
+    rev: 4.0.1
+    hooks:
+      - id: flake8
+        additional_dependencies:
+          - flake8-docstrings~=1.6.0
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v0.940
+    hooks:
+      - id: mypy
+        args: [--disallow-untyped-defs, --disallow-incomplete-defs, --disallow-untyped-calls, --ignore-missing-imports]

async-aggregators/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2021 Python Discord
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

async-aggregators/README.md

@@ -0,0 +1,123 @@
+# Digital Shadows
+
+![radio room](radio_room.png)
+
+**Digital Shadows** transports players into the enthralling depths of the digital realm, bridging the gap
+between the online world and palpable real-world locations, ranging from underground hacker dens and
+abandoned warehouses to fortified safe houses.
+
+In the game's opening cinematic, the narrative unfolds on a screen shrouded in darkness, gradually
+illuminated by cascading lines of mysterious code. As the climax of this digital downpour is reached,
+players are introduced to the central character: Eclipse is a master hacker known only by this codename.
+An encrypted message demands Eclipse's attention within a dimly lit enclave, awash with the glow of myriad screens:
+"They're making a move. The web is tightening. Need your skills."
+
+Eclipse's enigmatic past reveals a hacker who once operated on the digital periphery. Their trajectory
+dramatically shifts upon being recruited by an elite international cybersecurity group. But lurking in
+the backdrop is the game's menacing antagonist: "The Silent Hand," a sinister terrorist collective skilled
+in wielding advanced digital tools to sow real-world chaos.
+
+Embarking on the Digital Shadows journey, players are tasked with deciphering a complex array of digital
+puzzles. Every riddle unraveled delves deeper into the dark web, uncloaking encrypted data and unwinding
+layers of secretive communication. Successive solutions unravel the plots and expose the identities of
+the shadowy faction, drawing Eclipse ever closer to thwarting "The Silent Hand."
+
+Dive deep into this entwining of shadows, where the boundaries between the digital and tangible blur, and
+every decision could reveal a hidden secret or set off an unseen trap. Brace yourself, for in this world,
+shadows are always vigilant.
+
+
+## Prerequisites
+
+Before you begin, ensure you have met the following requirements:
+
+- [Python 3.10.x](https://www.python.org/downloads/)
+- [Poetry](https://python-poetry.org/docs/#installation)
+
+## Installation & Setup
+
+1. **Clone the repository:**
+
+   ```bash
+   git clone https://github.com/Flow-Glow/Code-Jam-2023-Async-Aggregators.git
+   cd Code-Jam-2023-Async-Aggregators
+    ```
+2. **Install dependencies:**
+    ```bash
+    poetry install
+    ```
+## Running the Project
+
+1. Activate the poetry environment:
+    ```bash
+    poetry shell
+    ```
+2. Run the project:
+    ```bash
+    python main.py
+    ```
+## Selecting Specific Levels
+
+### Level 1 - Ishihara Test
+   ```bash
+   python main.py
+   ```
+### Level 2 - Double Exposure
+   ```bash
+   python main.py 2
+   ```
+### Level 3 - Color Swap
+   ```bash
+   python main.py 3
+   ```
+### Level 4 - Hidden in ASCII
+   ```bash
+   python main.py 4
+   ```
+### Level 5 - Motion
+   ```bash
+   python main.py 5
+   ```
+## Contributing to the Project
+1. Fork the project
+2. Create a new branch (git checkout -b feature/YourFeature).
+3. Commit your changes (git commit -am 'Add some feature').
+4. Push to the branch (git push origin feature/YourFeature).
+5. Open a pull request.
+
+## License
+MIT License
+
+Copyright (c) 2023 Async Aggregators
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Commit History
+https://github.com/Flow-Glow/Code-Jam-2023-Async-Aggregators/assets/89105476/ccb20525-2001-46b5-9272-13eb91ceb908
+
+
+## Contributors:
+```
+Joshua Fleshman(ChronosFU)
+Leo Kim(leo.the.lion)
+Daniel Febles(dfebs)
+Ziv Landau(flowglow)
+Avongard
+Amor Budiyanto (sardines)
+```

async-aggregators/lib/double_exposure/double_exposure.py

@@ -0,0 +1,23 @@
+from PIL import Image
+
+
+def double_exposure(img1: Image, img2: Image, alpha: float = 0.5) -> Image:
+    """
+    Blend two images together using alpha blending
+
+    :param img1: PIL Image
+    :param img2: PIL Image
+    :param alpha: int
+    :return:
+    """
+    # Convert both images to RGB
+    img1 = img1.convert("RGB")
+    img2 = img2.convert("RGB")
+
+    # Resize img2 to match img1's size
+    img2 = img2.resize(img1.size)
+
+    # Blend the images
+    blended = Image.blend(img1, img2, alpha)
+
+    return blended

async-aggregators/lib/double_exposure/test_double_exposure.py

@@ -0,0 +1,67 @@
+import unittest
+
+from PIL import Image
+
+from .double_exposure import double_exposure
+
+
+class DoubleExposureTestCase(unittest.TestCase):
+    """Tests For double_exposure.py"""
+
+    def test_alpha_half(self) -> None:
+        """
+        Test that blending with default alpha=0.5 results in a blend of two images and preserves image size.
+
+        :return: None
+        """
+        # Load two example images
+        image1 = Image.new("RGB", (200, 200), (0, 255, 0))
+        image2 = Image.new("RGB", (200, 200), (255, 0, 0))
+
+        # Call the double_exposure function
+        result_image = double_exposure(image1, image2)
+
+        # Check if the size of the result image matches the input images
+        self.assertEqual(result_image.size, (200, 200))
+
+        # Check if the result image matches a blend of the two images
+        expected_image = Image.new("RGB", (200, 200), (127, 127, 0))
+        self.assertEqual(result_image, expected_image)
+
+    def test_alpha_zero(self) -> None:
+        """
+        Test that blending with alpha=0.0 results in the first image unchanged and preserves image size.
+
+        :return: None
+        """
+        # Create two images with different colors
+        image1 = Image.new("RGB", (200, 200), (255, 0, 0))  # Red
+        image2 = Image.new("RGB", (200, 200), (0, 255, 0))  # Green
+
+        # Blend the images with alpha = 0.0 (result should be the first image)
+        result_image = double_exposure(image1, image2, alpha=0.0)
+
+        # Check if the size of the result image matches the input images
+        self.assertEqual(result_image.size, (200, 200))
+
+        # Check if the result image matches the first image
+        self.assertEqual(result_image, image1)
+
+    def test_alpha_one(self) -> None:
+        """
+        Test that blending with alpha=1.0 results in the second image unchanged and preserves image size.
+
+        :return: None
+        """
+        # Create two images with different colors
+        image1 = Image.new("RGB", (200, 200), (255, 0, 0))  # Red
+        image2 = Image.new("RGB", (200, 200), (0, 255, 0))  # Green
+
+        # Blend the images with alpha = 1.0 (result should be the second image)
+        result_image = double_exposure(image1, image2, alpha=1.0)
+
+        # Check if the size of the result image matches the input images
+        self.assertEqual(result_image.size, (200, 200))
+
+        # Check if the result image matches the second image
+        self.assertEqual(result_image, image2)