bin-dec-conversions 0.1.1__py3-none-any.whl

bin_dec_conversions/__init__.py

@@ -0,0 +1,3 @@
+from .bin_dec_conversions import binary_to_decimal, decimal_to_binary
+
+__all__ = ["binary_to_decimal", "decimal_to_binary"]

bin_dec_conversions/bin_dec_conversions.py

@@ -0,0 +1,32 @@
+import re
+
+
+def binary_to_decimal(binary: str) -> int:
+    if not re.fullmatch(r"[01]+", binary):
+        raise ValueError("Binary must contain only 0s and 1s")
+
+    decimal = 0
+    for i, bit in enumerate(reversed(binary)):
+        if bit == "1":
+            decimal += 2**i
+
+    return decimal
+
+
+def decimal_to_binary(decimal: int, width: int = 0) -> str:
+    """Convert a non-negative integer to binary, left-padded with zeros to `width`."""
+    if decimal < 0:
+        raise ValueError("Decimal must be non-negative")
+    if width < 0:
+        raise ValueError("Width must be non-negative")
+
+    if decimal == 0:
+        bits = "0"
+    else:
+        digits = []
+        while decimal > 0:
+            digits.append(str(decimal % 2))
+            decimal //= 2
+        bits = "".join(reversed(digits))
+
+    return bits.zfill(width)

bin_dec_conversions/cli.py

@@ -0,0 +1,107 @@
+import argparse
+import sys
+
+import questionary
+
+from bin_dec_conversions import binary_to_decimal, decimal_to_binary
+
+
+def prompt_binary_to_decimal() -> None:
+    while True:
+        binary = input("Insert a binary number: ").strip()
+        try:
+            decimal = binary_to_decimal(binary)
+        except ValueError as e:
+            print(e)
+        else:
+            print(f"The decimal equivalent of {binary} is {decimal}")
+            return
+
+
+def prompt_decimal_to_binary() -> None:
+    while True:
+        raw = input("Insert a decimal number: ").strip()
+        try:
+            decimal = int(raw)
+        except ValueError:
+            print("Insert a whole number!")
+            continue
+
+        try:
+            binary = decimal_to_binary(decimal)
+        except ValueError as e:
+            print(e)
+        else:
+            print(f"The binary equivalent of {decimal} is {binary}")
+            return
+
+
+def interactive_menu():
+    choice = questionary.select(
+        "Which operation do you want to perform?",
+        choices=[
+            "From binary to decimal",
+            "From decimal to binary",
+        ],
+    ).ask()
+
+    match choice:
+        case "From binary to decimal":
+            prompt_binary_to_decimal()
+        case "From decimal to binary":
+            prompt_decimal_to_binary()
+
+
+def create_parser():
+    parser = argparse.ArgumentParser(
+        prog="bin-dec-conversions",
+        description="Convert between binary and decimal. "
+        "Run with no arguments for interactive mode.",
+    )
+    group = parser.add_mutually_exclusive_group()
+    group.add_argument(
+        "-d",
+        "--to-decimal",
+        metavar="BINARY",
+        help="convert a binary string to decimal",
+    )
+    group.add_argument(
+        "-b",
+        "--to-binary",
+        metavar="DECIMAL",
+        type=int,
+        help="convert a non-negative integer to binary",
+    )
+    parser.add_argument(
+        "-w",
+        "--width",
+        type=int,
+        default=0,
+        help="zero-pad the binary output to this width (only with --to-binary)",
+    )
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = create_parser()
+    args = parser.parse_args(argv)
+
+    if args.width and args.to_binary is None:
+        parser.error("--width can only be used with --to-binary")
+
+    try:
+        if args.to_decimal is not None:
+            print(binary_to_decimal(args.to_decimal))
+        elif args.to_binary is not None:
+            print(decimal_to_binary(args.to_binary, args.width))
+        else:
+            interactive_menu()
+    except ValueError as e:
+        print(e, file=sys.stderr)
+        return 1
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemError(main())

bin_dec_conversions-0.1.1.dist-info/METADATA

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: bin-dec-conversions
+Version: 0.1.1
+Summary: Convert between binary and decimal from Python or the command line
+Author-email: Marco Salvatore Tornabene <tornabenemarco56@gmail.com>
+License-Expression: MIT
+Project-URL: Repository, https://github.com/JustM4rk123/bin_dec_conversions
+Keywords: binary,decimal,conversion
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: questionary
+Dynamic: license-file
+
+# bin-dec-conversions
+
+Convert binary numbers to decimal and decimal integers to binary with a small
+Python library and command-line interface.
+
+## Features
+
+- Convert a non-empty string of `0`s and `1`s to a decimal integer.
+- Convert a non-negative integer to binary, optionally padding the output to a
+  minimum width.
+- Use the interactive menu or run a conversion directly with command-line
+  options.
+- Validate inputs and report invalid values.
+
+## Requirements
+
+- Python 3.10 or newer.
+- [`questionary`](https://github.com/tmbo/questionary) is installed automatically
+  and is used by the interactive menu.
+
+## Installation
+
+Clone the repository and install the package:
+
+```bash
+git clone https://github.com/JustM4rk123/bin_dec_conversions.git
+cd bin_dec_conversions
+python -m pip install .
+```
+
+## Usage
+
+### Command line
+
+Run without arguments to open the interactive menu. Select a conversion with
+the arrow keys and Enter, then enter a value:
+
+```text
+Which operation do you want to perform?  From binary to decimal
+Insert a binary number: 1010
+The decimal equivalent of 1010 is 10
+```
+
+In interactive mode, invalid input displays an error and prompts again. You can
+also convert directly with flags:
+
+```console
+$ bin-dec-conversions --to-decimal 1010
+10
+
+$ bin-dec-conversions --to-binary 10
+1010
+
+$ bin-dec-conversions --to-binary 10 --width 8
+00001010
+```
+
+Use `-d` for `--to-decimal`, `-b` for `--to-binary`, and `-w` for `--width`.
+The conversion options are mutually exclusive. The width option zero-pads
+binary output to at least the requested number of characters; it never
+truncates a result. Invalid flag-mode input is reported as an error and exits
+with a non-zero status.
+
+### Python library
+
+The public API provides two functions:
+
+- `binary_to_decimal(binary: str) -> int` converts a non-empty string containing
+  only `0`s and `1`s. It raises `ValueError` for empty strings or other
+  characters.
+- `decimal_to_binary(decimal: int, width: int = 0) -> str` converts a
+  non-negative integer to binary, left-padded with zeros to at least `width`
+  characters. It raises `ValueError` if the value or width is negative.
+
+```python
+from bin_dec_conversions import binary_to_decimal, decimal_to_binary
+
+binary_to_decimal("1010")        # 10
+binary_to_decimal("0001")        # 1 (leading zeros are allowed)
+
+decimal_to_binary(10)            # "1010"
+decimal_to_binary(5, width=8)    # "00000101"
+decimal_to_binary(255, width=4)  # "11111111" (never truncated)
+```
+
+## Development
+
+Create a virtual environment and install the project in editable mode with its
+development dependencies:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate        # Windows: .venv\Scripts\activate
+python -m pip install -e . --group dev  # requires pip 25.1+
+```
+
+Alternatively, with [uv](https://docs.astral.sh/uv/), run `uv sync`. The `dev`
+dependency group includes `pytest`, `black`, and `ruff`.
+
+Run the tests:
+
+```bash
+python -m pytest
+```
+
+Format and lint:
+
+```bash
+black .
+ruff check .
+```
+
+## Project structure
+
+```text
+bin_dec_conversions/
+├── pyproject.toml
+├── src/
+│   └── bin_dec_conversions/
+│       ├── __init__.py              # public API
+│       ├── bin_dec_conversions.py   # conversion functions
+│       └── cli.py                   # command-line interface
+└── tests/
+    ├── test_bin_dec_conversion.py
+    └── test_cli.py
+```
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE](LICENSE).

bin_dec_conversions-0.1.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+bin_dec_conversions/__init__.py,sha256=R8WfnORM39P_AF4mZZ1SeDww8jE5giwubvHGIUvYrLw,124
+bin_dec_conversions/bin_dec_conversions.py,sha256=MStJDemHowK8k1M12t0B69Shz2MsrFLJR7FvqwoB0I4,834
+bin_dec_conversions/cli.py,sha256=Igs1PMEaZ-G5sVhnKlsdcYCRRLmjRLuEW1iYlc0Jx4k,2736
+bin_dec_conversions-0.1.1.dist-info/licenses/LICENSE,sha256=YfFS1t3oeYHfAswn3mkASw5-g_S3lj7-Qk9iZH1ZPTY,1075
+bin_dec_conversions-0.1.1.dist-info/METADATA,sha256=qIs4NLpNWNwQR6s_aTuS-hq_XDWJ0HCLoO58ZDOAMtU,3983
+bin_dec_conversions-0.1.1.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+bin_dec_conversions-0.1.1.dist-info/entry_points.txt,sha256=KcOQCt_0BsbPt6Xr3-sykbZ4p8fLiLKvx83FaocFHY0,69
+bin_dec_conversions-0.1.1.dist-info/top_level.txt,sha256=Jvs-J_e3y4uJKoPbaEzOrbBWSZaOHlxdZH2dSpH3K5k,20
+bin_dec_conversions-0.1.1.dist-info/RECORD,,

bin_dec_conversions-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bin_dec_conversions-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bin-dec-conversions = bin_dec_conversions.cli:main

bin_dec_conversions-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marco S. Tornabene
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bin_dec_conversions-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+bin_dec_conversions