Skip to main content

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

Project description

Last Big Update: 1.1.0

- Added Support For Negative Numbers.

- A New Function «resys» For Converting To Decimal.

- New Error Handler.

- New Readme.


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 *» or «from sys_converter import sys, resys».
  • To use the library functions, use the command «sys(number: int, number_system_base: int)» or «resys(number: str, 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)
Fractional precision Fixed at 10 decimal places
Input type Integer, float or string only (look at «Usage»)

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

Error Examples

from sys_converter import *

# 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

# Not a number
result = resys("-4-2", 10)
print(result)
# Output:
# ERROR! The converted number is not a valid integer

# 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

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
1.1.0 02.04.2026 Release: Added Support For Negative Numbers, A New "resys" Function, A New Error Handler And A New Readme
1.1.1 02.04.2026 Release: Fixed Critical Bugs
1.1.2 02.04.2026 Release: Fixed Critical Bugs
1.1.3 03.04.2026 Release: Fixed Error Handler Bugs

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.1.3.tar.gz (5.3 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.1.3-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: sys_converter-1.1.3.tar.gz
  • Upload date:
  • Size: 5.3 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.1.3.tar.gz
Algorithm Hash digest
SHA256 ed73311b86f36122928e593e99f4c020abd2f1a24d1aabaf30a318ea782f57bb
MD5 326ec9c47922a00813a26358768a5a2b
BLAKE2b-256 65bf66b906456c52dbf47dbfb6ea984f03c93152624c07e90ae407f336ec60a7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: sys_converter-1.1.3-py3-none-any.whl
  • Upload date:
  • Size: 5.3 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.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 dcbcc38bbc92dd8ff4353342ee6ccc6e39d0edf0ac1f4d06eeff7d635849f7fe
MD5 ca36e3fb0072f26b2b6eec641fed30e6
BLAKE2b-256 11c0d2ff6b36b5933aae9ce2cc7935e7c64a5d7ade90acc14a6ea438291cb6cb

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