An open API service indexing awesome lists of open source software.

https://github.com/shreyammaity/assignmenty

Just Code and Push , Leave The Assignment Part on us....
https://github.com/shreyammaity/assignmenty

actionshackathon21 assignment assignment-builder assignment-management email-sender github-actions student

Last synced: about 2 months ago
JSON representation

Just Code and Push , Leave The Assignment Part on us....

Awesome Lists containing this project

README

          

Assignmenty Bot






Star Badge

----

> Just Code and Push , Leave The Assignment Part on us....Happy Coding >


https://user-images.githubusercontent.com/38105595/143308377-c08db022-9809-4a4d-9cbe-22097399f06b.mp4


- This is a [GitHub Action](https://developer.github.com/actions/) to create your assignment automatically with the help of git version control.

- It takes code and snaps from your latest commit and make it an assignment and send you in mailπŸ“§

- This action runs in a Docker container and therefore only supports Linux🐧

- [Watch Full Config Video Here](https://youtu.be/OWB7oYtS9N8)
-----
## Prep Work

1. Create you coding assignments like or [Watch Config Video Here](https://youtu.be/OWB7oYtS9N8?t=17)
```bash
``` This is Your Question , Write Questions like this```

def code():
this is your code. Just code anything

```
2. Save the code file as `assignment12.py` or `assignment34.py`
> This action currently supports only **Python Code Assignments** 🐍

> but this GitHub Action can me modified for any code based asssignments.Feel free to contribute.πŸ€—
- You can use [this](#usage) example to work it out 🧐
3. create a github repo and clone it, then add a action config (`.yml`) file.Steps are avialable [here](https://youtu.be/OWB7oYtS9N8?t=76) for more info πŸ€”
4. Add a template docx file and name it `tmplate.docx` or use my template and modify it. Check the template [here](./content/template.docx) πŸ“‘
5. save the template file , action config file in your github repo πŸ™
6. Push your code with snaps and Enjoy 😍


-----

## Usage :

The following example [workflow step](https://help.github.com/en/actions/configuring-and-managing-workflows/configuring-a-workflow) will get your latest commit and take the code file and snaps to form a `.docx` based assignment and send you via mail.

- ```yml
name: Assignmenty Mailer
on:
push:
branches:
- main
workflow_dispatch:
jobs:
mailer:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
with:
fetch-depth: 2
- uses: ShreyamMaity/Assignmenty@main
with:
MAILID : 'sample@gmail.com' #mail if of your choice
FILENAME : 'assignment' #assignment file name
```
Just copy the above code and paste it in your `.yml` file
or watch this video to understand how to config.[Watch Config Video Here](https://youtu.be/OWB7oYtS9N8?t=76)

----

## Options βš™οΈ

The following input variable options can/must be configured:

|Input variable|Necessity|Description|
|--------------------|--------|-----------|
|`MAILID`|Required|your mail id where you want to recieve the assignment|
|`FILENAME`|Required|your assignment file name|

----
## Action Config Guide

- ## Dir Methord :
- Create a `.github/workflows` directory in your repository on GitHub if this directory does not already exist.
- In the `.github/workflows` directory, create a file named `mailer.yml`.
- open the `mailer.yml` file and paste this code :
```yml
name: Assignmenty Mailer
on:
push:
branches:
- main
workflow_dispatch:
jobs:
mailer:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
with:
fetch-depth: 2
- uses: ShreyamMaity/Assignmenty@main
with:
MAILID : 'sample@gmail.com' #mail if of your choice
FILENAME : 'assignment' #assignment file name
```
- ## UI Methord :
- go to the `Actions` tab in your github repository
- press `set up a workflow yourself`
- Delete the base code and paste above code
- start commit
- and all set
-----
## Author

The Copy Paste GitHub action is written by [Shreyam Maity](https://github.com/ShreyamMaity)

-----

## License

This project is licensed under the [MIT License](https://opensource.org/licenses/MIT) - see the [LICENSE](LICENSE) file for details.