Introduction
This project provides a Python 2.7/3.x library to aid checking strings in files. Verace’s main use case is checking that version strings are consistent in project files. The main features of this library are:
-
Custom parse any project files for strings.
-
Easily determine if all strings are consistent.
-
Quickly updated tracked strings.
-
Should work on any platform without additional dependencies; Qprompt is recommended for default prompts.
Status
Currently, this project is in the development release stage. While this project is suitable for use, please note that there may be incompatibilities in new releases.
Requirements
Verace should run on any Python 2.7/3.x interpreter without additional dependencies.
Installation
Verace can be installed with pip using the following command: pip install verace
Additional, Verace can be installed from source by running: python setup.py install
Usage
Start by importing Verace into your Python script:
import veraceCreate a VerChecker object, name it and set the root location:
mychk = verace.VerChecker("My Checker", __file__)Include a file to check. If no check function is provided, check_basic() will be used by default. Let’s look for the version string in setup.py:
mychk.include(r"lib\setup.py", match="version = ", splits=[('"',1)])Get the string found by the checker:
print("version found = " + mychk.string())
# version found = 0.4.0The string can be updated in all associated files:
mychk.update("something different!")That’s the basics. Check out the documentation for more info.
Here are some real-world examples of Verace in action:
Documentation
The full documentation for this project can be found here on Read the Docs.
FAQ
How is Verace pronounced?
-
"ver-AH-che" - Italian word for "truthful/accurate".
Is this library only for Python projects?
-
Not at all! Any project can use Verace!
