Skip to main content

A library for converting numbers to different number systems (2-36)

Project description

Sys Converter

A library for converting numbers to different number systems (from binary to base-36).

Features

  • Convert integers to any number system (2-36).
  • Convert fractional numbers with precision up to 10 decimal places.
  • Error handling with clear messages.
  • Support for floating-point numbers.

Installation

pip install sys-converter

Usage

  • To import, use «from sys_converter import sys».
  • To use the library functions, use the command «sys(number: int, number_system_base: int)».

For example

This program accepts an integer (int) as input and outputs this number in the base-4 number system.

from sys_converter import sys

temp_num = int(input()) # Input: 26
new_num = sys(temp_num, 4)

print(new_num) # Output: 122

Requirements

  • Python 3.6 or higher
  • No external dependencies (uses only standard library)

Limitations

Limitation Details
Maximum base 36 (uses digits 0–9 and letters A–Z)
Negative numbers Not supported (returns error message)
Fractional precision Fixed at 10 decimal places
Input type Integer or float only

Error Handling

The library includes a comprehensive error handling system that validates inputs and provides clear, informative error messages.

Error Types

Error Description
Base out of range The number system base must be between 2 and 36
Base is not an integer The base parameter cannot be a floating-point number
Base is missing The base parameter is required
Negative number The library does not support negative numbers

Error Examples

from sys_converter import sys

# Invalid base (greater than 36)
result = sys(42, 37)
print(result)
# Output:
# ERROR! The base of the number system cannot be greater than 36

# Invalid base (less than 2)
result = sys(42, 1)
print(result)
# Output:
# ERROR! The base of the number system cannot be less than 2

# Base as float
result = sys(42, 4.5)
print(result)
# Output:
# ERROR! The base of the number system cannot be float number

# Negative number
result = sys(-42, 10)
print(result)
# Output:
# ERROR! The converted number cannot be a negative number

# Multiple errors (all displayed)
result = sys(-42, 1.5)
print(result)
# Output:
# ERROR! The base of the number system cannot be less than 2
# ERROR! The base of the number system cannot be float number
# ERROR! The converted number cannot be a negative number

Changelog

Version Date Commit
0.1.0 10.03.2026 Beta: First Beta Version On PyPI
0.1.1 10.03.2026 Beta: Fixed Critical Bugs
0.1.2 10.03.2026 Beta: Fixed Critical Bugs And New Error Handling
1.0.0 31.03.2026 Release: New Readme
1.0.1 31.03.2026 Release: New Readme
1.0.2 31.03.2026 Release: Without Changes

Made by the Hi Team.

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

sys_converter-1.0.2.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sys_converter-1.0.2-py3-none-any.whl (5.0 kB view details)

Uploaded Python 3

File details

Details for the file sys_converter-1.0.2.tar.gz.

File metadata

  • Download URL: sys_converter-1.0.2.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for sys_converter-1.0.2.tar.gz
Algorithm Hash digest
SHA256 76311c92de21770a587fbcf99d3cf151a975d3bc7fe05b91f7f16c7fd221b71d
MD5 bc836cd6edef2b93cfe97efe2e21a2b9
BLAKE2b-256 87482588328d68d69436b15858cb2644faf587e065eedce2b20f2c6c150b1152

See more details on using hashes here.

File details

Details for the file sys_converter-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: sys_converter-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 5.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for sys_converter-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 fcf0ddf933ff9de747860884b81fe438f59ba554aaea9f3341fff4b602c8c3b4
MD5 9ed5e69b8dddafe8ed262b34144431a2
BLAKE2b-256 ee36e3c9fb35d8e3bef87f8fc47db23a8c9e2447444c34f0c2385939be546367

See more details on using hashes here.

Supported by

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