Hey Alan,

Nice job on Tupelo by the way. I do find it a bit bloated though, and 
that's why I never use it. Any reason why all the different namespace are 
still mixed together? Seem like they could each be an independent lib, like 
how the datomic namespace was split out.

On Wednesday, 18 July 2018 13:16:15 UTC-7, Alan Thompson wrote:
>
> There is also a function `glue` 
> <https://github.com/cloojure/tupelo#gluing-together-like-collections> for 
> combining like collections:
>
>
> ---------------------------------------------------------------------------------
> Gluing Together Like Collections
>
> The concat function can sometimes have rather surprising results:
>
> (concat {:a 1} {:b 2} {:c 3} );=>   ( [:a 1] [:b 2] [:c 3] )
>
> In this example, the user probably meant to merge the 3 maps into one. 
> Instead, the three maps were mysteriously converted into length-2 vectors, 
> which were then nested inside another sequence.
>
> The conj function can also surprise the user:
>
> (conj [1 2] [3 4] );=>   [1 2  [3 4] ]
>
> Here the user probably wanted to get [1 2 3 4] back, but instead got a 
> nested vector by mistake.
>
> Instead of having to wonder if the items to be combined will be merged, 
> nested, or converted into another data type, we provide the glue function 
> to *always* combine like collections together into a result collection of 
> the same type:
>
> ; Glue together like collections:
> (is (= (glue [ 1 2] '(3 4) [ 5 6] )       [ 1 2 3 4 5 6 ]  ))   ; all 
> sequential (vectors & lists)
> (is (= (glue {:a 1} {:b 2} {:c 3} )       {:a 1 :c 3 :b 2} ))   ; all maps
> (is (= (glue #{1 2} #{3 4} #{6 5} )      #{ 1 2 6 5 3 4 }  ))   ; all sets
> (is (= (glue "I" " like " \a " nap!" )   "I like a nap!"   ))   ; all text 
> (strings & chars)
> ; If you want to convert to a sorted set or map, just put an empty one first:
> (is (= (glue (sorted-map) {:a 1} {:b 2} {:c 3})   {:a 1 :b 2 :c 3} ))
> (is (= (glue (sorted-set) #{1 2} #{3 4} #{6 5})  #{ 1 2 3 4 5 6  } ))
>
> An Exception will be thrown if the collections to be 'glued' are not all 
> of the same type. The allowable input types are:
>
>    - 
>    
>    all sequential: any mix of lists & vectors (vector result)
>    - 
>    
>    all maps (sorted or not)
>    - 
>    
>    all sets (sorted or not)
>    - 
>    
>    all text: any mix of strings & characters (string result)
>    
>
>
> On Wed, Jul 18, 2018 at 1:13 PM, Alan Thompson <cloo...@gmail.com 
> <javascript:>> wrote:
>
>> As someone mentioned, the functions `prepend` and `append` exist in the 
>> Tupelo library 
>> <https://github.com/cloojure/tupelo#adding-values-to-the-beginning-or-end-of-a-sequence>
>>  
>> to prevent this kind of confusion:
>>
>> from the README:
>>
>> ------------------------------------------------------------------------------------
>> Adding Values to the Beginning or End of a Sequence
>>
>> Clojure has the cons, conj, and concat functions, but it is not obvious 
>> how they should be used to add a new value to the beginning of a vector or 
>> list:
>>
>> ; Add to the end
>> > (concat [1 2] 3)    ;=> IllegalArgumentException
>> > (cons   [1 2] 3)    ;=> IllegalArgumentException
>> > (conj   [1 2] 3)    ;=> [1 2 3]
>> > (conj   [1 2] 3 4)  ;=> [1 2 3 4]
>> > (conj  '(1 2) 3)    ;=> (3 1 2)       ; oops
>> > (conj  '(1 2) 3 4)  ;=> (4 3 1 2)     ; oops
>> ; Add to the beginning
>> > (conj     1  [2 3] ) ;=> ClassCastException
>> > (concat   1  [2 3] ) ;=> IllegalArgumentException
>> > (cons     1  [2 3] ) ;=> (1 2 3)
>> > (cons   1 2  [3 4] ) ;=> ArityException
>> > (cons     1 '(2 3) ) ;=> (1 2 3)
>> > (cons   1 2 '(3 4) ) ;=> ArityException
>>
>> Do you know what conj does when you pass it nil instead of a sequence? 
>> It silently replaces it with an empty list: (conj nil 5) ⇒ (5) This can 
>> cause you to accumulate items in reverse order if you aren’t aware of the 
>> default behavior:
>>
>> (-> nil
>>   (conj 1)
>>   (conj 2)
>>   (conj 3));=> (3 2 1)
>>
>> These failures are irritating and unproductive, and the error messages 
>> don’t make it obvious what went wrong. Instead, use the simple prepend 
>> and append functions to add new elements to the beginning or end of a 
>> sequence, respectively:
>>
>> (append [1 2] 3  )   ;=> [1 2 3  ]
>> (append [1 2] 3 4)   ;=> [1 2 3 4]
>>
>> (prepend   3 [2 1])  ;=> [  3 2 1]
>> (prepend 4 3 [2 1])  ;=> [4 3 2 1]
>>
>> Both <code 
>> style="box-sizing:border-box;font-family:SFMono-Regular,Consolas,"Liberation
>>
>

-- 
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to