Skip to main content

Create restore points in your projects

Project description

checkpoint

Codacy Badge codecov.io GitHub release Downloads PRs Welcome

forthebadge made-with-python

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.

How to use checkpoint?

Currently, checkpoint can only be used in a CLI environment. 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
Restoring 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

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.txt
4. Install checkpoint as a local project.
pip install .
5. Run the tests
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

Screenshot 2021-10-24 225447 Screenshot 2021-10-24 225716

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pycheckpoint-1.2.tar.gz (14.2 kB view hashes)

Uploaded Source

Built Distribution

pycheckpoint-1.2-py3-none-any.whl (14.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page