feat: Creating a base number conversion package

Author: Nave-wata

.gitignore

@@ -0,0 +1,2 @@
+/.idea/
+/vendor/

Dockerfile

@@ -0,0 +1,28 @@
+FROM php:8.0
+
+WORKDIR /usr/app
+
+RUN \
+    apt-get update ; \
+    apt-get install -y --no-install-recommends \
+        git \
+        zip \
+        unzip \
+        sudo \
+    ; \
+    apt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false; \
+    apt-get clean; \
+    rm -rf /var/lib/apt/lists/* \
+    ; \
+    \
+    docker-php-ext-install bcmath \
+    ; \
+    \
+    useradd -m -s /bin/bash -u 1000 user ; \
+    usermod -aG sudo user ; \
+    \
+    echo "user ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/user;
+
+COPY --from=composer:2.2 /usr/bin/composer /usr/bin/composer
+
+USER user

README.md

@@ -1 +1,35 @@
-# BaseConversion-php
+# BaseConversion-php
+
+This is a simple PHP class to convert numbers from one base to another.
+
+It provides methods to perform conversions between binary, decimal, and hexadecimal numbers. It can also perform conversions between arbitrary radix numbers.
+
+## Installation
+
+```bash
+composer require nave-wata/base-conversion
+```
+
+## Usage
+
+```php
+use NaveWata\BaseConversion\BaseConversion;
+
+// Convert from binary
+BaseConversion::binaryToDecimal('1111');        // 15
+BaseConversion::binaryToHexadecimal('1111');    // F
+
+// Convert from decimal
+BaseConversion::decimalToBinary('2');           // 10
+BaseConversion::decimalToHexadecimal('15');     // F
+
+// Convert from hexadecimal
+BaseConversion::hexadecimalToBinary('F');       // 1111
+BaseConversion::hexadecimalToDecimal('F');      // 15
+
+// Custom conversion
+$custom = new BaseConversion('abcdefghijklmnopqrstuvwxyz');
+
+$custom->decimalToCustom('25');                  // z
+$custom->customToDecimal('z');                   // 25
+```

composer.json

@@ -0,0 +1,24 @@
+{
+    "name": "nave-wata/base-conversion",
+    "description": "This is a simple PHP class to convert numbers from one base to another.",
+    "type": "library",
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {
+            "NaveWata\\BaseConversion\\": "src/"
+        }
+    },
+    "require": {
+        "php": "8.*",
+        "ext-bcmath": "*"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^9.6"
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "NaveWata\\BaseConversion\\Tests\\": "tests/"
+        }
+    },
+    "minimum-stability": "stable"
+}