A tool for generating xcconfig files from a simple DSL
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
contributing
docs @ e1d3d18
examples/Hello World
pyconfig
slides
tests
tools
.codeclimate.yml
.gitignore
.gitmodules
Dangerfile
Gemfile
LICENSE
Makefile
circle.yml
contributing.md
pyc.py
pylintrc
readme.md
requirements.txt
setup.py
tox.ini

readme.md

pyconfig

Code Climate Test Coverage CircleCI branch Dependency Status

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.

Contributing and Code of Conduct License

This project and related material has a Code of Conduct that is listed in the contributing.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 read here.

Requirements Python Python

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

Module Version
pyparsing >=2.0.1

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 through pip install.

Installation homebrew homebrew

Via homebrew:

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

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

Installing for Python 2

$ make build2

Installing for Python 3

$ make build3

Usage

To use pyconfig 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 of pyconfig:

Flags Usage
--version Displays the version of pyconfig and exits
--scheme <name> Add additional variable defined as SCHEME_NAME = <name>
--no-analyze Skip the analysis step of processing the .pyconfig files
--dry-run Do not write any output files
--quiet Silences all logging output
--verbose Logs additional information
--scm-info <type> Write an additional .xcconfig file that contains information from the source control management software for versioning

Syntax

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 the wiki, which is located at the docs directory of this repo.

Future Plans

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.