dcen

Name	dcen JSON
Version	0.1 JSON
	download
home_page	https://github.com/cdnserver/DCEN
Summary	Embed and retrieve hidden data using pixelated color codes in PNG files.
upload_time	2024-08-14 09:22:40
maintainer	None
docs_url	None
author	cdnserver
requires_python	None
license	MIT
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # DCEN - Data Concealment and Extraction via Numerical encoding

## Description

**DCEN** is a _utility_ that enables encoding and decoding of data arrays by creating image files containing graphical information without data loss due to compression. DCEN uses [ASCII](https://theasciicode.com.ar/) padding, so make sure you use only ASCII symbols. (No cyrylica) 

## Features

- Encoding text messages into PNG images using grayscale color gradations.
- Decoding text messages from PNG images, restoring the original text.
- Does not require external data or keys; encoding and decoding are based on grayscale values in the image.

## Installation

To install the `dcen` package, use `pip`:

```
pip install dcen
```

## Usage

### Encoding a Message

To encode a message into a PNG image, use the `encode` function:

```
import dcen

# Encoding a message into an image
message = "Hello, World!"
dcen.encode(message, "encoded_image.png")
```

### Decoding a Message

To decode a message from a PNG image, use the `decode` function:

```
import dcen

# Decoding a message from an image
decoded_message = dcen.decode("encoded_image.png")
print(decoded_message)
```

## Functions

### `dcen.encode(text: str, filename: str)`

⬆ Encodes the given `text` into a PNG image and saves it as `filename`.

- **Parameters:**
  - `text` (str): Message to be encoded.
  - `filename` (str): Name of the file where the PNG image will be saved.

- **Returns:**
  - Encoded data as a PNG image.

### `dcen.decode(filename: str) -> str`

⬆ Decodes the message from a PNG image file.

- **Parameters:**
  - `filename` (str): Name of the file from which the message will be decoded.

- **Returns:**
  - Decoded message as a string.

## Requirements

- Python 3.6 or higher
- Pillow (Python Imaging Library)

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/cdnserver/DCEN",
    "name": "dcen",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": null,
    "author": "cdnserver",
    "author_email": "Xest03KmKtZUSETi@hidemail.app",
    "download_url": "https://files.pythonhosted.org/packages/9c/da/5e650a9b641adefc85070320352d1315e6e8b872ac1d50b892a895681cda/dcen-0.1.tar.gz",
    "platform": null,
    "description": "# DCEN - Data Concealment and Extraction via Numerical encoding\r\n\r\n## Description\r\n\r\n**DCEN** is a _utility_ that enables encoding and decoding of data arrays by creating image files containing graphical information without data loss due to compression. DCEN uses [ASCII](https://theasciicode.com.ar/) padding, so make sure you use only ASCII symbols. (No cyrylica) \r\n\r\n## Features\r\n\r\n- Encoding text messages into PNG images using grayscale color gradations.\r\n- Decoding text messages from PNG images, restoring the original text.\r\n- Does not require external data or keys; encoding and decoding are based on grayscale values in the image.\r\n\r\n## Installation\r\n\r\nTo install the `dcen` package, use `pip`:\r\n\r\n```\r\npip install dcen\r\n```\r\n\r\n## Usage\r\n\r\n### Encoding a Message\r\n\r\nTo encode a message into a PNG image, use the `encode` function:\r\n\r\n```\r\nimport dcen\r\n\r\n# Encoding a message into an image\r\nmessage = \"Hello, World!\"\r\ndcen.encode(message, \"encoded_image.png\")\r\n```\r\n\r\n### Decoding a Message\r\n\r\nTo decode a message from a PNG image, use the `decode` function:\r\n\r\n```\r\nimport dcen\r\n\r\n# Decoding a message from an image\r\ndecoded_message = dcen.decode(\"encoded_image.png\")\r\nprint(decoded_message)\r\n```\r\n\r\n## Functions\r\n\r\n### `dcen.encode(text: str, filename: str)`\r\n\r\n\u0432\u00ac\u2020 Encodes the given `text` into a PNG image and saves it as `filename`.\r\n\r\n- **Parameters:**\r\n  - `text` (str): Message to be encoded.\r\n  - `filename` (str): Name of the file where the PNG image will be saved.\r\n\r\n- **Returns:**\r\n  - Encoded data as a PNG image.\r\n\r\n### `dcen.decode(filename: str) -> str`\r\n\r\n\u0432\u00ac\u2020 Decodes the message from a PNG image file.\r\n\r\n- **Parameters:**\r\n  - `filename` (str): Name of the file from which the message will be decoded.\r\n\r\n- **Returns:**\r\n  - Decoded message as a string.\r\n\r\n## Requirements\r\n\r\n- Python 3.6 or higher\r\n- Pillow (Python Imaging Library)\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Embed and retrieve hidden data using pixelated color codes in PNG files.",
    "version": "0.1",
    "project_urls": {
        "Homepage": "https://github.com/cdnserver/DCEN"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6ee6adadc1ab66edc3b9aacee64c1a6daf2b392f51c5d146f9644c8856ee6b5b",
                "md5": "aecfd24fce16e553964f949abb31d2c0",
                "sha256": "1fffc2f6a95f95a53da15201696ddc91d4491083e0129db01d556f00bf21deb2"
            },
            "downloads": -1,
            "filename": "dcen-0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "aecfd24fce16e553964f949abb31d2c0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 4023,
            "upload_time": "2024-08-14T09:22:39",
            "upload_time_iso_8601": "2024-08-14T09:22:39.905255Z",
            "url": "https://files.pythonhosted.org/packages/6e/e6/adadc1ab66edc3b9aacee64c1a6daf2b392f51c5d146f9644c8856ee6b5b/dcen-0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9cda5e650a9b641adefc85070320352d1315e6e8b872ac1d50b892a895681cda",
                "md5": "dd1401a86166372b9548c202c4911312",
                "sha256": "7c7304d07c227d9cde44b66e9e2f683bea1a73153619cc19cfe10a9d03218144"
            },
            "downloads": -1,
            "filename": "dcen-0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "dd1401a86166372b9548c202c4911312",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 3709,
            "upload_time": "2024-08-14T09:22:40",
            "upload_time_iso_8601": "2024-08-14T09:22:40.850833Z",
            "url": "https://files.pythonhosted.org/packages/9c/da/5e650a9b641adefc85070320352d1315e6e8b872ac1d50b892a895681cda/dcen-0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-14 09:22:40",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "cdnserver",
    "github_project": "DCEN",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "dcen"
}