{"id":20168229,"url":"https://github.com/ionide/proj-info","last_synced_at":"2026-02-28T07:02:03.380Z","repository":{"id":42031031,"uuid":"83818401","full_name":"ionide/proj-info","owner":"ionide","description":"Parse and evaluate MsBuild project files","archived":false,"fork":false,"pushed_at":"2025-12-05T15:56:14.000Z","size":1049,"stargazers_count":68,"open_issues_count":22,"forks_count":42,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-12-09T00:35:53.180Z","etag":null,"topics":["csproj","dotnet","dotnet-cli","dotnet-core","fsharp","fsproj","sdk","vbproj"],"latest_commit_sha":null,"homepage":"","language":"F#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ionide.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"open_collective":"ionide"}},"created_at":"2017-03-03T16:27:21.000Z","updated_at":"2025-12-08T19:28:19.000Z","dependencies_parsed_at":"2023-12-20T14:35:10.793Z","dependency_job_id":"64114354-67a0-429d-b55b-f922834c2feb","html_url":"https://github.com/ionide/proj-info","commit_stats":{"total_commits":330,"total_committers":18,"mean_commits":"18.333333333333332","dds":0.6696969696969697,"last_synced_commit":"2a865580a7e82422af95b1571f498159ee0c9454"},"previous_names":["ionide/dotnet-proj-info"],"tags_count":92,"template":false,"template_full_name":null,"purl":"pkg:github/ionide/proj-info","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionide%2Fproj-info","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionide%2Fproj-info/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionide%2Fproj-info/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionide%2Fproj-info/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ionide","download_url":"https://codeload.github.com/ionide/proj-info/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionide%2Fproj-info/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29688221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T15:51:39.154Z","status":"ssl_error","status_checked_at":"2026-02-21T15:49:03.425Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["csproj","dotnet","dotnet-cli","dotnet-core","fsharp","fsproj","sdk","vbproj"],"created_at":"2024-11-14T01:06:49.850Z","updated_at":"2026-02-28T07:02:03.375Z","avatar_url":"https://github.com/ionide.png","language":"F#","funding_links":["https://opencollective.com/ionide"],"categories":[],"sub_categories":[],"readme":"# Ionide.ProjInfo\n\n[![NuGet](https://img.shields.io/nuget/v/Ionide.ProjInfo.svg)](https://www.nuget.org/packages/Ionide.ProjInfo/) ![GitHub Workflow Status](https://img.shields.io/github/workflow/status/Ionide/dotnet-proj-info/Build?style=flat-square)\n\nParsing and evaluating of `.fsproj` files. This repository contains several packages:\n* `Ionide.ProjInfo` - library for parsing and evaluating `.fsproj` files, using `Microsoft.Build` libraries\n* `Ionide.ProjInfo.FCS` - library providing utility for mapping project data types used by `Ionide.ProjInfo` into `FSharpProjectOptions` type used by `FSharp.Compiler.Service`\n* `Ionide.ProjInfo.ProjectSystem` - library providing high level project system component that can be used by editor tooling. It supports features like tracking changes, event-driven notifications about project loading status, and persistent caching of the data for fast initial load.\n* `Ionide.ProjInfo.Tool` - a CLI tool intended to help with debugging the cracking of various projects easily\n\n---\n\n## Used by:\n\n- [Fable compiler](https://github.com/fable-compiler/fable) to parse fsproj projects with `dotnet fable`\n- [FsAutocomplete (FSAC)](https://github.com/fsharp/FsAutoComplete/) to parse projects. That's the language server that add F# support in:\n  - [Ionide in Visual Studio Code](https://github.com/ionide/ionide-vscode-fsharp)\n  - [F# vim binding](https://github.com/fsharp/vim-fsharp)\n  - [F# Emacs mode](https://github.com/fsharp/emacs-fsharp-mode)\n- [F# Formatting](https://github.com/fsprojects/FSharp.Formatting)\n- [FSharpLint](https://github.com/fsprojects/FSharpLint)\n\n## Deprecated\n\n- as .NET Core Tool: [![NuGet](https://img.shields.io/nuget/v/dotnet-proj.svg)](https://www.nuget.org/packages/dotnet-proj/)\n- as dotnet cli tool: `dotnet proj-info` [![NuGet](https://img.shields.io/nuget/v/dotnet-proj-info.svg)](https://www.nuget.org/packages/dotnet-proj-info).\n- old libraries (`Dotnet.ProjInfo.*`): [![NuGet](https://img.shields.io/nuget/v/Dotnet.ProjInfo.svg)](https://www.nuget.org/packages/Dotnet.ProjInfo/)\n\n## Getting started\n\nThis project loads some MSBuild specific assemblies at runtime. Somewhat similar to how [MSBuildLocator](https://github.com/microsoft/MSBuildLocator) loads the correct assemblies.\nBecause of this you need to add a direct dependency on `Microsoft.Build.Framework` and `NuGet.Frameworks` but keep excluded them at runtime.\n\n```\n\u003cPackageReference Include=\"Microsoft.Build.Framework\" Version=\"17.2.0\" ExcludeAssets=\"runtime\" PrivateAssets=\"all\" /\u003e\n\u003cPackageReference Include=\"NuGet.Frameworks\" Version=\"6.2.1\" ExcludeAssets=\"runtime\" PrivateAssets=\"all\" /\u003e\n\u003cPackageReference Include=\"Ionide.ProjInfo\" Version=\"0.59.2\" /\u003e\n```\n\nNext, you first need to initialize the MsBuild integration.\n\n```fsharp\nopen Ionide.ProjInfo\n\nlet projectDirectory: DirectoryInfo = yourProjectOrSolutionFolder\nlet toolsPath = Init.init projectDirectory None\n```\n\nWith the `toolsPath` you can create a `loader`\n\n```fsharp\nlet defaultLoader: IWorkspaceLoader = WorkspaceLoader.Create(toolsPath, [])\n// or\nlet graphLoader: IWorkspaceLoader = WorkspaceLoaderViaProjectGraph.Create(toolsPath, [])\n```\n\nUsing the `IWorkspaceLoader` you can load projects or solutions.\nEvents are being emitted while projects/solutions are loaded.\nYou typically want to subscribe to this before you load anything.\n\n```fsharp\nlet subscription: System.IDisposable = defaultLoader.Notifications.Subscribe(fun msg -\u003e printfn \"%A\" msg)\nlet projectOptions = loader.LoadProjects([ yourFsProjPath ]) |\u003e Seq.toArray\n```\n\n\u003e If planning on passing to FSharp.Compiler.Service, please see [Ionide.ProjInfo.FCS](./src/Ionide.ProjInfo.FCS/README.md)\n\n## How to contribute\n\n*Imposter syndrome disclaimer*: I want your help. No really, I do.\n\nThere might be a little voice inside that tells you you're not ready; that you need to do one more tutorial, or learn another framework, or write a few more blog posts before you can help me with this project.\n\nI assure you, that's not the case.\n\nThis project has some clear Contribution Guidelines and expectations that you can [read here](https://github.com/ionide/dotnet-proj-info/blob/main/CONTRIBUTING.md).\n\nThe contribution guidelines outline the process that you'll need to follow to get a patch merged. By making expectations and process explicit, I hope it will make it easier for you to contribute.\n\nAnd you don't just have to write code. You can help out by writing documentation, tests, or even by giving feedback about this work. (And yes, that includes giving feedback about the contribution guidelines.)\n\nThank you for contributing!\n\n\n## Contributing and copyright\n\nThe project is hosted on [GitHub](https://github.com/ionide/dotnet-proj-info) where you can [report issues](https://github.com/ionide/dotnet-proj-info/issues), fork\nthe project and submit pull requests.\n\nThe library is available under [MIT license](https://github.com/ionide/dotnet-proj-info/blob/master/LICENSE.md), which allows modification and redistribution for both commercial and non-commercial purposes.\n\nPlease note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fionide%2Fproj-info","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fionide%2Fproj-info","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fionide%2Fproj-info/lists"}