{"id":21974690,"url":"https://github.com/parser3/als.config","last_synced_at":"2025-03-22T23:41:12.814Z","repository":{"id":56946302,"uuid":"71261822","full_name":"parser3/als.config","owner":"parser3","description":"Config Manager Component.","archived":false,"fork":false,"pushed_at":"2019-02-19T10:53:15.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-28T03:19:57.999Z","etag":null,"topics":["als","package","parser3"],"latest_commit_sha":null,"homepage":"","language":"OpenEdge ABL","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/parser3.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-18T15:18:44.000Z","updated_at":"2019-02-19T10:49:52.000Z","dependencies_parsed_at":"2022-08-21T02:40:17.132Z","dependency_job_id":null,"html_url":"https://github.com/parser3/als.config","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parser3%2Fals.config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parser3%2Fals.config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parser3%2Fals.config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parser3%2Fals.config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/parser3","download_url":"https://codeload.github.com/parser3/als.config/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245036127,"owners_count":20550662,"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":["als","package","parser3"],"created_at":"2024-11-29T15:47:12.746Z","updated_at":"2025-03-22T23:41:12.790Z","avatar_url":"https://github.com/parser3.png","language":"OpenEdge ABL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Als/Config\n\nConfig Manager Component.\n\n---\n\nDesigned to simplify access to configuration data within applications. The configuration\ndata may come from a variety of formats supporting hierarchical data storage. Currently\nprovides adapters that read configuration data stored in INI, JSON and XML files.\n\n---\n\n## Пример использования\n\n```ruby\n# Создаем объект класса 'Als/Config':\n$config[^Als/Config::create[]]\n\n\n# Читаем конфиги из файлов:\n^config.read[/path/to/config_ini.ini]\n^config.read[/path/to/config_xml.xml]\n^config.read[/path/to/config_json.json]\n\n# Тпереь нам доступны конфиги по ключам из названий файлов:\n$ini[$config.config_ini]\n$xml[$config.config_xml]\n$json[$config.config_json]\n\n# Так же при чтение файлов, мы можем указать ключ, по которому данные будут доступны:\n^config.read[cache;/path/to/cache.ini]\n#--\u003e $config.cache\n```\n\n---\n\n## Параметры создания объекта\n\n```ruby\n# При создании объекта класса 'Als/Config', мы можем указать папку с конфигами:\n$config[^Als/Config::create[\n\t$.root[/path/to/configs]\n]]\n\n# Теперь при чтении конфигов, нам не надо указывать полный путь к файлу с конфигом:\n^config.read[database.xml]\n\n\n# Так, же при создании объекта класса 'Als/Config', мы можем указать список\n# конфигов, которые будут автоматически загружены во время создания экземпляра класса:\n#\n# Аргумент $.configs[] передается в виде хеша, в котором:\n#  'ключ'     - это ключ по которому будут доступны данные конфига в объекте класса\n#  'значение' - путь к файлу с конфигурационными данными\n$config[^Als/Config::create[\n\t$.configs[\n\t\t$.cache[cache.ini]\n\t\t$.database[database.xml]\n\t]\n]]\n```\n\n---\n\n## Методы доступа к конфигурационным данным\n\n```ruby\n# Создаем объект класса 'Als/Config':\n$config[^Als/Config::create[]]\n\n# Читам конфигурационные данные из файла 'database.json', со следующим содержимым:\n#  {\n#    \"debug\": true,\n#    \"cache\": {\n#       \"path\": \"/path/to/database/cache\"\n#    }\n#  }\n^config.read[db;/path/to/database.json]\n\n# Теперь мы можем получать конфигурационные данные, обращаясь к объекту '$config', как к хешу:\n$debug($config.db.debug)\n\n# Так же мы можем воспользоваться методом '^get[]' (для разделения вложенности используются точки):\n$path[^config.get[db.cache.path]]\n\n# Если вызвать метод '^get[]' без аргументов, то он вернёт хеш со всеми ранее загруженными конфигами:\n$configs[^config.get[]]\n```\n---\n\n## Примеры конфигов\n\n### Формат .ini\n\n```ini\n; некоторый комментарий\n# комментарий в стиле Unix\n\n# Значения без секции\nparam1=value1 ; иногда допускается комментарий к отдельному параметру\nparam2=value2\n\n[section]\n; комментарий о разделе\nparam1=section.value1 # иногда допускается комментарий к отдельному параметру\nparam2=section.value2\n\n[section.subsection]\nparam1=section.subsection.value1\nparam2=section.subsection.value2\n\n; иногда позволяется перечислять несколько значений через запятую\n[section.subsection2]\nparam1=section.subsection2.value1\nparam2=section.subsection2.value2\n\n[section.subsection2.subsection3]\nparam1=section.subsection2.subsection3.value1\nparam2=section.subsection2.subsection3.value2\n\n; Иногда значения отсутствуют\n[section.subsection2.subsection4]\n\n[section.subsection2.subsection5]\nparam1=\nparam2=\n```\n\n### Формат .xml\n\n```xml\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\" ?\u003e\n\u003cconfig\u003e\n    \u003cparam1\u003evalue1\u003c/param1\u003e\n    \u003cparam2\u003evalue2\u003c/param2\u003e\n\n    \u003csection\u003e\n        \u003cparam1\u003esection.value1\u003c/param1\u003e\n        \u003cparam2\u003esection.value2\u003c/param2\u003e\n\n        \u003csubsection\u003e\n            \u003cparam1\u003esection.subsection.value1\u003c/param1\u003e\n            \u003cparam2\u003esection.subsection.value2\u003c/param2\u003e\n        \u003c/subsection\u003e\n\n        \u003csubsection2\u003e\n            \u003cparam1\u003esection.subsection2.value1\u003c/param1\u003e\n            \u003cparam2\u003esection.subsection2.value2\u003c/param2\u003e\n\n            \u003csubsection3\u003e\n                \u003cparam1\u003esection.subsection2.subsection3.value1\u003c/param1\u003e\n                \u003cparam2\u003esection.subsection2.subsection3.value2\u003c/param2\u003e\n            \u003c/subsection3\u003e\n\n            \u003csubsection4\u003e\u003c/subsection4\u003e\n\n            \u003csubsection5\u003e\n                \u003cparam1\u003e\u003c/param1\u003e\n                \u003cparam2\u003e\u003c/param2\u003e\n            \u003c/subsection5\u003e\n        \u003c/subsection2\u003e\n    \u003c/section\u003e\n\u003c/config\u003e\n```\n\n### Формат .json\n\n```json\n{\n  \"param1\": \"value1\",\n  \"param2\": \"value2\",\n\n  \"section\": {\n    \"param1\": \"section.value1\",\n    \"param2\": \"section.value2\",\n\n    \"subsection\": {\n      \"param1\": \"section.subsection.value1\",\n      \"param2\": \"section.subsection.value2\"\n    },\n\n    \"subsection2\": {\n      \"param1\": \"section.subsection2.value1\",\n      \"param2\": \"section.subsection2.value2\",\n\n      \"subsection3\": {\n        \"param1\": \"section.subsection2.subsection3.value1\",\n        \"param2\": \"section.subsection2.subsection3.value2\"\n      },\n\n      \"subsection4\": {},\n\n      \"subsection5\": {\n        \"param1\": \"\",\n        \"param2\": \"\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## TODO\n\n- Написать метод \"@parse[]\", что бы можно было нетолько загружать данные из файлов.\n- Написать метод \"@save[]\", что бы можно было сохранять конфиги.\n- Парсинг аттрибутов в XML, сейчас конфиги формата '.xml' парсятся без учете аттрибутов.\n\n---\n\n## References\n\n- Questions to Leonid Knyazev \u003cleonid@knyazev.me\u003e | \u003cn3o@design.ru\u003e\n- Bug reports and Feature requests to Issues.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparser3%2Fals.config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparser3%2Fals.config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparser3%2Fals.config/lists"}