rewrite-clj-v1-lang-cljs-and-rewrite-clj-v1-lang-clj.adoc

Diff of rewrite-clj 1.0.0-alpha cljs & clj

Diff of apis in:

1. rewrite-clj 1.0.0-alpha cljs

2. rewrite-clj 1.0.0-alpha clj

Options:

Option	Value
:arglists-by	:arity-only
:exclude-namespaces	["rewrite-clj.potemkin.clojure"]
:include	:changed-publics

Legend:

• -A only

• +B only

• -A is+different from B

• ≠changes within A and B

• =equal

Stats:

Element	Have changes within	In A Only	In B Only
namespaces	5	0	5
publics	0	1	38
arglists	0	1	49

Notes:

The cljs and clj sides of rewrite-clj v1 have the following differences of note:

1. You’ll notice that the Clojure API has the ability to deal with files, the ClojureScript API does not.

2. If we were to exclude api namespaces and functions marked with no-doc we would see only item 1 as differences. We include them because it seems that historically, internal undocumented features have been used in rewrite-cljs and rewrite-clj.

3. The ClojureScript API is missing the Clojure API namespaces that cause namespace clashes on the clojurescript side.

Table of diffs:

• ≠ rewrite-clj.node.protocols
  • +make-printable-clj!
  • -make-printable-cljs!
  • +write-node
• + rewrite-clj.node.string
  • +string-node
• ≠ rewrite-clj.parser
  • +parse-file
  • +parse-file-all
• ≠ rewrite-clj.reader
  • +file-reader
  • +newline-normalizing-reader
• ≠ rewrite-clj.zip
  • +of-file
• ≠ rewrite-clj.zip.base
  • +of-file
• + rewrite-clj.zip.edit
  • +edit
  • +prefix
  • +replace
  • +splice
  • +suffix
• + rewrite-clj.zip.find
  • +find
  • +find-depth-first
  • +find-last-by-pos
  • +find-next
  • +find-next-depth-first
  • +find-next-tag
  • +find-next-token
  • +find-next-value
  • +find-tag
  • +find-tag-by-pos
  • +find-token
  • +find-value
• + rewrite-clj.zip.remove
  • +remove
  • +remove-preserve-newline
• + rewrite-clj.zip.seq
  • +assoc
  • +get
  • +list?
  • +map
  • +map-keys
  • +map-vals
  • +map?
  • +seq?
  • +set?
  • +vector?

≠ rewrite-clj.node.protocols

• :no-doc = true

+make-printable-clj!

arglists	attributes
**` [green]#[# [green]`+class ]	:type **` [green]`:macro+

-make-printable-cljs!

arglists	attributes
- [ obj ]	:type - :var :no-doc - true

+write-node

arglists	attributes
**` [green]#[# [green]`+writer node ]	:type **` [green]`:var+

+ rewrite-clj.node.string

• :no-doc = true

+string-node

arglists	attributes
**` [green]#[# [green]`+lines ]	:type **` [green]`:var+

≠ rewrite-clj.parser

+parse-file

arglists	attributes
**` [green]#[# [green]`+f ]	:type **` [green]`:var+

+parse-file-all

arglists	attributes
**` [green]#[# [green]`+f ]	:type **` [green]`:var+

≠ rewrite-clj.reader

• :no-doc = true

+file-reader

arglists	attributes
**` [green]#[# [green]`+f ]	:type **` [green]`:var+

+newline-normalizing-reader

arglists	attributes
**` [green]#[# [green]`+rdr ]	:type **` [green]`:var+

≠ rewrite-clj.zip

+of-file

arglists	attributes
**` [green]#[# [green]`+f ] **` [green]#[# [green]`+f opts ]	:type **` [green]`:var+

≠ rewrite-clj.zip.base

• :no-doc = true

+of-file

arglists	attributes
**` [green]#[# [green]`+f ] **` [green]#[# [green]`+f opts ]	:type **` [green]`:var+

+ rewrite-clj.zip.edit

• :no-doc = true

+edit

arglists	attributes
**` [green]#[# [green]`+zloc f & args ]	:type **` [green]`:var+

+prefix

arglists	attributes
**` [green]#[# [green]`+zloc s ]	:type **` [green]`:var+

+replace

arglists	attributes
**` [green]#[# [green]`+zloc value ]	:type **` [green]`:var+

+splice

arglists	attributes
**` [green]#[# [green]`+zloc ]	:type **` [green]`:var+

+suffix

arglists	attributes
**` [green]#[# [green]`+zloc s ]	:type **` [green]`:var+

+ rewrite-clj.zip.find

• :no-doc = true

+find

arglists	attributes
**` [green]#[# [green]`+zloc p? ] **` [green]#[# [green]`+zloc f p? ]	:type **` [green]`:var+

+find-depth-first

arglists	attributes
**` [green]#[# [green]`+zloc p? ]	:type **` [green]`:var+

+find-last-by-pos

arglists	attributes
**` [green]#[# [green]`+zloc pos ] **` [green]#[# [green]`+zloc pos p? ]	:type **` [green]`:var+

+find-next

arglists	attributes
**` [green]#[# [green]`+zloc p? ] **` [green]#[# [green]`+zloc f p? ]	:type **` [green]`:var+

+find-next-depth-first

arglists	attributes
**` [green]#[# [green]`+zloc p? ]	:type **` [green]`:var+

+find-next-tag

arglists	attributes
**` [green]#[# [green]`+zloc t ] **` [green]#[# [green]`+zloc f t ]	:type **` [green]`:var+

+find-next-token

arglists	attributes
**` [green]#[# [green]`+zloc p? ] **` [green]#[# [green]`+zloc f p? ]	:type **` [green]`:var+

+find-next-value

arglists	attributes
**` [green]#[# [green]`+zloc v ] **` [green]#[# [green]`+zloc f v ]	:type **` [green]`:var+

+find-tag

arglists	attributes
**` [green]#[# [green]`+zloc t ] **` [green]#[# [green]`+zloc f t ]	:type **` [green]`:var+

+find-tag-by-pos

arglists	attributes
**` [green]#[# [green]`+zloc pos t ]	:type **` [green]`:var+

+find-token

arglists	attributes
**` [green]#[# [green]`+zloc p? ] **` [green]#[# [green]`+zloc f p? ]	:type **` [green]`:var+

+find-value

arglists	attributes
**` [green]#[# [green]`+zloc v ] **` [green]#[# [green]`+zloc f v ]	:type **` [green]`:var+

+ rewrite-clj.zip.remove

• :no-doc = true

+remove

arglists	attributes
**` [green]#[# [green]`+zloc ]	:type **` [green]`:var+

+remove-preserve-newline

arglists	attributes
**` [green]#[# [green]`+zloc ]	:type **` [green]`:var+

+ rewrite-clj.zip.seq

• :no-doc = true

+assoc

arglists	attributes
**` [green]#[# [green]`+zloc k v ]	:type **` [green]`:var+

+get

arglists	attributes
**` [green]#[# [green]`+zloc k ]	:type **` [green]`:var+

+list?

arglists	attributes
**` [green]#[# [green]`+zloc ]	:type **` [green]`:var+

+map

arglists	attributes
**` [green]#[# [green]`+f zloc ]	:type **` [green]`:var+

+map-keys

arglists	attributes
**` [green]#[# [green]`+f zloc ]	:type **` [green]`:var+

+map-vals

arglists	attributes
**` [green]#[# [green]`+f zloc ]	:type **` [green]`:var+

+map?

arglists	attributes
**` [green]#[# [green]`+zloc ]	:type **` [green]`:var+

+seq?

arglists	attributes
**` [green]#[# [green]`+zloc ]	:type **` [green]`:var+

+set?

arglists	attributes
**` [green]#[# [green]`+zloc ]	:type **` [green]`:var+

+vector?

arglists	attributes
**` [green]#[# [green]`+zloc ]	:type **` [green]`:var+