num2words2 0.1.0.dev1__tar.gz

num2words2-0.1.0.dev1/.coveragerc

@@ -0,0 +1,5 @@
+[run]
+branch = true
+source =
+    num2words2
+    tests

num2words2-0.1.0.dev1/.flake8

@@ -0,0 +1,14 @@
+[flake8]
+max-line-length = 160
+exclude =
+    .tox,
+    venv,
+    build,
+    dist,
+    num2words2/_version.py,
+    .git,
+    __pycache__,
+    *.egg-info
+ignore = E501,W503,W504
+per-file-ignores =
+    tests/*:E501,W293,W292,W503,W504

num2words2-0.1.0.dev1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+```python
+# Code example that demonstrates the issue
+from num2words2 import num2words
+# Your code here
+```
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Actual behavior**
+What actually happened instead.
+
+**Environment (please complete the following information):**
+ - OS: [e.g. Ubuntu 20.04]
+ - Python version: [e.g. 3.9.5]
+ - num2words2 version: [e.g. 0.5.15]
+ - Language/locale: [e.g. en, fr, es]
+
+**Additional context**
+Add any other context about the problem here.

num2words2-0.1.0.dev1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,30 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Language Support Request**
+If this is a request for a new language:
+- Language name:
+- ISO 639-1 code:
+- Example numbers and their text representation:
+  - 1:
+  - 10:
+  - 100:
+  - 1000:
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

num2words2-0.1.0.dev1/.github/ISSUE_TEMPLATE/language_support.md

@@ -0,0 +1,71 @@
+---
+name: Language Support
+about: Request support for a new language
+title: 'Add support for [LANGUAGE NAME]'
+labels: language-support
+assignees: ''
+
+---
+
+**Language Information**
+- Language name:
+- ISO 639-1 code:
+- ISO 639-2 code:
+- Writing system:
+- Number of native speakers (approximate):
+
+**Number System**
+Please provide examples of how numbers are written in this language:
+
+**Cardinal Numbers:**
+- 0:
+- 1:
+- 2:
+- 10:
+- 11:
+- 20:
+- 21:
+- 100:
+- 101:
+- 200:
+- 1000:
+- 1001:
+- 10000:
+- 100000:
+- 1000000:
+
+**Ordinal Numbers:**
+- 1st:
+- 2nd:
+- 3rd:
+- 10th:
+- 11th:
+- 20th:
+- 100th:
+
+**Decimal Numbers:**
+- 0.5:
+- 1.5:
+- 10.25:
+
+**Negative Numbers:**
+- -1:
+- -10:
+- -100:
+
+**Special Cases or Rules**
+Please describe any special grammatical rules, gender agreements, or other considerations for number words in this language:
+
+**Currency**
+If applicable, how are currency amounts expressed:
+- Currency name:
+- Currency code:
+- Example: 1.50 [currency] =
+
+**Resources**
+Please provide any reference materials or authoritative sources for the number system in this language:
+
+**Are you willing to help implement this?**
+- [ ] Yes, I can help with implementation
+- [ ] Yes, I can help with testing
+- [ ] No, but I can provide more examples if needed

num2words2-0.1.0.dev1/.github/dependabot.yml

@@ -0,0 +1,34 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+
+version: 2
+updates:
+  # Maintain dependencies for pip
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "03:00"
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+    open-pull-requests-limit: 10
+
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "03:00"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "ci"
+      include: "scope"
+    open-pull-requests-limit: 10

num2words2-0.1.0.dev1/.github/pull_request_template.md

@@ -0,0 +1,28 @@
+## Description
+Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context.
+
+Fixes # (issue)
+
+## Type of change
+Please delete options that are not relevant.
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] This change requires a documentation update
+
+## Checklist:
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published in downstream modules
+
+## Language Support
+If adding support for a new language:
+- [ ] Added comprehensive test cases
+- [ ] Updated README.md with the new language
+- [ ] Followed the existing language module structure

num2words2-0.1.0.dev1/.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.8, 3.9, '3.10', '3.11', '3.12', '3.13']
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # For setuptools_scm
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install tox tox-gh-actions coveralls
+        pip install -r tests/requirements-test.txt
+    - name: Test with tox
+      run: |
+        tox -v || (echo "Tox failed. Here's the log:" && cat .tox/*/log/*.log 2>/dev/null && exit 1)
+    - name: Build package
+      if: matrix.python-version == '3.11'
+      run: |
+        pip install build
+        python -m build
+        ls -la dist/
+    - name: Upload build artifacts
+      if: matrix.python-version == '3.11'
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+    - name: Upload coverage data to coveralls.io
+      run: coveralls --service=github
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        COVERALLS_FLAG_NAME: ${{ matrix.python-version }}
+        COVERALLS_PARALLEL: true
+      continue-on-error: true
+
+  coveralls:
+    name: Indicate completion to coveralls.io
+    needs: build
+    runs-on: ubuntu-latest
+    container: python:3-slim
+    steps:
+      - name: Finished
+        run: |
+          pip3 install --upgrade coveralls
+          coveralls --service=github --finish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

num2words2-0.1.0.dev1/.github/workflows/codeql-analysis.yml

@@ -0,0 +1,46 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ master, main ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master, main ]
+  schedule:
+    - cron: '45 23 * * 5'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'python' ]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3

num2words2-0.1.0.dev1/.github/workflows/e2e-tests.yml

@@ -0,0 +1,118 @@
+name: E2E Tests
+
+on:
+  push:
+    branches: [ master, main, develop ]
+    paths:
+      - 'num2words2/**'
+      - 'tests/**'
+      - 'tests/run_e2e_tests.py'
+      - 'tests/e2e_test_suite.csv'
+      - '.github/workflows/e2e-tests.yml'
+  pull_request:
+    branches: [ master, main ]
+    paths:
+      - 'num2words2/**'
+      - 'tests/**'
+      - 'tests/run_e2e_tests.py'
+      - 'tests/e2e_test_suite.csv'
+  schedule:
+    # Run daily at 2 AM UTC
+    - cron: '0 2 * * *'
+  workflow_dispatch:
+    inputs:
+      test_limit:
+        description: 'Number of tests to run (empty for all)'
+        required: false
+        default: ''
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+        include:
+          # Test on PyPy as well
+          - os: ubuntu-latest
+            python-version: 'pypy-3.9'
+          - os: ubuntu-latest
+            python-version: 'pypy-3.10'
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+        cache: 'pip'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pytest pytest-cov
+        pip install -e .
+
+    - name: Quick E2E Test (PR/Push)
+      if: github.event_name != 'schedule' && github.event_name != 'workflow_dispatch'
+      run: |
+        python tests/run_e2e_tests.py --quick --detailed
+      continue-on-error: ${{ matrix.python-version == 'pypy-3.9' || matrix.python-version == 'pypy-3.10' }}
+
+    - name: Full E2E Test (Scheduled)
+      if: github.event_name == 'schedule'
+      run: |
+        python tests/run_e2e_tests.py --detailed --limit 10000
+      continue-on-error: ${{ matrix.python-version == 'pypy-3.9' || matrix.python-version == 'pypy-3.10' }}
+
+    - name: Custom E2E Test (Manual)
+      if: github.event_name == 'workflow_dispatch'
+      run: |
+        if [ -z "${{ github.event.inputs.test_limit }}" ]; then
+          python tests/run_e2e_tests.py --detailed
+        else
+          python tests/run_e2e_tests.py --detailed --limit ${{ github.event.inputs.test_limit }}
+        fi
+      shell: bash
+      continue-on-error: ${{ matrix.python-version == 'pypy-3.9' || matrix.python-version == 'pypy-3.10' }}
+
+    - name: Upload test results
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: e2e-results-${{ matrix.os }}-${{ matrix.python-version }}
+        path: |
+          *.log
+          test-results/
+        retention-days: 30
+
+  summary:
+    needs: test
+    runs-on: ubuntu-latest
+    if: always()
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Create summary
+      run: |
+        echo "# E2E Test Results Summary" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "## Test Configuration" >> $GITHUB_STEP_SUMMARY
+        echo "- Trigger: ${{ github.event_name }}" >> $GITHUB_STEP_SUMMARY
+        echo "- Branch: ${{ github.ref_name }}" >> $GITHUB_STEP_SUMMARY
+        echo "- Commit: ${{ github.sha }}" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "## Results by Platform and Python Version" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "| OS | Python | Status |" >> $GITHUB_STEP_SUMMARY
+        echo "|---|---|---|" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "Results will be updated as jobs complete." >> $GITHUB_STEP_SUMMARY

num2words2-0.1.0.dev1/.github/workflows/lint.yml

@@ -0,0 +1,48 @@
+name: Lint
+
+on:
+  push:
+    branches: [ master, main ]
+  pull_request:
+    branches: [ master, main ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10']
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install flake8 isort black mypy
+
+    - name: Check code formatting with Black
+      run: |
+        black --check --diff num2words2 tests
+      continue-on-error: true
+
+    - name: Lint with flake8
+      run: |
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 num2words2 tests --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+        flake8 num2words2 tests --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+    - name: Check import sorting with isort
+      run: |
+        isort --check-only --diff num2words2 tests
+      continue-on-error: true
+
+    - name: Type checking with mypy
+      run: |
+        mypy num2words2 --ignore-missing-imports
+      continue-on-error: true

num2words2-0.1.0.dev1/.github/workflows/manual-publish.yml

@@ -0,0 +1,90 @@
+# Manual workflow to publish to PyPI
+name: Manual PyPI Publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      version_increment:
+        description: 'Version increment type'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+        - patch
+        - minor
+        - major
+
+permissions:
+  contents: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.x'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: Get current version
+      id: get_version
+      run: |
+        VERSION=$(python -c "import re; print(re.search(r'__version__ = [\"\'](.*?)[\"\']', open('bin/num2words2').read()).group(1))")
+        echo "current_version=$VERSION" >> $GITHUB_OUTPUT
+
+    - name: Increment version
+      run: |
+        CURRENT_VERSION=${{ steps.get_version.outputs.current_version }}
+        IFS='.' read -r -a parts <<< "$CURRENT_VERSION"
+        major=${parts[0]}
+        minor=${parts[1]}
+        patch=${parts[2]}
+
+        case "${{ github.event.inputs.version_increment }}" in
+          "major")
+            major=$((major + 1))
+            minor=0
+            patch=0
+            ;;
+          "minor")
+            minor=$((minor + 1))
+            patch=0
+            ;;
+          "patch")
+            patch=$((patch + 1))
+            ;;
+        esac
+
+        NEW_VERSION="$major.$minor.$patch"
+
+        # Update version in bin/num2words2
+        sed -i "s/__version__ = \"$CURRENT_VERSION\"/__version__ = \"$NEW_VERSION\"/" bin/num2words2
+
+        echo "Updated version from $CURRENT_VERSION to $NEW_VERSION"
+
+        # Commit the version bump
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+        git add bin/num2words2
+        git commit -m "Bump version to $NEW_VERSION [skip ci]"
+        git push
+
+    - name: Build package
+      run: python -m build
+
+    - name: Publish package to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        twine upload dist/* --verbose

num2words2-0.1.0.dev1/.github/workflows/manual-release.yml

@@ -0,0 +1,88 @@
+name: Manual Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version number (e.g., 1.0.0)'
+        required: true
+        type: string
+      prerelease:
+        description: 'Pre-release?'
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  create-release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build setuptools wheel setuptools_scm
+        pip install -r tests/requirements-test.txt
+
+    - name: Run tests
+      run: |
+        python -m pytest tests/ -v --tb=short
+
+    - name: Build distribution
+      run: |
+        python -m build
+        ls -la dist/
+
+    - name: Check build
+      run: |
+        pip install twine
+        twine check dist/*
+
+    - name: Create and push tag
+      run: |
+        git config user.name "GitHub Actions"
+        git config user.email "actions@github.com"
+        git tag -a "v${{ inputs.version }}" -m "Release v${{ inputs.version }}"
+        git push origin "v${{ inputs.version }}"
+
+    - name: Create GitHub Release
+      uses: softprops/action-gh-release@v1
+      with:
+        tag_name: v${{ inputs.version }}
+        name: Release v${{ inputs.version }}
+        draft: false
+        prerelease: ${{ inputs.prerelease }}
+        files: dist/*
+        body: |
+          ## Release v${{ inputs.version }}
+
+          ### What's New
+          - Added 45 new language modules
+          - Now supporting 119+ language codes
+          - Full implementations with native language support
+
+          ### Installation
+          ```bash
+          pip install num2words2==${{ inputs.version }}
+          ```
+
+          ### Full Changelog
+          See [CHANGELOG](https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md)
+
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/