cedbox 0.1.0

A Python utility package for data handling, input validation, Morse code processing, and audio generation

CedBox

CedBox is a Python utility package that provides various tools for data handling, user input validation, Morse code processing, and audio generation.

Features

• Yggdrasil: A hierarchical tree-like data structure that extends Python's dictionary, with support for:

  • Automatic node creation
  • Loading data from DataFrames and SQL queries
  • Tree visualization

• Input Utilities: Functions for handling user input with validation and type conversion:

  • String input
  • Integer input with validation
  • Float input with validation
  • Choice selection
  • Boolean (yes/no) input
  • File path input with validation
  • Date input with validation
  • Email input with validation

• Morse Code Processing: Tools for working with Morse code:

  • Convert text to Morse code
  • Represent Morse code as time units
  • Generate Morse code sequences

• Audio Generation: Utilities for creating WAV audio files:

  • Generate audio signals from sequences of durations
  • Create Morse code audio signals

Installation

pip install cedbox

Usage Examples

Yggdrasil

Yggdrasil is a hierarchical tree-like data structure that extends Python's dictionary with additional functionality.

from cedbox import Yggdrasil
import pandas as pd

# Create a new tree
tree = Yggdrasil()

# Add data with automatic node creation
tree['users']['john']['email'] = '[e-mail]'
tree['users']['john']['age'] = 30
tree['users']['jane']['email'] = '[e-mail]'
tree['users']['jane']['age'] = 28

# Print tree structure
tree.print_tree()

Output:

Yggdrasil
├── users
│   ├── john
│   │   ├── email: [e-mail]
│   │   └── age: 30
│   └── jane
│       ├── email: [e-mail]
│       └── age: 28

Creating from DataFrame

# Create from DataFrame
df = pd.DataFrame({
    'name': ['John', 'Jane'],
    'email': ['[e-mail]', '[e-mail]'],
    'age': [30, 28]
})
tree_from_df = Yggdrasil.from_dataframe(df)
tree_from_df.print_tree()

Output:

Yggdrasil
├── 0
│   ├── name: John
│   ├── email: [e-mail]
│   └── age: 30
└── 1
    ├── name: Jane
    ├── email: [e-mail]
    └── age: 28

Creating from SQL Query

import sqlite3

# Create a sample database
conn = sqlite3.connect(':memory:')
cursor = conn.cursor()
cursor.execute('CREATE TABLE users (name TEXT, email TEXT, age INTEGER)')
cursor.execute('INSERT INTO users VALUES ("John", "[e-mail]", 30)')
cursor.execute('INSERT INTO users VALUES ("Jane", "[e-mail]", 28)')
conn.commit()

# Create tree from SQL query
tree_from_sql = Yggdrasil.from_sql("SELECT * FROM users", conn)
tree_from_sql.print_tree()

Output:

Yggdrasil
├── 0
│   ├── name: John
│   ├── email: [e-mail]
│   └── age: 30
└── 1
    ├── name: Jane
    ├── email: [e-mail]
    └── age: 28

Input Utilities

CedBox provides various functions for handling user input with validation and type conversion.

from cedbox.inputs import (
    string_put, int_put, float_put, choice_put, 
    bool_put, file_put, date_put, mail_put
)

# String input
name = string_put("Enter your name: ")
# User enters: John
print(f"Hello, {name}!")
# Output: Hello, John!

# Integer input with validation
age = int_put(
    "Enter your age: ", 
    conditions=[lambda x: x > 0, lambda x: x < 120],
    max_times=3,
    default=30
)
# User enters: -5
# Output: -5 is not valid assert lambda x: x > 0
# User enters: 25
print(f"You are {age} years old.")
# Output: You are 25 years old.

# Float input with validation
height = float_put(
    "Enter your height in meters: ",
    conditions=[lambda x: 0.5 < x < 2.5],
    default=1.75
)
# User enters: 1.85
print(f"Your height is {height} meters.")
# Output: Your height is 1.85 meters.

# Choice selection
color = choice_put("Select a color ", choices=['red', 'green', 'blue'])
# Output: Select a color (red/green/blue): 
# User enters: yellow
# Output: yellow is not valid
# User enters: red
print(f"You selected {color}.")
# Output: You selected red.

# Boolean input
confirm = bool_put("Confirm? ")
# Output: Confirm? (y/n): 
# User enters: y
print(f"Confirmed: {confirm}")
# Output: Confirmed: True

Morse Code Processing

The EasyMorse class provides tools for working with Morse code.

from cedbox import EasyMorse, MORSE_CODE_DICT

# Create Morse code from text
morse = EasyMorse("SOS")
print(f"Original text: {morse.raw_text}")
# Output: Original text: SOS

print(f"Morse code: {morse.morse_code}")
# Output: Morse code: ._._.____-_-_-___._._._

# View the time sequence (1=dot, 3=dash, -3=pause between symbols)
print(f"Time sequence: {morse.morse_seq}")
# Output: Time sequence: [1, 1, 1, -3, 3, 3, 3, -3, 1, 1, 1]

# Create with custom prefix (VVV- is a common Morse prefix)
morse_with_prefix = EasyMorse("HELLO", prefix=True)
print(f"With prefix: {morse_with_prefix.morse_message}")
# Output: With prefix: ._._._-___._._._-___._._._-___-_._._._._-_____._._._.___._____._____._._..___._..___._..___---

Audio Generation

The EasyWav class allows you to create WAV audio files from sequences of durations.

from cedbox import EasyMorse, EasyWav

# Create Morse code sequence for "SOS"
morse = EasyMorse("SOS")
sequence = morse.morse_seq
print(f"Morse sequence: {sequence}")
# Output: Morse sequence: [1, 1, 1, -3, 3, 3, 3, -3, 1, 1, 1]

# Generate WAV file from sequence
wav = EasyWav(
    sequence=sequence,
    frequency=800,  # 800 Hz tone
    time_unit=100   # 100ms per unit
)
wav.save('morse_sos.wav')
print("Audio file created: morse_sos.wav")
# Output: Audio file created: morse_sos.wav

# Create a more complex audio pattern
custom_sequence = [1, -1, 3, -1, 1, -3, 5, -5]  # Custom pattern of tones and pauses
wav = EasyWav(
    sequence=custom_sequence,
    frequency=440,  # A4 note
    sample_rate=48000  # Higher quality
)
wav.save('custom_pattern.wav')

Complete Example: Morse Code Converter

Here's a complete example that combines multiple components to create a Morse code converter:

from cedbox import EasyMorse, EasyWav, string_put

def morse_converter():
    # Get input text from user
    text = string_put("Enter text to convert to Morse code: ")

    # Convert to Morse code
    morse = EasyMorse(text, prefix=True)

    print(f"Text: {morse.raw_text}")
    print(f"Morse code: {morse.morse_code}")

    # Generate audio file
    wav = EasyWav(
        sequence=morse.morse_seq,
        frequency=800,
        time_unit=80  # Faster speed
    )

    filename = f"morse_{text.replace(' ', '_')}.wav"
    wav.save(filename)
    print(f"Audio saved to {filename}")

    return morse, filename

# Run the converter
morse_result, audio_file = morse_converter()

Dependencies

• pandas >= 2.0.0
• setuptools == 80.9.0
• pytest (for testing)

License

See the LICENSE file for details.