New release 0.1.0 (#197)

Author: Grazfather

.circleci/config.yml

@@ -0,0 +1,55 @@
+# Python CircleCI 2.0 configuration file
+#
+# Check https://circleci.com/docs/2.0/language-python/ for more details
+#
+version: 2
+jobs:
+  build:
+    docker:
+      - image: circleci/python:3.6.1
+
+      # Specify service dependencies here if necessary
+      # CircleCI maintains a library of pre-built images
+      # documented at https://circleci.com/docs/2.0/circleci-images/
+      # - image: circleci/postgres:9.4
+
+    working_directory: ~/repo
+
+    steps:
+      - checkout
+
+      # Download and cache dependencies
+      - restore_cache:
+          keys:
+            - v1-dependencies-{{ checksum "requirements.txt" }}
+            # fallback to using the latest cache if no exact match is found
+            - v1-dependencies-
+
+      - run:
+          name: install dependencies
+          command: |
+            python3 -m venv venv
+            . venv/bin/activate
+            pip install -r requirements.txt
+
+      - save_cache:
+          paths:
+            - ./venv
+          key: v1-dependencies-{{ checksum "requirements.txt" }}
+
+      - run:
+          name: run tests
+          command: |
+            . venv/bin/activate
+            python runtests.py
+
+      - run:
+          name: lint
+          command: |
+            . venv/bin/activate
+            pylint **/*.py -E
+            pylint **/*.py --exit-zero
+
+      - store_artifacts:
+          path: test-reports
+          destination: test-reports

.dockerignore

@@ -0,0 +1,2 @@
+.git
+.venv

.gitignore

@@ -1,5 +1,6 @@
 *.pyc
 config.json
+config_savelink.json
 config_solvetracker.json
 *.bin
 *.log

CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+All notable changes to this project will be kept in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## [0.1.0] - 2019-09-10
+Initial release

Dockerfile

@@ -1,10 +1,14 @@
 FROM python:3
 
-# Bundle app source
-COPY . /src/
-WORKDIR /src/
+WORKDIR /src
+
+# Copy requirements
+COPY ./requirements.txt /src
 
 # Install requirements
 RUN pip install --no-cache-dir -r requirements.txt
 
+# Copy rest of source
+COPY . /src
+
 CMD ["python", "run.py"]

Makefile

@@ -1,13 +1,28 @@
 PWD = $(shell pwd)
 
-image:
+build:
 	docker build . -t otabot
 
-lint:
+image:
+	docker images | grep otabot || docker build . -t otabot
+
+lint: image
 	docker run --rm -v ${PWD}/:/src/ otabot pylint **/*.py -E
 
-run: image
+checklint: image
+	docker run --rm -v ${PWD}/:/src/ otabot pylint **/*.py --exit-zero
+
+run: build
 	docker run --rm -it otabot
 
-runlocal:
+runlocal: image
 	docker run --rm -it -v ${PWD}/:/src/ otabot
+
+test:
+	docker run --rm -v ${PWD}/:/src/ otabot python3 runtests.py
+
+background: image
+	docker run --rm -d --name otabot otabot
+
+stop:
+	docker stop otabot

README.md

@@ -108,3 +108,48 @@ Example:
 3. Update the templates in `templates` according to your preferences (or go with the default ones).
 4. Make sure that there's a `_posts` and `_stats` folder in your git repository.
 4. You should be good to go now and git support should be active on the next startup. You can now use the `postsolves` command to push blog posts with the current solve status to git.
+
+
+## Using Link saver
+
+1. Setup a github repo with jekyll and staticman (e.g. https://github.com/ujjwal96/links).
+2. Copy `config_savelink.json.template` to `config_savelink.json`.
+3. Configure the git repo and branch to be used.
+4. Add the decrypted staticman-token used in `staticman.yml` in the config.
+5. Add a link to your repo, so people can look it up via `showlinkurl`
+
+Example:
+```
+{
+    "git_repo": "reponame/links",
+    "git_branch": "gh-pages",
+    "staticman-token": "9d837771-945a-489d-cd80-13abcdefa112",
+    "allowed_users": [],
+    "repo_link_url": "https://reponame.github.io/links/"
+}
+```
+
+## Archive reminder
+
+To enable archive reminders set an offset (in hours) in `config.json` for `archive_ctf_reminder_offset`. Clear or remove the setting to disable reminder handling.
+
+If active, the bot will create a reminder for every bot admin on `!endctf` to inform him, when the ctf was finished for the specified time and it should be archived.
+
+Example (for being reminded one week after the ctf has finished):
+```
+{
+    ...
+    "archive_ctf_reminder_offset" : "168"
+}
+```
+
+## Log command deletion
+
+To enable logging of deleting messages containing specific keywords, set `delete_watch_keywords` in `config.json` to a comma separated list of keywords. 
+Clear or remove the setting to disable deletion logging.
+
+Example
+```
+{
+    "delete_watch_keywords" : "workon, reload, endctf"
+}

addons/syscalls/syscallinfo.py

@@ -11,7 +11,7 @@ def __init__(self, filename):
 
         self.parse_table(filename)
 
-    def getEntryDict(self, parts, identifiers):
+    def get_entry_dict(self, parts, identifiers):
         entry = collections.OrderedDict()
 
         for i in range(len(parts)):
@@ -33,23 +33,20 @@ def parse_table(self, filename):
 
         for line in lines[1:]:
             parts = line.split("\t")
-            self.entries[parts[1]] = self.getEntryDict(
+            self.entries[parts[1]] = self.get_entry_dict(
                 line.split("\t"), identifiers)
 
-    def getEntryByID(self, idx):
+    def get_entry_by_id(self, idx):
         for entry in self.entries:
             if self.entries[entry]["#"] == str(idx):
                 return self.entries[entry]
 
         return None
 
-    def getEntryByName(self, name):
-        if name in self.entries:
-            return self.entries[name]
+    def get_entry_by_name(self, name):
+        return self.entries.get(name)
 
-        return None
-
-    def getInfoMessage(self, entry):
+    def get_info_message(self, entry):
         if entry:
             msg = ""
 
@@ -60,13 +57,13 @@ def getInfoMessage(self, entry):
 
         return None
 
-    def getInfoMessageByID(self, idx):
-        entry = self.getEntryByID(idx)
-        return self.getInfoMessage(entry)
+    def get_info_message_by_id(self, idx):
+        entry = self.get_entry_by_id(idx)
+        return self.get_info_message(entry)
 
-    def getInfoMessageByName(self, name):
-        entry = self.getEntryByName(name)
-        return self.getInfoMessage(entry)
+    def get_info_message_by_name(self, name):
+        entry = self.get_entry_by_name(name)
+        return self.get_info_message(entry)
 
 
 class SyscallInfo:
@@ -79,10 +76,10 @@ def __init__(self, basedir):
 
             self.tables[table] = SyscallTable(filename)
 
-    def getAvailableArchitectures(self):
+    def get_available_architectures(self):
         return self.tables.keys()
 
-    def getArch(self, arch):
+    def get_arch(self, arch):
         if arch in self.tables:
             return self.tables[arch]
 

bottypes/challenge.py

@@ -5,8 +5,10 @@ class Challenge:
     def __init__(self, ctf_channel_id, channel_id, name, category):
         """
         An object representation of an ongoing challenge.
+        ctf_channel_id : The slack id for the associated parent ctf channel
         channel_id : The slack id for the associated channel
         name : The name of the challenge
+        category : The category of the challenge
         """
 
         self.channel_id = channel_id

bottypes/command.py

@@ -1,10 +1,12 @@
-from abc import ABC, abstractmethod
+from abc import ABC
 
 
 class Command(ABC):
     """Defines the command interface."""
 
-    def __init__(self): pass
+    def __init__(self):
+        pass
 
     @classmethod
-    def execute(cls, slack_client, args, channel_id, user, user_is_admin): pass
+    def execute(cls, slack_wrapper, args, timestamp, channel_id, user_id, user_is_admin):
+        pass