Skip to content

uber-go/fx

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
11 branches 33 tags
Code

Latest commit

@JacobOaks
JacobOaks Stricter Control over Starting/Stopping Lifecycle (#994)
94f1a09 Dec 6, 2022
Stricter Control over Starting/Stopping Lifecycle (#994) 
Currently, there is nothing preventing somebody from making calls to
`app.Start` and `app.Stop` when it doesn't make sense, for example
calling `app.Start` or `app.Stop` twice, or trying to run the
application twice concurrently. Because of this lack of control, it's
possible for users to cause race conditions and panics (#991) by putting
the lifecycle is strange positions.

This PR places a small state machine in `Lifecycle` so that we can check
if calls to `(*Lifecycle).Start` and `(*Lifecycle).Stop` make sense
before going through. This will disallow starting an already
starting/started app, and stopping an already stopping/stopped app.
Tests to verify that are also added.
94f1a09

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
.github
ci/docs: Fix setup-node action (#964)
Oct 12, 2022
docs
Fixed typo (#993)
Nov 26, 2022
fxevent
Allow setting Zap logger level (#982)
Oct 28, 2022
fxtest
Fix comment typos (#907)
Jul 30, 2022
internal
Stricter Control over Starting/Stopping Lifecycle (#994)
Dec 6, 2022
tools
Add machinery for verified docs
Oct 11, 2022
.codecov.yml
docs: Set up Vuepress website
Oct 12, 2022
.gitignore
Rewrite annotated to apply annotations in certain order (#983)
Nov 16, 2022
CHANGELOG.md
docs: Add release notes (#968)
Oct 12, 2022
CONTRIBUTING.md
docs: Add contribution guide, merge docs/CONTRIBUTING (#969)
Oct 12, 2022
LICENSE
Update LICENSE file and headers (#612)
Jan 4, 2018
Makefile
CI: Set up GitHub Workflow
Oct 12, 2022
README.md
README/Getting Started: Link to website (#977)
Oct 18, 2022
annotated.go
Add fx.From annotation (#990)
Dec 1, 2022
annotated_test.go
Add fx.From annotation (#990)
Dec 1, 2022
app.go
Refactor Done() to use a broadcasted Signal type for future features. (…
Nov 2, 2022
app_internal_test.go
Add fx.Module (#830)
Feb 8, 2022
app_test.go
Stricter Control over Starting/Stopping Lifecycle (#994)
Dec 6, 2022
app_unixes.go
CI: Test against Go 1.17 (#777)
Aug 23, 2021
app_windows.go
CI: Test against Go 1.17 (#777)
Aug 23, 2021
app_windows_test.go
TestWindowsCtrlCHandler: Post-land fixups (#818)
Nov 22, 2021
checklicense.sh
tools: Add internal linter, lint fxevent.Loggers (#752)
Jul 2, 2021
decorate.go
Use Go 1.19 / Remove deprecated API usage (#910)
Aug 4, 2022
decorate_test.go
Fix decorator not being applied to transient dependencies (#941)
Sep 22, 2022
doc.go
Use Go 1.19 / Remove deprecated API usage (#910)
Aug 4, 2022
error_example_test.go
Add support for context- and error-less annotated hook funcs (#953)
Oct 13, 2022
example_test.go
Add support for context- and error-less annotated hook funcs (#953)
Oct 13, 2022
extract.go
fx.Extract: Deprecate in favor of populate (#889)
Jun 4, 2022
extract_test.go
Parallelize all tests (#785)
Sep 8, 2021
go.mod
Allow setting Zap logger level (#982)
Oct 28, 2022
go.sum
Allow setting Zap logger level (#982)
Oct 28, 2022
inout.go
doc(Soft value groups): Fix missing return (#935)
Sep 13, 2022
inout_test.go
Parallelize all tests (#785)
Sep 8, 2021
invoke.go
Fix Invoke order when fx.Module is used (#925)
Aug 19, 2022
lifecycle.go
Add support for various Hook-convertible functions (#952)
Oct 13, 2022
log.go
Rename event types and messages with consistent tenses. (#756)
Jul 20, 2021
log_test.go
WithLogger: Support decoration (#872)
Apr 8, 2022
module.go
Consolidate app and module's custom logger construction logic (#954)
Oct 11, 2022
module_test.go
Consolidate app and module's custom logger construction logic (#954)
Oct 11, 2022
populate.go
ValidateApp should detect Populate and Extract Option's errors (#784)
Sep 8, 2021
populate_example_test.go
Add WithLogger option to supply a fxevent.Logger (#733)
Jul 1, 2021
populate_test.go
Use Go 1.19 / Remove deprecated API usage (#910)
Aug 4, 2022
printer_writer.go
Add WithLogger option to supply a fxevent.Logger (#733)
Jul 1, 2021
provide.go
Use Go 1.19 / Remove deprecated API usage (#910)
Aug 4, 2022
replace.go
Use Go 1.19 / Remove deprecated API usage (#910)
Aug 4, 2022
replace_test.go
TestReplaceSuccess: Silence output (#871)
Apr 8, 2022
shutdown.go
Refactor Done() to use a broadcasted Signal type for future features. (…
Nov 2, 2022
shutdown_test.go
Refactor Done() to use a broadcasted Signal type for future features. (…
Nov 2, 2022
signal.go
Refactor Done() to use a broadcasted Signal type for future features. (…
Nov 2, 2022
signal_test.go
Refactor Done() to use a broadcasted Signal type for future features. (…
Nov 2, 2022
supply.go
Use Go 1.19 / Remove deprecated API usage (#910)
Aug 4, 2022
supply_test.go
Add documentation and tests for soft group values (#909)
Aug 4, 2022
version.go
Back to development (#949)
Sep 28, 2022
🦄 Fx Installation Getting started Stability

README.md

🦄 Fx GoDoc Github release Build Status Coverage Status Go Report Card

Fx is a dependency injection system for Go.

Benefits

  • Eliminate globals: Fx helps you remove global state from your application. No more init() or global variables. Use Fx-managed singletons.
  • Code reuse: Fx lets teams within your organization build loosely-coupled and well-integrated shareable components.
  • Battle tested: Fx is the backbone of nearly all Go services at Uber.

See our docs to get started and/or learn more about Fx.

Installation

Use Go modules to install Fx in your application.

go get go.uber.org/fx@v1

Getting started

To get started with Fx, start here.

Stability

This library is v1 and follows SemVer strictly.

No breaking changes will be made to exported APIs before v2.0.0.

This project follows the Go Release Policy. Each major version of Go is supported until there are two newer major releases.

About

A dependency injection based application framework for Go.

uber-go.github.io/fx/

Topics

go golang framework service dependency-injection app-framework

Resources

Readme

License

MIT license

Stars

3.3k stars

Watchers

68 watching

Forks

228 forks

Releases 33

v1.18.2 Latest
Sep 28, 2022
+ 32 releases

Packages

No packages published

Used by 2

Contributors 58

+ 47 contributors

Languages