checkpoint

Create restore points for your project locally

Checkpoint is a tool that helps you to create restore points for your project. This is very similar to git tagging, the only difference between these two is that checkpoint doesn't require the project to be git initialized. It also doesn't require you to have a git remote.

How does it work?

Checkpoint provides multiple Sequence classes that have memeber functions which execute based on their order in the sequence. These sequences are used to perform all the sequentional operations that are required to create a restore point. Some of these sequences are:

• IOSequence: This sequence is used to perfrom all the input/output sequentional operations.
• CLISequence: This sequence is used to perform all the CLI operations which includes parsing the arguments, determining the action and performing the action.

Checkpoint also supports custom sequences that can be used to initialize checkpoint in different environments. For example, if checkpoint isto be initialized in a UI enviroment a sequence for UI can be created and passed to the Checkpoint constructor.

Detailed documentation can be found here

How to use checkpoint?

To run checkpoint in UI environment, run the following command:

Run checkpoint in UI environment

checkpoint --run-ui

The following is an example of how to use checkpoint in a CLI environment.

Initialize checkpoint in the target project

checkpoint --action=init --path=path/to/project 

After initialization a .checkpoint directory is created in the target project. If the project is git initialized, this directory should be added to the git ignore file.

Creating a restore point

checkpoint --name=restore_point_name --action=create --path=path/to/project

Jumping to a restore point

checkpoint --name=restore_point_name --action=restore --path=path/to/project

Deleting a restore point

checkpoint --name=restore_point_name --action=delete --path=path/to/project

Version of checkpoint

checkpoint --name=restore_point_name --action=version --path=path/to/project

Installation

pip install pycheckpoint

Development

1. Get the source code by cloning from remote repository.

git clone https://github.com/antrikshmisri/checkpoint.git

2. Create and activate a virtual environment.

python -m venv venv
source venv/bin/activate

3. Get the dependencies

pip install -r requirements/default.txt

4. Install checkpoint as a local project.

pip install .

5. Run the tests

pip intall -r requirements/test.txt
pytest -v checkpoint/tests/

Code of Conduct

Please go through the code of conduct before contributing to this project which can be found here.

Screenshots