Setup for development

• Install clojure.

Contributing

1. Fork it
2. Clone repo (https://github.com/{your-nickname}/battle_asserts.git)
3. Create your feature branch (git checkout -b my-new-feature)
4. Make changes
5. Run tests (make test)
6. Run linters (make checks)
7. Commit your changes (git commit -am 'Added some feature')
8. Push to the branch (git push origin my-new-feature)
9. Create new Pull Request
10. Check if Request passed GithubActions
11. Wait, until PR is reviewed

How to add a new issue

1. Write the description of the issue with function signature and test-data

A description of the issue includes:

• level — difficulty of the problem; possible values are elementary, easy, medium, hard.
• description — detailed description of the issue. Now supported laguages is ru and en, en is required. You can run make check-translations for list current translation progress.
• tags — tags that provides addittional info about task, array of strings.
• signature — function signature; map with input and output types. Available types integer, float, string, array, hash (map, dicts). See examples in the existing issues.
• test-data — data in a specified format which will be used to test solutions. The first element in this list will be displayed as an example to players, so it should clarify and illustrate the problem as much as possible. Do not choose a trivial case for this example.

Example:

(ns battle-asserts.issues.array_sum)

(def level :elementary)

(def tags ["training" "collections"])

(def description 
  {:en "Calculate the sum of array." :ru "Рассчитайте сумму всех чисел в массиве."})

(def signature
  {:input  [{:argument-name "numbers" :type {:name "arr" :nested {:name "integer"}}}]
   :output {:type {:name "integer"}}})

(def test-data
  [{:expected 1 :arguments [[1]]}
   {:expected 0 :arguments [[]]}
   {:expected 10 :arguments [[1 2 3 4]]}])

See examples in src/battle_asserts/issues/*.clj

2. Write the implementation of the issue and test

An implementation of the issue includes:

• arguments-generator — arguments generator for the solution function; generated arguments will be used to test players' solutions.
• solution — implemented correct solution. Example:

(ns battle-asserts.issues.array_sum)

(def level :elementary)

(def tags ["training" "collections"])

(def description 
  {:en "Calculate the sum of array." :ru "Рассчитайте сумму всех чисел в массиве."})

(def signature
  {:input  [{:argument-name "numbers" :type {:name "arr" :nested {:name "integer"}}}]
   :output {:type {:name "integer"}}})

(def test-data
  [{:expected 1 :arguments [[1]]}
   {:expected 0 :arguments [[]]}
   {:expected 10 :arguments [[1 2 3 4]]}])

(defn arguments-generator []
  (gen/tuple (gen/list gen/small-integer))

(defn solution [numbers]
  (apply + numbers))

Corresponding tests are in test/test_helper.clj there is no need to add tests to this file, because tests runs dynamically, depending on the described signature, test-data, arguments-generator and solution.

• run-solution-spec-test tests are checking that result type of solving issue is correct.
• run-generator-spec-test tests are checking that input signatures are correctly described for arguments-generator.
• run-solution-test tests are checking that test data solves correctly.
• run-test-data-spec-test tests are checking that test data corresponds to signature.
• run-description-test tests are checking that issue has minimal description.
• run-difficulty-test tests are checking that issue has correct difficulty level.

3. Create pull-request

It will appear with auto-generated asserts on codebattle after merge .

Useful commands

• make check-translations check current tasks translation progress.
• make check-tags check current tasks tagging progress.
• make check-generators-and-solutions check current tasks solution and arguments-generator progress.
• make collect-tags check tags stats, useful to check typo in tags.
• make collect-disabled check task disabled status.

Related links

Clojure

• https://clojure.org/index
• https://clojure.org/guides/getting_started
• https://ru.code-basics.com/languages/clojure (currently, only in russian)

Better clojure dev experience

• https://www.gnu.org/software/emacs/ or https://www.spacemacs.org/
• https://clojure.org/guides/repl/annex_community_resources