Hints for insert/3 added.

2 files changed, 88 insertions, 14 deletions

diff --git a/prolog/problems/lists/insert_3/common.py b/prolog/problems/lists/insert_3/common.py
index 5b049f7..3b56cf3 100644
--- a/prolog/problems/lists/insert_3/common.py
+++ b/prolog/problems/lists/insert_3/common.py
@@ -26,10 +26,11 @@ hint_type = {
     'predicate_always_false': Hint('predicate_always_false'),
     'base_case': Hint('base_case'),
     'timeout': Hint('timeout'),
-    'del_from_empty_list_success': Hint('del_from_empty_list_success'),
     'lost_heads': Hint('lost_heads'),
     'recursive_case': Hint('recursive_case'),
     'leading_heads_all_x': Hint('leading_heads_all_x'),
+    'ins_results_in_empty_list': Hint('ins_results_in_empty_list'),
+    'ins_results_in_arbitrary_result': Hint('ins_results_in_arbitrary_result'),
 }
 
 test_cases = [
@@ -77,34 +78,35 @@ def hint(code, aux_code):
         # recursion is getting bigger and bigger
 
 
-        # deleting from empty list succeeds with an emtpy list result
-        if prolog.engine.ask_truthTO(engine_id, 'del(_, [], _)'):
-            return [{'id': 'del_from_empty_list_success'}]
+        # inserting an element succeeds with an emtpy list result
+        if prolog.engine.ask_truthTO(engine_id, 'insert(_, _, [])'):
+            return [{'id': 'ins_results_in_empty_list'}]
+
+        # inserting an element succeeds with an arbitrary result
+        if prolog.engine.ask_truth(engine_id, 'insert(_, _, L), var(L)'):
+            return [{'id': 'ins_results_in_arbitrary_result'}]
 
         # missing/failed base case
-        if not prolog.engine.ask_one(engine_id, 'del(qQ, [qQ,qa,qb,qc], [qa,qb,qc])'):
+        if not prolog.engine.ask_one(engine_id, 'insert(qQ, [qa,qb,qc], [qQ,qa,qb,qc])'):
             return [{'id': 'base_case'}]
 
         # target predicate seems to always be false
-        if not prolog.engine.ask_truth(engine_id, 'del(_, [_,_,_,_,_,_], _)'):
+        if not prolog.engine.ask_truth(engine_id, 'insert(_, [_,_,_,_,_,_], _)'):
             return [{'id': 'predicate_always_false'}]
 
         # forgot to put list head(s) back in the list when deleting an element
-        if prolog.engine.ask_truth(engine_id, 'del(q, [a,b,c,d,q,x,y,z], [x,y,z])'):
+        if prolog.engine.ask_truth(engine_id, 'insert(q, [a,b,c,d,x,y,z], [q,x,y,z])'):
             return [{'id': 'lost_heads'}]
 
         # used [X|T] instead of more general [H|T] in recursive case
         if prolog.engine.ask_truth(engine_id, \
-                'findall(NL, del(q, [q,q,q,a,b,c], NL), [[q,q,a,b,c],[q,q,a,b,c],[q,q,a,b,c]]).') and \
-           not prolog.engine.ask_truth(engine_id, 'del(q, [a,b,c,q,x,y,z], [a,b,c,x,y,z])'):
+                'findall(NL, insert(q, [a,b,c], NL), [[q,a,b,c], [q,q,b,c], [q,q,q,c], [q,q,q,q]]).') and \
+           not prolog.engine.ask_truth(engine_id, 'insert(q, [a,b,c,x,y,z], [a,b,c,q,x,y,z])'):
             return [{'id': 'leading_heads_all_x'}]
 
-        # L=[H|T] at the end of the rule; this can be detected with test cases and can be wrong (in some sense)
-        # TODO: implement it, and provide a good explanation (might be hard)
-
         # base case works, the recursive doesn't (but it doesn't timeout)
         # this may be left as the last, most generic hint
-        if not prolog.engine.ask_truth(engine_id, 'del(qQ, [qa,qb,qQ,qc], [qa,qb,qc])'):
+        if not prolog.engine.ask_truth(engine_id, 'insert(qQ, [qa,qb,qc], [qa,qb,qQ,qc])'):
             return [{'id': 'recursive_case'}]
 
 
diff --git a/prolog/problems/lists/insert_3/sl.py b/prolog/problems/lists/insert_3/sl.py
index 7db15a6..e0d7d95 100644
--- a/prolog/problems/lists/insert_3/sl.py
+++ b/prolog/problems/lists/insert_3/sl.py
@@ -12,4 +12,76 @@ description = '''\
   L = [2,3,1].
 </pre>'''
 
-hint = {}
+plan = ['''
+<p>Kam v seznam lahko vstavimo element <code>X</code>? Spomni se, da ima seznam dva dela, glavo in rep.
+Torej sta možnosti dve! Tako je, na tem mestu dve, v repu pa spet lahko vstavimo ali v njegovo glavo ali v rep od repa.
+In tako dalje, rekurzija na pomoč!</p>
+''', '''\
+<p>Kaj je najenostavnejša možnost? Vstavimo na začetek!</p>
+''', '''\
+<p>Kako vstavim nekam v rep? Seznam razbijem na glavo in rep, rekurzivno (problem je za en element manjši!)
+vstavim v rep in ob vračanju iz rekurzije ne pozabim na prej "odtrgano" glavo.</p>
+''', '''\
+<p>Rekurzivni korak: če predpostavim, da je <code>NewTail</code> rep z že vstavljenim elementom <code>X</code>,
+potem je <code>[H|NewTail]</code> celoten seznam z vstavljenim elementom <code>X</code>.</p>
+''']
+
+hint = {
+    'eq_instead_of_equ': '''\
+<p>Operator <code>==</code> je strožji od operatorja <code>=</code> v smislu, da je za slednjega dovolj,
+da elementa lahko naredi enaka (unifikacija). Morda z uporabo <code>=</code> narediš predikat
+<code>insert/3</code> delujoč tudi v kakšni drugi smeri. To bo kasneje znalo priti prav!</p>
+<p>Seveda pa lahko nalogo rešiš brez obeh omenjenih operatorjev, spomni se, da lahko unifikacijo narediš
+implicitno že kar v argumentih predikata (glavi stavka).</p>
+''',
+
+    'eq_instead_of_equ_markup': '''\
+<p>Morda bi bil bolj primeren operator za unifikacijo (=)?</p>
+''',
+
+    'base_case': '''\
+<p>Si pomislil na robni pogoj? Na katero mesto v seznamu najlažje vstaviš nek element?</p>
+''',
+
+    'recursive_case': '''\
+<p>Robni primer deluje. Kaj pa rekurzivni, splošni, primer?</p>
+''',
+
+    'predicate_always_false': '''\
+<p>Vse kaže, da tvoj predikat vedno vrne "false". Si mu dal pravilno ime, si se morda pri imenu zatipkal?</p>
+<p>Če je ime pravilno, se morda splača preveriti tudi, če se nisi zatipkal kje drugje,
+je morda kakšna pika namesto vejice ali obratno, morda kakšna spremenljivka z malo začetnico?</p>
+<p>Možno je seveda tudi, da so tvoji pogoji prestrogi ali celo nemogoči (kot bi bila npr. zahteva,
+da je <code>X</code> hkrati starš in sestra od <code>Y</code> ali kaj podobno zlobnega).</p>
+''',
+
+    'timeout': '''\
+<p>Je morda na delu potencialno neskončna rekurzija? Kako se bo ustavila?</p>
+<p>Morda pa je kriv tudi manjkajoč, neustrezen ali preprosto nekompatibilen (s splošnim primerom) robni pogoj?</p>
+''',
+
+    'ins_results_in_empty_list': '''\
+<p>Kako je lahko rezultat vstavljanja v seznam prazen seznam?</p>
+<p>Če je to tvoj robni pogoj, ga še enkrat premisli: kaj je rezultat vstavljanja?</p>
+''',
+
+    'ins_results_in_arbitrary_result': '''\
+<p>Kako je lahko rezultat vstavljanja v seznam poljuben seznam oz. karkoli?</p>
+<p>Če je to tvoj robni pogoj, ga še enkrat premisli: kaj je rezultat vstavljanja?</p>
+''',
+
+    'lost_heads': '''\
+<p>Element je vstavljen, ampak vsi pred njim so se pa izgubili, kajne?
+Si pozabil dati glavo nazaj na začetek seznama, ko se vračaš iz rekurzije?</p>
+<p>Poskusi postaviti naslednje vprašanje prologu in preglej <emph>vse</emph> rešitve:</p>
+<p><code>?- insert(q, [a,b,c,d], L).</code></p>
+''',
+
+    'leading_heads_all_x': '''\
+<p>Si morda pozabil (copy/paste?) in uporabil <code>[X|T]</code> namesto bolj splošnega
+<code>[H|T]</code> v rekurzivnem primeru?</p>
+<p>Od spodnjih dveh vprašanj prologu prvo deluje, drugo pa ne.</p>
+<p><code>?- insert(d, [d,d,d,d,e,f,g], L).</code></p>
+<p><code>?- insert(d, [a,b,c,d,e,f,g], L).</code></p>
+''',
+}