{"id":13410435,"url":"https://github.com/zertovitch/ini-files","last_synced_at":"2025-03-14T16:32:10.770Z","repository":{"id":44874967,"uuid":"208611831","full_name":"zertovitch/ini-files","owner":"zertovitch","description":"Ini file manager: a standalone, portable Ada package for configuration files ","archived":false,"fork":false,"pushed_at":"2024-05-25T10:20:57.000Z","size":37,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-07-31T20:42:43.532Z","etag":null,"topics":["ada","ada-language","ada-library","cfg-files","config","configuration-file","configuration-files","ini-parser"],"latest_commit_sha":null,"homepage":"https://sf.net/projects/ini-files/","language":"Ada","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zertovitch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-15T15:09:06.000Z","updated_at":"2024-05-25T10:21:01.000Z","dependencies_parsed_at":"2024-10-26T05:50:59.234Z","dependency_job_id":"60f81c86-79f2-492a-985c-4f33e965d2f0","html_url":"https://github.com/zertovitch/ini-files","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zertovitch%2Fini-files","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zertovitch%2Fini-files/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zertovitch%2Fini-files/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zertovitch%2Fini-files/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zertovitch","download_url":"https://codeload.github.com/zertovitch/ini-files/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243610202,"owners_count":20318920,"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":["ada","ada-language","ada-library","cfg-files","config","configuration-file","configuration-files","ini-parser"],"created_at":"2024-07-30T20:01:06.879Z","updated_at":"2025-03-14T16:32:10.733Z","avatar_url":"https://github.com/zertovitch.png","language":"Ada","funding_links":[],"categories":["Libraries"],"sub_categories":["Format Readers and Writers","Format Readers, Writers and Checkers"],"readme":"Welcome to the Ini file manager\n===============================\n\nThe Ini file manager consists of a single package, Config, which\ncan read and modify informations from various configuration\nfiles known as \"ini\" files. They are called \"ini\" files because\nthey have often the \".ini\" extension, but some also have\n\".inf\", \".cfg\" extensions. They are actually text files which\nlook like the following:\n\n     ; Comment line\n     \n     [Section 1]\n     a_string = abcd     # a comment here...\n     a_number = +123.456 ; another comment\n     \n     [Section 2]\n     a_string = efgh\n\nIntro to the Ini file manager\n=============================\n\nFor more examples in this format, just search files with\nthe .ini extension on your computer!\nThe Config package is typically used as in\nthe following demo procedure:\n\n        with Config; use Config;\n        with Ada.Text_IO; use Ada.Text_IO;\n        procedure Small_demo is\n          c: Configuration;\n        begin\n          Init(c, \"config.ini\");\n          Put_Line(Value_Of(c, \"Section 2\", \"a_string\"));\n        end;\n\nContents\n========\n  - config.ads            : package specification\n  - config.adb            : package body\n  - tests/test_config.adb : test/demo procedure\n  - ini_files.gpr         : project file for the GNAT compiler\n  - ini_files_oa.prj      : project file for the ObjectAda compiler\n  - README.md             : this file\n\nWarning \u0026 legal\n===============\nThere is NO WARRANTY in this software. Read copyright notice in config.ads.\n  \nHow to build and test the Ini file manager\n==========================================\nFor building with GNAT/GCC:\n      - type \"gprbuild -p -P ini_files.gpr\" in the command line\n  or\n      - use the project file, ini_files.gpr, from the\n        GNAT Programming Studio (GPS); press F4\n  or\n      - copy the two files config.ads and config.adb to your project\n  or\n      - open test_config.adb with AdaGIDE, press F3\n  or\n      - your way...\n\nFor building with ObjectAda, you can use the ini_files_oa.prj project file.\n\nFor other compilers, it should be simple as well: have\nconfig.ads, config.adb, test_config.adb at the same place\nand build test_config as the main program.\n      \nAs a result there is a test_config[.exe] executable.\n\nHow to use the Ini file manager\n===============================\nChances are that the only usage you'll make of Config will be to\nread values from a configuration file. This is done with the\nfunction Value_Of as in the example above.\n\nIf you need to update the configuration file, you can replace single\nvalues (Replace_Value) or whole sections (Replace_Section).\nIf you need to rewrite the entire configuration file, it is simpler\nto do it in one go, with Put_Line's.\n\nLook at test_config.adb for a complete example, especially when it\ncomes to handle numerical errors contained in a configuration file.\n\nEnjoy!\n\nGautier de Montmollin \u0026 Rolf Ebert\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzertovitch%2Fini-files","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzertovitch%2Fini-files","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzertovitch%2Fini-files/lists"}