Manage automatic code capture

Learn how to manage automatic code capture in Vectice.

Vectice captures your git commit information, including the repository name, branch name, commit hash, and the commit URL when there is a .git folder or repository available. Only locally changed files not registered in Vectice are captured with each new git commit.

Vectice is not a substitute for a code version system and is best used in coordination with a git-based system.

Prerequisites

To capture code in Vectice, you will need the following prerequisites:

  • Ensure you have installed vectice with the correct version.

  • Configure your API to connect to the Vectice API

  • Locally configure your Git username and user email

  • Check out a git branch

  • Add a valid remote (origin)

  • Make at least one commit

Git Configuration

Vectice supports all git integrations, including GitHub, GitLab, and Bitbucket.

You can obtain the prerequisites by first configuring your environment with your Git user name and email via the Git CLI.

git config --global user.name "My Name"
git config --global user.email "my@email.com"

Then either clone your existing remote repository or create a new one, followed by adding a valid remote origin.

git clone https://github.com/user/repo # Clone repo 
git init . # New repo
git remote add origin https://github.com/user/repo # Adding a valid remote origin

Lastly, make your first commit to begin code capture.

git add "README.md" # or some other file
git commit -m "Initial commit"

Commits may not include the latest code changes in the UI. Ensure to commit all new code changes.

Code Capture Overview

Automatic code capture is enabled by default, and it happens when:

  • You push a new commit with code changes that are not already registered

  • You register a model within an iteration

  • You register a dataset (origin, cleaned, or modeling datasets) within a step

More than one capture can happen within a single iteration.

With automatic code capture enabled, you will see the following log output indicating successful code capture:

Code captured the following changed files; <filename>.txt, <anotherfilename>.txt

In the UI, you can view the git branch and the commit hash. You can click the git hash or View to see your code changes in your repository.

Disable Code Capture

To disable the automatic capture of your local code, you can set code_capture to False, as shown below. Ensure to set this method at the global level.

import vectice
vectice.code_capture = False

Code Capture Best Practices

  • Don't forget to commit your code before running your iteration so that you log a clean commit into Vectice.

  • Work in a separate branch for each experiment to make it easy to reproduce the work and track changes.

  • Ensure to commit your final code changes before completing an iteration to ensure all the latest commits are registered in the UI.