Getting Started¶
Installation¶
Manifest checker can be installed using pip :
The cataloger tool and APIs are compatible with both Python 2 (2.7 and later) and Python 3 (3.5 and later)
Simple Usage¶
Using the cataloger command line tool with the default arguments is easy :
To create the manifest
$ cd <tree root>
$ catalog create
This will create a catalog.cat - detailing all the source code files in the current directory tree, with a sha224 hash created for each file. You can then deploy/copy your source code to the destination and execute
$ cd <tree root>
$ catalog check
By default, the check subcommand rescursively searches the directory tree under the current directory, and computes the hash for each file - and compares that against the computed has in the manifest file.
Note
Make sure you copy/deploy your catalog.cat file along with your source code - if you don’t the catalog check
command will fail immediately.
By default the catalog check
will detect and report on three different types of issue :
- missing files : files listed in the manifest file, but which don’t exist in the local directory tree.
- record_extra files : files which are not listed in the manifest file, but which exist in the local directory tree.
- incorrect hashes : files where there is a discrepancy between the hash created for the local file, and the hash listed in the manifest.
Further Reading¶
- Complete details of all the command line options : doc:CommandLine Options
- Details of how to write config files : doc:config
- Details of the default options that are applied : doc`Defaults`
- Detailed use cases of typical usage and suggested configurations : doc:UseCases