Add slack integration for job board (chicagopython#419)

* adds slack integration for job board

* adds logging for failed job posting

* removes print statment

* updates template and adds weekdays parameter to command

* updates to django 2.2.24 for security issue

* adds @ray's feedback

Co-authored-by: Aaron Elmquist <[email protected]>

Author: elmq0022

chipy_org/apps/job_board/forms.py

@@ -29,7 +29,7 @@ class Meta:
         ]
 
         help_texts = {
-            "affiliation": ("Is this posting affiliated with a 3rd party? Please select:"),  # pylint: disable=line-too-long
+            "affiliation": ("Is this posting affiliated with a 3rd party? Please select:"),
         }
 
         widgets = {

chipy_org/apps/job_board/management/commands/post_approved_jobs_to_slack.py

@@ -0,0 +1,56 @@
+import datetime
+import json
+import logging
+
+import requests
+from django.conf import settings
+from django.core.management.base import BaseCommand, CommandError
+from django.template import loader
+
+from chipy_org.apps.job_board.models import JobPost
+
+logger = logging.getLogger(__name__)
+
+
+class Command(BaseCommand):
+    help = """
+    This command retrieves all approved and active job posts from the database
+    and posts them to the slack jobs channel. 
+    
+    Integrate this command with a scheduler to automatically post jobs to the 
+    slack jobs channel.  
+    """
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "weekdays",
+            nargs="+",
+            type=int,
+            help="""
+            The desired weekdays to post represented an integer where Monday=0, Tuesday=1, ... , Saturday=5, and Sunday=6.
+            Posts to the slack channel will only occur on the selected weekdays.
+            """,
+        )
+
+    def handle(self, *args, **options):
+        posts = JobPost.approved_and_active.all()
+
+        if posts.count() and datetime.date.today().weekday() in options["weekdays"]:
+            context = {"posts": posts}
+            template = loader.get_template("job_board/slack_template.txt")
+            msg = template.render(context)
+
+            job_post_key = settings.JOB_POST_KEY
+            webhook_url = f"https://hooks.slack.com/services/{job_post_key}"
+            slack_data = {"text": msg}
+
+            response = requests.post(
+                webhook_url,
+                data=json.dumps(slack_data),
+                headers={"Content-Type": "application/json"},
+            )
+
+            if response.status_code != 200:
+                raise CommandError(
+                    f"Failed to post to slack job channel - status code: {response.status_code}."
+                )

chipy_org/apps/job_board/templates/job_board/slack_template.txt

@@ -0,0 +1,11 @@
+There {{ posts.count|pluralize:"is,are" }} currently *{{ posts.count }}* job{{ posts.count|pluralize }} on the Chipy job board.
+
+{% for post in posts %}
+*{{ post.company_name }}* posted a *{{ post.position }}* opportunity.
+
+*Description*:
+{{ post.description }}
+
+{% endfor %}
+
+See all the open job posts on https://www.chipy.org/job-board/

chipy_org/settings.py

@@ -111,6 +111,10 @@ def env_list(key, defaults=None, delimiter=","):
 else:
     MEDIA_ROOT = os.path.abspath(os.path.join(PROJECT_ROOT, "mediafiles"))
 
+
+JOB_POST_KEY = env_var("JOB_POST_KEY", "")
+
+
 STATIC_ROOT = os.path.abspath(os.path.join(PROJECT_ROOT, "..", "staticfiles"))
 
 STATIC_URL = "/static/"
@@ -124,7 +128,6 @@ def env_list(key, defaults=None, delimiter=","):
 # Make this unique, and don't share it with anybody.
 SECRET_KEY = env_var("SECRET_KEY")
 
-
 ROOT_URLCONF = "chipy_org.urls"
 
 

docker/docker.env.sample

@@ -83,3 +83,7 @@ EMAIL_BACKEND='django.core.mail.backends.console.EmailBackend'
 #AWS_STORAGE_BUCKET_NAME=""
 #
 ################################################
+
+# Slack Webhooks ##########################################
+JOB_POST_KEY=""
+###########################################################

requirements.txt

@@ -14,7 +14,7 @@ django-ical==1.7.0
 django-nocaptcha-recaptcha==0.0.20
 django-storages==1.9.1
 django-tinymce==2.8.0
-Django==2.2.22
+Django==2.2.24
 djangorestframework==3.11.2
 feedparser==5.2.1
 gunicorn==20.0.4