🚀 4단계 - GitHub(인기 저장소)

README.md

@@ -20,3 +20,8 @@
   - [x] Loading : Indicator 출력, 에러 시 스낵바 출력
   - [x] Empty : "목록이 비었습니다" 출력
   - [x] Success : 리스트 출력
+
+## 4단계
+- [x] 저장소의 Star 개수 노출
+- [x] 저장소의 Star 개수가 50개 이상이면 HOT 텍스트 노출
+- [x] (선택) 도메인 계층 구현

app/src/main/java/nextstep/AppContainer.kt

@@ -5,6 +5,8 @@ import kotlinx.serialization.json.Json
 import nextstep.github.data.repository.GithubRepoRepository
 import nextstep.github.data.repository.impl.DefaultGithubRepoRepository
 import nextstep.github.data.service.GithubService
+import nextstep.github.domain.usecase.DefaultGetRepositoriesUseCase
+import nextstep.github.domain.usecase.GetRepositoriesUseCase
 import okhttp3.MediaType.Companion.toMediaType
 import okhttp3.OkHttpClient
 import okhttp3.logging.HttpLoggingInterceptor
@@ -29,6 +31,9 @@ class AppContainer {
 
     val githubRepoRepository: GithubRepoRepository = DefaultGithubRepoRepository(githubService)
 
+    val getRepositoriesUseCase: GetRepositoriesUseCase =
+        DefaultGetRepositoriesUseCase(githubRepoRepository)
+
     companion object {
         private const val CONTENT_TYPE = "application/json"
         private const val BASE_URL = "https://api.github.com"

app/src/main/java/nextstep/github/data/repository/model/RepositoryEntity.kt

@@ -8,4 +8,5 @@ data class RepositoryEntity(
     @SerialName("id") val id: Long,
     @SerialName("full_name") val fullName: String?,
     @SerialName("description") val description: String?,
+    @SerialName("stargazers_count") val stars: Int?,
 )

app/src/main/java/nextstep/github/domain/model/Repository.kt

@@ -0,0 +1,26 @@
+package nextstep.github.domain.model
+
+import nextstep.github.data.repository.model.RepositoryEntity
+import nextstep.github.util.orZero
+
+data class Repository(
+    val id: Long,
+    val fullName: String,
+    val description: String,
+    val stars: Int,
+) {
+    val isHot: Boolean = stars >= HOT_STANDARD
+
+    companion object {
+        private const val HOT_STANDARD = 50
+    }
+}
+
+fun RepositoryEntity.toDomain(): Repository {
+    return Repository(
+        id = id,
+        fullName = fullName.orEmpty(),
+        description = description.orEmpty(),
+        stars = stars.orZero()
+    )
+}

app/src/main/java/nextstep/github/domain/usecase/GetRepositoriesUseCase.kt

@@ -0,0 +1,17 @@
+package nextstep.github.domain.usecase
+
+import nextstep.github.data.repository.GithubRepoRepository
+import nextstep.github.domain.model.Repository
+import nextstep.github.domain.model.toDomain
+
+fun interface GetRepositoriesUseCase {
+    suspend operator fun invoke(organization: String): List<Repository>
+}
+
+class DefaultGetRepositoriesUseCase(
+    private val githubRepoRepository: GithubRepoRepository,
+) : GetRepositoriesUseCase {
+    override suspend operator fun invoke(organization: String): List<Repository> {
+        return githubRepoRepository.getRepositories(organization).map { it.toDomain() }
+    }
+}

app/src/main/java/nextstep/github/ui/RepositoryListViewModel.kt

@@ -6,43 +6,59 @@ import androidx.lifecycle.ViewModelProvider.AndroidViewModelFactory.Companion.AP
 import androidx.lifecycle.viewModelScope
 import androidx.lifecycle.viewmodel.initializer
 import androidx.lifecycle.viewmodel.viewModelFactory
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.flow.SharingStarted
+import kotlinx.coroutines.flow.asSharedFlow
 import kotlinx.coroutines.flow.catch
 import kotlinx.coroutines.flow.flow
 import kotlinx.coroutines.flow.stateIn
 import nextstep.github.GithubApplication
-import nextstep.github.data.repository.GithubRepoRepository
+import nextstep.github.R
+import nextstep.github.domain.usecase.GetRepositoriesUseCase
+import nextstep.github.ui.model.RepositoryListEvent
 import nextstep.github.ui.model.RepositoryListUiState
 
 class RepositoryListViewModel(
-    private val githubRepoRepository: GithubRepoRepository
+    private val getRepositoryUseCase: GetRepositoriesUseCase
 ) : ViewModel() {
-    val uiState = flow {
-        emit(RepositoryListUiState.Loading(error = false))
-
-        val repositories = githubRepoRepository.getRepositories(ORGANIZATION)
-        if (repositories.isEmpty()) {
-            emit(RepositoryListUiState.Empty)
-        } else {
-            emit(RepositoryListUiState.Success(items = repositories))
-        }
-    }.catch {
-        emit(RepositoryListUiState.Loading(error = true))
-    }.stateIn(
+    val uiState = getRepositoriesFlow().stateIn(
         scope = viewModelScope,
         started = SharingStarted.WhileSubscribed(5_000),
-        initialValue = RepositoryListUiState.Loading(error = false)
+        initialValue = RepositoryListUiState.Loading
     )
 
+    private val _event = MutableSharedFlow<RepositoryListEvent>()
+    val event = _event.asSharedFlow()
+
+    private fun getRepositoriesFlow(): Flow<RepositoryListUiState> {
+        return flow {
+            val repositories = getRepositoryUseCase(ORGANIZATION)
+            if (repositories.isEmpty()) {
+                emit(RepositoryListUiState.Empty)
+            } else {
+                emit(RepositoryListUiState.Success(items = repositories))
+            }
+        }.catch {
+            emit(RepositoryListUiState.Loading)
+            _event.tryEmit(
+                RepositoryListEvent.ShowSnackBar(
+                    msgRes = R.string.repository_list_fetch_error,
+                    actionLabelRes = R.string.retry
+                )
+            )
+        }
+    }
+
     companion object {
         private const val ORGANIZATION = "next-step"
 
         val Factory: ViewModelProvider.Factory = viewModelFactory {
             initializer {
-                val githubRepository = (this[APPLICATION_KEY] as GithubApplication)
+                val getRepositoriesUseCase = (this[APPLICATION_KEY] as GithubApplication)
                     .appContainer
-                    .githubRepoRepository
-                RepositoryListViewModel(githubRepository)
+                    .getRepositoriesUseCase
+                RepositoryListViewModel(getRepositoriesUseCase)
             }
         }
     }

app/src/main/java/nextstep/github/ui/component/RepositoryItem.kt

@@ -2,38 +2,83 @@ package nextstep.github.ui.component
 
 import androidx.compose.foundation.background
 import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
 import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Star
 import androidx.compose.material3.HorizontalDivider
+import androidx.compose.material3.Icon
 import androidx.compose.material3.MaterialTheme
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.tooling.preview.PreviewParameter
+import androidx.compose.ui.tooling.preview.PreviewParameterProvider
 import androidx.compose.ui.unit.dp
-import nextstep.github.data.repository.model.RepositoryEntity
+import nextstep.github.R
+import nextstep.github.domain.model.Repository
 import nextstep.github.ui.theme.GithubTheme
 
 @Composable
 fun RepositoryItem(
-    repository: RepositoryEntity,
+    repository: Repository,
+    modifier: Modifier = Modifier
+) {
+    RepositoryItem(
+        fullName = repository.fullName,
+        description = repository.description,
+        stars = repository.stars,
+        isHot = repository.isHot,
+        modifier = modifier
+    )
+}
+
+@Composable
+fun RepositoryItem(
+    fullName: String,
+    description: String,
+    stars: Int,
+    isHot: Boolean,
     modifier: Modifier = Modifier
 ) {
     Column(
         modifier = modifier
             .background(color = MaterialTheme.colorScheme.surface)
     ) {
         Column(
-            modifier = Modifier.padding(16.dp)
+            modifier = Modifier
+                .padding(16.dp)
+                .fillMaxWidth()
         ) {
+            Row(
+                modifier = Modifier.fillMaxWidth(),
+            ) {
+                if (isHot) {
+                    Text(
+                        text = stringResource(R.string.repository_item_hot),
+                        style = MaterialTheme.typography.labelLarge,
+                        color = MaterialTheme.colorScheme.primary
+                    )
+                }
+                Spacer(modifier = Modifier.weight(1f))
+                StarCount(
+                    count = stars,
+                )
+            }
             Text(
-                text = repository.fullName.orEmpty(),
+                text = fullName,
                 style = MaterialTheme.typography.titleLarge,
                 color = Color.Black
             )
             Text(
-                text = repository.description.orEmpty(),
+                text = description,
                 style = MaterialTheme.typography.bodyMedium,
                 color = Color.Black
             )
@@ -42,16 +87,45 @@ fun RepositoryItem(
     }
 }
 
+@Composable
+fun StarCount(
+    count: Int,
+    modifier: Modifier = Modifier
+) {
+    Row(
+        modifier = modifier,
+        verticalAlignment = Alignment.CenterVertically,
+    ) {
+        Icon(
+            modifier = Modifier.size(18.dp),
+            imageVector = Icons.Filled.Star,
+            contentDescription = null
+        )
+        Text(
+            text = count.toString(),
+            style = MaterialTheme.typography.labelLarge,
+        )
+    }
+}
+
+private class RepositoryItemPreviewParameterProvider : PreviewParameterProvider<Boolean> {
+    override val values = sequenceOf(
+        true,
+        false
+    )
+}
+
 @Preview
 @Composable
-private fun RepositoryItemPreview() {
+private fun RepositoryItemPreview(
+    @PreviewParameter(RepositoryItemPreviewParameterProvider::class) value: Boolean
+) {
     GithubTheme {
         RepositoryItem(
-            RepositoryEntity(
-                id = 0,
-                fullName = "next-step/nextstep-docs",
-                description = "nextstep 매뉴얼 및 문서를 관리하는 저장소"
-            ),
+            fullName = "next-step/nextstep-docs",
+            description = "nextstep 매뉴얼 및 문서를 관리하는 저장소",
+            stars = 100,
+            isHot = value,
             modifier = Modifier.fillMaxWidth()
         )
     }

app/src/main/java/nextstep/github/ui/component/RepositoryList.kt

@@ -7,12 +7,12 @@ import androidx.compose.foundation.lazy.items
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.tooling.preview.Preview
-import nextstep.github.data.repository.model.RepositoryEntity
+import nextstep.github.domain.model.Repository
 import nextstep.github.ui.theme.GithubTheme
 
 @Composable
 fun RepositoryList(
-    repositories: List<RepositoryEntity>,
+    repositories: List<Repository>,
     modifier: Modifier = Modifier
 ) {
     LazyColumn(
@@ -33,10 +33,11 @@ private fun RepositoryListPreview() {
     GithubTheme {
         RepositoryList(
             repositories = List(10) {
-                RepositoryEntity(
+                Repository(
                     id = it.toLong(),
                     fullName = "next-step/nextstep-docs",
-                    description = "nextstep 매뉴얼 및 문서를 관리하는 저장소"
+                    description = "nextstep 매뉴얼 및 문서를 관리하는 저장소",
+                    stars = 500,
                 )
             },
             modifier = Modifier.fillMaxSize()

app/src/main/java/nextstep/github/ui/model/RepositoryListEvent.kt

@@ -0,0 +1,7 @@
+package nextstep.github.ui.model
+
+import androidx.annotation.StringRes
+
+sealed interface RepositoryListEvent {
+    data class ShowSnackBar(@StringRes val msgRes: Int, @StringRes val actionLabelRes: Int): RepositoryListEvent
+}

app/src/main/java/nextstep/github/ui/model/RepositoryListUiState.kt

@@ -1,9 +1,9 @@
 package nextstep.github.ui.model
 
-import nextstep.github.data.repository.model.RepositoryEntity
+import nextstep.github.domain.model.Repository
 
 sealed interface RepositoryListUiState {
-    data class Loading(val error: Boolean): RepositoryListUiState
+    data object Loading : RepositoryListUiState
     data object Empty: RepositoryListUiState
-    data class Success(val items: List<RepositoryEntity>): RepositoryListUiState
+    data class Success(val items: List<Repository>): RepositoryListUiState
 }