Metadata-Version: 2.1
Name: cs-app-osx-defaults
Version: 20241122
Summary: Access the MacOS defaults via the `defaults` command.
Author-email: Cameron Simpson <cs@cskk.id.au>
License: GNU General Public License v3 or later (GPLv3+)
Project-URL: Monorepo Hg/Mercurial Mirror, https://hg.sr.ht/~cameron-simpson/css
Project-URL: Monorepo Git Mirror, https://github.com/cameron-simpson/css
Project-URL: MonoRepo Commits, https://bitbucket.org/cameron_simpson/css/commits/branch/main
Project-URL: Source, https://github.com/cameron-simpson/css/blob/main/lib/python/cs/app/osx/defaults.py
Keywords: python3
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Description-Content-Type: text/markdown
Requires-Dist: cs.app.osx.plist>=20221228
Requires-Dist: cs.deco>=20241109
Requires-Dist: cs.lex>=20241122
Requires-Dist: cs.psutils>=20241122
Requires-Dist: typeguard

Access the MacOS defaults via the `defaults` command.

*Latest release 20241122*:
run: drop quiet=False parameter, the run() inside defaults() will pick things up.

## <a name="Defaults"></a>Class `Defaults`

A view of the defaults.

*`Defaults.domains`*:
Return a list of the domains present in the defaults.

*`Defaults.run(self, argv, doit=True) -> str`*:
Run a `defaults` subcommand, return the output decoded from UTF-8.

## <a name="defaults"></a>`defaults(argv, *, host=None, doit=True, **subp)`

Run the `defaults` command with the arguments `argv`.
If the optional `host` parameter is supplied,
a value of `'.'` uses the `-currentHost` option
and other values are used with the `-host` option.
Return the `CompletedProcess` result or `None` if `doit` is false.

## <a name="DomainDefaults"></a>Class `DomainDefaults`

A view of the defaults for a particular domain.

*`DomainDefaults.as_dict(self)`*:
Return the current defaults as a `dict`.

*`DomainDefaults.flush(self)`*:
Forget any cached information.

# Release Log



*Release 20241122*:
run: drop quiet=False parameter, the run() inside defaults() will pick things up.

*Release 20240316*:
Fixed release upload artifacts.

*Release 20240201*:
Initial PyPI release.
