Repository: dbt-labs/dbt-core

Issue:
Improve error message in `pip install dbt`
Starting in v1.0.0, `pip install dbt` will raise an explicit error:

```
As of v1.0.0, `pip install dbt` is no longer supported.
  Instead, please use either:
    - `pip install dbt-core`, for core functionality
    - `pip install dbt-<adapter>`, to use dbt with your database, platform, or query engine
  See full list: https://docs.getdbt.com/docs/available-adapters
```

The goal here is clarity for what users should do as a next step. In https://github.com/dbt-labs/dbt-core/pull/4133#issuecomment-962730765, @joellabes rightly pointed out that the first line is confusing. We expect that >95% of users will want to use the second.

Let's reorder and alter the wording in this error to something like:
```
As of v1.0.0, `pip install dbt` is no longer supported.
Instead, please use one of the following:

**To use dbt with your specific database, platform, or query engine:**
    
    pip install dbt-<adapter>
    
    See full list: https://docs.getdbt.com/docs/available-adapters
    
**For developers of integrations with dbt Core:**

    pip install dbt-core
    
    Be advised, dbt Core's python API is not yet stable or documented
    https://docs.getdbt.com/docs/running-a-dbt-project/dbt-api

**For the previous behavior of `pip install dbt`:**

    pip install dbt-core dbt-postgres dbt-redshift dbt-snowflake dbt-bigquery
```

I think we should feel comfortable taking up more screen real estate, since this is the only real thing folks will see when they run `pip install dbt`.


Discussion:
@joellabes What do you think of the proposed message above? Open to any/all wordsmithing suggestions!
Yep I'm 100% happy with this! I was originally going to suggest swapping `pip install dbt-adapter` to pole position, but it wouldn't have made sense with the old layout. 

Resolving patch:
diff --git a/setup.py b/setup.py
--- a/setup.py
+++ b/setup.py
@@ -6,10 +6,24 @@
 if 'sdist' not in sys.argv:
     print('')
     print('As of v1.0.0, `pip install dbt` is no longer supported.')
-    print('Instead, please use either:')
-    print('  - `pip install dbt-core`, for core functionality')
-    print('  - `pip install dbt-<adapter>`, to use dbt with your database, platform, or query engine')
-    print('See full list: https://docs.getdbt.com/docs/available-adapters')
+    print('Instead, please use one of the following.')
+    print('')
+    print('**To use dbt with your specific database, platform, or query engine:**')
+    print('')
+    print('    pip install dbt-<adapter>')
+    print('')
+    print('    See full list: https://docs.getdbt.com/docs/available-adapters')
+    print('')
+    print('**For developers of integrations with dbt Core:**')
+    print('')
+    print('    pip install dbt-core')
+    print('')
+    print('    Be advised, dbt Core''s python API is not yet stable or documented')
+    print('    (https://docs.getdbt.com/docs/running-a-dbt-project/dbt-api)')
+    print('')
+    print('**For the previous behavior of `pip install dbt`:**')
+    print('')
+    print('    pip install dbt-core dbt-postgres dbt-redshift dbt-snowflake dbt-bigquery')
     print('')
     sys.exit(1)
 


Test patch: