a2pcej

a2pcej, convert Alphabet to Phonetic Code in English and Japanese.

This module convert each alphabet letters to phonetic code, and also convert each alphabet letters to katakana.

Functions

conv_al(letters, delimiter='-', upper_sign='(CAPS)', num=False)

letters is string.

def conv_al(letters, delimiter='-', sign='(CAPS)', num=False):
    return str

conv_ak(letters, delimiter='・', upper_sign='（大文字）', num=False)

letters is string.

def conv_ak(letters, delimiter='・', sign='（大文字）', num=False):
    return str

Simple example of usage

First of all, import module.

>>> from a2pcej import *

Convert 'examples' to Phonetic code in English.

>>> conv_al('examples')
'Echo-Xray-Alfa-Mike-Papa-Lima-Echo-Sierra'

Convert 'examples' to Phonetic code in Japanese Katakana.

>>> conv_ak('examples')
'イー・エクス・エイ・エム・ピー・エル・イー・エス'

Non alphabet letters are not convert (default).
Upper case letters has (CAPS) or (大文字) sign (default).

>>> conv_al('Examples002')
'Echo(CAPS)-Xray-Alfa-Mike-Papa-Lima-Echo-Sierra-0-0-2'
>>> conv_ak('Examples002')
'イー（大文字）・エクス・エイ・エム・ピー・エル・イー・エス・0・0・2'

You can change delimiter and Upper case letters sign.

>>> conv_al('Examples003', delimiter=', ', sign='(CAPITAL)')
'Echo(CAPITAL), Xray, Alfa, Mike, Papa, Lima, Echo, Sierra, 0, 0, 3'
>>> conv_ak('Examples003', delimiter='／', sign='(大)')
'イー(大)／エクス／エイ／エム／ピー／エル／イー／エス／0／0／3'

If you would like to convert numbers to phonetic code, set num=True.

>>> conv_al('Examples004', num=True)
'Echo(CAPS)-Xray-Alfa-Mike-Papa-Lima-Echo-Sierra-zero-zero-four'
>>> conv_ak('Examples004', num=True)
'イー（大文字）・エクス・エイ・エム・ピー・エル・イー・エス・ゼロ・ゼロ・ヨン'

Development and Release

Setting up for development

# Clone the repository
git clone https://github.com/kacchan822/a2pcej.git
cd a2pcej

# Install in development mode
pip install -e .[dev]

# Run tests
pytest tests/ -v

# Format code
black .
isort .

# Lint code
flake8 .

Release Process

This project uses automated releases via GitHub Actions. To create a new release:

1. Update the version information and commit your changes
2. Create and push a tag:

   git tag v1.0.0  # Replace with your version
   git push origin v1.0.0

3. GitHub Actions will automatically:
   • Run tests across multiple Python versions
   • Build the package
   • Publish to PyPI

GitHub Actions Setup

To enable automatic PyPI publishing, you need to set up authentication:

Option 1: PyPI API Token (Traditional)

1. Create an API token on PyPI
2. Add it as PYPI_API_TOKEN in GitHub repository secrets

Option 2: Trusted Publishing (Recommended)

1. Configure Trusted Publishing on PyPI for this repository
2. No secrets needed - uses OpenID Connect (OIDC)

For more details, see the PyPI documentation on Trusted Publishing.