bin-dec-conversions 0.1.1__tar.gz

bin_dec_conversions-0.1.1/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,130 @@
+# 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/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools >= 77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bin-dec-conversions"
+version = "0.1.1"
+requires-python = ">=3.10"
+authors = [{name = "Marco Salvatore Tornabene", email = "tornabenemarco56@gmail.com"}]
+description = "Convert between binary and decimal from Python or the command line"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["binary", "decimal", "conversion"]
+dependencies = ["questionary"]
+
+[project.urls]
+Repository = "https://github.com/JustM4rk123/bin_dec_conversions"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "black",
+    "ruff",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[project.scripts]
+bin-dec-conversions = "bin_dec_conversions.cli:main"

bin_dec_conversions-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bin_dec_conversions-0.1.1/src/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-0.1.1/src/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-0.1.1/src/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/src/bin_dec_conversions.egg-info/PKG-INFO

@@ -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/src/bin_dec_conversions.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/bin_dec_conversions/__init__.py
+src/bin_dec_conversions/bin_dec_conversions.py
+src/bin_dec_conversions/cli.py
+src/bin_dec_conversions.egg-info/PKG-INFO
+src/bin_dec_conversions.egg-info/SOURCES.txt
+src/bin_dec_conversions.egg-info/dependency_links.txt
+src/bin_dec_conversions.egg-info/entry_points.txt
+src/bin_dec_conversions.egg-info/requires.txt
+src/bin_dec_conversions.egg-info/top_level.txt
+tests/test_bin_dec_conversion.py
+tests/test_cli.py

bin_dec_conversions-0.1.1/src/bin_dec_conversions.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bin_dec_conversions-0.1.1/src/bin_dec_conversions.egg-info/entry_points.txt

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

bin_dec_conversions-0.1.1/src/bin_dec_conversions.egg-info/requires.txt

@@ -0,0 +1 @@
+questionary

bin_dec_conversions-0.1.1/src/bin_dec_conversions.egg-info/top_level.txt

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

bin_dec_conversions-0.1.1/tests/test_bin_dec_conversion.py

@@ -0,0 +1,85 @@
+import pytest
+
+from bin_dec_conversions import binary_to_decimal, decimal_to_binary
+
+# --- binary_to_decimal ---
+
+
+@pytest.mark.parametrize(
+    "binary, expected",
+    [
+        ("0", 0),
+        ("1", 1),
+        ("1010", 10),
+        ("10000000", 128),
+        ("11111111", 255),
+        ("0001", 1),  # leading zeros
+    ],
+)
+def test_bin2dec(binary, expected):
+    assert binary_to_decimal(binary) == expected
+
+
+@pytest.mark.parametrize("bad", ["", "20", "Cat", "1 0", "-101", "10.1", " 101"])
+def test_bin2dec_invalid(bad):
+    with pytest.raises(ValueError):
+        binary_to_decimal(bad)
+
+
+# --- decimal_to_binary ---
+
+
+@pytest.mark.parametrize(
+    "decimal, expected",
+    [
+        (0, "0"),
+        (1, "1"),
+        (10, "1010"),
+        (128, "10000000"),
+        (255, "11111111"),
+    ],
+)
+def test_dec2bin(decimal, expected):
+    assert decimal_to_binary(decimal) == expected
+
+
+def test_dec2bin_negative():
+    with pytest.raises(ValueError):
+        decimal_to_binary(-10)
+
+
+# --- width / padding (needed for 8-bit octets) ---
+
+
+@pytest.mark.parametrize(
+    "decimal, width, expected",
+    [
+        (5, 8, "00000101"),
+        (0, 8, "00000000"),
+        (255, 8, "11111111"),
+        (1, 4, "0001"),
+        (5, 0, "101"),  # default: no padding
+        (255, 4, "11111111"),  # width smaller than needed: never truncates
+    ],
+)
+def test_dec2bin_width(decimal, width, expected):
+    assert decimal_to_binary(decimal, width) == expected
+
+
+def test_dec2bin_negative_width():
+    with pytest.raises(ValueError):
+        decimal_to_binary(5, -1)
+
+
+# --- cross-checks ---
+
+
+@pytest.mark.parametrize("n", range(300))
+def test_matches_builtins(n):
+    assert decimal_to_binary(n) == bin(n)[2:]
+    assert binary_to_decimal(bin(n)[2:]) == n
+
+
+@pytest.mark.parametrize("n", [0, 1, 2, 10, 128, 255, 1023])
+def test_round_trip(n):
+    assert binary_to_decimal(decimal_to_binary(n)) == n

bin_dec_conversions-0.1.1/tests/test_cli.py

@@ -0,0 +1,33 @@
+import pytest
+
+from bin_dec_conversions.cli import main
+
+
+def test_to_decimal(capsys):
+    assert main(["--to-decimal", "1010"]) == 0
+    assert capsys.readouterr().out.strip() == "10"
+
+
+def test_to_binary_with_width(capsys):
+    assert main(["-b", "5", "-w", "8"]) == 0
+    assert capsys.readouterr().out.strip() == "00000101"
+
+
+def test_invalid_binary(capsys):
+    assert main(["-d", "102"]) == 1
+    assert capsys.readouterr().err != ""
+
+
+def test_negative_decimal(capsys):
+    assert main(["-b", "-5"]) == 1
+
+
+def test_width_without_to_binary():
+    with pytest.raises(SystemExit) as exc:
+        main(["--width", "8"])
+    assert exc.value.code == 2
+
+
+def test_mutually_exclusive():
+    with pytest.raises(SystemExit):
+        main(["-d", "101", "-b", "5"])