UniBinaryTextVault 1.1

A lightweight text file management system for developers

UniBinaryTextVault (TVault)

A lightweight, command-line text file management system with automatic backup support.

✨ Features

• Simple CRUD operations: Create, read, update, and delete text files
• Automatic backups: Every write operation creates a backup
• TOTP support: Generate time-based one-time passwords from files containing "tt" in their names
• Cross-platform: Works on Linux, macOS, and Windows
• No database required: Uses plain text files
• Easy to use: Simple command-line interface

📦 Installation

Method 1: Install from PyPI (Recommended)

pip3 install UniBinaryTextVault

After installation, you need to run the setup:

# In Python interpreter
from tvault.dev import install
install()

Method 2: Install from source

git clone https://github.com/UniBinary/TextVault.git
cd TextVault
pip3 install .

🚀 Quick Start

# Create a new text file
tvault new notes

# Write content to the file
tvault write notes

# Read the file
tvault read notes

# Create a backup
tvault backup notes

# List all files
tvault list

# Get help
tvault --help

📖 Usage

Basic Operations

Command	Description	Example
tvault new <file>	Create a new text file	tvault new notes
tvault read <file>	Read content from a file	tvault read notes
tvault write <file>	Write content to a file (with backup)	tvault write notes
tvault backup <file>	Create a backup of a file	tvault backup notes
tvault recover <file>	Recover file from backup	tvault recover notes
tvault remove <file>	Remove a file	tvault remove notes
tvault removebak <file>	Remove backup file	tvault removebak notes
tvault readbak <file>	Read content from backup	tvault readbak notes
tvault list	List all files in vault	tvault list
tvault dumpdb	Backup entire vault	tvault dumpdb
tvault rmdb	Remove vault and uninstall	tvault rmdb

TOTP Feature

If a filename contains "tt" (e.g., totp-secret), TVault can generate TOTP codes:

# Create a file with TOTP secret
tvault new totp-secret
tvault write totp-secret  # Enter your TOTP secret

# Read the file to get current TOTP code
tvault read totp-secret
# Output: TOTP: 123456

Advanced Options

# Force overwrite when creating files
tvault new existing-file --force

# Use custom data directory
tvault new notes --data-dir /path/to/custom/dir

🛠️ Development

Project Structure

textvault/
├── tvault/
│   ├── __init__.py      # Package initialization
│   ├── tvault.py        # Main CLI logic
│   ├── dev.py           # Development tools
│   ├── tvault              # Shell wrapper script
│   └── intros/          # Documentation files
├── setup.py             # Installation configuration
└── README.md            # This file

Running Tests

# Install development dependencies
pip3 install -e .

# Run the development mode
python3 -c "from tvault.dev import run; run()"

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Reporting Issues

If you encounter any issues, please:

1. Check the existing issues
2. Create a new issue with:
   • A clear description of the problem
   • Steps to reproduce
   • Expected vs actual behavior
   • Your environment (OS, Python version)

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Contact

• Author: UniBinary
• Email: [e-mail]
• GitHub: UniBinary
• Issues: GitHub Issues

🙏 Acknowledgments

• Thanks to all contributors and users
• Built with Python's standard library and pyotp

---

Note: This is version 1.0.0.1. The project is actively maintained and improved.