Metadata-Version: 2.1
Name: fsactl
Version: 0.1.2
Summary: Install and update MSFS2020 addons
Home-page: https://michaelsasser.github.io/fsactl/index.html
License: GPL-3.0+
Keywords: FlightSimulator,FS2020,MSFS2020,Flight,Simulator,Addon,AddonManager
Author: Michael Sasser
Author-email: Michael@MichaelSasser.org
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Games/Entertainment :: Simulation
Classifier: Typing :: Typed
Provides-Extra: docs
Requires-Dist: GitPython (>=3.1.11,<4.0.0)
Requires-Dist: Jinja2 (>=2.11.2,<3.0.0)
Requires-Dist: PyYaml (>=5.3.1,<6.0.0)
Requires-Dist: coloredlogs (>=14.0,<15.0)
Requires-Dist: semver (>=2.13.0,<3.0.0)
Requires-Dist: sphinx (>=3.2.1,<4.0.0); extra == "docs"
Requires-Dist: sphinx-autodoc-typehints (>=1.11.1,<2.0.0); extra == "docs"
Requires-Dist: sphinx_rtd_theme (>=0.5.0,<0.6.0); extra == "docs"
Requires-Dist: sphinxcontrib-programoutput (>=0.16,<0.17); extra == "docs"
Requires-Dist: tabulate (>=0.8.7,<0.9.0)
Project-URL: Documentation, https://michaelsasser.github.io/fsactl/index.html
Project-URL: Repository, https://github.com/MichaelSasser/fsactl
Description-Content-Type: text/markdown

![GitHub](https://img.shields.io/github/license/MichaelSasser/fsactl?style=flat-square)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fsactl?style=flat-square)
![PyPI - Wheel](https://img.shields.io/pypi/wheel/fsactl?style=flat-square)
![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/michaelsasser/fsactl?style=flat-square)
![GitHub Release Date](https://img.shields.io/github/release-date/michaelsasser/fsactl?style=flat-square)
![PyPI - Status](https://img.shields.io/pypi/status/fsactl?style=flat-square)
![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/michaelsasser/fsactl?style=flat-square)

# MS FlightSimulator 2020 Addon Control

fsactl is a program to download, install, update, build and manage your FlightSimulator addons.

## Development

This program is currently under development.

## Installation

fsactl is written in Python. The installation is straight forward. Just run ``pip install fsactl``. fsactl will be installd from the [Python Package Index (PyPi)](https://pypi.org/project/fsactl/).

You will find more information in the documentation.

## Configuration File

Create a directory named fsactl in your My Documents directory and create a file called config.yaml in it
with a configuration like the following:

```yaml
---

# This is a comment

msfs:
  addon_dir: E:/MSFS-ADDONS  # A directory where your addons can be stored and managed
  community_dir: E:/MSFS/Community  # Your community folder
  addons:
    - github: pimarc/pms50-gns530   # A prebuild addon from github
    - github: lmk02/B787-XE  # A nother one
    - github: saltysimulations/salty-747  # This addon needs a build step
      build:
        - path: "{{ addon_path }}"  # build directory
          command: python build.py  # build command
    - github: r9r-dev/fs2020-vl3-rotax915  # This addon must be build in two steps
      build:
        - path: "{{ addon_path }}"  # first build directory
          command: update-layout.bat  # first build command
        - path: "{{ addon_path }}/community-vl3rotax915"  # second build directory
          command: "python {{ addon_path }}/build.py"  # second build command
```

Be sure to use slashs `/` instead of backslashs in all paths.

You will get a more detailed Documentation to this in the near future.

## Usage

```
$ fsactl
usage: fsactl [-h] [--version] [-d] {update,download,make,install} ...

positional arguments:
  {update,download,make,install}
    update              Update and build addons
    download            Download new addons
    make                Force to rebuild the addons
    install             Install addons

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -d, --debug           Enables debugging mode.
```

## Semantic Versioning

This repository uses [SemVer](https://semver.org/) for its release
cycle.

## Branching Model

This repository uses the
[git-flow](https://danielkummer.github.io/git-flow-cheatsheet/index.html)
branching model by [Vincent Driessen](https://nvie.com/about/).
It has two branches with infinite lifetime:

* [master](https://github.com/MichaelSasser/fsactl/tree/master)
* [develop](https://github.com/MichaelSasser/fsactl/tree/develop)

The master branch gets updated on every release. The develop branch is the
merging branch.

## License
Copyright &copy; 2020 Michael Sasser <Info@MichaelSasser.org>. Released under
the GPLv3 license.

