greatbody
/
logseq
mirror of https://github.com/logseq/logseq
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
logseq/deps/graph-parser
History
Gabriel Horner e2fe300da7 Move delete-blocks-fn to graph-parser for reuse for nbb 
Also:
- Move test to a more appropriate ns - model-test isn't for testing
  higher level parse file behavior
- Delete model fns that are no longer used
- Fix tests which had incorrect target-page-content and were no longer
  testing retractAttribute
- Add options to cli ns for related nbb reuse
- Light cleanup of block deletion
 		2022-11-26 01:01:36 -05:00
..
.carve Move delete-blocks-fn to graph-parser for reuse for nbb 2022-11-26 01:01:36 -05:00
.clj-kondo Bump to latest kondo and enable new aliased-namespace-symbol linter 2022-10-19 21:24:54 +08:00
src/logseq Move delete-blocks-fn to graph-parser for reuse for nbb 2022-11-26 01:01:36 -05:00
test/logseq Move delete-blocks-fn to graph-parser for reuse for nbb 2022-11-26 01:01:36 -05:00
.gitignore Setup cljs tests for graph-parser 2022-05-26 18:04:45 -04:00
README.md Add 3 missing built-in-properties 2022-07-15 15:26:09 +08:00
bb.edn Add ns linter to deps libs and then add+update ns docstrings 2022-09-21 10:17:15 +08:00
deps.edn Bump to latest kondo and enable new aliased-namespace-symbol linter 2022-10-19 21:24:54 +08:00
package.json fix: CI 2022-09-09 14:13:35 +08:00
yarn.lock fix: CI 2022-09-09 14:13:35 +08:00

README.md

Description

This library parses a logseq graph directory and returns it as a datascript database connection. This library powers the Logseq app and also runs from the commandline, independent of the app. This is powerful as this can run anywhere that a Node.js script has access to a Logseq graph e.g. on CI processes like Github Actions. This library is compatible with ClojureScript and with nbb-logseq to respectively provide frontend and commandline functionality.

API

This library is under the parent namespace logseq.graph-parser. This library provides two main namespaces for parsing, logseq.graph-parser and logseq.graph-parser.cli. logseq.graph-parser/parse-file is the main fn for the frontend. logseq.graph-parser.cli/parse-graph is the main fn for node.js CLIs.

Usage

See logseq.graph-parser.cli-test for now. A real world example is coming soon.

Dev

This follows the practices that the Logseq frontend follows. Most of the same linters are used, with configurations that are specific to this library. See this library's CI file for linting examples.

Setup

To run linters and tests, you'll want to install yarn dependencies once:

yarn install

This step is not needed if you're just running the application.

Testing

Since this file is compatible with cljs and nbb-logseq, tests are run against both languages.

ClojureScript tests use https://github.com/Olical/cljs-test-runner. To run tests:

clojure -M:test

To see available options that can run specific tests or namespaces: clojure -M:test --help

To run nbb-logseq tests:

yarn test

Managing dependencies

The package.json dependencies are just for testing and should be updated if there is new behavior to test.

The deps.edn dependecies are used by both ClojureScript and nbb-logseq. Their versions should be backwards compatible with each other with priority given to the frontend. No new dependency should be introduced to this library without an understanding of the tradeoffs of adding this to nbb-logseq.