{"id":37036869,"url":"https://github.com/nosinovacao/name-sdk","last_synced_at":"2026-01-14T04:23:14.311Z","repository":{"id":22269566,"uuid":"93735726","full_name":"nosinovacao/name-sdk","owner":"nosinovacao","description":"A dependencies management library designed to expose and access dependencies information.","archived":true,"fork":false,"pushed_at":"2022-06-22T15:32:22.000Z","size":294,"stargazers_count":14,"open_issues_count":13,"forks_count":4,"subscribers_count":4,"default_branch":"dev","last_synced_at":"2025-12-11T17:16:04.449Z","etag":null,"topics":["asp","cross-platform","csharp","dependencies","expose","library","microservices","net-core","net-framework","netstandard","sdk","self-contained-system","service"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nosinovacao.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-08T10:12:28.000Z","updated_at":"2025-12-02T11:01:29.000Z","dependencies_parsed_at":"2022-09-15T06:51:15.683Z","dependency_job_id":null,"html_url":"https://github.com/nosinovacao/name-sdk","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/nosinovacao/name-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nosinovacao%2Fname-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nosinovacao%2Fname-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nosinovacao%2Fname-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nosinovacao%2Fname-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nosinovacao","download_url":"https://codeload.github.com/nosinovacao/name-sdk/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nosinovacao%2Fname-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28409476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T01:52:23.358Z","status":"online","status_checked_at":"2026-01-14T02:00:06.678Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["asp","cross-platform","csharp","dependencies","expose","library","microservices","net-core","net-framework","netstandard","sdk","self-contained-system","service"],"created_at":"2026-01-14T04:23:13.769Z","updated_at":"2026-01-14T04:23:14.295Z","avatar_url":"https://github.com/nosinovacao.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NAME: Self-Contained Dependencies Management\n[![Travis Build Status](https://travis-ci.org/nosinovacao/name-sdk.svg?branch=master)](https://travis-ci.org/nosinovacao/name-sdk)\n[![AppVeyor Build status](https://ci.appveyor.com/api/projects/status/p6iokqd596iuw3vr/branch/master?svg=true)](https://ci.appveyor.com/project/nosinovacao/name-sdk/branch/master)\n\n\nNAME is a service dependencies management library designed to expose and access services information, written in C#. \n\nIts goal is to make it easier and simpler to detect service dependencies problems in a world where there are more and more services per application. It provides human and machine friendly dependencies information without the need for external tools.\n\n### Main Features\n* Self-contained\n* Developer friendly service dependencies definition\n* Human and machine readable service dependencies status\n* Deep dependencies health checks\n* Third-party service dependencies checks\n* Support for **optional** central registration\n* .Net Core and .NET 4.5+ compatible\n\n## Getting Started \n### Installing on ASP.NET Web API\n1. Install the Nuget Package\n```powershell\n    Install-Package NAME.WebApi\n```\n\nThe configuration file is present in `App_Start/NAMEConfig.cs` and the dependencies definition file is `dependencies.json`.\n\n2. Start the application and access the **/manifest** endpoint. It should show the dependencies state.\n\n### Installing on ASP.NET Core\n1. Install the NuGet package\n\n```powershell\n    Install-Package NAME.AspNetCore\n```\n\n2. Add the NAME middleware in the *Configure* method of your *Startup.cs* file.\n```csharp\n// NAME middleware should be registered first so that the custom\n// header is set before any other middleware has a chance to \n// send a response.\napp.UseNAME(config =\u003e\n{\n    Assembly a = typeof(Startup).GetTypeInfo().Assembly;\n    config.APIName = a.GetName().Name;\n    config.APIVersion = a.GetName().Version.ToString();\n    // Comment the next line if you don't use the default Asp.Net Core IConfiguration interface.\n    config.Configuration = Configuration;\n});\n```\n\n3. Create the `dependencies.json` file at the root of the project, the following example is a good starting point.\n```json\n{\n  \"$schema\": \"https://raw.githubusercontent.com/nosinovacao/name-sdk/schema-v1/name.dependencies.v1.jschema\",\n  \"infrastructure_dependencies\": [\n    {\n      \"os_name\": \"debian\",\n      \"type\": \"OperatingSystem\",\n      \"min_version\": \"8\",\n      \"max_version\": \"*\"\n    }\n  ],\n  \"service_dependencies\": [\n    {\n      \"name\": \"Internal Service\",\n      \"min_version\": \"1.2.53\",\n      \"max_version\": \"1.8\",\n      \"connection_string\": {\n        \"locator\": \"IConfiguration\",\n        \"key\": \"ConnectionStrings:InternalServiceUri\"\n      }\n    }\n  ]\n}\n```\n\n4. Start the application and access the **/manifest** endpoint. It should show the dependencies state.\n\n### Non-Web Applications\nFor applications without a web server we created a SelfHost solution.\nYou can read how to install NAME on those applications at [Using NAME On Non Web Applications](https://github.com/nosinovacao/name-sdk/wiki/Using-NAME-On-Non-Web-Applications).\n\n## Documentation\nSee the [Wiki](https://github.com/nosinovacao/name-sdk/wiki) for full documentation, examples, operational details and other information.\n\n## Building and testing\nWe define our build using [Cake](https://github.com/cake-build/cake/), this allows us to define a common ground for developers on different operating systems, but it requires .Net 4.5 or Mono 4.2.3, so make sure you have those dependencies setup.\n\nBootstrap scripts are provided for both Windows and Linux environments. Keep in mind that not all tests will run on Linux, because some projects are targeting .NET 4.5+.\n\nTo build and run unit tests on Windows execute the command:\n    \n    powershell ./build.ps1\n\nTo build and run unit tests on Linux execute the command:\n\n    ./build.sh\n\n## Contributing\nWe really appreciate your interest in contributing to NAME. 👍\n\nAll we ask is that you follow some simple guidelines, so please read the [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests.\n\nThank you, [contributors](https://github.com/nosinovacao/name-sdk/graphs/contributors)!\n\n## License\nCopyright © NOS Inovação.\n\nThis project is licensed under the BSD 3-Clause License - see the [LICENSE](LICENSE) file for details","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnosinovacao%2Fname-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnosinovacao%2Fname-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnosinovacao%2Fname-sdk/lists"}