WafflesExploits/Python-Print-In-CPP

A lightweight C++ library offering Python-like syntax for intuitive, type-safe, and minimal-code formatted output. Combines the benefits of printf and cout for easier string formatting.

Python-Print-In-CPP

-> A lightweight C++ library offering Python-like syntax for intuitive, type-safe, and minimal-code formatted output. Combines the benefits of printf and cout for easier string formatting.

Table of Contents

1. Key Features
2. Why Create Python-Print-In-CPP When Libraries Like fmt Exist?
3. Installation
4. Usage Example
5. Error Handling
6. Contributions
7. Contact

Key Features:

• Simple & Intuitive Syntax: print("Hello, {}!", name); instead of std::cout << "Hello, " << name << "!";.
• Automatic Formatting: Handles multiple data types seamlessly, similar to Python's f-strings.
• Lightweight: Dependency-free, utilizing only C-style strings, variadic templates, and the iostream library.
• Error Handling: Provides clear error messages for mismatched placeholders and arguments.
• Supports C++14 and Above: Ensures compatibility with modern C++ standards.

Why Create Python-Print-In-CPP When Libraries Like fmt Exist?

While fmt is a great library, I developed Python-Print-In-CPP as a lightweight alternative for scenarios where minimizing dependencies is crucial, like in malware development. The goal was to create something small, efficient, and easy to integrate, without external libraries or added complexity. It’s perfect for projects where keeping the codebase lean is a priority, while still avoiding the verbosity of cout.

Installation:

• Copy python_print.h into your project directory.
• Include in Your Code: #include "python_print.h"

Usage Example

#include <iostream>
#include "python_print.h"

// Example usage
int main() {
   // Example 1: Simple replacement
   print("5 + 5 = {}", 10);
   // Output: 5 + 5 = 10

   // Example 2: Multiple replacements
   const char* greeting = "Hello";
   const char* target = "World";
   print("{} {}!", greeting, target);
   // Output: Hello World!

   // Example 3: Mixed types
   int age = 30;
   double pi = 3.14159;
   print("Age: {}, Pi: {}", age, pi);
   // Output: Age: 30, Pi: 3.14159

   // Example 4: Escaped braces
   print("Use double braces to include literals: {{}} and replace {}", "this");
   // Output: Use double braces to include literals: {} and replace this

   // Example 5: Escaped braces with multiple replacements
   print("Escaped braces: {{{{ and }}}} and values: {} {}", 100, 200);
   // Output: Escaped braces: {{ and }} and values: 100 200

   // Example 6: No arguments
   print("No arguments to replace here.");
   // Output: No arguments to replace here.   

   return 0;
}

Error Handling

• Extra Arguments: If more arguments are provided than placeholders, an error message is displayed.
• Missing Arguments: If fewer arguments are provided than placeholders, an error message is displayed.
• Escaped Braces: Use double braces ({{ or }}) to include literal braces in the output.

   //-- Error Handling --
   // Example 1: More arguments than placeholders
   print("Only one placeholder: {}", "First", "Second");
   // Output: Only one placeholder: First 
   // [!] Error: Extra arguments provided
   
   // Example 2: No placeholders
   print("This string has no placeholders.", 123);
   // Output: This string has no placeholders.
   // [!] Error: Extra arguments provided

   // Example 3: Fewer arguments than placeholders
   print("Missing arguments: {} and {}", "Only one");
   // Output: Missing arguments: Only one and  
   // [!] Error: Missing arguments

Contributions

Contributions are welcome! Please open an issue or submit a pull request for any enhancements or bug fixes.

Contact

Created by @WafflesExploits - You can reach me out on my socials :)