Metadata-Version: 2.0
Name: wpbackup2
Version: 0.2.2
Summary: Backup and restore all your self-hosted WordPress content
Home-page: https://github.com/ravensorb/py-wordpress-backup
Author: Shawn Anderson
Author-email: code@eye-catcher.com
License: MIT License
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: chesney (~=1.0)
Requires-Dist: wpconfigr (~=1.0)
Requires-Dist: wpdatabase (~=1.0)
Provides-Extra: dev
Requires-Dist: autopep8; extra == 'dev'
Requires-Dist: coverage; extra == 'dev'
Requires-Dist: pylint; extra == 'dev'

# py-wordpress-backup

A Python package for backing up and restoring a self-hosted WordPress installation, including the database and uploaded content.

The backup file will contain:

 - Your database as a MySQL dump.
 - An exact copy of your entire WordPress directory.

## TODO

 - Unit tests.
 - Handle `wp-config.php` being somewhere other than the default location.

## Installation

```shell
pip install wpbackup2
```

## Usage

To backup:

```
python3 -m wpbackup2 --backup --wp-dir  /www/wordpress --archive ~/backup.tar.gz
```

Note that the current release of `py-wordpress-backup` expected `wp-config.php` to exist within your WordPress directory, and will use it to read your database credentials to perform the backup. Keeping your `wp-config.php` file in this location *might* not be the best practice, and I'll likely handle this in a future update.

To restore using database admin credentials held in AWS Secrets Manager:

```shell
python3 -m wpbackup2 --restore --wp-dir /www/wordpress --archive ~/backup.tar.gz --admin-credentials-aws-secret-id AdminUserSecretID --admin-credentials-aws-region eu-west-1
```

To restore with specified database admin credentials:

```shell
python3 -m wpbackup2 --restore --wp-dir /www/wordpress --archive ~/backup.tar.gz --admin-user admin --admin-password trustno1 --new-site-url https://new.site.url --new-site-host https://new.site.url --new-db-host --new-db-port 3306 --new-db-name new-wordpress-db-name  
```

## Development

### Prerequisites

py-wordpress-backup requires Python 3.6 or newer.

### Installing dependencies

```shell
pip install -e .[dev]
```


