Metadata-Version: 2.1
Name: valvevmf
Version: 0.1.2
Summary: A library to parse .VMF files (level editor files for the Source engine).
Home-page: https://pysourcesdk.github.io/ValveVMF/
Author: Maxime Dupuis
Author-email: mdupuis@hotmail.ca
License: gpl-3.0
Project-URL: Documentation, https://pysourcesdk.github.io/ValveVMF/
Project-URL: Github, https://github.com/pySourceSDK/ValveVMF
Keywords: vmf,source,sourcesdk,hammer,valve
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Description-Content-Type: text/markdown
License-File: LICENSE.txt

[![GPLv3 license](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://github.com/pySourceSDK/ValveVMF/blob/master/LICENSE.txt)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/valvevmf.svg)](https://pypi.python.org/pypi/valvevmf/)
[![Platforms](https://img.shields.io/badge/platform-Linux,_MacOS,_Windows-blue)]()
[![PyPI version fury.io](https://badge.fury.io/py/valvevmf.svg)](https://pypi.python.org/pypi/valvevmf/)
[![GitHub Workflow Status (with event)](https://github.com/pySourceSDK/ValveVMF/actions/workflows/CI.yml/badge.svg)]()
[![Test coverage](https://github.com/pySourceSDK/ValveVMF/blob/master/docs/source/coverage.svg "coverage")]()

# ValveVMF

ValveVMF is a Python library designed to parse and edit .VMF files, which store game level data for Valve's level editor, Hammer.

Full documentation: https://pysourcesdk.github.io/ValveVMF/

## Installation

### PyPI

ValveVMF is available on the Python Package Index. This makes installing it with pip as easy as:

```bash
pip3 install valvevmf
```

### Git

If you want the latest code or even feel like contributing, the code is available on GitHub.

You can easily clone the code with git:

```bash
git clone git@github.com:pySourceSDK/ValveVMF.git
```

and install it with:

```bash
python3 setup.py install
```

## Usage

Here's a few example usage of ValveVMF

### Parsing

Parsing can be done by creating an instance of Vmf with a path.

```python
>>> from valvevmf import Vmf

>>> vmf = Vmf('C:/mapsrc/yourmap.vmf')
>>> print(vmf.nodes)
>>> vmf.save()
```
