Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blowdart/idunno.bluesky
A .NET class library for the the Bluesky social network.
https://github.com/blowdart/idunno.bluesky
atproto bluesky bluesky-api bluesky-social
Last synced: 10 days ago
JSON representation
A .NET class library for the the Bluesky social network.
- Host: GitHub
- URL: https://github.com/blowdart/idunno.bluesky
- Owner: blowdart
- License: mit
- Created: 2024-04-25T00:11:26.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-01-23T11:09:52.000Z (12 days ago)
- Last Synced: 2025-01-23T12:20:19.017Z (12 days ago)
- Topics: atproto, bluesky, bluesky-api, bluesky-social
- Language: C#
- Homepage:
- Size: 34.6 MB
- Stars: 62
- Watchers: 2
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: readme.md
- Changelog: history.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# idunno.Bluesky
[if you want me to wear 37 pieces of flair, like your pretty boy over there, Brian, why don't you just make the minimum 37 pieces of flair?]: #
[](https://github.com/blowdart/idunno.Bluesky/blob/main/LICENSE)
[](https://github.com/blowdart/idunno.Bluesky/commits/main/)
[](https://github.com/blowdart/idunno.Bluesky/tags)
[](https://www.nuget.org/packages/idunno.Bluesky/)
[](https://www.nuget.org/packages/idunno.Bluesky/)
A .NET 8 class library for the [AT Protocol](https://docs.bsky.app/docs/api/at-protocol-xrpc-api) and APIs for the [Bluesky social network](https://bsky.social/).
## Getting Started
Add the `idunno.Bluesky` package to your project, and then
```c#
BlueskyAgent agent = new ();
var loginResult = await agent.Login(username, password);
if (loginResult.Succeeded)
{
var response = await agent.CreatePost("Hello World");
if (response.Succeeded)
{
}
}
```
Please see the [documentation](https://bluesky.idunno.dev/) for much more useful documentation and samples.
The [API status page](https://bluesky.idunno.dev/docs/endpointStatus.html) shows what APIs are currently implemented.
## Current Build Status
## Release History
The [releases page](https://github.com/blowdart/idunno.Bluesky/releases) provides details of each release and what was added, changed or removed.
## License
`idunno.Bluesky` and `idunno.AtProto` are available under the MIT license, see the [LICENSE](LICENSE) file for more information.
## Planned work
### Major
* Logging in idunno.Bluesky
* OAuth
* GIF attaching
* AOT & trimming support
* Firehose support
* Wider test coverage
* More deserialization tests with captured responses
### Awaiting external
* Automatic Open Graph card generation when link facets detected.
## Dependencies
`idunno.AtProto` takes a dependency on `System.Text.Json` v9 to support deserializing derived types where the `$type` property is not the
first property in the JSON object.
### External dependencies
* [Microsoft.Extensions.Logging](https://learn.microsoft.com/en-us/dotnet/core/extensions/logging) - used to provide log messages.
* [Microsoft.IdentityModel.Tokens](https://github.com/AzureAD/azure-activedirectory-identitymodel-extensions-for-dotnet) - used to extract the expiry date and time of the JWT tokens issued by Bluesky.
* [DnsClient](https://dnsclient.michaco.net/) - used in Handle to DID resolution.
### External analyzers used during builds
* [DotNetAnalyzers.DocumentationAnalyzers](https://github.com/DotNetAnalyzers/DocumentationAnalyzers) - used to validate XML docs on public types.
* [SonarAnalyzer.CSharp](https://www.sonarsource.com/products/sonarlint/features/visual-studio/) - used for common code smell detection.
### External build & testing tools
* [xunit](https://github.com/xunit/xunit) - used for unit tests.
* [NerdBank.GitVersioning](https://github.com/dotnet/Nerdbank.GitVersioning) - used for version stamping assemblies and packages.
* [DotNet.ReproducibleBuilds](https://github.com/dotnet/reproducible-builds) - used to easily set .NET reproducible build settings.
* [ReportGenerator](https://github.com/danielpalme/ReportGenerator) - used to produce code coverage reports.
* [JunitXml.TestLogger](https://github.com/spekt/junit.testlogger) - used in CI builds to produce test results in a format understood by the [test-summary](https://github.com/test-summary/action) GitHub action.
* [sign](https://github.com/dotnet/sign) - used to code sign assemblies and nuget packages.
* [docfx](https://dotnet.github.io/docfx/) - used to generate the documentation site.
## Other .NET Bluesky libraries
* [FishyFlip](https://github.com/drasticactions/FishyFlip)
* [X.Bluesky](https://github.com/a-gubskiy/X.Bluesky)
* [atprotosharp](https://github.com/taranasus/atprotosharp)