Skip to main content

A package to identify Tanzanian phone number carriers.

Project description

nambazasimu

A Python package that identifies a Tanzanian phone number with respect to the mobile network (carrier).

Why is this important?

In Tanzania, it can be challenging to identify which mobile network a phone number belongs to. This can be especially important for various services that rely on knowing the carrier, such as billing, sending cash, customer support, or mobile-specific features.

Mobile Networks covered

  • Vodacom
  • Tigo
  • Airtel
  • Halotel
  • Zantel
  • Smile

Research

The author conducted intensive research and came across useful resources:

Installation

You can install the nambazasimu package via pip:

pip install nambazasimu

Usage

To use the package, you can import the identify_carrier function and pass a Tanzanian phone number to it. Here's a simple example:

from nambazasimu.carrier_identifier import identify_carrier

print(identify_carrier("+255684567890"))  # Output: Airtel
print(identify_carrier("255754567890"))   # Output: Voda
print(identify_carrier("0714567890"))     # Output: Tigo

How to Contribute

If you'd like to contribute to this project, follow these steps:

  1. Fork the repo: Click the "Fork" button at the top right of the repository page.

  2. Clone the forked repo:

    git clone https://github.com/<yourusername>/nambazasimu.git
    
  3. Navigate to the project directory:

    cd nambazasimu
    
  4. Set up a Python environment and install the requirements:

    python -m venv venv
    source venv/bin/activate  # On Windows use `venv\Scripts\activate`
    pip install -r requirements.txt
    
  5. Make your changes, and be sure to write tests if necessary.

  6. Commit your changes:

    git add .
    git commit -m "Description of your changes"
    
  7. Push your changes to your fork:

    git push origin your-branch-name
    
  8. Raise a Pull Request: Go to the original repository and create a new pull request.

Challenges

This package won't work if a phone number has undergone Mobile Number Portability .

What is MNP ( Mobile Number Portability ) ?

Mobile Number Portability (MNP) is a telecommunications feature that allows mobile phone users to retain their phone numbers when switching from one mobile network operator to another.

Raising Issues

If you encounter any issues, please report them via the GitHub issues page. Provide as much detail as possible about the issue, including any error messages and steps to reproduce the problem.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

References

Example Code

Here are some more examples of how to use the package:

from nambazasimu.carrier_identifier import identify_carrier

print(identify_carrier("+255625567890"))  # Output: Halotel
print(identify_carrier("255774567890"))   # Output: Zantel
print(identify_carrier("0734567890"))     # Output: TTCL
print(identify_carrier("+255123456789"))  # Output: Unknown

Feel free to reach out if you have any questions or need further assistance!

Author: Alex Mkwizu Email : alexgmkwizu@gmail.com | @genie360s

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nambazasimu-0.1.0.tar.gz (4.4 kB view details)

Uploaded Source

File details

Details for the file nambazasimu-0.1.0.tar.gz.

File metadata

  • Download URL: nambazasimu-0.1.0.tar.gz
  • Upload date:
  • Size: 4.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for nambazasimu-0.1.0.tar.gz
Algorithm Hash digest
SHA256 76828fc99413cbf00a26aa5c13c105014cd0e9a95414859ff0eed40957bb49fc
MD5 3150b81adb803ba275514cbbfede1f66
BLAKE2b-256 572c260fac67b06e2842548d9c4b47d88cfef73a71b4dc617255452acd66592c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page