{"id":16309762,"url":"https://github.com/chansen/p5-mac-systemdirectory","last_synced_at":"2025-04-13T17:12:59.486Z","repository":{"id":56836680,"uuid":"42725303","full_name":"chansen/p5-Mac-SystemDirectory","owner":"chansen","description":null,"archived":false,"fork":false,"pushed_at":"2022-02-21T05:34:01.000Z","size":39,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-13T17:12:54.006Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chansen.png","metadata":{"files":{"readme":"README.pod","changelog":"Changes","contributing":"CONTRIBUTING","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-09-18T13:55:10.000Z","updated_at":"2023-04-01T00:48:32.000Z","dependencies_parsed_at":"2022-09-01T13:20:26.460Z","dependency_job_id":null,"html_url":"https://github.com/chansen/p5-Mac-SystemDirectory","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chansen%2Fp5-Mac-SystemDirectory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chansen%2Fp5-Mac-SystemDirectory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chansen%2Fp5-Mac-SystemDirectory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chansen%2Fp5-Mac-SystemDirectory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chansen","download_url":"https://codeload.github.com/chansen/p5-Mac-SystemDirectory/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248750126,"owners_count":21155687,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-10T21:22:28.643Z","updated_at":"2025-04-13T17:12:59.447Z","avatar_url":"https://github.com/chansen.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"=pod\n\n=encoding UTF-8\n\n=head1 NAME\n\nMac::SystemDirectory - Locate Mac OS X Standard System Directories\n\n=head1 VERSION\n\nversion 0.14\n\n=head1 SYNOPSIS\n\n  use Mac::SystemDirectory qw[:all];\n  \n  $path = FindDirectory(NSDocumentDirectory);\n  $path = HomeDirectory();\n  $path = TemporaryDirectory();\n\n=head1 DESCRIPTION\n\nLocate Mac OS X Standard System Directories\n\n=head1 FUNCTIONS\n\n=over 4\n\n=item FindDirectory(Directory [, DomainMask])\n\nCreates a list of path strings for the specified directories in the specified \ndomains. The list is in the order in which you should search the directories.\n\nI\u003cUsage\u003e\n\n    $path  = FindDirectory(NSApplicationDirectory);\n    @paths = FindDirectory(NSApplicationDirectory);\n\nI\u003cArguments\u003e\n\n=over 4\n\n=item Directory\n\nL\u003c/Directory\u003e constant.\n\n=item DomainMask (optional)\n\nL\u003c/DomainMask\u003e constant. Defaults to C\u003cNSUserDomainMask\u003e.\n\n=back\n\nI\u003cReturns\u003e\n\nWhen called in scalar context this function returns the first matching \ndirectory. In list context it returns all matching directories.\nIf no directories are found, undef is returned in a scalar context and an \nempty list in a list context.\n\n=item HomeDirectory()\n\nPath to the current user's home directory.\n\nI\u003cUsage\u003e\n\n    $path = HomeDirectory();\n\nI\u003cReturns\u003e\n\nA string containing the path of the current user's home directory.\n\n=item TemporaryDirectory()\n\nPath to the current user's temporary directory.\n\nI\u003cUsage\u003e\n\n    $path = TemporaryDirectory();\n\nI\u003cReturns\u003e\n\nA string containing the path of the temporary directory for the current user. \nIf no such directory is currently available, returns undef.\n\n=back\n\n=head1 CONSTANTS\n\n=head2 DomainMask\n\nBitmask constants that identify the file-system domain (User, System, Local, Network) or all domains.\n\n=over 4\n\n=item NSUserDomainMask\n\nThe user's home directory-the place to install user's personal items (~).\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSLocalDomainMask\n\nLocal to the current machine-the place to install items available to everyone on this machine.\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSNetworkDomainMask\n\nPublicly available location in the local area network-the place to install items available on the network (/Network).\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSSystemDomainMask\n\nProvided by Apple - can't be modified (/System).\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSAllDomainsMask\n\nAll domains. Includes all of the above and future items.\n\nAvailable in Mac OS X v10.0 and later.\n\n=back\n\n=head2 Directory\n\nConstants that identify the name or type of directory (for example, Library, Documents, or Applications).\n\n=over 4\n\n=item NSApplicationDirectory\n\nSupported applications (/Applications).\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSDemoApplicationDirectory\n\nUnsupported applications and demonstration versions.\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSDeveloperApplicationDirectory\n\nDeveloper applications (/Developer/Applications).\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSAdminApplicationDirectory\n\nSystem and network administration applications.\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSLibraryDirectory\n\nVarious user-visible documentation, support, and configuration files (/Library).\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSDeveloperDirectory\n\nDeveloper resources (/Developer).\nDeprecated: Beginning with Xcode 3.0, developer tools can be installed in any location.\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSUserDirectory\n\nUser home directories (/Users).\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSDocumentationDirectory\n\nDocumentation.\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSDocumentDirectory\n\nDocument directory.\n\nAvailable in Mac OS X v10.2 and later.\n\n=item NSCoreServiceDirectory\n\nLocation of core services (System/Library/CoreServices).\n\nAvailable in Mac OS X v10.4 and later.\n\n=item NSAutosavedInformationDirectory\n\nLocation of user's autosaved documents Documents/Autosaved\n\nAvailable in Mac OS X v10.6 and later.\n\n=item NSDesktopDirectory\n\nLocation of user's desktop directory.\n\nAvailable in Mac OS X v10.4 and later.\n\n=item NSCachesDirectory\n\nLocation of discardable cache files (Library/Caches).\n\nAvailable in Mac OS X v10.4 and later.\n\n=item NSApplicationSupportDirectory\n\nLocation of application support files (Library/Application Support).\n\nAvailable in Mac OS X v10.4 and later.\n\n=item NSDownloadsDirectory\n\nLocation of the user's downloads directory.\n\nAvailable in Mac OS X v10.5 and later.\n\n=item NSInputMethodsDirectory\n\nLocation of Input Methods (Library/Input Methods)\n\nAvailable in Mac OS X v10.6 and later.\n\n=item NSMoviesDirectory\n\nLocation of user's Movies directory (~/Movies)\n\nAvailable in Mac OS X v10.6 and later.\n\n=item NSMusicDirectory\n\nLocation of user's Movies directory (~/Music)\n\nAvailable in Mac OS X v10.6 and later.\n\n=item NSPicturesDirectory\n\nLocation of user's Movies directory (~/Pictures)\n\nAvailable in Mac OS X v10.6 and later.\n\n=item NSPrinterDescriptionDirectory\n\nLocation of system's PPDs directory (Library/Printers/PPDs)\n\nAvailable in Mac OS X v10.6 and later.\n\n=item NSSharedPublicDirectory\n\nLocation of user's Public sharing directory (~/Public)\n\nAvailable in Mac OS X v10.6 and later.\n\n=item NSPreferencePanesDirectory\n\nLocation of the PreferencePanes directory for use with System Preferences (Library/PreferencePanes)\n\nAvailable in Mac OS X v10.6 and later.\n\n=item NSItemReplacementDirectory\n\nFor use with NSFileManager method URLForDirectory:inDomain:appropriateForURL:create:error:\n\nAvailable in Mac OS X v10.6 and later.\n\n=item NSAllApplicationsDirectory\n\nAll directories where applications can occur.\n\nAvailable in Mac OS X v10.0 and later.\n\n=item NSAllLibrariesDirectory\n\nAll directories where resources can occur.\n\nAvailable in Mac OS X v10.0 and later.\n\n=back\n\n=head1 EXPORT\n\nNone by default. Functions and constants can either be imported individually or\nin sets grouped by tag names. The tag names are:\n\n=over 4\n\n=item C\u003c:all\u003e exports all functions and constants.\n\n=item C\u003c:DomainMask\u003e exports all L\u003c/DomainMask\u003e constants.\n\n=item C\u003c:Directory\u003e exports all L\u003c/Directory\u003e constants.\n\n=back\n\n=head1 SEE ALSO\n\nL\u003chttp://developer.apple.com/mac/library/DOCUMENTATION/Cocoa/Conceptual/LowLevelFileMgmt/Articles/StandardDirectories.html\u003e\nL\u003chttp://developer.apple.com/mac/library/documentation/MacOSX/Conceptual/BPFileSystem/BPFileSystem.html\u003e\n\n=head1 SUPPORT\n\nBugs may be submitted through L\u003cthe RT bug tracker|https://rt.cpan.org/Public/Dist/Display.html?Name=Mac-SystemDirectory\u003e\n(or L\u003cbug-Mac-SystemDirectory@rt.cpan.org|mailto:bug-Mac-SystemDirectory@rt.cpan.org\u003e).\n\n=head1 AUTHOR\n\nChristian Hansen \u003cchansen@cpan.org\u003e\n\n=head1 CONTRIBUTOR\n\n=for stopwords Karen Etheridge\n\nKaren Etheridge \u003cether@cpan.org\u003e\n\n=head1 COPYRIGHT AND LICENCE\n\nThis software is copyright (c) 2009 by Christian Hansen.\n\nThis is free software; you can redistribute it and/or modify it under\nthe same terms as the Perl 5 programming language system itself.\n\n=cut\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchansen%2Fp5-mac-systemdirectory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchansen%2Fp5-mac-systemdirectory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchansen%2Fp5-mac-systemdirectory/lists"}