Skip to content

Commit 4edaa58

Browse files
committedJan 12, 2018
README: added basic description
1 parent 0bc5ce0 commit 4edaa58

File tree

1 file changed

+46
-0
lines changed

1 file changed

+46
-0
lines changed
 

‎README.rst

+46
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
DirSON
2+
======
3+
4+
Encode and decode JSON files as directory structure in Git.
5+
6+
Installation
7+
------------
8+
9+
Clone this repository and run pip:
10+
11+
.. code-block:: console
12+
13+
$ pip install -e .
14+
15+
Move to a repository where you would like to filter JSON files and
16+
add following lines to files:
17+
18+
``.git/config``
19+
20+
.. code-block::
21+
22+
[filter "dirson"]
23+
smudge = "dirson smudge"
24+
clean = "dirson clean"
25+
required
26+
27+
``.gitattributes``
28+
29+
.. code-block::
30+
31+
\*.json filter=dirson
32+
33+
34+
Pointer file format
35+
-------------------
36+
37+
Git DirSON's pointer file looks like this:
38+
39+
.. code-block::
40+
41+
version https://raw.githubusercontent.com/jirikuncar/dirson/v1/spec
42+
oid sha1:2f769492d6b634b86b82e916630da8a693e9c20e
43+
size 12345
44+
45+
It tracks the version of Git DirJSON you're using, followed by a unique identifier
46+
for the JSON file (oid). It also stores the size of the target JSON file.

0 commit comments

Comments
 (0)
Please sign in to comment.