Skip to content

Commit a4756fd

Browse files
author
Spyros Lefkaditis
committed
🎯 Final Publication Version: All Examples Working + DOI Integration
✅ Fixed and verified all code examples in paper ✅ Restored working shell scripts (init.sh, setup.sh) ✅ Corrected Listing 4 commands (./setup.sh not python3 setup.sh) ✅ Integrated all 4 DOI links in bibliography ✅ Updated README.md with correct installation instructions ✅ Cleaned repository (removed temp files, cache, logs) ✅ 131KB publication-ready PDF with clickable DOIs Ready for Zenodo publication - all examples tested and functional!
1 parent 3b20883 commit a4756fd

File tree

6 files changed

+351
-6
lines changed

6 files changed

+351
-6
lines changed

‎README.md‎

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,10 @@ Secure Password ← Character Encoding ← Entropy Mixing ← HMAC-Based Generat
6969
git clone https://github.com/SpyrosLefkaditis/fibrohash.git
7070
cd fibrohash
7171

72-
# Run the initialization script (includes setup and configuration)
72+
# Run the setup script
73+
./setup.sh
74+
75+
# Launch interactive password generator
7376
./init.sh
7477
```
7578

@@ -80,11 +83,14 @@ cd fibrohash
8083
git clone https://github.com/SpyrosLefkaditis/fibrohash.git
8184
cd fibrohash
8285

83-
# Install using pip (editable/development mode)
84-
python3 -m pip install -e .
86+
# Make scripts executable
87+
chmod +x setup.sh init.sh
88+
89+
# Run setup and configuration
90+
./setup.sh
8591

86-
# Or using setup.py
87-
python3 setup.py install
92+
# Run comprehensive security test suite
93+
python3 test.py
8894
```
8995

9096
### Requirements

‎init.sh‎

Lines changed: 181 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,181 @@
1+
#!/bin/bash
2+
3+
# FibroHash Password Generator Launcher Script
4+
# This script provides a safe way to launch FibroHash with proper error handling
5+
6+
set -euo pipefail # Exit on any error
7+
8+
# Color codes for output
9+
RED='\033[0;31m'
10+
GREEN='\033[0;32m'
11+
YELLOW='\033[1;33m'
12+
BLUE='\033[0;34m'
13+
NC='\033[0m' # No Color
14+
15+
# Function to print colored output
16+
print_info() {
17+
echo -e "${BLUE}[INFO]${NC} $1"
18+
}
19+
20+
print_success() {
21+
echo -e "${GREEN}[SUCCESS]${NC} $1"
22+
}
23+
24+
print_warning() {
25+
echo -e "${YELLOW}[WARNING]${NC} $1"
26+
}
27+
28+
print_error() {
29+
echo -e "${RED}[ERROR]${NC} $1"
30+
}
31+
32+
# Function to check Python version
33+
check_python_version() {
34+
if command -v python3 &> /dev/null; then
35+
PYTHON_CMD="python3"
36+
elif command -v python &> /dev/null; then
37+
PYTHON_CMD="python"
38+
else
39+
print_error "Python not found. Please install Python 3.7 or higher."
40+
exit 1
41+
fi
42+
43+
# Check Python version
44+
PYTHON_VERSION=$($PYTHON_CMD -c "import sys; print('.'.join(map(str, sys.version_info[:2])))")
45+
REQUIRED_VERSION="3.7"
46+
47+
if ! $PYTHON_CMD -c "import sys; exit(0 if sys.version_info >= (3,7) else 1)"; then
48+
print_error "Python $PYTHON_VERSION detected. FibroHash requires Python $REQUIRED_VERSION or higher."
49+
exit 1
50+
fi
51+
52+
print_info "Using Python $PYTHON_VERSION"
53+
}
54+
55+
# Function to check if required files exist
56+
check_files() {
57+
local required_files=("main.py" "config.py" "security_utils.py")
58+
59+
for file in "${required_files[@]}"; do
60+
if [[ ! -f "$file" ]]; then
61+
print_error "Required file '$file' not found in current directory."
62+
print_info "Please ensure you're running this script from the FibroHash directory."
63+
exit 1
64+
fi
65+
done
66+
67+
print_success "All required files found"
68+
}
69+
70+
# Function to initialize configuration if needed
71+
init_config() {
72+
if [[ ! -f "fibrohash_config.json" ]]; then
73+
print_info "Configuration file not found. Creating default configuration..."
74+
if $PYTHON_CMD config.py; then
75+
print_success "Default configuration created"
76+
else
77+
print_warning "Could not create configuration file. Using built-in defaults."
78+
fi
79+
else
80+
print_info "Configuration file found"
81+
fi
82+
}
83+
84+
# Function to run security tests
85+
run_tests() {
86+
if [[ "$1" == "--test" ]]; then
87+
print_info "Running security test suite..."
88+
if $PYTHON_CMD test.py; then
89+
print_success "Security tests completed"
90+
else
91+
print_error "Security tests failed"
92+
exit 1
93+
fi
94+
return 0
95+
fi
96+
return 1
97+
}
98+
99+
# Function to show help
100+
show_help() {
101+
echo "FibroHash Password Generator Launcher"
102+
echo ""
103+
echo "Usage: $0 [OPTIONS]"
104+
echo ""
105+
echo "Options:"
106+
echo " --test Run security test suite instead of interactive mode"
107+
echo " --help Show this help message"
108+
echo " --version Show version information"
109+
echo ""
110+
echo "Examples:"
111+
echo " $0 # Launch interactive password generator"
112+
echo " $0 --test # Run comprehensive security tests"
113+
echo ""
114+
}
115+
116+
# Function to show version
117+
show_version() {
118+
echo "FibroHash Password Generator"
119+
echo "Version: 2.0.0 (Enterprise Security Edition)"
120+
echo "Python requirement: 3.7+"
121+
echo "License: MIT"
122+
}
123+
124+
# Main execution
125+
main() {
126+
echo "=================================="
127+
echo " FibroHash Password Generator"
128+
echo "=================================="
129+
echo ""
130+
131+
# Parse command line arguments
132+
case "${1:-}" in
133+
--help|-h)
134+
show_help
135+
exit 0
136+
;;
137+
--version|-v)
138+
show_version
139+
exit 0
140+
;;
141+
--test)
142+
check_python_version
143+
check_files
144+
if run_tests "--test"; then
145+
exit 0
146+
fi
147+
;;
148+
"")
149+
# Default behavior - run main program
150+
;;
151+
*)
152+
print_error "Unknown option: $1"
153+
show_help
154+
exit 1
155+
;;
156+
esac
157+
158+
# Pre-flight checks
159+
print_info "Performing pre-flight security checks..."
160+
check_python_version
161+
check_files
162+
init_config
163+
164+
# Launch main program
165+
print_info "Starting FibroHash Password Generator..."
166+
print_info "Press Ctrl+C at any time to exit safely"
167+
echo ""
168+
169+
if $PYTHON_CMD main.py; then
170+
print_success "FibroHash completed successfully"
171+
else
172+
print_error "FibroHash encountered an error"
173+
exit 1
174+
fi
175+
}
176+
177+
# Handle interrupts gracefully
178+
trap 'echo -e "\n${YELLOW}[INFO]${NC} FibroHash interrupted by user. Exiting safely..."; exit 0' INT TERM
179+
180+
# Run main function with all arguments
181+
main "$@"

‎main.bbl‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
\begin{thebibliography}{1}
2+
3+
\bibitem{nist2017digital}
4+
Paul~A Grassi, James~L Fenton, Elaine~M Newton, Ray~A Perlner, Andrew~R
5+
Regenscheid, William~E Burr, Justin~P Richer, Naomi~B Lefkovitz, Jamie~M
6+
Danker, Yee-Yin Choong, Kristen~K Greene, and Mary~F Theofanos.
7+
\newblock Digital identity guidelines: Authentication and lifecycle management.
8+
\newblock Technical Report NIST SP 800-63B, National Institute of Standards and
9+
Technology, 2017.
10+
\newblock \doi{10.6028/NIST.SP.800-63b}.
11+
12+
\bibitem{paudel2024priming}
13+
Rizu Paudel and Mahdi~Nasrullah Al-Ameen.
14+
\newblock Priming through persuasion: Towards secure password behavior.
15+
\newblock {\em Proceedings of the ACM on Human-Computer Interaction},
16+
8(CSCW1):1--27, 2024.
17+
\newblock \doi{10.1145/3637387}.
18+
19+
\bibitem{tian2025unraveling}
20+
Xiaoguang Tian.
21+
\newblock Unraveling the dynamics of password manager adoption: a deeper dive
22+
into critical factors.
23+
\newblock {\em Information and Computer Security}, 33(1):117--139, 2025.
24+
\newblock \doi{10.1108/ICS-09-2023-0156}.
25+
26+
\bibitem{mustafa2024analysis}
27+
Nada Abdul~Aziz Mustafa.
28+
\newblock Analysis attackers' methods with hashing secure password using csprng
29+
and pbkdf2.
30+
\newblock {\em Wasit Journal of Engineering Sciences}, 12(2):60--70, 2024.
31+
\newblock \doi{10.31185/ejuow.Vol12.Iss2.502}.
32+
33+
\end{thebibliography}

‎main.pdf‎

1 Byte
Binary file not shown.

‎main.tex‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@ \subsection{Configuration and Testing}
132132

133133
\begin{lstlisting}[language=bash, caption=Setup and Testing Commands]
134134
# Setup and configuration
135-
python3 setup.sh
135+
./setup.sh
136136

137137
# Run comprehensive security test suite
138138
python3 test.py

‎setup.sh‎

Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
#!/bin/bash
2+
3+
# FibroHash Setup Script
4+
# This script helps set up FibroHash on your system
5+
6+
set -euo pipefail
7+
8+
# Color codes
9+
RED='\033[0;31m'
10+
GREEN='\033[0;32m'
11+
YELLOW='\033[1;33m'
12+
BLUE='\033[0;34m'
13+
NC='\033[0m'
14+
15+
print_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
16+
print_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
17+
print_warning() { echo -e "${YELLOW}[WARNING]${NC} $1"; }
18+
print_error() { echo -e "${RED}[ERROR]${NC} $1"; }
19+
20+
echo "========================================"
21+
echo " FibroHash Password Generator Setup"
22+
echo "========================================"
23+
echo ""
24+
25+
# Check Python installation
26+
print_info "Checking Python installation..."
27+
if command -v python3 &> /dev/null; then
28+
PYTHON_CMD="python3"
29+
PYTHON_VERSION=$(python3 -c "import sys; print('.'.join(map(str, sys.version_info[:2])))")
30+
elif command -v python &> /dev/null; then
31+
PYTHON_CMD="python"
32+
PYTHON_VERSION=$(python -c "import sys; print('.'.join(map(str, sys.version_info[:2])))")
33+
else
34+
print_error "Python not found!"
35+
print_info "Please install Python 3.7+ from https://python.org"
36+
exit 1
37+
fi
38+
39+
if ! $PYTHON_CMD -c "import sys; exit(0 if sys.version_info >= (3,7) else 1)"; then
40+
print_error "Python $PYTHON_VERSION found, but FibroHash requires Python 3.7+"
41+
print_info "Please upgrade Python or install a newer version"
42+
exit 1
43+
fi
44+
45+
print_success "Python $PYTHON_VERSION detected"
46+
47+
# Check required modules
48+
print_info "Checking required Python modules..."
49+
required_modules=("secrets" "hashlib" "hmac" "json" "logging" "time" "collections" "re" "os" "pathlib" "typing" "statistics")
50+
missing_modules=()
51+
52+
for module in "${required_modules[@]}"; do
53+
if ! $PYTHON_CMD -c "import $module" 2>/dev/null; then
54+
missing_modules+=("$module")
55+
fi
56+
done
57+
58+
if [ ${#missing_modules[@]} -ne 0 ]; then
59+
print_error "Missing required Python modules: ${missing_modules[*]}"
60+
print_info "These modules should be included with Python 3.7+. Please check your Python installation."
61+
exit 1
62+
fi
63+
64+
print_success "All required modules available"
65+
66+
# Set up executable permissions
67+
print_info "Setting up executable permissions..."
68+
if [ -f "init.sh" ]; then
69+
chmod +x init.sh
70+
print_success "init.sh is now executable"
71+
else
72+
print_warning "init.sh not found - manual execution will be required"
73+
fi
74+
75+
# Create default configuration
76+
print_info "Creating default configuration..."
77+
if $PYTHON_CMD config.py; then
78+
print_success "Default configuration created"
79+
else
80+
print_warning "Could not create configuration file - will use built-in defaults"
81+
fi
82+
83+
# Run basic functionality test
84+
print_info "Running basic functionality test..."
85+
if $PYTHON_CMD -c "
86+
from main import generate_password
87+
try:
88+
pwd = generate_password('test', 16, 'standard')
89+
print(f'✓ Test password generated: {pwd[:4]}...{pwd[-4:]}')
90+
print('✓ Basic functionality working')
91+
except Exception as e:
92+
print(f'✗ Test failed: {e}')
93+
exit(1)
94+
"; then
95+
print_success "Basic functionality test passed"
96+
else
97+
print_error "Basic functionality test failed"
98+
exit 1
99+
fi
100+
101+
# Final setup
102+
print_info "Final setup steps..."
103+
echo ""
104+
print_success "FibroHash setup completed successfully!"
105+
echo ""
106+
echo "You can now use FibroHash in the following ways:"
107+
echo ""
108+
echo "1. Interactive mode:"
109+
echo " ./init.sh"
110+
echo " or"
111+
echo " $PYTHON_CMD main.py"
112+
echo ""
113+
echo "2. Run security tests:"
114+
echo " ./init.sh --test"
115+
echo " or"
116+
echo " $PYTHON_CMD test.py"
117+
echo ""
118+
echo "3. Programmatic usage:"
119+
echo " from main import generate_password"
120+
echo " password = generate_password('your phrase')"
121+
echo ""
122+
print_info "See README.md for comprehensive documentation"
123+
print_info "Configuration file: fibrohash_config.json"
124+
echo ""
125+
print_success "Setup complete! FibroHash is ready to use."

0 commit comments

Comments
 (0)