Name | asetools JSON |
Version |
0.1.1
JSON |
| download |
home_page | None |
Summary | Tools to work with Aseprite files |
upload_time | 2024-07-11 06:09:07 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.9 |
license | Apache 2.0 |
keywords |
aseprite
image
conversion
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# Asetools
[Aseprite][] is a wonderful pixelart tool. Unfortunately its license is not OSI compliant, even if the source code is available. This makes it complicated to rely on the tool being available everywhere it's needed. This is a problem for CI servers or open-source application stores like F-Droid.
Asetools are open-source command-line tools to work with Aseprite images.
[Aseprite]: https://aseprite.com
## Tools
### asesplit
The `asesplit` tool turns .ase images into .png. It can extract individual layers and/or slices, trim and rotate them.
<!-- [[[cog
from subprocess import run
p = run(["asesplit", "--help"], check=True, capture_output=True, text=True)
print(f"```\n{p.stdout}```")
]]] -->
```
usage: asesplit [-h] [--split-layers] [--split-slices] [--trim]
[--rotate ANGLE] [--dry-run]
ase_file format
Turn an Aseprite file into one or several png files.
positional arguments:
ase_file
format Define the name of the generated files. Supported keywords:
{title}, {layer}, {frame}, {slice}
options:
-h, --help show this help message and exit
--split-layers
--split-slices
--trim
--rotate ANGLE Rotate image by ANGLE degrees counter-clockwise
--dry-run
```
<!-- [[[end]]] -->
### aseinfo
The `aseinfo` tool gives you information about the content of a .ase file.
<!-- [[[cog
from subprocess import run
p = run(["aseinfo", "--help"], check=True, capture_output=True, text=True)
print(f"```\n{p.stdout}```")
]]] -->
```
usage: aseinfo [-h] [-j] ase_file
Display info about an aseprite file
positional arguments:
ase_file
options:
-h, --help show this help message and exit
-j, --json JSON output
```
<!-- [[[end]]] -->
## Installation
The recommended way to install is using [pipx][].
```
pipx install asetools
```
[pipx]: https://pipx.pypa.io/stable/
## Tests
You can run tests using `pytest`. Just run `pytest` in this directory.
## Warning
Asetools works well for me: it has been used for years now in [Pixel Wheels](https://agateau.com/projects/pixelwheels), but its support for .ase files is limited to the subset of Aseprite features I use. In particular, it currently only supports sprites with a color palette.
Raw data
{
"_id": null,
"home_page": null,
"name": "asetools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "aseprite, image, conversion",
"author": null,
"author_email": "Aurelien Gateau <mail@agateau.com>",
"download_url": "https://files.pythonhosted.org/packages/43/b5/7dd62bb9ef25690e01f82feb3d86ce580ebc965baf7aa9e042f73ea431cf/asetools-0.1.1.tar.gz",
"platform": null,
"description": "# Asetools\n\n[Aseprite][] is a wonderful pixelart tool. Unfortunately its license is not OSI compliant, even if the source code is available. This makes it complicated to rely on the tool being available everywhere it's needed. This is a problem for CI servers or open-source application stores like F-Droid.\n\nAsetools are open-source command-line tools to work with Aseprite images.\n\n[Aseprite]: https://aseprite.com\n\n## Tools\n\n### asesplit\n\nThe `asesplit` tool turns .ase images into .png. It can extract individual layers and/or slices, trim and rotate them.\n\n<!-- [[[cog\nfrom subprocess import run\np = run([\"asesplit\", \"--help\"], check=True, capture_output=True, text=True)\nprint(f\"```\\n{p.stdout}```\")\n]]] -->\n```\nusage: asesplit [-h] [--split-layers] [--split-slices] [--trim]\n [--rotate ANGLE] [--dry-run]\n ase_file format\n\nTurn an Aseprite file into one or several png files.\n\npositional arguments:\n ase_file\n format Define the name of the generated files. Supported keywords:\n {title}, {layer}, {frame}, {slice}\n\noptions:\n -h, --help show this help message and exit\n --split-layers\n --split-slices\n --trim\n --rotate ANGLE Rotate image by ANGLE degrees counter-clockwise\n --dry-run\n```\n<!-- [[[end]]] -->\n\n### aseinfo\n\nThe `aseinfo` tool gives you information about the content of a .ase file.\n\n<!-- [[[cog\nfrom subprocess import run\np = run([\"aseinfo\", \"--help\"], check=True, capture_output=True, text=True)\nprint(f\"```\\n{p.stdout}```\")\n]]] -->\n```\nusage: aseinfo [-h] [-j] ase_file\n\nDisplay info about an aseprite file\n\npositional arguments:\n ase_file\n\noptions:\n -h, --help show this help message and exit\n -j, --json JSON output\n```\n<!-- [[[end]]] -->\n\n## Installation\n\nThe recommended way to install is using [pipx][].\n\n```\npipx install asetools\n```\n\n[pipx]: https://pipx.pypa.io/stable/\n\n## Tests\n\nYou can run tests using `pytest`. Just run `pytest` in this directory.\n\n## Warning\n\nAsetools works well for me: it has been used for years now in [Pixel Wheels](https://agateau.com/projects/pixelwheels), but its support for .ase files is limited to the subset of Aseprite features I use. In particular, it currently only supports sprites with a color palette.\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Tools to work with Aseprite files",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://gitlab.com/agateau/asetools",
"Repository": "https://gitlab.com/agateau/asetools"
},
"split_keywords": [
"aseprite",
" image",
" conversion"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e69894d762a47c67e503c5f1db849a2aca4841899e251d5261307541671df88a",
"md5": "e292b1e469967a715072be793c9eac03",
"sha256": "5a48e9b0866d7586420aeb3d0ef16aa9c59a191bb5620de143e3cf0a314019cf"
},
"downloads": -1,
"filename": "asetools-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e292b1e469967a715072be793c9eac03",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 11693,
"upload_time": "2024-07-11T06:09:05",
"upload_time_iso_8601": "2024-07-11T06:09:05.386872Z",
"url": "https://files.pythonhosted.org/packages/e6/98/94d762a47c67e503c5f1db849a2aca4841899e251d5261307541671df88a/asetools-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "43b57dd62bb9ef25690e01f82feb3d86ce580ebc965baf7aa9e042f73ea431cf",
"md5": "59c540a9517302a225968149246cf5da",
"sha256": "4a32dc2379a8f5a31ded1fc214d97787382bf7e2e00e6bf960d1e426f29064a0"
},
"downloads": -1,
"filename": "asetools-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "59c540a9517302a225968149246cf5da",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 12091,
"upload_time": "2024-07-11T06:09:07",
"upload_time_iso_8601": "2024-07-11T06:09:07.489339Z",
"url": "https://files.pythonhosted.org/packages/43/b5/7dd62bb9ef25690e01f82feb3d86ce580ebc965baf7aa9e042f73ea431cf/asetools-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-11 06:09:07",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "agateau",
"gitlab_project": "asetools",
"lcname": "asetools"
}