Many hyperlinks are disabled.
Use anonymous login
to enable hyperlinks.
| Artifact ID: | 8be649c094fa2d7efc9d6430afc6abcfba708ce7 |
|---|---|
| Page Name: | home |
| Date: | 2013-07-28 18:38:45 |
| Original User: | stephan |
| Parent: | ca7965ebfc70d7c16ce14569771e467ae3074a1a (diff) |
| Next | e5fd65139274e0851e71bb31224c4079fb45a4db |
Fossil v2 Scratchpad
See also: download
This source code repository houses experimentation for a potential library API for the Fossil SCM. The primary goal is to port existing behaviour into a library form (the v1 app is extremely monolithic in nature). While it has been informally dubbed "v2", so far no format-breaking changes are planned so it might turn out to provide an alternative to fossil v1, as opposed to a replacement.
This code currently doesn't do much - it is intended for those interested in following or participating in the design of Fossil v2. All current Fossil committers (those who have a signed a license waiver on file with DRH) are welcomed contributors - email me your preferred user name to get access: sgbeal@googlemail.com.
[stephan@host:~/cvs/fossil/f2/th1ish]$ ./th1ish -f test-001.th1ish -- -c -r=../../whio.fsl This script's name: test-001.th1ish ==canonical==> /home/stephan/cvs/fossil/f2/th1ish/test-001.th1ish test-001.th1ish:38:15 Repo db: Db@AA7D70 test-001.th1ish:41:11 f = FossilContext@A8B200 test-001.th1ish:50:19 Db details: repo Db@AA7D70 Opened repo: /home/stephan/cvs/fossil/whio.fsl Size of repo: 3922944 mtime of repo: Sun Jul 28 10:49:41 2013 test-001.th1ish:50:19 Db details: checkout Db@AA86F0 Opened repo: /home/stephan/cvs/fossil/f2/.fslckout Size of repo: 136192 mtime of repo: Sun Jul 28 16:47:25 2013 ...
Status, TODOs, and Whatnot
All of this code is an experiment, and it does not represent a commitment by anyone that any of this code wll some day end up living under the umbrella of the larger Fossil SCM project. If all goes well, that's the eventual goal, though. It is pre-alpha quality. What's there works but there is still a a great deal of the SCM-specific infrastructure left to port in and refactor to make it usable via library-style interfaces. Anyone looking for a timeline is asked respectfully to look elsewhere - there is no timebox on nor schedule for this project/experiment.
TODOs... you might want to get a coffee/tee/beer before starting through the list.
"Rules" for Code Contributors
- All code contributors must have a license waiver on file with DRH, as the hope is to eventually release this code as the next generation of Fossil. Non-code contributions are happily accepted from anyone.
- When working on bits which themselves write to the repository, e.g. creating checkins, please be exceedingly careful not to corrupt the db :-D.
- Please try to conform to the overall coding style (as laid out by Fossil v1).
- Don't bother using branches unless you really want to - the trunk has no stability guarantees and is very much in flux, so feel free to work there instead of a branch.
- There is nothing holy or sacred about this repo, so feel free to experiment.
Aside from that: hack at will. Generally the quickest/most complete way to test changes it to add them to the th1ish script bindings (in shell_extend.c). If you prefer writing C-level tests, please add them to test.c in the top-level directory.
News
Notable changes...
- 20130728: it can now search for and open a checkout based on a directory name, analog to how v1 finds an open checkout.
- 20130727: started work on a th1ish script engine binding for v2. It is of course a work-in-progress but it is extended in parallel to the core lib because that simplifies testing and helps work the kinks out of the core API.
- 20130726: when opening a repo db, the library now validates that it is a repo db, and can distinguish between/report various types of errors, e.g. repo schema is out of data or the db is not a fossil repo.
- 20130725: removed the per-instance allocator configuration - it is now library-wide. This simplified buffer usage and makes it legal to use them before instantiating a fossil context.