seitime-frappe/frappe/docs/current/api/utils/frappe.utils.backups.html
Anand Doshi 8a5addaae7 [feature] Private files. Fixes #927
- Option during upload + all new incoming email files will be private
- Paired with @rmehta
2015-12-09 14:02:14 +05:30

254 lines
No EOL
7.2 KiB
HTML

<!-- title: frappe.utils.backups --><div class="dev-header">
<a class="btn btn-default btn-sm" disabled style="margin-bottom: 10px;">
Version 6.x.x</a>
<a class="btn btn-default btn-sm" href="https://github.com/frappe/frappe/blob/develop/frappe/utils/backups.py"
target="_blank" style="margin-left: 10px; margin-bottom: 10px;"><i class="octicon octicon-mark-github"></i> Source</a>
</div>
<h2>Introduction</h2><br><p>This module handles the On Demand Backup utility</p>
<br><br>
<h3 style="font-weight: normal;">Class <b>BackupGenerator</b></h3>
<div class="docs-attr-desc"><p>This class contains methods to perform On Demand Backup</p>
<p>To initialize, specify (db<em>name, user, password, db</em>file<em>name=None, db</em>host="localhost")
If specifying db<em>file</em>name, also append ".sql.gz"</p>
</div>
<div style="padding-left: 30px;">
<p class="docs-attr-name">
<a name="__init__" href="#__init__" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
<b>__init__</b>
<i class="text-muted">(self, db_name, user, password, backup_path_db=None, backup_path_files=None, backup_path_private_files=None, db_host=localhost)</i>
</p>
<div class="docs-attr-desc"><p><span class="text-muted">No docs</span></p>
</div>
<br>
<p class="docs-attr-name">
<a name="get_backup" href="#get_backup" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
<b>get_backup</b>
<i class="text-muted">(self, older_than=24, ignore_files=False, force=False)</i>
</p>
<div class="docs-attr-desc"><p>Takes a new dump if existing file is old
and sends the link to the file as email</p>
</div>
<br>
<p class="docs-attr-name">
<a name="get_recent_backup" href="#get_recent_backup" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
<b>get_recent_backup</b>
<i class="text-muted">(self, older_than)</i>
</p>
<div class="docs-attr-desc"><p><span class="text-muted">No docs</span></p>
</div>
<br>
<p class="docs-attr-name">
<a name="send_email" href="#send_email" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
<b>send_email</b>
<i class="text-muted">(self)</i>
</p>
<div class="docs-attr-desc"><p>Sends the link to backup file located at erpnext/backups</p>
</div>
<br>
<p class="docs-attr-name">
<a name="set_backup_file_name" href="#set_backup_file_name" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
<b>set_backup_file_name</b>
<i class="text-muted">(self)</i>
</p>
<div class="docs-attr-desc"><p><span class="text-muted">No docs</span></p>
</div>
<br>
<p class="docs-attr-name">
<a name="take_dump" href="#take_dump" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
<b>take_dump</b>
<i class="text-muted">(self)</i>
</p>
<div class="docs-attr-desc"><p><span class="text-muted">No docs</span></p>
</div>
<br>
<p class="docs-attr-name">
<a name="zip_files" href="#zip_files" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
<b>zip_files</b>
<i class="text-muted">(self)</i>
</p>
<div class="docs-attr-desc"><p><span class="text-muted">No docs</span></p>
</div>
<br>
</div>
<hr>
<p class="docs-attr-name">
<a name="frappe.utils.backups.backup" href="#frappe.utils.backups.backup" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
frappe.utils.backups.<b>backup</b>
<i class="text-muted">(with_files=False, backup_path_db=None, backup_path_files=None, quiet=False)</i>
</p>
<div class="docs-attr-desc"><p>Backup</p>
</div>
<br>
<p class="docs-attr-name">
<a name="frappe.utils.backups.delete_temp_backups" href="#frappe.utils.backups.delete_temp_backups" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
frappe.utils.backups.<b>delete_temp_backups</b>
<i class="text-muted">(older_than=24)</i>
</p>
<div class="docs-attr-desc"><p>Cleans up the backup<em>link</em>path directory by deleting files older than 24 hours</p>
</div>
<br>
<p><span class="label label-info">Public API</span>
<br><code>/api/method/frappe.utils.backups.get_backup</code>
</p>
<p class="docs-attr-name">
<a name="frappe.utils.backups.get_backup" href="#frappe.utils.backups.get_backup" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
frappe.utils.backups.<b>get_backup</b>
<i class="text-muted">()</i>
</p>
<div class="docs-attr-desc"><p>This function is executed when the user clicks on
Toos &gt; Download Backup</p>
</div>
<br>
<p class="docs-attr-name">
<a name="frappe.utils.backups.get_backup_path" href="#frappe.utils.backups.get_backup_path" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
frappe.utils.backups.<b>get_backup_path</b>
<i class="text-muted">()</i>
</p>
<div class="docs-attr-desc"><p><span class="text-muted">No docs</span></p>
</div>
<br>
<p class="docs-attr-name">
<a name="frappe.utils.backups.is_file_old" href="#frappe.utils.backups.is_file_old" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
frappe.utils.backups.<b>is_file_old</b>
<i class="text-muted">(db_file_name, older_than=24)</i>
</p>
<div class="docs-attr-desc"><p>Checks if file exists and is older than specified hours
Returns ->
True: file does not exist or file is old
False: file is new</p>
</div>
<br>
<p class="docs-attr-name">
<a name="frappe.utils.backups.new_backup" href="#frappe.utils.backups.new_backup" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
frappe.utils.backups.<b>new_backup</b>
<i class="text-muted">(older_than=6, ignore_files=False, backup_path_db=None, backup_path_files=None, backup_path_private_files=None, force=False)</i>
</p>
<div class="docs-attr-desc"><p><span class="text-muted">No docs</span></p>
</div>
<br>
<p class="docs-attr-name">
<a name="frappe.utils.backups.scheduled_backup" href="#frappe.utils.backups.scheduled_backup" class="text-muted small">
<i class="icon-link small" style="color: #ccc;"></i></a>
frappe.utils.backups.<b>scheduled_backup</b>
<i class="text-muted">(older_than=6, ignore_files=False, backup_path_db=None, backup_path_files=None, backup_path_private_files=None, force=False)</i>
</p>
<div class="docs-attr-desc"><p>this function is called from scheduler
deletes backups older than 7 days
takes backup</p>
</div>
<br>
<!-- autodoc -->