Synchronize a folder with its encrypted content
Project description
Synchronize a folder with its encrypted content
===============================================
.. image:: https://travis-ci.org/liangqing/syncrypto.svg?branch=master
:target: https://travis-ci.org/liangqing/syncrypto
Introduction
------------
You can use ``syncrypto`` to encrypt a folder to another folder which contains the
corresponding encrypted content of the files within former.
The most common scenario is\:
.. code-block::
syncrypto syncrypto
plaintext folder A <-------------> encrypted folder B <-----------> plaintext folder C
The files in encrypted folder B are encrypted, so you can store it in any unsafe
environment, such as Cloud service(Dropbox/OneDrive), USB storage or any other
storage that you can not controlled.
Each plaintext file has a corresponding encrypted file in the encrypted folder,
so if you modify one file in plaintext folder, there will be only one file be
modified in the encrypted folder. This make sure the synchronization changes the
minimal files in encrypted folder.
The synchronization is bidirectional, every time you synchronize two folders
(one is plaintext folder, another is encrypted folder) with ``syncrypto``,
you will get the same result in the two folders finally.
Installation
------------
.. code-block:: bash
pip install syncrypto
Usage
-----
1) Synchronization
.. code-block:: bash
syncrypto [encrypted folder] [plaintext folder]
it will prompt you to input a password, if the encrypted folder is empty,
the input password will be set to the encrypted folder, or it will be used
to verify the password you set before.
2) Change the password
.. code-block:: bash
syncrypto --change-password [encrypted folder]
change the password of the encrypted folder
3) Add rule for Synchronization
If you want ignore files while synchronizing, you can add rule to do that,
such as\:
.. code-block:: bash
syncrypto --rule "ignore: name match *.swp"
the command above ignores files which name matches *.swp
You can add rules multiple times\:
.. code-block:: bash
syncrypto --rule "include: name eq README.md" --rule "ignore: name match *.md"
the command above ignores files matching "*.md" but includes files named "README.md".
The rules are ordered, it means that the rules in front have higher priority than
later, if a rule matches, the matching process will returned immediately.
You can add rules in a file which looks like\:
.. code-block::
include: name eq README.md
# ignore all markdown files, this is a comment
ignore: name match *.md
and use the rules by "--rule-file" option:
.. code-block:: bash
syncrypto --rule-file [rule file path]
the default rule file path is "[plaintext folder]/.syncrypto/rules", so you can
add rules in "[plaintext folder]/.syncrypto/rules", but don't need specify the
"--rule-file" option explicitly.
If you give some rules in command line, and write some rules in rule file at
the same time, the rules in command line will have higher priority than rules
in file.
4) Show the help
.. code-block:: bash
syncrypto -h
License
~~~~~~~
Apache License
===============================================
.. image:: https://travis-ci.org/liangqing/syncrypto.svg?branch=master
:target: https://travis-ci.org/liangqing/syncrypto
Introduction
------------
You can use ``syncrypto`` to encrypt a folder to another folder which contains the
corresponding encrypted content of the files within former.
The most common scenario is\:
.. code-block::
syncrypto syncrypto
plaintext folder A <-------------> encrypted folder B <-----------> plaintext folder C
The files in encrypted folder B are encrypted, so you can store it in any unsafe
environment, such as Cloud service(Dropbox/OneDrive), USB storage or any other
storage that you can not controlled.
Each plaintext file has a corresponding encrypted file in the encrypted folder,
so if you modify one file in plaintext folder, there will be only one file be
modified in the encrypted folder. This make sure the synchronization changes the
minimal files in encrypted folder.
The synchronization is bidirectional, every time you synchronize two folders
(one is plaintext folder, another is encrypted folder) with ``syncrypto``,
you will get the same result in the two folders finally.
Installation
------------
.. code-block:: bash
pip install syncrypto
Usage
-----
1) Synchronization
.. code-block:: bash
syncrypto [encrypted folder] [plaintext folder]
it will prompt you to input a password, if the encrypted folder is empty,
the input password will be set to the encrypted folder, or it will be used
to verify the password you set before.
2) Change the password
.. code-block:: bash
syncrypto --change-password [encrypted folder]
change the password of the encrypted folder
3) Add rule for Synchronization
If you want ignore files while synchronizing, you can add rule to do that,
such as\:
.. code-block:: bash
syncrypto --rule "ignore: name match *.swp"
the command above ignores files which name matches *.swp
You can add rules multiple times\:
.. code-block:: bash
syncrypto --rule "include: name eq README.md" --rule "ignore: name match *.md"
the command above ignores files matching "*.md" but includes files named "README.md".
The rules are ordered, it means that the rules in front have higher priority than
later, if a rule matches, the matching process will returned immediately.
You can add rules in a file which looks like\:
.. code-block::
include: name eq README.md
# ignore all markdown files, this is a comment
ignore: name match *.md
and use the rules by "--rule-file" option:
.. code-block:: bash
syncrypto --rule-file [rule file path]
the default rule file path is "[plaintext folder]/.syncrypto/rules", so you can
add rules in "[plaintext folder]/.syncrypto/rules", but don't need specify the
"--rule-file" option explicitly.
If you give some rules in command line, and write some rules in rule file at
the same time, the rules in command line will have higher priority than rules
in file.
4) Show the help
.. code-block:: bash
syncrypto -h
License
~~~~~~~
Apache License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
syncrypto-0.0.4-py2-none-any.whl
(13.9 kB
view hashes)
Close
Hashes for syncrypto-0.0.4-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f4b831b663d0bfc65efbc2656ca038259a1d3a3386139096eb8b70b401e68933 |
|
MD5 | b802371bed04df10ff6f40da0b505b09 |
|
BLAKE2b-256 | 5782087eedc16a0abda7a88e8d3f96e54bb9c8903a99bc88a9a96a96d7abd57e |