| Name | gmdm JSON |
| Version |
0.2.8
JSON |
| download |
| home_page | None |
| Summary | The GMDM CLI tool for managing dependencies of GameMaker projects and files. |
| upload_time | 2024-04-05 20:45:06 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | MIT License |
| keywords |
gamemaker
gml
dependencies
export
libraries
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# GmDm
A GameMaker Dependency Management system
## Installation
To install this project as a global Python package, you need to have Python installed on your system. Then, follow these steps:
1. Install the package using `pip install gmdm`
Otherwise, you can create a virtual environment By following these steps:
1. Create a virtual environment using `python -m venv venv`
2. Activate the virtual environment using `source venv/bin/activate` (Linux/Mac) or `venv\Scripts\activate` (Windows)
3. Install the package using `pip install gmdm`
In the second way, you will have to activate the virtual environment every time you want to use `gmdm`
## Usage
Now that you have installed this package, you will have to set up the projects that do the imports (current project) to work with it.
For any GameMaker project to be compatible with GmDm, you don't have to create a `gmdm.yml` file inside each GameMaker project's folder.
This file is optional. It defines the yyp file name, optionally imports and exports, if any, of your GameMaker project(s).
It simply tells GmDm that this project imports a GameMaker "Folder" or Group of resources from other projects.
These other projects should be GmDm compatible.
Projects to be imported are looked up in multiple directories:
1. `${GMDM_IMPORT_DIRS}` env variable. Which is string of paths delimited by ;
2. Absolute path.
3. relative to current directory.
4. ~/Documents/GameMakerStudio2/Projects.
### Basic Usage
To make your project GmDm compatible at least it should have this content at minimum:
##### File: C:/path/to/My Project/My Project.yyp
##### File: C:/path/to/My Project/gmdm.yml
```yml
name: My Project.yyp
```
Another example where you define a project that is to be a dependency for other projects:
```yml
name: Core.yyp
exports:
- Sprites/My Group
- Objects/My Group
- Scripts/My Group
```
Now to import the project's exports:
```yml
name: Second Project.yyp
imports:
- path/to/core
```
Basically the same as:
```yml
name: Second Project.yyp
imports:
- path/to/core:
- Sprites/My Group
- Objects/My Group
- Scripts/My Group
```
For advance usage, you can see the file `gmdm.yml.EXAMPLE`.
Now you can use `gmdm sync`, or any of these commands when inside your project directory:
```bash
gmdm sync --fake # displays operations without actually performing any. Useful for visualization of what will happen.
gmdm sync # performs reimporting (newely modified assets from the imported projects)
```
To show the help, you can use the following command:
`gmdm --help`
## Advanced Usage
Consider using `to` in order to have the same path from multiple projects.
```yml
name: Project1.yyp
imports:
- path/to/project2:
- My Main Folder/My Folder:
to: Extensions/My Project 2 Folder
- ../project3:
- My Main Folder/My Different Folder:
to: Extensions/My Project 3 Folder
- !ENV '${MY_DIR}/project5'
- AWellKnownProject
```
## Notes
Do:
- Keep things simple.
- Use this for your own local machine package management.
- Know what you are importing.
Do not:
- Do not import the same assets or folders that have the same assets from multiple projects.
- Do not import the same folder path from multiple projects. Use `to` in this case.
Other:
- Zombie files are kept.
- GmDm is intelligent enough to handle renamed imports when syncing.
- If a project does not have specific exports, it is thoroughly imported.
- If a project does not have a gmdm.yml file, it will still be able to be a dependency.
- For best usage, clone the repos of projects, that you want as dependencies, to a specific directory. Then use gmdm to import them. It is best to set up an environment variable `GMDM_IMPORT_DIRS=/d/Projects/;/e/GameMaker/`
## Contributing
This project is open for contributions. If you want to contribute, please follow these steps:
1. Fork this repository and create a new branch
2. Make your changes and commit them with a descriptive message
3. Push your branch to your forked repository
4. Create a pull request and explain your changes
## License
This project is licensed under the MIT License. See the LICENSE file for more details.
Raw data
{
"_id": null,
"home_page": null,
"name": "gmdm",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "gamemaker, gml, dependencies, export, libraries",
"author": null,
"author_email": "Kenan Masri <kenanmasri@outlook.com>",
"download_url": "https://files.pythonhosted.org/packages/d4/97/55f0f95ce990b7d1773c0b8f549b76628c7056b9fdebb0bdeda01681d93f/gmdm-0.2.8.tar.gz",
"platform": null,
"description": "# GmDm\n\nA GameMaker Dependency Management system\n\n## Installation\n\nTo install this project as a global Python package, you need to have Python installed on your system. Then, follow these steps:\n\n1. Install the package using `pip install gmdm`\n\nOtherwise, you can create a virtual environment By following these steps:\n\n1. Create a virtual environment using `python -m venv venv`\n2. Activate the virtual environment using `source venv/bin/activate` (Linux/Mac) or `venv\\Scripts\\activate` (Windows)\n3. Install the package using `pip install gmdm`\n\nIn the second way, you will have to activate the virtual environment every time you want to use `gmdm`\n\n## Usage\n\nNow that you have installed this package, you will have to set up the projects that do the imports (current project) to work with it.\n\nFor any GameMaker project to be compatible with GmDm, you don't have to create a `gmdm.yml` file inside each GameMaker project's folder.\nThis file is optional. It defines the yyp file name, optionally imports and exports, if any, of your GameMaker project(s).\n\nIt simply tells GmDm that this project imports a GameMaker \"Folder\" or Group of resources from other projects.\nThese other projects should be GmDm compatible.\n\nProjects to be imported are looked up in multiple directories:\n\n1. `${GMDM_IMPORT_DIRS}` env variable. Which is string of paths delimited by ;\n2. Absolute path.\n3. relative to current directory.\n4. ~/Documents/GameMakerStudio2/Projects.\n\n\n### Basic Usage\n\nTo make your project GmDm compatible at least it should have this content at minimum:\n\n##### File: C:/path/to/My Project/My Project.yyp\n##### File: C:/path/to/My Project/gmdm.yml\n```yml\nname: My Project.yyp\n\n```\n\nAnother example where you define a project that is to be a dependency for other projects:\n```yml\nname: Core.yyp\nexports:\n - Sprites/My Group\n - Objects/My Group\n - Scripts/My Group\n```\n\nNow to import the project's exports:\n\n```yml\nname: Second Project.yyp\nimports:\n - path/to/core\n```\n\nBasically the same as:\n\n```yml\nname: Second Project.yyp\nimports:\n - path/to/core:\n - Sprites/My Group\n - Objects/My Group\n - Scripts/My Group\n```\n\nFor advance usage, you can see the file `gmdm.yml.EXAMPLE`.\n\nNow you can use `gmdm sync`, or any of these commands when inside your project directory:\n\n```bash\ngmdm sync --fake # displays operations without actually performing any. Useful for visualization of what will happen.\ngmdm sync # performs reimporting (newely modified assets from the imported projects)\n```\n\nTo show the help, you can use the following command:\n\n`gmdm --help`\n\n\n## Advanced Usage\n\nConsider using `to` in order to have the same path from multiple projects.\n\n```yml\nname: Project1.yyp\nimports:\n - path/to/project2:\n - My Main Folder/My Folder:\n to: Extensions/My Project 2 Folder\n - ../project3:\n - My Main Folder/My Different Folder:\n to: Extensions/My Project 3 Folder\n - !ENV '${MY_DIR}/project5'\n\n - AWellKnownProject\n\n```\n\n## Notes\n\nDo:\n\n- Keep things simple. \n- Use this for your own local machine package management.\n- Know what you are importing.\n\nDo not:\n\n- Do not import the same assets or folders that have the same assets from multiple projects.\n- Do not import the same folder path from multiple projects. Use `to` in this case.\n\nOther:\n\n- Zombie files are kept.\n- GmDm is intelligent enough to handle renamed imports when syncing.\n- If a project does not have specific exports, it is thoroughly imported.\n- If a project does not have a gmdm.yml file, it will still be able to be a dependency.\n- For best usage, clone the repos of projects, that you want as dependencies, to a specific directory. Then use gmdm to import them. It is best to set up an environment variable `GMDM_IMPORT_DIRS=/d/Projects/;/e/GameMaker/`\n\n## Contributing\n\nThis project is open for contributions. If you want to contribute, please follow these steps:\n\n1. Fork this repository and create a new branch\n2. Make your changes and commit them with a descriptive message\n3. Push your branch to your forked repository\n4. Create a pull request and explain your changes\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for more details.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "The GMDM CLI tool for managing dependencies of GameMaker projects and files.",
"version": "0.2.8",
"project_urls": {
"Bug Tracker": "https://github.com/knno/gmdm/issues"
},
"split_keywords": [
"gamemaker",
" gml",
" dependencies",
" export",
" libraries"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9e3b847b3cea1f9bc2ca794a8c0ec990feec86767ac3ecd32b258a52b926986c",
"md5": "daab2ef7059fe602c4279a71eed83112",
"sha256": "bb5e6794c19cd21d463284170f31532d21723d8e384168956a11677d5ee559cd"
},
"downloads": -1,
"filename": "gmdm-0.2.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "daab2ef7059fe602c4279a71eed83112",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 15094,
"upload_time": "2024-04-05T20:45:04",
"upload_time_iso_8601": "2024-04-05T20:45:04.482326Z",
"url": "https://files.pythonhosted.org/packages/9e/3b/847b3cea1f9bc2ca794a8c0ec990feec86767ac3ecd32b258a52b926986c/gmdm-0.2.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d49755f0f95ce990b7d1773c0b8f549b76628c7056b9fdebb0bdeda01681d93f",
"md5": "359a3f2e931488c236025c1936d600a7",
"sha256": "fa22e04a4d37c6570dfb51d07d7bc359b8a2bbe8fc486b6190c1135e1ef684bb"
},
"downloads": -1,
"filename": "gmdm-0.2.8.tar.gz",
"has_sig": false,
"md5_digest": "359a3f2e931488c236025c1936d600a7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 14639,
"upload_time": "2024-04-05T20:45:06",
"upload_time_iso_8601": "2024-04-05T20:45:06.177405Z",
"url": "https://files.pythonhosted.org/packages/d4/97/55f0f95ce990b7d1773c0b8f549b76628c7056b9fdebb0bdeda01681d93f/gmdm-0.2.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-05 20:45:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "knno",
"github_project": "gmdm",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "gmdm"
}
