Repository files navigation

pyconfig is a tool that allows you to write the contents of your.xcconfig files in a simple and more expressive language and have them be generated prior to building a target in Xcode.

This project and related material has a Code of Conduct that is listed in thecontributing.md file. This must be read and adhered to when interacting with this project. Additionally this code is released under a 3-clause BSD license that you can readhere.

This tool is built and tested against Python 2.7.10 and 3.6.0.

Note: All of these modules come as part of the system Python installation for OS X (which is 2.7.10 as of 10.11.5), but you will have to install them yourself if necessary on other systems. These modules can be accquired throughpip install.

Viahomebrew:

$ brew update$ brew tap samdmarshall/formulae$ brew install samdmarshall/formulae/pyconfig

To install the tool from the repo, clone from Github then run the respectivemake command for the desired version.

$ make build2

$ make build3

To usepyconfig to generate an.xcconfig file, you will have to pass it a path as input:

$ pyconfig <file path to the configuration file or directory>

There are a number of flags that can be passed to modify the behavior ofpyconfig:

One of the greatest benefits to using.xcconfig files are part of your build process is that they make the configuration of build settings be represented inside of a human-readable plain-text file rather than being part of the Xcode project's.pbxproj file. For the documentation on the DSL syntax please refer to thewiki, which is located at the docs directory of this repo.

I hope to be able to further enhance the capabilities of this tool to make the management of the.xcconfig files easy and understandable to newcomers. If you have an idea as to how to better extend this tool you should open a new issue to discuss it.