RomanNum3ral
/
python-forensics-handbook
mirror of https://github.com/chapinb/python-forensics-handbook.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

deploy: 6f28f39639

This commit is contained in:
chapinb 2020-10-21 22:40:39 +00:00
parent 107caaa6ae
commit 4e95e102ad
14 changed files with 28 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.buildinfo
View File

@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: bba2bba94c5da3a0f35a41a0438a5a1d
config: 877dfce6d4455a042d96b6f25671b11e
tags: 645f666f9bcd5a90fca523b33c5a78b7

BIN
.doctrees/ch01_essentials.doctree
View File

Binary file not shown.

BIN
.doctrees/environment.pickle
View File

Binary file not shown.

2
_static/documentation_options.js
View File

@ -1,6 +1,6 @@
var DOCUMENTATION_OPTIONS = {
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
VERSION: '0.1.1',
VERSION: '0.1.2',
LANGUAGE: 'None',
COLLAPSE_INDEX: false,
BUILDER: 'html',

20
ch01_essentials.html
View File

@ -7,7 +7,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Chapter 1 - Essential Scripts &mdash; Python Forensics Handbook 0.1.1 documentation</title>
<title>Chapter 1 - Essential Scripts &mdash; Python Forensics Handbook 0.1.2 documentation</title>
@ -72,7 +72,7 @@
<div class="version">
0.1.1
0.1.2
</div>
@ -286,16 +286,18 @@ to write content to STDOUT uninterrupted. Additionally, you can
set different logging levels for the two handlers - generally you
keep debugging information in the log file while writing more
critical messages to the console in STDERR.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">setup_logging</span><span class="p">(</span><span class="n">logging_obj</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">setup_logging</span><span class="p">(</span><span class="n">logging_obj</span><span class="p">,</span> <span class="n">log_file</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;Function to setup logging configuration and test it.</span>
<span class="sd"> Args:</span>
<span class="sd"> logging_obj: A logging instance, returned from logging.getLogger().</span>
<span class="sd"> log_file: File path to write log messages to.</span>
<span class="sd"> verbose: Whether or not to enable the debug level in STDERR output.</span>
<span class="sd"> Examples:</span>
<span class="sd"> &gt;&gt;&gt; sample_logger = logging.getLogger(name=__name__)</span>
<span class="sd"> &gt;&gt;&gt; sample_logger = setup_logging(sample_logger)</span>
<span class="sd"> &gt;&gt;&gt; log_path = &quot;sample.log&quot;</span>
<span class="sd"> &gt;&gt;&gt; setup_logging(sample_logger, log_path, verbose=True)</span>
<span class="sd"> &gt;&gt;&gt; sample_logger.debug(&quot;This is a debug message&quot;)</span>
<span class="sd"> &gt;&gt;&gt; sample_logger.info(&quot;This is an info message&quot;)</span>
<span class="sd"> &gt;&gt;&gt; sample_logger.warning(&quot;This is a warning message&quot;)</span>
@ -320,15 +322,13 @@ critical messages to the console in STDERR.</p>
<span class="n">stderr_handle</span><span class="o">.</span><span class="n">setFormatter</span><span class="p">(</span><span class="n">log_format</span><span class="p">)</span>
<span class="c1"># Setup file logging</span>
<span class="n">file_handle</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">FileHandler</span><span class="p">(</span><span class="s2">&quot;sample.log&quot;</span><span class="p">,</span> <span class="s2">&quot;a&quot;</span><span class="p">)</span>
<span class="n">file_handle</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">FileHandler</span><span class="p">(</span><span class="n">log_file</span><span class="p">,</span> <span class="s2">&quot;a&quot;</span><span class="p">)</span>
<span class="n">file_handle</span><span class="o">.</span><span class="n">setLevel</span><span class="p">(</span><span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">)</span>
<span class="n">file_handle</span><span class="o">.</span><span class="n">setFormatter</span><span class="p">(</span><span class="n">log_format</span><span class="p">)</span>
<span class="c1"># Add handles</span>
<span class="n">logging_obj</span><span class="o">.</span><span class="n">addHandler</span><span class="p">(</span><span class="n">stderr_handle</span><span class="p">)</span>
<span class="n">logging_obj</span><span class="o">.</span><span class="n">addHandler</span><span class="p">(</span><span class="n">file_handle</span><span class="p">)</span>
<span class="k">return</span> <span class="n">logging_obj</span>
</pre></div>
</div>
</div>
@ -336,19 +336,21 @@ critical messages to the console in STDERR.</p>
<h3>Docstring References<a class="headerlink" href="#docstring-references" title="Permalink to this headline"></a></h3>
<dl class="py function">
<dt id="pyforhandbook.ch01_essentials.logging_example.setup_logging">
<code class="sig-name descname">setup_logging</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">logging_obj</span></em>, <em class="sig-param"><span class="n">verbose</span><span class="o">=</span><span class="default_value">False</span></em><span class="sig-paren">)</span><a class="headerlink" href="#pyforhandbook.ch01_essentials.logging_example.setup_logging" title="Permalink to this definition"></a></dt>
<code class="sig-name descname">setup_logging</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">logging_obj</span></em>, <em class="sig-param"><span class="n">log_file</span></em>, <em class="sig-param"><span class="n">verbose</span><span class="o">=</span><span class="default_value">False</span></em><span class="sig-paren">)</span><a class="headerlink" href="#pyforhandbook.ch01_essentials.logging_example.setup_logging" title="Permalink to this definition"></a></dt>
<dd><p>Function to setup logging configuration and test it.</p>
<dl class="field-list simple">
<dt class="field-odd">Parameters</dt>
<dd class="field-odd"><ul class="simple">
<li><p><strong>logging_obj</strong> – A logging instance, returned from logging.getLogger().</p></li>
<li><p><strong>log_file</strong> – File path to write log messages to.</p></li>
<li><p><strong>verbose</strong> – Whether or not to enable the debug level in STDERR output.</p></li>
</ul>
</dd>
</dl>
<p class="rubric">Examples</p>
<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="n">sample_logger</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="vm">__name__</span><span class="p">)</span>
<span class="gp">&gt;&gt;&gt; </span><span class="n">sample_logger</span> <span class="o">=</span> <span class="n">setup_logging</span><span class="p">(</span><span class="n">sample_logger</span><span class="p">)</span>
<span class="gp">&gt;&gt;&gt; </span><span class="n">log_path</span> <span class="o">=</span> <span class="s2">&quot;sample.log&quot;</span>
<span class="gp">&gt;&gt;&gt; </span><span class="n">setup_logging</span><span class="p">(</span><span class="n">sample_logger</span><span class="p">,</span> <span class="n">log_path</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
<span class="gp">&gt;&gt;&gt; </span><span class="n">sample_logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;This is a debug message&quot;</span><span class="p">)</span>
<span class="gp">&gt;&gt;&gt; </span><span class="n">sample_logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;This is an info message&quot;</span><span class="p">)</span>
<span class="gp">&gt;&gt;&gt; </span><span class="n">sample_logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;This is a warning message&quot;</span><span class="p">)</span>

4
ch02_registry.html
View File

@ -7,7 +7,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Chapter 2 - Registry Parsing &mdash; Python Forensics Handbook 0.1.1 documentation</title>
<title>Chapter 2 - Registry Parsing &mdash; Python Forensics Handbook 0.1.2 documentation</title>
@ -72,7 +72,7 @@
<div class="version">
0.1.1
0.1.2
</div>

4
ch03_event_logs.html
View File

@ -7,7 +7,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Chapter 3 - Windows Event Log Parsing &mdash; Python Forensics Handbook 0.1.1 documentation</title>
<title>Chapter 3 - Windows Event Log Parsing &mdash; Python Forensics Handbook 0.1.2 documentation</title>
@ -72,7 +72,7 @@
<div class="version">
0.1.1
0.1.2
</div>

4
ch06_databases.html
View File

@ -7,7 +7,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Chapter 6 - Sqlite &amp; MacOS/Mobile/Browsers &mdash; Python Forensics Handbook 0.1.1 documentation</title>
<title>Chapter 6 - Sqlite &amp; MacOS/Mobile/Browsers &mdash; Python Forensics Handbook 0.1.2 documentation</title>
@ -71,7 +71,7 @@
<div class="version">
0.1.1
0.1.2
</div>

4
genindex.html
View File

@ -7,7 +7,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Index &mdash; Python Forensics Handbook 0.1.1 documentation</title>
<title>Index &mdash; Python Forensics Handbook 0.1.2 documentation</title>
@ -70,7 +70,7 @@
<div class="version">
0.1.1
0.1.2
</div>

4
index.html
View File

@ -7,7 +7,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>The Python Forensics Handbook &mdash; Python Forensics Handbook 0.1.1 documentation</title>
<title>The Python Forensics Handbook &mdash; Python Forensics Handbook 0.1.2 documentation</title>
@ -71,7 +71,7 @@
<div class="version">
0.1.1
0.1.2
</div>

BIN
objects.inv
View File

Binary file not shown.

4
py-modindex.html
View File

@ -7,7 +7,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Python Module Index &mdash; Python Forensics Handbook 0.1.1 documentation</title>
<title>Python Module Index &mdash; Python Forensics Handbook 0.1.2 documentation</title>
@ -73,7 +73,7 @@
<div class="version">
0.1.1
0.1.2
</div>

4
search.html
View File

@ -7,7 +7,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Search &mdash; Python Forensics Handbook 0.1.1 documentation</title>
<title>Search &mdash; Python Forensics Handbook 0.1.2 documentation</title>
@ -72,7 +72,7 @@
<div class="version">
0.1.1
0.1.2
</div>

2
searchindex.js
View File

File diff suppressed because one or more lines are too long