Developing on Windows¶
To download the latest version of Plaso you’ll need to install the git tools: http://git-scm.com/downloads
Checkout the plaso source from the git repo:
git clone https://github.com/log2timeline/plaso.git
If you intend to submit code make sure to configure git to use convert to the Unix-style end-of-line characters (linefeed) on submission and not have the Windows-style end-of-line characters (carriage return + linefeed).
We recommend to configure your editor of choice to use linefeed only and turn off git’s autocrlf:
git config --global core.autocrlf false
Check if you have all the dependencies installed and have the right minimum version:
Note that some dependencies are actively under development and can be frequently updated, therefore we recommend checking the status of the dependencies regularly.
Running the development release¶
To run the development release directly from source make sure Python can find the plaso source files by setting PYTHONPATH correspondingly.
To run e.g. pinfo:
C:\Python27\python.exe C:\plaso-build\plaso\plaso\frontend\pinfo.py plaso.db
If you intend to do development on plaso you’ll also need to install some development tools:
- Python Mock
At the moment Plaso development requires PyLint 1.6.x.
TODO: describe building pylint 1.6.x
For pylint 1.6.x the following additional dependencies are required:
Download the latest source package from: https://pypi.python.org/pypi/mock
To build the MSI file run the following commands from the build root directory:
tar xvf mock-1.0.1.tar.gz cd mock-1.0.1\ C:\Python27\python.exe setup.py bdist_msi cd ..
This will create a MSI in the dist sub directory e.g.:
Install the MSI.