NexTOR_IP_CHANGER/QUICK_REFERENCE.md

NexTOR Debian Package Quick Reference

Essential Commands

Building

# Quick build (recommended)
debuild -us -uc

# Build with verbose output
debuild -v -us -uc

# Build binary only
debuild -us -uc -b

# Build source only
debuild -us -uc -S

# After build, check results
ls -lh ../nextor_*.deb

Quality Assurance

# Check for Debian policy violations
lintian ../nextor_1.1-1_all.deb

# Show all issues including info
lintian -i ../nextor_1.1-1_all.deb

# Check specific category
lintian -t debian_policy ../nextor_1.1-1_all.deb

Installation

# Standard installation
sudo dpkg -i ../nextor_1.1-1_all.deb

# Fix dependency issues
sudo apt-get install -f

# Reinstall (if corrupted)
sudo dpkg --configure nextor
sudo apt-get install --reinstall nextor

# Complete removal
sudo apt-get purge nextor

Testing

# Verify installation
which nextor
dpkg -l | grep nextor

# Test command
nextor --help

# View documentation
man nextor

# Test Python imports
python3 -c "from Nex_Tor_IP_changer import NexTOR; print('OK')"

Inspection

# Package contents
dpkg -c ../nextor_1.1-1_all.deb

# Installed files
dpkg -L nextor

# Package info
dpkg -I ../nextor_1.1-1_all.deb

# Installed details
dpkg -s nextor

# Extract for inspection
mkdir /tmp/nextor-check
dpkg-deb -x ../nextor_1.1-1_all.deb /tmp/nextor-check
find /tmp/nextor-check

Cleanup

# Clean build artifacts
debclean

# Manual cleanup
rm -rf build/ dist/ *.egg-info/
rm -f debian/nextor/
rm -f ../nextor_*

# Full source clean
fakeroot debian/rules clean

# Remove extracted inspection
rm -rf /tmp/nextor-check

Common Issues & Fixes

Issue	Command/Solution
Build tool missing	sudo apt-get install devscripts debhelper
Dependency error	sudo apt-get build-dep .
Permission denied	chmod +x debian/rules
Import error	python3 -c "from Nex_Tor_IP_changer import NexTOR"
nextor not found	sudo dpkg -i ../nextor_*.deb && sudo apt-get install -f
lintian errors	Review DEBIAN_PACKAGING.md for fixes
Git signing issues	git config user.signingkey <KEY_ID>

Directory Structure

NexTOR_IP_CHANGER/
├── debian/                     # Debian packaging files
│   ├── control                # Package metadata
│   ├── changelog              # Release history
│   ├── copyright              # License (MIT)
│   ├── rules                  # Build rules
│   ├── install                # File installation
│   ├── nextor.1               # Man page
│   ├── compat                 # Debhelper level 13
│   └── source/format          # Format v3
├── Nex_Tor_IP_changer/        # Main Python package
│   ├── __init__.py           # Package init
│   ├── NexTOR.py             # Main executable
│   ├── nex.py                # Helper functions
│   └── install.py            # Install utilities
├── setup.py                   # Python setup
├── pyproject.toml            # Modern Python build config
├── MANIFEST.in               # Build manifest
├── BUILD_INSTRUCTIONS.md     # Detailed build guide
├── DEBIAN_PACKAGING.md       # Debian standards guide
├── KALI_SUBMISSION.md        # Kali submission guide
├── LICENSE                   # MIT License
└── README.md                 # Project documentation

Build Process Flow

1. Install build tools
   └─> debhelper, dh-python, devscripts

2. Prepare source
   └─> Ensure debian/ directory present

3. Build package
   └─> debuild -us -uc

4. Run lintian
   └─> All errors must be fixed

5. Test installation
   └─> sudo dpkg -i, nextor command

6. Archive artifacts
   └─> Save nextor_1.1-1_all.deb

7. Submit to Kali (optional)
   └─> Follow KALI_SUBMISSION.md

Package Metadata Quick View

# View package name and version
grep "^Package:\|^Version:" debian/control

# View dependencies
grep "^Depends:" debian/control

# View maintainer
grep "^Maintainer:\|^Uploaders:" debian/control

# View description
grep "^Description:" -A 10 debian/control

For Kali Linux Submission

# 1. Update maintainer
nano debian/control  # Change Maintainer to Kali Linux

# 2. Update changelog
nano debian/changelog  # Add -1kali1 suffix

# 3. Push to GitLab
git add debian/
git commit -S -m "Prepare for Kali Linux"
git push origin submit/nextor-1.1

# 4. Create merge request on GitLab
# https://gitlab.com/kali-team/packages/nextor

Performance Tips

# Parallel build (if available)
debuild -us -uc -j$(nproc)

# Faster cleanup
debclean -v

# Background build
debuild -us -uc &

# Check build progress
tail -f ../nextor_*.log

Dependency Verification

# Check if dependencies are installed
apt-cache search python3-stem
apt-cache search python3-requests
apt-cache search tor

# Install dependencies for testing
sudo apt-get install python3-stem python3-requests tor

# Verify availability
python3 -c "import stem; print(stem.__version__)"
python3 -c "import requests; print(requests.__version__)"

Version Scheme

Current: 1.1-1

• 1.1 = Upstream version
• -1 = Debian package revision

For Future Updates:

1.1-2    # Debian packaging fix (no code change)
1.2-1    # New upstream version
1.2-1kali1  # For Kali Linux submission

Success Criteria

✓ All commands listed above complete without errors
✓ lintian reports clean
✓ Package installs and works
✓ nextor command is available
✓ Documentation is accessible via man nextor
✓ Dependencies are properly resolved

---

Quick Links:

• Detailed guide: BUILD_INSTRUCTIONS.md
• Debian standards: DEBIAN_PACKAGING.md
• Kali submission: KALI_SUBMISSION.md
• GitHub repo: https://github.com/0x5t4l1n/NexTOR_IP_CHANGER