# File Signature Collectors
Project focused on obtaining, processing and storing information related to "magic numbers" from the files.
You can save the data in a normal file (`file_signatures` - default) or in a sqlite file (`file_signatures.sqlite` - default).
>
> Note:
> In the `Byte Offset` field, if it appears:
> * `-512` => last 512 bytes.
> * `+=188` => every 188th bytes.
>
# Install
```bash
pip install filesignaturecollectors
```
# How to use - Python
```python
from filesignaturecollectors import Controller
# Initializes the counter.
c = Controller()
# gets data from source.
data1 = c.get_data_wiki()
data2 = c.get_data_gck()
# filters and concatenates the elements into a single list.
c.consolidate_data(data1, data2)
# gets the list of formatted items for storage.
data_formatted = c.get_dict_data()
# saves to normal file.
c.to_file(data=data_formatted)
# saves to sqlite file.
c.to_db(data=data_formatted)
```
# How to use - CLI
```bash
$ collectfilesignatures -h
usage: collectfilesignatures [-h] [-a] [-w] [-g] [-f] [-db]
Collect file signatures from sources.
options:
-h, --help show this help message and exit
-a, --all Gets data from all collectors.
-w, --wiki Gets data from all collectors.
-g, --gck Gets data from all collectors.
-f, --to_file Save the data into a file.
-db, --to_db Save the data into a sqlite db.
An easy way to get file signatures.
```
# Sources
> * [GCK page - File Signatures](https://www.garykessler.net/library/file_sigs.html)
> * [Wikipedia - File Signatures](https://en.wikipedia.org/wiki/List_of_file_signatures)
Raw data
{
"_id": null,
"home_page": "https://github.com/kurotom/filesignaturecollectors",
"name": "filesignaturecollectors",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7,<4.0",
"maintainer_email": "",
"keywords": "filesignature,file signature,magicnumbers,magic numbers",
"author": "kurotom",
"author_email": "55354389+kurotom@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/45/9d/660cbf66944db05a1deff458bd9076366550d458273206b75c963ab92735/filesignaturecollectors-0.1.7.tar.gz",
"platform": null,
"description": "# File Signature Collectors\n\nProject focused on obtaining, processing and storing information related to \"magic numbers\" from the files.\n\n\nYou can save the data in a normal file (`file_signatures` - default) or in a sqlite file (`file_signatures.sqlite` - default).\n\n>\n> Note:\n> In the `Byte Offset` field, if it appears:\n> * `-512` => last 512 bytes.\n> * `+=188` => every 188th bytes.\n> \n\n# Install\n\n```bash\npip install filesignaturecollectors\n```\n\n# How to use - Python\n\n```python\nfrom filesignaturecollectors import Controller\n\n# Initializes the counter.\nc = Controller()\n\n# gets data from source.\ndata1 = c.get_data_wiki()\ndata2 = c.get_data_gck()\n\n# filters and concatenates the elements into a single list.\nc.consolidate_data(data1, data2)\n\n# gets the list of formatted items for storage.\ndata_formatted = c.get_dict_data()\n\n# saves to normal file.\nc.to_file(data=data_formatted)\n\n# saves to sqlite file.\nc.to_db(data=data_formatted)\n```\n\n# How to use - CLI\n\n```bash\n$ collectfilesignatures -h\nusage: collectfilesignatures [-h] [-a] [-w] [-g] [-f] [-db]\n\nCollect file signatures from sources.\n\noptions:\n -h, --help show this help message and exit\n -a, --all Gets data from all collectors.\n -w, --wiki Gets data from all collectors.\n -g, --gck Gets data from all collectors.\n -f, --to_file Save the data into a file.\n -db, --to_db Save the data into a sqlite db.\n\nAn easy way to get file signatures.\n```\n\n\n# Sources\n\n> * [GCK page - File Signatures](https://www.garykessler.net/library/file_sigs.html)\n> * [Wikipedia - File Signatures](https://en.wikipedia.org/wiki/List_of_file_signatures)\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Collects, processes and stores information on 'magic numbers'.",
"version": "0.1.7",
"project_urls": {
"Bug Tracker": "https://github.com/kurotom/filesignaturecollectors/issues",
"Homepage": "https://github.com/kurotom/filesignaturecollectors",
"Pypi": "https://pypi.org/project/filesignaturecollectors/",
"Repository": "https://github.com/kurotom/filesignaturecollectors"
},
"split_keywords": [
"filesignature",
"file signature",
"magicnumbers",
"magic numbers"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2effcc87df266a3d5f7a8589a5ef84e7b1d661f539abc2a3ca371a5f119b15ee",
"md5": "964bd31787885a96146f10cd66f45706",
"sha256": "fdf2c0921b04a9570fa4945624cecd281a853f78a8f30a6af0cae09e78ef6dec"
},
"downloads": -1,
"filename": "filesignaturecollectors-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "964bd31787885a96146f10cd66f45706",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<4.0",
"size": 13622,
"upload_time": "2024-02-21T01:37:28",
"upload_time_iso_8601": "2024-02-21T01:37:28.083064Z",
"url": "https://files.pythonhosted.org/packages/2e/ff/cc87df266a3d5f7a8589a5ef84e7b1d661f539abc2a3ca371a5f119b15ee/filesignaturecollectors-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "459d660cbf66944db05a1deff458bd9076366550d458273206b75c963ab92735",
"md5": "fd49435283b78cb8e0bd909121bec56c",
"sha256": "f7d489eb2b167a70a4a74f5a9cea82d8d0a6d93912c96252b8a95b557b15173b"
},
"downloads": -1,
"filename": "filesignaturecollectors-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "fd49435283b78cb8e0bd909121bec56c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<4.0",
"size": 9573,
"upload_time": "2024-02-21T01:37:30",
"upload_time_iso_8601": "2024-02-21T01:37:30.307046Z",
"url": "https://files.pythonhosted.org/packages/45/9d/660cbf66944db05a1deff458bd9076366550d458273206b75c963ab92735/filesignaturecollectors-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-21 01:37:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kurotom",
"github_project": "filesignaturecollectors",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "filesignaturecollectors"
}
JSON
